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

Metadata

Release files for zuspec-be-sw 0.0.1.21086046738rc0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for zuspec-be-sw 0.0.1.21086046738rc0
File	Interpreter	ABI	Platform	Reset
zuspec_be_sw-0.0.1.21086046738rc0-py3-none-any.whl 77.0 kB Jan 17, 2026 Without provenance	Python 3	none	any	Details

Release files / zuspec_be_sw-0.0.1.21086046738rc0-py3-none-any.whl

Download URL	zuspec_be_sw-0.0.1.21086046738rc0-py3-none-any.whl
Size	77.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`e499acd6c130fe573a5ae6c418dad8d7734ff318b815691ff35469f7940b0f11`
BLAKE2b-256 checksum How to use checksums	`073f0cbb049c782d26e5d7d20a2b3eeea0fdbefae56e7fef132f647d6294b211`
Upload date	Jan 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.13.11`

Security for zuspec-be-sw 0.0.1.21086046738rc0

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.