Pylasu – Python Language Support

Pylasu is an AST Library in the StarLasu family, targeting the Python language. Documentation is on Read the Docs.

Testing

python -m unittest discover tests

Linting

flake8 . && flake8 tests

Packaging and distributing

Update version in pyproject.toml, setup.cfg and setup.py (TODO do we need all three?), then run:

rm dist/*
python -m build
python -m twine upload dist/*

If all goes well, tag the release:

git tag

Extracting Documentation

Here's how to extract the documentation into HTML using Sphinx, the most popular documentation generator for Python.

First, ensure you have Sphinx and the chosen theme installed:

pip install sphinx sphinx_rtd_theme

Then, extract the documentation from the source code:

sphinx-apidoc -o docs pylasu

Finally, change into the docs directory and launch the build process:

cd docs
make html

If everything goes as it should, in docs/_build/html you'll find the generated documentation.

We also host the documentation on ReadTheDocs. The project is pylasu. Documentation needs to be built manually for each release for it to appear online on https://pylasu.readthedocs.io.