Back to skills
extension
Category: Development & EngineeringNo API key required

ffi-pyo3-maturin

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

personAuthor: jakexiaohubgithub

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.