laterite 0.2.0

Rust-backed AGS4 reader/writer/validator — a fast, drop-in replacement for python-ags4 with a narwhals-native API

laterite

A Rust-backed AGS4 reader, writer and validator for Python.

A faster drop-in for python-ags4's AGS4 module (1.2.0 parity-pinned, 122/131 tests) — swap from python_ags4 import AGS4 for from laterite import compat as AGS4. Native API returns narwhals frames over Polars, so you can target polars / pandas / pyarrow without laterite picking for you.

pip install laterite                  # base AGS4 (polars + narwhals)
pip install "laterite[compat]"        # + pandas (python-ags4 drop-in)
pip install "laterite[ags5]"          # + experimental .ags5db surface

import laterite

result = laterite.validate("delivery.ags")
for rule, findings in result.by_rule().items():
    print(rule, len(findings))

# python-ags4 drop-in
from laterite import compat as AGS4
tables, _ = AGS4.AGS4_to_dataframe("delivery.ags")

# Or a typed view of the file
from laterite.ags4 import read_typed
proj = read_typed("delivery.ags")

The validator engine is clean-room from the AGS4 spec. python-ags4 is LGPL-3.0; the clean-room separation lets laterite ship under MIT.

Requires Python ≥ 3.12.

Full docs, parity catalogue and observations at https://github.com/niko86/laterite.