aas-core-codegen
Aas-core-codegen:
generates code for different programming environments and schemas
to handle asset administration shells
based on the meta-model in simplified Python.
Motivation
The meta-model is still at the stage where it changes frequently. However, we need SDKs in different languages (C#, C++, C, Java, Golang, Erlang etc.) as well as different schemas (JSON Schema, XSD, RDF etc.). Keeping up with the changes is hard, time-consuming and error-prone as each SDK and schema needs to be reviewed independently.
To make the whole development cycle of the meta-model, SDKs and schemas more maintainable, we wrote a code and schema generator. We write a meta-model in a subset of Python language, parse it and, based on this meta-model, generate the code for different languages and schemas.
Therefore we can easily scale to many languages and schemas.
Here is a diagram to illustrate the whole process:
Installation
Single-File Release
Please download and unzip the latest release from the GitHub release page.
From PyPI
The tool is also available on PyPI.
Create a virtual environment:
python -m venv venv-aas-core-codegenActivate it (in Windows):
venv-venv-aas-core-codegen\Scripts\activateor in Linux and OS X:
source venv-aas-core-codegen/bin/activateInstall the tool in the virtual environment:
pip3 install aas-core-codegenUsage
Write your meta-model somewhere as well as the code snippets for implementation specific classes and functions. For example, take our test meta-model for inspiration how to write the meta-model and the snippets.
Make sure you are within the virtual environment where you installed the generator. Alternatively, if you are using the binary release, make sure the release is on your path.
Call the generator with the appropriate target:
aas-core-codegen \
--model_path path/to/meta_model.py \
--snippets_dir path/to/snippets \
--output_dir path/to/output \
--target csharp--help
usage: aas-core-codegen [-h] --model_path MODEL_PATH --snippets_dir
SNIPPETS_DIR --output_dir OUTPUT_DIR --target
{cpp,csharp,golang,java,jsonschema,python,typescript,xsd}
[--cache_model] [--version]
Generate implementations and schemas based on an AAS meta-model.
options:
-h, --help show this help message and exit
--model_path MODEL_PATH
path to the meta-model
--snippets_dir SNIPPETS_DIR
path to the directory containing implementation-
specific code snippets
--output_dir OUTPUT_DIR
path to the generated code
--target {cpp,csharp,golang,java,jsonschema,python,typescript,xsd}
target language or schema
--cache_model If set, cache the parsed meta-model in the temporary
directory of your OS. This makes the repeated runs
faster as the meta-model does not need to be reparsed.
--version show the current version and exitVersioning
We are still not clear about how to version the generator. For the moment, we use a lax incremental versioning with 0.0 prefix (0.0.1, 0.0.2``) etc.
The changelog is available in CHANGELOG.rst.
Contributing
Feature requests or bug reports are always very, very welcome!
Please see quickly if the issue does not already exist in the issue section and, if not, create a new issue.
Contributions in code are also welcome! Please see CONTRIBUTING.rst for developing guidelines.
1 maintainer
Metadata
1 maintainer
Release files for aas-core-codegen 0.0.26
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| aas_core_codegen-0.0.26.tar.gz | 709.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| aas_core_codegen-0.0.26-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.6 MB
Release files / aas_core_codegen-0.0.26.tar.gz
| Download URL | aas_core_codegen-0.0.26.tar.gz |
|---|---|
| Size | 709.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
16b7b53c533186ac7cad670ecb639e1346d9312cd5034fd002e80acb3439d979
|
|
BLAKE2b-256 checksum How to use checksums |
de0027ff5653e98c9e5cd1bf60d9445f469628200409b351f53d1ab7761f2b93
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.6
|
Release files / aas_core_codegen-0.0.26-py3-none-any.whl
| Download URL | aas_core_codegen-0.0.26-py3-none-any.whl |
|---|---|
| Size | 907.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0c9e2a8f5797ce1c67cc45aac0530694346fb7cd6a9d92610f32cab61aadc140
|
|
BLAKE2b-256 checksum How to use checksums |
9a488aa5821ab299f8cdf749d6a63d47ba8de9e34455e6bae80067d486b4094a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.6
|
