Metadata-Version: 2.4
Name: hoa_utils_redux
Version: 0.2.0
Summary: A slightly updated fork of `hoa_utils`. Utilities for the HOA format.
Project-URL: Repository, https://github.com/lou1306/hoa-utils.git
Project-URL: Documentation, https://whitemech.github.io/hoa-utils
Project-URL: Bug Tracker, https://github.com/lou1306/hoa-utils/issues
Project-URL: Pull Requests, https://github.com/lou1306/hoa-utils/pulls
Author-email: Luca Di Stefano <luca.di.stefano@tuwien.ac.at>
License-Expression: LGPL-3.0-or-later
License-File: AUTHORS.md
License-File: LICENSE
Keywords: HOA,HOA-format,automata
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 or later (LGPLv3+)
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Requires-Python: <4.0,>=3.8
Requires-Dist: click<9,>=8.1.0
Requires-Dist: interegular>=0.3.3
Requires-Dist: lark<2,>=1.3.1
Description-Content-Type: text/markdown

## Disclaimer

This repository is a fork of `hoa-utils` (https://github.com/whitemech/hoa-utils).
I sincerely hope the (limited) changes I suggest are merged upstream. In case this
happens, I will archive the repository/PyPI package and redirect users towards the
upstream repo.

## Original README.md

Utilities for the HOA format.

## Install

The best way is to install the package from PyPI:
```
pip install hoa-utils
```

Alternatively, you can install it from source (master branch):
```
pip install git+https://github.com/whitemech/hoa-utils.git
```

## What you'll find

- APIs to create and manipulate HOA objects
- CLI tools to about the HOA format.

The implementation may not be very stable at the moment.

Currently, the only supported CLI tool is:
- `pyhoafparser`: parse and validate a file in HOA format. 


## Development

If you want to contribute, here's how to set up your development environment.

- Install [Poetry](https://python-poetry.org/)
- Clone the repository: `git clone https://github.com/whitemech/hoa-utils.git && cd hoa-utils`
- Install the dependencies: `poetry install`

## Tests

To run tests: `tox`

To run only the code tests: `tox -e py3.7`

To run only the code style checks:
 - `tox -e black-check`
 - `tox -e isort-check`
 - `tox -e flake8`
 
 In `tox.ini` you can find all the test environment supported.

## Docs

To build the docs: `mkdocs build`

To view documentation in a browser: `mkdocs serve`
and then go to [http://localhost:8000](http://localhost:8000)

## Authors

- [Marco Favorito](https://marcofavorito.github.io/)
- [Francesco Fuggitti](https://francescofuggitti.github.io/)

## License

`hoa-utils` is released under the MIT License.

Copyright 2020 WhiteMech
