Skip to main content

Python interpreter for Stencila

Project description

🐍 Pyla

Python interpreter for Stencila

Build Status Code coverage 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

Alternatively, you can use Pyla directly to execute documents:

$ python3 -m stencila.pyla execute <inputfile> <outputfile> [parameters]
  • <inputfile> and/or <outputfile> can be set to - to read from stdin and/or write to stdout (respectively).

  • [parameters] is a list of parameters to pass to the document –- these will differ based on what the document defines. They can be passed either by --parameter_name=parameter_value or --parameter_name parameter_value. Each parameter must be named.


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.

Files for stencila-pyla, version 0.2.2
Filename, size File type Python version Upload date Hashes
Filename, size stencila_pyla-0.2.2-py3-none-any.whl (21.9 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size stencila-pyla-0.2.2.tar.gz (20.4 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page