Python interpreter for executable documents

This project is deprecated and no longer maintained. At the time of writing, we are instead focussing on using tree-sitter for sematic analysis, and ipykernel for execution, of Python code. Please see, our main repository, stencila/stencila for further information.

Pyla is available as a Python package,

pip3 install stencila-pyla

Register Pyla so that it can be discovered by other executors on your machine,

python3 -m stencila.pyla register

Then, if you have executa installed then you can run it using the repl command and specifying python as the starting language,

executa repl python

To install the packages needed for development, run make setup or,

pip3 install --user --upgrade -r requirements-dev.txt

We use Black to maintain a consistent code formatting style. To run it use black . or make format.

There are two options to run the interpreter without installing this package (which can be useful when developing).

Run python3 setup.py develop which will link this library into your site packages directory. You can then execute documents with the above command.

You can run the interpreter as a module by changing into the stencila directory first, and then omitting the stencila namespace:

$ cd stencila
$ python3 -m pyla execute <inputfile> <outputfile> [parameters]