PyO3 + maturin FFI Workflow

Build

• cd packages/python_viterbo && uv run maturin develop --manifest-path ../rust_viterbo/Cargo.toml

Test

• cd packages/python_viterbo && uv run pytest -q tests/smoke

Contract and expectations

• See: packages/rust_viterbo/docs/ffi-contract.md
• Keep wrappers thin and convert types near the boundary.
• Validate inputs at the boundary, return structured errors.
• Avoid breaking Python-facing APIs without coordination.