neulang 0.2.2

Executable org-formatted pseudocode embedded in Python.

Neulang

Coding for humans.

Description

Neulang is a natural language enabling layer embedded in Python. It takes scripts containing pseudocode in Org format and runs them.

Why?

As the easiest programming language for anyone to learn, Python is awesome. But there's still that curve that continues to shut many out of the coding world. People shouldn't have to learn another language to code, especially in this age of smart devices, IoT and AI. Let's bring coding to the people, not the people to coding. Oh, and I have a lot of pseudocode in Org format that I'd like to make executable.

Installing

• pip install neulang

Features

• Command line mode
  • neu [options] --command="* neu command"
• Interactive mode
  • neu [options] [-i]
  • Exit with *exit* or *quit*
• Importable as module
  • from neulang import Neulang
  • n = Neulang()
  • script = "* air_say 'hello world'"
  • n.loads(script)
  • n.eval()
• Run script files
  • neu [options] /path/to/script.neu
• Run a single node in a script file
  • neu [options] script.neu -o"s/org/path/as/regex/or/index"
• Import other Neulang modules from the command line
  • neu [options] -m"path/to/first/module.neu:another/module.neu"

Usage

• NB: This is early beta software.
• For the best experience, use a text editor which supports org-mode. Preferably Emacs as it is used for the project.
• Activate org-mode on a new buffer (ALT+x org-mode ENTER) and write a script as organized pseudocode.
• Modify your pseudocode so it adheres to the operations available in tests/tests.neu. The following operational categories are currently available:
  • Regular Python expression nodes:
    • * print("Hello world")
  • ASTIR (Abstract Syntax Tree Intermediate Representation) nodes as a drop-in for statements and expressions (not all are implemented as yet). It is distinguished by keywords beginning with air_. The rest tends to, in most cases, correspond to the Python-native name of the operation (though not in this example):
    • * air_setv
    • ** my_string
    • ** This is a string
    • * air_call print my_string
  • Natural language nodes parsed via the Mycroft Adapt intent parser:
    • The intent_parts section takes 1+ valid regular expressions which uses dict groups to enable parsing into an intent.
    • The body section is made of any of the categories, and also gets a dict nl_ctx containing the parsed data.
    • NB: see tests.neu for example usage.
• Run your script: neu script.neu
• Provide feedback on your experience, bugs and suggestions for improvement.

Org-Mode Primer

Org-mode is a rich plain-text system for keeping notes, planning projects and a variety of other organizational tasks. It uses a hierarchial tree structure denoted by stars which can be easily manipulated with keyboard shortcuts. Parts of the text can be folded to show only the general structure and parts currently being worked on.

These core features are inherited by Neulang, which will in time make coding more a matter of organizing natural phrases/sentences which describe desired operations. Specifically, the org-mode features (and their Emacs bindings) which make Neulang easily manipulable are:

• Create a new node
  • ALT+ENTER
• Move a single node up/down
  • ALT+UP/DOWN
• Indent/deindent a single node
  • ALT+LEFT/RIGHT
• Indent/deindent a node and its children
  • ALT_SHIFT+LEFT/RIGHT
• Cycle parent node folding
  • TAB

To Do

• Implement remaining core Python features in AST
• Complete CLI functionality
• Implement fuzzy search and learning resolvers