Skip to main content

Module graduation

Module graduation 

Source
Expand description

Honest Python-to-Rust/component graduation workflow.

The workflow scaffolds adapters and verifies recorded behavior. It never claims to translate arbitrary Python business logic. Candidate publication, attestation, activation, and rollback are serialized and digest-bound.

Structs§

ComparisonRequest
Host-owned inputs for one bounded Python/component dual-run.
ConformanceAttestation
Successful, digest-bound conformance evidence required by activation.
GraduationArtifact
Immutable component identity retained in the graduation workspace.
GraduationFixture
One recorded Python input/output pair used for component conformance.
GraduationState
Durable state for one graduation workspace.

Functions§

activate
Publish the attested candidate into the live provider directory.
build_component
Build (or import), verify, and publish an immutable candidate artifact.
commit_transaction
Commit a live activation only after the caller has refreshed and verified the active provider generation.
compare
Replay fixtures and persist digest-bound conformance evidence.
graduate
Scaffold a reusable Rust core plus thin PyO3 and WIT adapters.
is_ambiguous_commit
Whether commit crossed the atomic marker transition but failed its directory durability sync. Such errors must never trigger rollback.
recover
Restore the exact pre-operation provider files and graduation state.
recover_all
Recover interrupted transactions beneath an operator-owned graduation root before provider discovery observes partially promoted files.
rollback
Reactivate the retained component, or restore the original Python source.
status
Read-only operator status with integrity checks for referenced artifacts.
verify_component
Validate a component artifact against the versioned WIT runtime.