openair-rs-py 0.1.2

Python bindings for OpenAir airspace file parser

openair-rs-py

Note: This is a fork of https://github.com/dbrgn/openair-rs with Python bindings. See README_ORIG.md for original readme.

This directory contains Python bindings for the OpenAir airspace file parser written in Rust.

Openair Format specification

https://web.archive.org/web/20220703063934/http://www.winpilot.com/usersguide/userairspace.asp (original page no longer available, archived version linked)

see also FORMAT.txt

For future improvements (version 2.1), see: https://github.com/naviter/seeyou_file_formats/blob/main/OpenAir_File_Format_Support.md

Features

• Fast OpenAir file parsing using Rust
• Python-friendly API returning standard Python dictionaries
• Support for all OpenAir format features:
  • Airspace metadata (name, class, bounds)
  • Polygon points, circles, arcs
  • Extension records (AY/AF/AG)

Installation

Prerequisites

1. Rust toolchain: Install from rustup.rs
2. Python 3.8+
3. Maturin: Install with pip install maturin

Building and Installation

Setup Virtual Environment (Recommended)

# Create and activate a virtual environment
python3 -m venv .venv
# (Optional) If Python 3.13 is installed, create virtual environment with:
python3.13 -m venv .venv
source .venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies (inside the virtual environment)
pip install --upgrade pip
# Install the package in editable mode with all development dependencies
pip install -e ".[dev]"

Build Commands

# Development build with debug symbols (installs directly into current environment)
maturin develop --features python

# Release build for distribution (creates wheel file)
maturin build --release --features python

Use maturin develop for development - it compiles the Rust code and installs the Python module directly into your current environment. Use maturin build --release when you need to create distribution wheels.

Usage

from openair import parse_string, parse_file

# Parse from string
openair_data = """
AC D
AN EXAMPLE CTR
AL GND
AH 5000 ft
DP 46:57:13 N 008:27:52 E
DP 46:57:46 N 008:30:41 E
"""

airspaces = parse_string(openair_data)

# Parse from file
airspaces = parse_file("path/to/airspace.txt")

# Each airspace is a dictionary with structure:
for airspace in airspaces:
    print(f"Name: {airspace['name']}")
    print(f"Class: {airspace['class']}")
    print(f"Lower bound: {airspace['lowerBound']}")
    print(f"Upper bound: {airspace['upperBound']}")
    print(f"Geometry: {airspace['geom']}")

Example Output

The parser returns airspaces as Python dictionaries with this structure:

{
  "name": "EXAMPLE CTR",
  "class": "D",
  "lowerBound": {"type": "Gnd"},
  "upperBound": {"type": "FeetAmsl", "val": 5000},
  "geom": {
    "type": "Polygon",
    "segments": [
      {"type": "Point", "lat": 46.95361, "lng": 8.46444},
      {"type": "Point", "lat": 46.96277, "lng": 8.51138}
    ]
  }
}

---

Code Quality & Formatting

To keep the codebase clean and consistent, use the following tools. You can run them manually, or automatically before each commit using pre-commit hooks:

Pre-commit Hook Setup

1. Install pre-commit (once per machine): pip install pre-commit

2. Install the hooks (once per clone): pre-commit install

3. Now, every commit will automatically run:

   flake8 python/ --extend-ignore E501,E203
   mypy python/
   isort python/
   black python/
   pydocstyle --convention=google python/
   npx cspell python/
   

You can also run all hooks manually: pre-commit run --all-files or specific hooks pre-commit run cspell --all-files

If you need to skip hooks for a commit, use git commit --no-verify.