tac2iwxxm 0.1.0__tar.gz

tac2iwxxm-0.1.0/.gitignore

@@ -0,0 +1,188 @@
+# =============================================================================
+# METAR → IWXXM monorepo — apps/, packages/, vendor/
+# =============================================================================
+
+# --- Secrets & local operator env (never commit) ---
+.env
+.env.*
+!.env.example
+prod.env
+.envrc
+
+# Per-workspace env overrides (apps/* and packages/*)
+apps/**/.env
+apps/**/.env.*
+!apps/**/.env.example
+packages/**/.env
+packages/**/.env.*
+!packages/**/.env.example
+
+# Legacy env paths (pre-migration; remove after cutover)
+backend/.env
+auth/.env
+frontend/.env
+
+# --- Python (uv workspace: apps/backend, packages/*) ---
+__pycache__/
+*.py[codz]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+*.manifest
+*.spec
+pip-log.txt
+pip-delete-this-directory.txt
+__pypackages__/
+*.sage.py
+.venv/
+venv/
+env/
+ENV/
+env.bak/
+venv.bak/
+.pdm-python
+.pdm-build/
+.pixi
+
+# --- Node / pnpm workspace (apps/*, packages/*) ---
+**/node_modules/
+.pnp
+.pnp.js
+.pnpm-store/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+.eslintcache
+*.tsbuildinfo
+
+# --- Build & bundle outputs ---
+**/dist/
+**/dist-ssr/
+**/build/
+**/.vite/
+**/.turbo/
+**/.next/
+**/.nuxt/
+**/.output/
+**/.svelte-kit/
+
+# --- Test & coverage ---
+.tox/
+.nox/
+.coverage
+.coverage.*
+.coverage-baseline.json
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+htmlcov/
+htmlcov_ann/
+cover/
+.hypothesis/
+.pytest_cache/
+.nyc_output
+**/coverage/
+
+# Playwright (apps/e2e and legacy frontend/)
+**/test-results/
+**/playwright-report/
+**/blob-report/
+**/.playwright/
+**/playwright/.cache/
+
+# --- Typecheck & lint caches ---
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pyre/
+.pytype/
+.ruff_cache/
+cython_debug/
+
+# --- IDE & OS ---
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+Thumbs.db
+
+# --- Docs site builds ---
+docs/_build/
+/site
+
+# --- Local tooling binaries / artifacts ---
+.tools/
+.local/
+
+# --- Cursor (local indexing prefs only; .cursorignore is tracked) ---
+.cursorindexingignore
+
+# --- Misc generated ---
+*.log
+*.db
+*.local
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+instance/
+.webassets-cache
+.scrapy
+.ipynb_checkpoints
+profile_default/
+ipython_config.py
+celerybeat-schedule
+celerybeat.pid
+.abstra/
+.pypirc
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+# --- Legacy submodule / pre-migration paths (remove after M7 cutover) ---
+# Vendor snapshots live under vendor/schemas/ once migrated (tracked, not ignored).
+GIFTs/.venv/
+GIFTs/.gifts/
+GIFTs/build/
+GIFTs/dist/
+GIFTs/data/
+GIFTs/.coverage
+GIFTs/.pytest_cache/
+GIFTs/.mypy_cache/
+GIFTs/sfstns.db
+GIFTs/driver.py
+GIFTs/wiki/
+
+# --- Rust / maturin (tac2iwxxm / iwxxm-validate PyO3) ---
+packages/tac2iwxxm/rust/target/
+packages/iwxxm-validate/rust/target/
+
+# E10-34 — synced runtime schema subset (generated; MANIFEST.json is tracked)
+packages/iwxxm-validate/src/iwxxm_validate/schemas/iwxxm/
+packages/iwxxm-validate/src/iwxxm_validate/schemas/iwxxm-us/
+packages/iwxxm-validate/src/iwxxm_validate/schemas/LAST_SYNC.json
+
+# ADR-027 — xsdata pydantic trees are committed (T3.7); ignore only bytecode
+packages/shared/src/metar_shared/iwxxm_xsd/**/__pycache__/
+

