Ratio ESL#

Ratio support for the Elephant Specification Language (ESL) in Python.

Quickstart#

Installation#

RaESL can be installed using pip install raesl[all] for any Python version >=3.9. Or, for Poetry managed projects, use poetry add raesl -E all to add it as a dependency.

For RaESL’s different subcommands and functionality, the wheel provides extras which you could provide instead of the all used above:

  • doc: documentation generation using pandoc, Markdown and optionally LaTeX.

  • jupyter: a Jupyter ESL kernel.

  • pygments: an ESL syntax highlighter for pygments.

  • rich: Rich doc output in the form of Plotly images.

  • server: A language server to parse documents.

The default compile command is always available.

Please refer to the usage documentation for more info on how to use RaESL.

Developer guide#

Python packaging information#

This project is packaged using poetry. Packaging information as well as dependencies are stored in pyproject.toml.

Installing the project and its development dependencies can be done using poetry install -E all.

Versioning#

This project uses semantic versioning. Version increments are checked using Raver.

Changelog#

Changelog format as described by https://keepachangelog.com/ has been adopted and can be reviewed on this page <https://raesl.ratio-case.nl/changelog.html>.

Tests#

Tests can be run using poetry run pytest.

Linting#

Linting config is included in pyproject.toml for both Black and Ruff.