---
name: ffi-pyo3-maturin
description: Build or modify the Rust↔Python FFI using PyO3+maturin. Use for binding builds, smoke tests, and boundary validation workflow.
---

# 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.