tac2iwxxm-0.1.0/PKG-INFO

@@ -0,0 +1,61 @@
+Metadata-Version: 2.4
+Name: tac2iwxxm
+Version: 0.1.0
+Summary: General TAC → IWXXM converter (F6)
+License: MIT
+Requires-Python: >=3.12
+Requires-Dist: msgspec>=0.19
+Provides-Extra: validate
+Requires-Dist: iwxxm-validate>=0.1.0; extra == 'validate'
+Requires-Dist: tac-validate>=0.1.0; extra == 'validate'
+Description-Content-Type: text/markdown
+
+# tac2iwxxm
+
+General TAC → IWXXM converter package (F6 / F14). MIT licensed.
+
+See ADR-013 / ADR-014 / ADR-016 / ADR-017.
+
+## Install
+
+```bash
+# Convert only (no validators)
+pip install tac2iwxxm
+
+# Convert + TAC lint + IWXXM XSD/Schematron (F14)
+pip install 'tac2iwxxm[validate]'
+```
+
+The `[validate]` extra depends on **`tac-validate`** and **`iwxxm-validate`** (E10-20).
+Convert works without the extra.
+
+```python
+from tac2iwxxm import convert
+
+result = convert(
+    "METAR KJFK 231751Z 18012KT 10SM FEW040 15/07 A3005=",
+    product="METAR",
+)
+assert result.ok and result.xml
+```
+
+With `[validate]` installed:
+
+```python
+from tac_validate import lint
+from iwxxm_validate import validate_iwxxm
+
+assert lint(tac, product="METAR").ok
+assert validate_iwxxm(result.xml, iwxxm_version="2025-2").ok
+```
+
+## Native extension (PyO3)
+
+Optional Rust hotspots live under `rust/` and import as `tac2iwxxm._rust`
+(ADR-017). Pure Python remains the default `uv sync` path.
+
+```bash
+# requires rustc + maturin
+make build-tac2iwxxm-native
+make test-tac2iwxxm-native
+```

tac2iwxxm-0.1.0/README.md

@@ -0,0 +1,49 @@
+# tac2iwxxm
+
+General TAC → IWXXM converter package (F6 / F14). MIT licensed.
+
+See ADR-013 / ADR-014 / ADR-016 / ADR-017.
+
+## Install
+
+```bash
+# Convert only (no validators)
+pip install tac2iwxxm
+
+# Convert + TAC lint + IWXXM XSD/Schematron (F14)
+pip install 'tac2iwxxm[validate]'
+```
+
+The `[validate]` extra depends on **`tac-validate`** and **`iwxxm-validate`** (E10-20).
+Convert works without the extra.
+
+```python
+from tac2iwxxm import convert
+
+result = convert(
+    "METAR KJFK 231751Z 18012KT 10SM FEW040 15/07 A3005=",
+    product="METAR",
+)
+assert result.ok and result.xml
+```
+
+With `[validate]` installed:
+
+```python
+from tac_validate import lint
+from iwxxm_validate import validate_iwxxm
+
+assert lint(tac, product="METAR").ok
+assert validate_iwxxm(result.xml, iwxxm_version="2025-2").ok
+```
+
+## Native extension (PyO3)
+
+Optional Rust hotspots live under `rust/` and import as `tac2iwxxm._rust`
+(ADR-017). Pure Python remains the default `uv sync` path.
+
+```bash
+# requires rustc + maturin
+make build-tac2iwxxm-native
+make test-tac2iwxxm-native
+```

tac2iwxxm-0.1.0/pyproject.toml

