py-osc2 0.1.0

Description:

pyosc2 0.1.0

PMSF py-osc2 Framework





What is it?
PMSF py-osc2 is a Python package for working with ASAM OpenSCENARIO
DSL 2.x scenario files.
Note that this package is currently provided as a community service.
It is based on the current public review draft of version 2.1.0 of the
language, which is non-final, and might include updates based on
current developments.
It is offered without any support and should be considered draft alpha
quality.
Specifically both the public review draft standard, this rendering of
the grammar in ANTLR4, and any intermediate fixes might contain errors.
Nor is the rendering of the grammar in ANTLR4 intended for purposes
other than the goals of this package.
If you are interested in OpenSCENARIO DSL development, please feel free
to contact us directly.
Main features

ANTLR4-based parser and lexer for parsing ASAM OpenSCENARIO DSL 2.x
files.
Simple syntax checking driver osc2parser for parsing and checking
ASAM OpenSCENARIO DSL 2.x files.

Where to get it
The source code is currently hosted on GitHub at:
https://github.com/PMSFIT/py-osc2
Binary installers for the latest released version are available at the
Python Package Index (PyPI).
# or PyPI
pip install py-osc2

Dependencies

antlr4-python3-runtime

When rebuilding the parser from its grammar:

setuptools-antlr

Rebuilding the parser
To rebuild the parser, you need setuptools-antlr
in addition to the normal dependencies above:
pip install setuptools-antlr

To rebuild the package with a rebuilt parser, execute:
python setup.py antlr build

or for installing:
python setup.py antlr install

or alternatively to install in development mode:
python setup.py antlr develop

License
(C) 2021-2024 PMSF IT Consulting Pierre R. Mai
MPL 2.0
Documentation
After installation of the package, an executable script, called
osc2parser, is available to parse and check ASAM OpenSCENARIO DSL 2.x
files:
osc2parser examples/demo.osc

This script can optionally also output a tree-view of the parsed file
contents:
osc2parser -t examples/demo.osc