The AVEAS OpenLABEL specification
Project description
AVEAS OpenLABEL
Installation and usage
This library can be installed via pip using pip install aveas_openlabel
or with poetry using poetry add aveas_openlabel
.
The documentation with minimal examples can be found here: understand-ai.github.io/aveas_openlabel/
Development
Poetry
This package uses Poetry, a tool for dependency management and packaging.
Please install it via the official installer from here.
In the root of the repository, you install all dependencies into a virtual environment using poetry install
.
Working with this repository
This repository employs several tools to ensure a constant and good code quality.
Black
Black is a code formatter that we use to assure consistent code style across our projects.
Use it in-between, or after your code changes, via poetry run black .
in the root directory of this repository.
Merge requests will only be merge-able if black has nothing to complain about.
MyPy
Mypy is a static type checker for Python.
Is assures type safety throughout our code and is necessary to ensure that our AVEAS OpenLABEL format is consistent
with the base ASAM OpenLABEL format.
Mypy can be run with poetry run mypy .
in the root directory of this repository.
Merge requests will only be merge-able if MyPy has nothing to complain about.
Ruff
Ruff is a Python linter and code formatter.
It can be run with poetry run ruff .
in the root directory of this repository.
Documentation
Please write docstrings for the class itself and each of its class variables. For inspiration of what to write into the docstring, look at the description of the object or field in the official ASAM OpenLABEL spec (link). The docstrings allow the use of reStructuredText (link).
We are using pydoctor to automatically generate documentation from the docstrings in our code.
The documentation generation can be run using poetry run pydoctor
and is written in the directory documentation/
in the root of this repository.
If administrator privileges required for this operation under MS Windows and poetry is not installed for the administrator account, poetry can be run from Powershell via:
Start-Process poetry -ArgumentList "run pydoctor" -Verb runAs
The documentation is ignored from Git, as it is better to generate it by hand from the latest commit.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for aveas_openlabel-0.4.10-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 212238b36e98fd21fcbb08d890bfb4ff5bb1e9fc2759434072a53dafdc32489c |
|
MD5 | 2a494bc7f9fecbd1f9ea4adabdaddf0c |
|
BLAKE2b-256 | e4c701a2b65f86d65b8ab797ad432a9139223e3ff91d469a90958962e9b6952d |