@@ -0,0 +1,53 @@
+[project]
+name = "tac2iwxxm"
+version = "0.1.0"
+description = "General TAC → IWXXM converter (F6)"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.12"
+dependencies = [
+  "msgspec>=0.19",
+]
+
+[project.optional-dependencies]
+# F14 / E10-20: optional TAC lint + IWXXM XSD/Schematron validators.
+validate = [
+  "tac-validate>=0.1.0",
+  "iwxxm-validate>=0.1.0",
+]
+
+[build-system]
+requires = ["hatchling>=1.25"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/tac2iwxxm"]
+
+# Maturin builds the optional PyO3 cdylib (ADR-017 / T4.3). Pure-Python hatch wheel
+# remains the default ``uv sync`` path; CI rust job runs ``maturin develop``.
+[tool.maturin]
+manifest-path = "rust/Cargo.toml"
+python-source = "src"
+module-name = "tac2iwxxm._rust"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+markers = [
+  "slow: longer local/CI smokes (clean-venv wheel installs)",
+]
+
+[tool.coverage.run]
+branch = true
+source = ["src/tac2iwxxm"]
+
+[tool.coverage.report]
+fail_under = 95
+show_missing = true
+
+[tool.ruff]
+line-length = 120
+
+[tool.ruff.lint]
+select = ["E", "W", "F", "I"]
+ignore = ["E501"]

tac2iwxxm-0.1.0/rust/Cargo.lock

@@ -0,0 +1,180 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 3
+
+[[package]]
+name = "autocfg"
+version = "1.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f2032f911046de80f0a198e0901378627c33f59ea0ac00e363d481118bd70a53"
+
+[[package]]
+name = "cfg-if"
+version = "1.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
+
+[[package]]
+name = "heck"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2304e00983f87ffb38b55b444b5e3b60a884b5d30c0fca7d82fe33449bbe55ea"
+
+[[package]]
+name = "indoc"
+version = "2.0.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "79cf5c93f93228cf8efb3ba362535fb11199ac548a09ce117c9b1adc3030d706"
+dependencies = [
+ "rustversion",
+]
+
+[[package]]
+name = "libc"
+version = "0.2.186"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "68ab91017fe16c622486840e4c83c9a37afeff978bd239b5293d61ece587de66"
+
+[[package]]
+name = "memoffset"
+version = "0.9.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "488016bfae457b036d996092f6cb448677611ce4449e970ceaf42695203f218a"
+dependencies = [
+ "autocfg",
+]
+
+[[package]]
+name = "once_cell"
+version = "1.21.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50"
+
+[[package]]
+name = "portable-atomic"
+version = "1.13.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c33a9471896f1c69cecef8d20cbe2f7accd12527ce60845ff44c153bb2a21b49"
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.106"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8fd00f0bb2e90d81d1044c2b32617f68fcb9fa3bb7640c23e9c748e53fb30934"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "pyo3"
+version = "0.23.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7778bffd85cf38175ac1f545509665d0b9b92a198ca7941f131f85f7a4f9a872"
+dependencies = [
+ "cfg-if",
+ "indoc",
+ "libc",
+ "memoffset",
+ "once_cell",
+ "portable-atomic",
+ "pyo3-build-config",
+ "pyo3-ffi",
+ "pyo3-macros",
+ "unindent",
+]
+
+[[package]]
+name = "pyo3-build-config"
+version = "0.23.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "94f6cbe86ef3bf18998d9df6e0f3fc1050a8c5efa409bf712e661a4366e010fb"
+dependencies = [
+ "once_cell",
+ "target-lexicon",
+]
+
+[[package]]
+name = "pyo3-ffi"
+version = "0.23.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e9f1b4c431c0bb1c8fb0a338709859eed0d030ff6daa34368d3b152a63dfdd8d"
+dependencies = [
+ "libc",
+ "pyo3-build-config",
+]
+
+[[package]]
+name = "pyo3-macros"
+version = "0.23.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fbc2201328f63c4710f68abdf653c89d8dbc2858b88c5d88b0ff38a75288a9da"
+dependencies = [
+ "proc-macro2",
+ "pyo3-macros-backend",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "pyo3-macros-backend"
+version = "0.23.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fca6726ad0f3da9c9de093d6f116a93c1a38e417ed73bf138472cf4064f72028"
+dependencies = [
+ "heck",
+ "proc-macro2",
+ "pyo3-build-config",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.46"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dfbc457d0c7a0759a614551b11a6409e5951f6c7537be1f1b7682b9ae9230368"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "rustversion"
+version = "1.0.23"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cf54715a573b99ac80df0bc206da022bcd442c974952c7b9720069370852e21f"
+
+[[package]]
+name = "syn"
+version = "2.0.118"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1b9ae57f904213ebb649ce6895b8a66c66f0203b9319718f69a5612a065b1422"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "tac2iwxxm_rust"
+version = "0.1.0"
+dependencies = [
+ "pyo3",
+]
+
+[[package]]
+name = "target-lexicon"
+version = "0.12.16"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "61c41af27dd6d1e27b1b16b489db798443478cef1f06a660c96db617ba5de3b1"
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.24"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"
+
+[[package]]
+name = "unindent"
+version = "0.2.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7264e107f553ccae879d21fbea1d6724ac785e8c3bfc762137959b5802826ef3"

tac2iwxxm-0.1.0/rust/Cargo.toml

@@ -0,0 +1,18 @@
+[package]
+name = "tac2iwxxm_rust"
+version = "0.1.0"
+edition = "2021"
+description = "PyO3 native hotspots for tac2iwxxm (ADR-017)"
+license = "MIT"
+rust-version = "1.74"
+
+[lib]
+name = "_rust"
+crate-type = ["cdylib"]
+
+[dependencies]
+pyo3 = { version = "0.23", features = ["extension-module"] }
+
+[package.metadata.maturin]
+python-source = "../src"
+module-name = "tac2iwxxm._rust"

tac2iwxxm-0.1.0/rust/src/lib.rs

@@ -0,0 +1,39 @@
+//! PyO3 native extension for `tac2iwxxm` (ADR-017).
+//!
+//! T4.3 scaffold + T4.5 `scan_metar_tokens` hotspot (TAC lexer).
+
+use pyo3::prelude::*;
+
+/// Extension package version (mirrors Cargo.toml).
+#[pyfunction]
+fn extension_version() -> &'static str {
+    env!("CARGO_PKG_VERSION")
+}
+
+/// Health check used by CI / import smoke tests.
+#[pyfunction]
+fn ping() -> &'static str {
+    "pong"
+}
+
+/// Split METAR/SPECI TAC into whitespace tokens (hotspot scaffold for T4.5+).
+///
+/// Strips a trailing ``=`` terminator when present. Does not yet implement a full
+/// remark-aware lexer — that lands with further PyO3 work.
+#[pyfunction]
+fn scan_metar_tokens(tac: &str) -> Vec<String> {
+    let trimmed = tac.trim().trim_end_matches('=').trim();
+    trimmed
+        .split_whitespace()
+        .map(|part| part.to_string())
+        .collect()
+}
+
+#[pymodule]
+fn _rust(m: &Bound<'_, PyModule>) -> PyResult<()> {
+    m.add("__version__", env!("CARGO_PKG_VERSION"))?;
+    m.add_function(wrap_pyfunction!(extension_version, m)?)?;
+    m.add_function(wrap_pyfunction!(ping, m)?)?;
+    m.add_function(wrap_pyfunction!(scan_metar_tokens, m)?)?;
+    Ok(())
+}

tac2iwxxm-0.1.0/src/tac2iwxxm/__init__.py

@@ -0,0 +1,30 @@
+"""General TAC → IWXXM converter (F6)."""
+
+from __future__ import annotations
+
+from tac2iwxxm.bulletin import BulletinSplitError, split_bulletin
+from tac2iwxxm.convert import ConvertError, convert
+from tac2iwxxm.decode import DecodeResidual, DecodeResult, DecodeSegment, decode_tac
+from tac2iwxxm.models import BulletinMeta, BulletinSplit, ConvertIssue, ConvertResult
+from tac2iwxxm.native import rust_available, rust_module, scan_metar_tokens
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "BulletinMeta",
+    "BulletinSplit",
+    "BulletinSplitError",
+    "ConvertError",
+    "ConvertIssue",
+    "ConvertResult",
+    "DecodeResidual",
+    "DecodeResult",
+    "DecodeSegment",
+    "__version__",
+    "convert",
+    "decode_tac",
+    "rust_available",
+    "rust_module",
+    "scan_metar_tokens",
+    "split_bulletin",
+]