makoralle 🪸
makoralle provides pydantic models for the German
MaKo (Marktkommunikation) processes together with serializers that turn those
models into the output formats used downstream:
- YAML – process and EBD (Entscheidungsbaum-Diagramm) representations
- WSD – the websequencediagrams DSL for sequence diagrams
- BPMN – business process model XML
- Markdown – human-readable process documentation
It is the shared, dependency-light foundation (only pydantic and PyYAML) consumed by
the private makorele parser and by the process-documentation webapp.
Separation of concerns
Part of the Hochfrequenz MaKo tooling — four repositories, one responsibility each:
- makoralle (public, PyPI) — the data model + serializers. ← this repo
- makorele (private) — the parser (BDEW PDFs → validated models).
- machine-readable_mako-prozesse (private) — the generated dataset, consumed at a pinned tag.
- mako_prozesse — the web app that presents the dataset.
Dependencies flow one way: makorele → makoralle; the dataset is produced by the tooling and consumed by the web app at a pinned tag. makoralle imports neither the parser nor the app.
Installation
pip install makoralle
Usage
The public serialization API is exposed at the package root and resolved lazily
(importing makoralle, or a light submodule like makoralle.grouping, does not
eagerly pull in the serialization stack):
from makoralle import emit_yaml, emit_wsd, emit_markdown, emit_bpmn
from makoralle.models.process import Process
# build or load a Process model, then serialize it
yaml_text = emit_yaml(process)
wsd_text = emit_wsd(process.sequence_diagrams[0])
The models live under makoralle.models (process, ebd, pid, activity, chunk)
and the serializers under makoralle.serialization.
Development
This project uses the Hochfrequenz src-layout Python template
with uv. To set up a development environment:
uv sync --group dev
Run the unit tests, linting, type checks and coverage (matching what CI runs):
uv run --group tests pytest
uv run --group linting ruff check src/makoralle unittests
uv run --group linting ruff format --check .
uv run --group type_check mypy --strict src/makoralle
uv run --group type_check mypy --strict unittests
cd unittests && uv run --group coverage coverage run -m pytest && cd ..
2 maintainers
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
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file makoralle-0.0.4.tar.gz.
File metadata
- Download URL: makoralle-0.0.4.tar.gz
- Upload date:
- Size: 89.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7d5cc787fb33420f84f9f47ff941656f7f91822e030e8fc55b5b1776dbb12a74
|
|
| MD5 |
45ec4f854616e2be327970e7302fe23d
|
|
| BLAKE2b-256 |
db609a3a4c75504fde7835f1b13aa500a5a072b0ab6a61abfdd5be453f50d668
|
Provenance
The following attestation bundles were made for makoralle-0.0.4.tar.gz:
Publisher:
python-publish.yml on Hochfrequenz/makoralle
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
makoralle-0.0.4.tar.gz -
Subject digest:
7d5cc787fb33420f84f9f47ff941656f7f91822e030e8fc55b5b1776dbb12a74 - Sigstore transparency entry: 2451080681
- Sigstore integration time:
-
Permalink:
Hochfrequenz/makoralle@f06357223477d725ff75ea4c8e4d409e8148bd67 -
Branch / Tag:
refs/tags/v0.0.4 - Owner: https://github.com/Hochfrequenz
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
python-publish.yml@f06357223477d725ff75ea4c8e4d409e8148bd67 -
Trigger Event:
release
-
Statement type:
File details
Details for the file makoralle-0.0.4-py3-none-any.whl.
File metadata
- Download URL: makoralle-0.0.4-py3-none-any.whl
- Upload date:
- Size: 42.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c09c596ac2f609dfe76bc238ebe708bc158b872bd02cd800651a781c3d056be2
|
|
| MD5 |
aa94b65d3b56af6616dcaa4d951ff073
|
|
| BLAKE2b-256 |
c4cef15c4325211fa2d1cf4a38bc472a7c6da1ee811708dedc9cece7181d34ae
|
Provenance
The following attestation bundles were made for makoralle-0.0.4-py3-none-any.whl:
Publisher:
python-publish.yml on Hochfrequenz/makoralle
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
makoralle-0.0.4-py3-none-any.whl -
Subject digest:
c09c596ac2f609dfe76bc238ebe708bc158b872bd02cd800651a781c3d056be2 - Sigstore transparency entry: 2451080742
- Sigstore integration time:
-
Permalink:
Hochfrequenz/makoralle@f06357223477d725ff75ea4c8e4d409e8148bd67 -
Branch / Tag:
refs/tags/v0.0.4 - Owner: https://github.com/Hochfrequenz
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
python-publish.yml@f06357223477d725ff75ea4c8e4d409e8148bd67 -
Trigger Event:
release
-
Statement type:
