Generate code from DSDL using Jinja2 templates.
Project description
Nunavut is a UAVCAN DSDL code generator that automates exposing a pydsdl abstract syntax tree to Jinja2 templates allowing authors to generate code, schemas, metadata, documentation, etc.
Partial example: generating a C struct
/*
* UAVCAN data structure definition
*
* Autogenerated, do not edit.
*
* Source file: {{T.source_file_path}}
*/
#ifndef {{T.full_name | c.macrofy}}
#define {{T.full_name | c.macrofy}}
typedef struct {{T.full_name | c.to_snake_case}}Type
{
{%- for attribute in T.attributes %}
{%- if attribute is constant %}
const {{ attribute.data_type | c.type_from_primitive(use_standard_types=True) }} {{ attribute.name }} = {{ attribute.value }};
{% endif -%}
{% endfor %}
...
} {{ T.full_name | c.to_snake_case }};
#endif // {{T.full_name | c.macrofy}}
Nunavut is named after the Canadian territory. We chose the name because it is a beautiful word to say and read. Also, the name fits with a theme of “places in Canada” started with the Yukon project.
Installation
Nunavut requires Python 3.5 or newer and depends on pydsdl.
Install from PIP:
pip install nunavut
Bundled third-party software
Nunavut embeds the following third-party software libraries into its source (i.e. these are not dependencies and do not need to be installed):
Jinja2 by Armin Ronacher and contributors, BSD 3-clause license.
markupsafe by Armin Ronacher and contributors, BSD 3-clause license (needed for Jinja).
Documentation
The documentation for Nunavut is hosted on readthedocs.io:
nunavut - The python library provided by this project.
nnvg – Command-line script for using nunavut directly or as part of a build system.
nunavut template guide – Documentation for authors of nunavut templates.
nunavut contributors guide – Documentation for contributors to the Nunavut project.
nunavut licenses – Licenses and copyrights
Nunavut is part of the UAVCAN project:
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 Distributions
Hashes for nunavut-0.1.4-4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a2011c4e448722d917903160449fb86652de6f0da0a5abb307b58e79b83b4075 |
|
MD5 | b2dc6e065c604e3858f542e3425c882a |
|
BLAKE2b-256 | e6033b88ca51eb19518ba6e536d0121fa4b43f6ddc4be1a68abbf3cbb50236fb |
Hashes for nunavut-0.1.4-3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d0f43b19f8def10a95a93311309e04ebed77d5e1ed9b8b156bbe7fa5fb629a95 |
|
MD5 | d44cf146b329f6ed8c496b862ea0f3e7 |
|
BLAKE2b-256 | b4c7a9b8a587dc7f24c9d2f45e82ba772e8ec35eb281b14e4a46e5bb6f3d9210 |