Skip to main content

Python interpreter for executable documents

Project description

🐍 Pyla

Python interpreter for executable documents

Build Status Code coverage Code style PyPI Docs

This is the Python implementation of an interpreter capable of interpreting executable documents defined in JSON using Stencila Schema.


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

Code formatting

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).

Use develop

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

Change into stencila folder

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]

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

stencila-pyla-0.3.1.tar.gz (19.6 kB view hashes)

Uploaded source

Built Distribution

stencila_pyla-0.3.1-py3-none-any.whl (20.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page