Metadata-Version: 2.1
Name: pylasu
Version: 0.5.0
Summary: Pylasu is an AST Library in the StarLasu family, targeting the Python language.
Author: Strumenta S.R.L.
Author-email: Lorenzo Addazi <lorenzo.addazi@strumenta.com>, Alessio Stalla <alessio.stalla@strumenta.com>, Federico Tomassetti <federico@strumenta.com>
License: Apache License V2
Project-URL: Homepage, https://github.com/strumenta/pylasu
Project-URL: Bug Tracker, https://github.com/strumenta/pylasu/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Provides-Extra: ecore
License-File: LICENSE

# Pylasu – Python Language Support #

[![Build Status](https://github.com/Strumenta/pylasu/actions/workflows/pythonapp.yml/badge.svg)](https://github.com/Strumenta/pylasu/actions/workflows/pythonapp.yml)
[![PyPI](https://img.shields.io/pypi/v/pylasu.svg)](https://pypi.org/project/pylasu)
[![Documentation](https://readthedocs.org/projects/pylasu/badge/?version=latest&style=flat)](https://pylasu.readthedocs.io)

Pylasu is an AST Library in the [StarLasu](https://github.com/Strumenta/StarLasu) family, targeting the Python language. [Documentation](https://pylasu.readthedocs.io) is on Read the Docs.

## Testing

```shell
python -m unittest discover tests 
```

## Linting

```shell
flake8 . && flake8 tests
```

## Packaging and distributing

Update version in `pyproject.toml`, `setup.cfg` and `pylasu/__version__.py` _(TODO do we need all three?)_,
commit and check that CI completes normally. Then run:

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

If all goes well, tag the release:

```shell
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:
```shell
pip install sphinx sphinx_rtd_theme
```

Then, extract the documentation from the source code:
```shell
sphinx-apidoc -o docs pylasu
```

Finally, change into the docs directory and launch the build process:
```shell
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](https://readthedocs.org/projects/pylasu/). 
Documentation needs to be built manually for each release for it to appear online on https://pylasu.readthedocs.io.
