Pre-release
This release is a pre-release and may not be stable for production use.
Zuspec Software Backend
The Zuspec Software (SW) Backend transforms Zuspec hardware component models into executable C/C++ code for simulation, testing, and modeling.
Features
- Component Translation: Zuspec Components → C structs and functions
- Async/Sync: Transforms async methods with optional sync conversion
- Protocol Interfaces: Generates C API structs for Protocol types
- Type Mapping: Maps Zuspec types to C types
- Validation: Pre-generation compatibility checks
- Compilation: Built-in GCC compiler interface
- Test Execution: Automated test runner
- Type Specialization: Optional monomorphization (experimental)
Installation
pip install zuspec-be-sw
Quick Start
import zuspec.dataclasses as zdc
from zuspec.be.sw import CGenerator, CValidator, CCompiler, TestRunner
from pathlib import Path
@zdc.dataclass
class Counter(zdc.Component):
count: int = zdc.field(default=0)
def increment(self):
self.count += 1
def get_count(self) -> int:
return self.count
# Build → Validate → Generate → Compile → Run
factory = zdc.DataModelFactory()
ctxt = factory.build(Counter)
validator = CValidator()
assert validator.validate(ctxt)
gen = CGenerator(Path("output"))
sources = gen.generate(ctxt)
compiler = CCompiler(Path("output"))
exe = compiler.compile(sources, Path("output/test"))
runner = TestRunner()
result = runner.run(exe)
Generated C Code
typedef struct Counter {
int count;
} Counter;
void Counter_init(Counter *self);
void Counter_increment(Counter *self);
int Counter_get_count(Counter *self);
Documentation
Requirements
- Python >= 3.7
- zuspec-dataclasses
- C compiler (GCC)
License
Apache-2.0
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
No source distribution files available for this release.See tutorial on generating distribution archives.
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 zuspec_be_sw-0.0.1.20941125465rc0-py3-none-any.whl.
File metadata
- Download URL: zuspec_be_sw-0.0.1.20941125465rc0-py3-none-any.whl
- Upload date:
- Size: 77.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.13.11
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1d739cf29ee56288f7854c224f7739c2cce77bf57b141c0c1e977e274c6ff0f7
|
|
| MD5 |
ef399fb169909a43a32d5cce9824bd31
|
|
| BLAKE2b-256 |
09ecd50cc995c8c857b96ccb97c40e01119768e4182410980494806f1fb02521
|
