Metadata-Version: 2.4
Name: aviconv-fpl
Version: 0.2.0
Summary: Bidirectional ICAO 2012 Flight Plan ↔ JSON ↔ FIXM 4.3 ↔ ADEXP converter.
Project-URL: Homepage, https://github.com/ams-dev25/aviconv
Project-URL: Documentation, https://ams-dev25.github.io/aviconv/
Project-URL: Source, https://github.com/ams-dev25/aviconv
Project-URL: Issues, https://github.com/ams-dev25/aviconv/issues
Author: aviconv contributors
License: MIT
Keywords: adexp,atm,aviation,fixm,flight-plan,fpl,icao
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: aviconv-core<0.1,>=0.0.2
Requires-Dist: click>=8.1
Requires-Dist: lxml>=5.2
Requires-Dist: pydantic>=2.7
Requires-Dist: xmlschema>=3.3
Description-Content-Type: text/markdown

# aviconv-fpl

Bidirectional ICAO 2012 Flight Plan parser, formatter, and converter to
**FIXM 4.3** XML and **ADEXP** — part of the
[`aviconv`](https://github.com/ams-dev25/aviconv) family.

> **Status:** Phase 2 in progress — public release planned as `0.2.0`.
> Until then this package is `dev0`-tagged on the workspace and not
> published to PyPI.

## Install

```bash
pip install aviconv-fpl
```

## What it will do (Phase 2 deliverables)

- Parse ICAO 2012 FPL text into a typed `FlightPlan` model (Items 7–19,
  Item 18 sub-fields, Item 15 route tokenisation).
- Re-emit canonical ICAO text (byte-stable round-trip on the fixture
  corpus).
- Convert to/from FIXM 4.3 XML, with optional XSD validation on emission.
- Convert to/from EUROCONTROL ADEXP, with byte-stable round-trip.
- Validate against ICAO Doc 8643 (aircraft type designators), Item 10
  equipment letters, and Item 18 known-key registry.
- Provide a Click sub-command group mounted on the `aviconv` console
  script:

  ```bash
  aviconv fpl parse        plan.fpl > plan.json
  aviconv fpl format       plan.json
  aviconv fpl to-fixm      plan.fpl --validate > plan.xml
  aviconv fpl from-fixm    plan.xml > plan.fpl
  aviconv fpl to-adexp     plan.fpl > plan.adexp
  aviconv fpl from-adexp   plan.adexp > plan.fpl
  aviconv fpl validate     plan.fpl --strict
  ```

## License

MIT. FIXM 4.3 XSDs (BSD-3) are bundled under `LICENSES/` from PR4
onward. ICAO Doc 8643 aircraft-type data is reproduced from public ICAO
reference material; see `LICENSES/README.md` for attribution.
