thrust

thrust is the Rust acceleration layer behind traffic, with Python bindings and WASM bindings for browser/Node use-cases.

Repository layout

• crates/thrust: core Rust crate (traffic-thrust) for FAA and EUROCONTROL parsing.
• python: Python package (thrust) built with maturin (thrust.core extension module).
• crates/thrust-wasm: WASM crate and npm packaging pipeline.

Highlights

• FAA support:
  • ArcGIS OpenData datasets (airports, navaids, fixes, ATS routes)
  • NASR field15 extraction from cycle zip files
  • NAT bulletin parsing
• EUROCONTROL support:
  • AIXM baseline datasets
  • DDR datasets from either folder paths or direct zip archives
• Multi-language distribution:
  • PyPI wheels via .github/workflows/wheels.yml
  • npm package (thrust-wasm) via .github/workflows/npm.yml

Releasing

Release versions are defined by the workspace version in Cargo.toml and must be published as matching vX.Y.Z tags. After the version bump is merged to master, pushing the tag runs the full maturin matrix and then:

• verifies the tag and distribution versions match;
• verifies CPython 3.11–3.14 Linux wheels exist;
• creates a GitHub Release containing all wheels and the source distribution;
• publishes all artifacts to PyPI.

The workflow is rerunnable if an upload is interrupted. Do not reuse a published version: PyPI releases are immutable.

Local development

Rust checks:

cargo fmt --all
cargo clippy --workspace --all-features --all-targets -- -D warnings
cargo test --workspace --all-targets --features traffic-thrust/net

Python checks:

cd python
uv sync --dev
uv run ruff check .
uv run ty check thrust
uv run pytest tests

WASM packaging:

cd crates/thrust-wasm
just pkg