emx-onnx-cgen 0.2.0__tar.gz

emx_onnx_cgen-0.2.0/MANIFEST.in

@@ -0,0 +1 @@
+include build_backend.py

emx_onnx_cgen-0.2.0/PKG-INFO

@@ -0,0 +1,128 @@
+Metadata-Version: 2.4
+Name: emx-onnx-cgen
+Version: 0.2.0
+Summary: emmtrix ONNX-to-C Code Generator
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# emmtrix ONNX-to-C Code Generator (emx-onnx-cgen)
+
+[![PyPI - Version](https://img.shields.io/pypi/v/emx-onnx-cgen.svg)](https://pypi.org/project/emx-onnx-cgen)
+
+`emx-onnx-cgen` compiles ONNX models to portable, deterministic C code for deeply embedded systems. The generated code is designed to run without dynamic memory allocation, operating systems, or external runtimes, making it suitable for safety-critical and resource-constrained targets.
+
+Key characteristics:
+
+- **No dynamic memory allocation** (`malloc`, `free`, heap usage)
+- **Static, compile-time known memory layout** for parameters, activations, and temporaries
+- **Deterministic control flow** (explicit loops, no hidden dispatch or callbacks)
+- **No OS or libc dependencies** beyond basic C
+- **Single-threaded execution model**
+- **Bitwise-stable code generation** for reproducible builds
+- **Readable, auditable C code** suitable for certification and code reviews
+- Designed for **bare-metal and RTOS-based systems**
+
+## Goals
+
+- Correctness-first compilation with outputs comparable to ONNX Runtime.
+- Deterministic and reproducible C code generation.
+- Clean, pass-based compiler architecture (import → normalize → optimize → lower → emit).
+- Minimal C runtime with explicit, predictable data movement.
+
+## Non-goals
+
+- Aggressive performance optimizations in generated C.
+- Implicit runtime dependencies or dynamic loading.
+- Training/backpropagation support.
+
+## Features
+
+- CLI for ONNX-to-C compilation and verification.
+- Deterministic codegen with explicit tensor shapes and loop nests.
+- Minimal C runtime templates in `templates/`.
+- ONNX Runtime comparison for end-to-end validation.
+- Official ONNX operator coverage tracking.
+- Support for a wide range of ONNX operators (see `OFFICIAL_ONNX_FILE_SUPPORT.md`).
+- Supported data types:
+  - `float`, `double`, `float16`
+  - `int8_t`, `uint8_t`, `int16_t`, `uint16_t`, `int32_t`, `uint32_t`, `int64_t`, `uint64_t`
+  - `bool`
+- Supporting dynamic dimensions by utilizing C99 variable-length arrays (VLAs).
+
+## Installation
+
+Install the package directly from PyPI (recommended):
+
+```bash
+pip install emx-onnx-cgen
+```
+
+Optional for verification and tests:
+
+- `onnxruntime`
+- `numpy`
+- A C compiler (`cc`, `gcc`, `clang` or via `--cc`)
+
+## Quickstart
+
+Compile an ONNX model into a C source file:
+
+```bash
+emx-onnx-cgen compile path/to/model.onnx build/model.c
+```
+
+Verify an ONNX model end-to-end against ONNX Runtime:
+
+```bash
+emx-onnx-cgen verify path/to/model.onnx
+```
+
+## CLI Reference
+
+`emx-onnx-cgen` provides two subcommands: `compile` and `verify`.
+
+### `compile`
+
+```bash
+emx-onnx-cgen compile <model.onnx> <output.c> [options]
+```
+
+Options:
+
+- `--template-dir`: Directory containing the C templates (default: `templates`).
+- `--model-name`: Override the generated model name (default: output file stem).
+- `--emit-testbench`: Emit a JSON-producing `main()` testbench for validation.
+- `--emit-data-file`: Emit constant data arrays into a companion `_data` C file.
+- `--no-restrict-arrays`: Disable `restrict` qualifiers on generated array parameters.
+
+### `verify`
+
+```bash
+emx-onnx-cgen verify <model.onnx> [options]
+```
+
+Options:
+
+- `--template-dir`: Directory containing the C templates (default: `templates`).
+- `--model-name`: Override the generated model name (default: model file stem).
+- `--cc`: Explicit C compiler command for building the testbench binary.
+
+## Output
+
+By default, the compiler emits a single C source file that includes:
+
+- A generated entry point that mirrors the ONNX graph inputs/outputs.
+- Tensor buffers for constants and temporaries.
+- A lightweight runtime implemented via templates in `templates/`.
+
+When `--emit-data-file` is enabled, the main C source declares constant arrays
+as `extern`, and a second file named like the output with a `_data` suffix
+contains the constant definitions.
+
+## Official ONNX test coverage
+
+See [`OFFICIAL_ONNX_FILE_SUPPORT.md`](OFFICIAL_ONNX_FILE_SUPPORT.md) for the generated support matrix.
+
+## Maintained by
+
+This project is maintained by [emmtrix](https://www.emmtrix.com).

emx_onnx_cgen-0.2.0/README.md

@@ -0,0 +1,121 @@
+# emmtrix ONNX-to-C Code Generator (emx-onnx-cgen)
+
+[![PyPI - Version](https://img.shields.io/pypi/v/emx-onnx-cgen.svg)](https://pypi.org/project/emx-onnx-cgen)
+
+`emx-onnx-cgen` compiles ONNX models to portable, deterministic C code for deeply embedded systems. The generated code is designed to run without dynamic memory allocation, operating systems, or external runtimes, making it suitable for safety-critical and resource-constrained targets.
+
+Key characteristics:
+
+- **No dynamic memory allocation** (`malloc`, `free`, heap usage)
+- **Static, compile-time known memory layout** for parameters, activations, and temporaries
+- **Deterministic control flow** (explicit loops, no hidden dispatch or callbacks)
+- **No OS or libc dependencies** beyond basic C
+- **Single-threaded execution model**
+- **Bitwise-stable code generation** for reproducible builds
+- **Readable, auditable C code** suitable for certification and code reviews
+- Designed for **bare-metal and RTOS-based systems**
+
+## Goals
+
+- Correctness-first compilation with outputs comparable to ONNX Runtime.
+- Deterministic and reproducible C code generation.
+- Clean, pass-based compiler architecture (import → normalize → optimize → lower → emit).
+- Minimal C runtime with explicit, predictable data movement.
+
+## Non-goals
+
+- Aggressive performance optimizations in generated C.
+- Implicit runtime dependencies or dynamic loading.
+- Training/backpropagation support.
+
+## Features
+
+- CLI for ONNX-to-C compilation and verification.
+- Deterministic codegen with explicit tensor shapes and loop nests.
+- Minimal C runtime templates in `templates/`.
+- ONNX Runtime comparison for end-to-end validation.
+- Official ONNX operator coverage tracking.
+- Support for a wide range of ONNX operators (see `OFFICIAL_ONNX_FILE_SUPPORT.md`).
+- Supported data types:
+  - `float`, `double`, `float16`
+  - `int8_t`, `uint8_t`, `int16_t`, `uint16_t`, `int32_t`, `uint32_t`, `int64_t`, `uint64_t`
+  - `bool`
+- Supporting dynamic dimensions by utilizing C99 variable-length arrays (VLAs).
+
+## Installation
+
+Install the package directly from PyPI (recommended):
+
+```bash
+pip install emx-onnx-cgen
+```
+
+Optional for verification and tests:
+
+- `onnxruntime`
+- `numpy`
+- A C compiler (`cc`, `gcc`, `clang` or via `--cc`)
+
+## Quickstart
+
+Compile an ONNX model into a C source file:
+
+```bash
+emx-onnx-cgen compile path/to/model.onnx build/model.c
+```
+
+Verify an ONNX model end-to-end against ONNX Runtime:
+
+```bash
+emx-onnx-cgen verify path/to/model.onnx
+```
+
+## CLI Reference
+
+`emx-onnx-cgen` provides two subcommands: `compile` and `verify`.
+
+### `compile`
+
+```bash
+emx-onnx-cgen compile <model.onnx> <output.c> [options]
+```
+
+Options:
+
+- `--template-dir`: Directory containing the C templates (default: `templates`).
+- `--model-name`: Override the generated model name (default: output file stem).
+- `--emit-testbench`: Emit a JSON-producing `main()` testbench for validation.
+- `--emit-data-file`: Emit constant data arrays into a companion `_data` C file.
+- `--no-restrict-arrays`: Disable `restrict` qualifiers on generated array parameters.
+
+### `verify`
+
+```bash
+emx-onnx-cgen verify <model.onnx> [options]
+```
+
+Options:
+
+- `--template-dir`: Directory containing the C templates (default: `templates`).
+- `--model-name`: Override the generated model name (default: model file stem).
+- `--cc`: Explicit C compiler command for building the testbench binary.
+
+## Output
+
+By default, the compiler emits a single C source file that includes:
+
+- A generated entry point that mirrors the ONNX graph inputs/outputs.
+- Tensor buffers for constants and temporaries.
+- A lightweight runtime implemented via templates in `templates/`.
+
+When `--emit-data-file` is enabled, the main C source declares constant arrays
+as `extern`, and a second file named like the output with a `_data` suffix
+contains the constant definitions.
+
+## Official ONNX test coverage
+
+See [`OFFICIAL_ONNX_FILE_SUPPORT.md`](OFFICIAL_ONNX_FILE_SUPPORT.md) for the generated support matrix.
+
+## Maintained by
+
+This project is maintained by [emmtrix](https://www.emmtrix.com).

emx_onnx_cgen-0.2.0/build_backend.py

@@ -0,0 +1,81 @@
+from __future__ import annotations
+
+from datetime import datetime, timezone
+from pathlib import Path
+import subprocess
+
+from setuptools import build_meta as _build_meta
+
+BUILD_INFO_MODULE = (
+    Path(__file__).resolve().parent / "src" / "emx_onnx_cgen" / "_build_info.py"
+)
+
+
+def _write_build_info() -> None:
+    build_date = datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
+    git_version = _read_git_version()
+
+    # Ensure the package directory exists (useful for clean checkouts / CI)
+    BUILD_INFO_MODULE.parent.mkdir(parents=True, exist_ok=True)
+
+    BUILD_INFO_MODULE.write_text(
+        '"""Auto-generated by build backend. Do not edit."""\n'
+        f"BUILD_DATE = {build_date!r}\n"
+        f"GIT_VERSION = {git_version!r}\n",
+        encoding="utf-8",
+    )
+
+
+def _read_git_version() -> str:
+    try:
+        result = subprocess.run(
+            ["git", "rev-parse", "--short", "HEAD"],
+            check=True,
+            capture_output=True,
+            text=True,
+        )
+    except (OSError, subprocess.CalledProcessError):
+        return "unknown"
+    return result.stdout.strip() or "unknown"
+
+
+def build_wheel(wheel_directory, config_settings=None, metadata_directory=None):
+    _write_build_info()
+    return _build_meta.build_wheel(
+        wheel_directory,
+        config_settings=config_settings,
+        metadata_directory=metadata_directory,
+    )
+
+
+def build_editable(wheel_directory, config_settings=None, metadata_directory=None):
+    _write_build_info()
+    return _build_meta.build_editable(
+        wheel_directory,
+        config_settings=config_settings,
+        metadata_directory=metadata_directory,
+    )
+
+
+def build_sdist(sdist_directory, config_settings=None):
+    return _build_meta.build_sdist(sdist_directory, config_settings=config_settings)
+
+
+def get_requires_for_build_wheel(config_settings=None):
+    return _build_meta.get_requires_for_build_wheel(config_settings=config_settings)
+
+
+def get_requires_for_build_editable(config_settings=None):
+    return _build_meta.get_requires_for_build_editable(config_settings=config_settings)
+
+
+def prepare_metadata_for_build_wheel(metadata_directory, config_settings=None):
+    return _build_meta.prepare_metadata_for_build_wheel(
+        metadata_directory, config_settings=config_settings
+    )
+
+
+def prepare_metadata_for_build_editable(metadata_directory, config_settings=None):
+    return _build_meta.prepare_metadata_for_build_editable(
+        metadata_directory, config_settings=config_settings
+    )

emx_onnx_cgen-0.2.0/pyproject.toml

@@ -0,0 +1,20 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "build_backend"
+backend-path = ["."]
+
+[project]
+name = "emx-onnx-cgen"
+version = "0.2.0"
+description = "emmtrix ONNX-to-C Code Generator"
+readme = { file = "README.md", content-type = "text/markdown" }
+requires-python = ">=3.10"
+
+[project.scripts]
+emx-onnx-cgen = "emx_onnx_cgen.cli:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]

emx_onnx_cgen-0.2.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

emx_onnx_cgen-0.2.0/src/emx_onnx_cgen/__init__.py

@@ -0,0 +1,6 @@
+"""ONNX to C compiler MVP."""
+
+from .compiler import Compiler
+from .errors import CodegenError, ShapeInferenceError, UnsupportedOpError
+
+__all__ = ["Compiler", "CodegenError", "ShapeInferenceError", "UnsupportedOpError"]

emx_onnx_cgen-0.2.0/src/emx_onnx_cgen/__main__.py

@@ -0,0 +1,9 @@
+from __future__ import annotations
+
+import sys
+
+from .cli import main
+
+
+if __name__ == "__main__":
+    raise SystemExit(main(sys.argv[1:]))

emx_onnx_cgen-0.2.0/src/emx_onnx_cgen/_build_info.py

@@ -0,0 +1,4 @@
+"""Build metadata for emx_onnx_cgen."""
+
+BUILD_DATE = "unknown"
+GIT_VERSION = "unknown"