laterite 0.5.0__tar.gz

laterite-0.5.0/LICENSE

@@ -0,0 +1,34 @@
+MIT License
+
+Copyright (c) 2026 niko86
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+Third-party data notice:
+
+The AGS4 standard data dictionaries bundled under
+`rust-packages/laterite-ags4-validator/data/` (`Standard_dictionary_v4_1.ags`,
+`Standard_dictionary_v4_2.ags`) are © The Association of Geotechnical and
+Geoenvironmental Specialists (AGS), all rights reserved. They are reference
+data for the published AGS4 transfer-format standard, redistributed here as
+a documented decision — see that directory's `PROVENANCE.md`. This MIT
+licence covers the source code of this repository; it does not purport to
+relicense the AGS dictionary data.

laterite-0.5.0/PKG-INFO

@@ -0,0 +1,87 @@
+Metadata-Version: 2.4
+Name: laterite
+Version: 0.5.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Rust
+Classifier: Topic :: Scientific/Engineering
+Classifier: Typing :: Typed
+Requires-Dist: polars>=1.40.1
+Requires-Dist: duckdb>=1.4.0
+Requires-Dist: pandas<3 ; extra == 'all'
+Requires-Dist: pyarrow>=24.0.0 ; extra == 'all'
+Requires-Dist: pandas<3 ; extra == 'compat'
+Requires-Dist: pandas<3 ; extra == 'pandas'
+Requires-Dist: pyarrow>=24.0.0 ; extra == 'pyarrow'
+Provides-Extra: all
+Provides-Extra: compat
+Provides-Extra: pandas
+Provides-Extra: pyarrow
+License-File: LICENSE
+Summary: Rust-backed AGS4 reader/writer/validator — a fast, drop-in replacement for python-ags4 with born-typed polars/pandas reads (pyarrow-free)
+Keywords: ags,ags4,geotechnical,ground-investigation,validator,parser,rust,polars,pandas,duckdb
+Author-email: niko86 <me@niko86.com>
+License-Expression: MIT
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Changelog, https://github.com/niko86/laterite/blob/main/CHANGELOG.md
+Project-URL: Homepage, https://github.com/niko86/laterite
+Project-URL: Issues, https://github.com/niko86/laterite/issues
+Project-URL: Repository, https://github.com/niko86/laterite
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/niko86/laterite/main/assets/laterite-social-preview-white.png" alt="laterite — a Rust-backed AGS4 reader, writer and validator" width="600" />
+</p>
+
+# laterite
+
+A Rust-backed AGS4 reader, writer and validator for Python.
+
+A faster drop-in for
+[`python-ags4`](https://gitlab.com/ags-data-format-wg/ags-python-library)'s
+`AGS4` module (1.2.0 parity-pinned, 122/131 tests) — swap
+`from python_ags4 import AGS4` for `from laterite import compat as AGS4`.
+The native API returns born-typed **polars** frames by default (or
+**pandas** with `read(..., backend="pandas")`) — both **pyarrow-free**,
+read back from a Python-owned in-memory DuckDB engine.
+
+[![ci](https://github.com/niko86/laterite/actions/workflows/ci.yml/badge.svg)](https://github.com/niko86/laterite/actions/workflows/ci.yml)
+[![rust cov](https://img.shields.io/codecov/c/github/niko86/laterite?flag=rust&label=rust%20cov)](https://codecov.io/gh/niko86/laterite)
+[![python cov](https://img.shields.io/codecov/c/github/niko86/laterite?flag=python&label=python%20cov)](https://codecov.io/gh/niko86/laterite)
+[![web cov](https://img.shields.io/codecov/c/github/niko86/laterite?flag=web&label=web%20cov)](https://codecov.io/gh/niko86/laterite)
+[![PyPI](https://img.shields.io/pypi/v/laterite.svg)](https://pypi.org/project/laterite/)
+[![Python versions](https://img.shields.io/pypi/pyversions/laterite.svg)](https://pypi.org/project/laterite/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+```bash
+pip install laterite                  # base AGS4 (polars + duckdb, pyarrow-free)
+pip install "laterite[compat]"        # + pandas (python-ags4 drop-in)
+```
+
+```python
+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>.
+

laterite-0.5.0/README.md

@@ -0,0 +1,52 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/niko86/laterite/main/assets/laterite-social-preview-white.png" alt="laterite — a Rust-backed AGS4 reader, writer and validator" width="600" />
+</p>
+
+# laterite
+
+A Rust-backed AGS4 reader, writer and validator for Python.
+
+A faster drop-in for
+[`python-ags4`](https://gitlab.com/ags-data-format-wg/ags-python-library)'s
+`AGS4` module (1.2.0 parity-pinned, 122/131 tests) — swap
+`from python_ags4 import AGS4` for `from laterite import compat as AGS4`.
+The native API returns born-typed **polars** frames by default (or
+**pandas** with `read(..., backend="pandas")`) — both **pyarrow-free**,
+read back from a Python-owned in-memory DuckDB engine.
+
+[![ci](https://github.com/niko86/laterite/actions/workflows/ci.yml/badge.svg)](https://github.com/niko86/laterite/actions/workflows/ci.yml)
+[![rust cov](https://img.shields.io/codecov/c/github/niko86/laterite?flag=rust&label=rust%20cov)](https://codecov.io/gh/niko86/laterite)
+[![python cov](https://img.shields.io/codecov/c/github/niko86/laterite?flag=python&label=python%20cov)](https://codecov.io/gh/niko86/laterite)
+[![web cov](https://img.shields.io/codecov/c/github/niko86/laterite?flag=web&label=web%20cov)](https://codecov.io/gh/niko86/laterite)
+[![PyPI](https://img.shields.io/pypi/v/laterite.svg)](https://pypi.org/project/laterite/)
+[![Python versions](https://img.shields.io/pypi/pyversions/laterite.svg)](https://pypi.org/project/laterite/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+```bash
+pip install laterite                  # base AGS4 (polars + duckdb, pyarrow-free)
+pip install "laterite[compat]"        # + pandas (python-ags4 drop-in)
+```
+
+```python
+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>.

laterite-0.5.0/pyproject.toml

@@ -0,0 +1,96 @@
+[project]
+name = "laterite"
+version = "0.5.0"
+description = "Rust-backed AGS4 reader/writer/validator — a fast, drop-in replacement for python-ags4 with born-typed polars/pandas reads (pyarrow-free)"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "niko86", email = "me@niko86.com" }]
+keywords = [
+    "ags",
+    "ags4",
+    "geotechnical",
+    "ground-investigation",
+    "validator",
+    "parser",
+    "rust",
+    "polars",
+    "pandas",
+    "duckdb",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Rust",
+    "Topic :: Scientific/Engineering",
+    "Typing :: Typed",
+]
+requires-python = ">=3.12"
+# Mandatory runtime deps:
+#   polars   — the default frame backend; the read boundary hands Rust-built
+#              Arrow over zero-copy (a pyo3-arrow capsule), loaded into DuckDB,
+#              and materialised back pyarrow-free into born-typed polars frames.
+#   duckdb   — the Python-owned in-memory engine: read() loads each group into a
+#              born-typed DuckDB table, so ags[code] / ags.sql(...) run real
+#              cross-group joins + filter pushdown. NOT bundled in the wheel (the
+#              CLI keeps its own); needs no pinned storage version. Floor >=1.4.0
+#              (LTS line, in-memory COMPRESS).
+# narwhals is GONE — the core returns polars / pandas directly and `compat`
+# branches on the native frame; nothing imports narwhals at runtime.
+# pyarrow is NOT a laterite dependency anywhere — not base, not the [compat] extra.
+# The polars path uses the Arrow C-stream capsule; the pandas path (core AND compat)
+# uses DuckDB's NumPy `.df()`; both are pyarrow-free. An Arrow table is only reachable
+# via `ags.connection` (or the explicit `pyarrow` backend/extra) with the user's own
+# pyarrow. pandas is an optional extra; a python-ags4 install pulls pandas in
+# unconditionally, laterite does not.
+dependencies = [
+    "polars>=1.40.1",
+    "duckdb>=1.4.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/niko86/laterite"
+Repository = "https://github.com/niko86/laterite"
+Issues = "https://github.com/niko86/laterite/issues"
+Changelog = "https://github.com/niko86/laterite/blob/main/CHANGELOG.md"
+
+# `compat` is the python-ags4 drop-in surface — it defaults to returning
+# pandas frames, so `pip install laterite[compat]` is what most callers
+# want when porting from python_ags4. `pandas` is retained as a
+# back-compat alias (same set). `set_backend("polars")` (or
+# LATERITE_COMPAT_BACKEND=polars) removes the pandas requirement entirely.
+[project.optional-dependencies]
+# compat (the python-ags4 drop-in, pandas by default) is now pyarrow-free: its pandas
+# output goes polars -> pandas via DuckDB's NumPy `.df()` (the same trick the core
+# uses), so the extra is just pandas. `pandas` is a back-compat alias of `compat`;
+# `pyarrow` stays for callers who explicitly want the Arrow backend (the only thing
+# that pulls pyarrow).
+compat = ["pandas<3"]
+pandas = ["pandas<3"]
+pyarrow = ["pyarrow>=24.0.0"]
+# The experimental DuckDB-backed `.ags5db` surface was decoupled from the
+# shipped AGS4 product (#177) — it now lives in the dormant `ags5/` holding
+# folder and is no longer installable as an extra. The future AGS5 strand
+# will publish it as a separate library.
+all = ["pandas<3", "pyarrow>=24.0.0"]
+
+[project.scripts]
+# Deliberately named `lat-check` (not `laterite`/`ags4`) so the command,
+# its flags, JSON/NDJSON shape and exit codes are byte-faithful to the
+# Rust `lat-check` binary. This is the Python face of the same CLI.
+lat-check = "laterite._cli:main"
+
+[build-system]
+requires = ["maturin>=1.7,<2"]
+build-backend = "maturin"
+
+[tool.maturin]
+module-name = "laterite._laterite_native"
+manifest-path = "rust-packages/laterite-py/Cargo.toml"
+python-source = "python"
+# abi3 (cp312-abi3): laterite-py/Cargo.toml sets `abi3-py312` on pyo3, so
+# maturin emits ONE `cp312-abi3` wheel per platform that runs on Python 3.12+.
+# (The old "pinned to 3.14 / pyo3-polars couples the wheel" note was wrong — the

laterite-0.5.0/python/laterite/README-cli.md

@@ -0,0 +1,97 @@
+# lat-check
+
+A clean-room Rust validator for the **AGS4** geotechnical
+transfer-format — the capability `python-ags4`'s `AGS4.check_file()`
+provides, with no Python at runtime. Reports the numbered AGS Format
+Rule violations in a file.
+
+## Usage
+
+    lat-check <file.ags> [options]
+    lat-check --readme        # this document
+
+## Options
+
+    --dict-version <V>   bundled dictionary edition:
+                         auto (default — picked from the file's
+                         TRAN_AGS) | 4.0.3 | 4.0.4 | 4.1 | 4.1.1 | 4.2
+    --dict <path>        external dictionary override (not supported)
+    --json               machine-readable findings (pretty JSON)
+    --ndjson             one flat JSON object per finding per line
+    --out <path>         write the active format to <path> instead of
+                         stdout (prints a one-line confirmation)
+    --json-out <path>    also tee the JSON report to <path>
+    --fix                mechanically repair the file: apply the SAFE
+                         fixes (CRLF / BOM / embedded-CR / short-row pad /
+                         numeric reformat / TRAN delimiter+concatenator
+                         rows) and write the result. Non-destructive —
+                         writes a sibling <file>.fixed.ags by default.
+                         Exit 0 if the repaired file is clean, 1 if
+                         findings remain that can't be auto-fixed.
+    --fix-risky          like --fix but ALSO applies the intent-guessing
+                         fixes (duplicate-heading rename, dd/mm date
+                         canonicalisation, smart-quote→ASCII typography)
+    --in-place           with --fix: overwrite the source file in place
+    --fix-out <path>     with --fix: write the repaired file to <path>
+    --diff <other.ags>   compare the input file against <other> and print the
+                         KEY-aware/type-aware revision delta (per-group
+                         +added -removed ~changed; --json for the full delta)
+    --no-warnings        errors only — suppress the WARNING tier, which is
+                         shown by default (malformed DICT, nonstandard
+                         abbreviations, unrecognised TRAN_AGS edition)
+    --show-fyi           include FYI-severity findings (e.g. Rule 1)
+    --check-files        also run Rule 20's on-disk check: the sidecar
+                         FILE/<fset>/<name> tree must exist next to the
+                         .ags. Default OFF — data-level Rule 20 is
+                         path-independent (the library default); enable
+                         for a packaging/QA pass on a real delivery.
+    --encoding <name>    source text encoding for legacy extended-ASCII
+                         files: utf-8 (default) | cp1252 | latin1 |
+                         iso-8859-1 | iso-8859-15. latin1 / iso-8859-1
+                         map to Windows-1252 (the CP1252 superset
+                         python-ags4 uses by default).
+    --list-rules         print the AGS4 rule catalogue (title / severity /
+                         fixable / cited observations) and exit; add --json
+                         for the full machine-readable form. No input file.
+    --quiet              suppress the progress spinner
+    --tui                interactive findings browser (needs the
+                         `tui` build feature + an interactive terminal)
+    --readme             print this document and exit
+    -h, --help           short usage
+
+## Dictionary auto-selection
+
+By default the edition is chosen **per file from its `TRAN_AGS`**:
+an exact bundled match wins (`4.0.3/4.0.4/4.1/4.1.1/4.2`), else the
+newest bundled patch of that `major.minor` (`4.0`→4.0.4, `4.1.5`→
+4.1.1), else a fallback to 4.1.1 (matching python-ags4's
+`LATEST_DICT_VERSION`). AGS 3.x is refused (exit 4) rather than
+silently validated against an AGS4 schema. `--dict-version` forces
+one edition regardless.
+
+## Output
+
+Human table on a TTY (coloured unless `NO_COLOR`); `--json` for a
+nested `{file, findings:{rule:[{line,group,desc}]}}` document;
+`--ndjson` for a stream. Progress is on stderr; the report on stdout.
+
+## Exit codes
+
+    0  clean (no findings)
+    1  findings present
+    3  file not found / unreadable
+    4  not UTF-8 / not an AGS4 file / unsupported AGS edition (3.x)
+    5  bad arguments / bad dictionary
+
+## Examples
+
+    lat-check delivery.ags                 # human table
+    lat-check delivery.ags --json | jq .   # machine-readable
+    lat-check delivery.ags --dict-version 4.2   # force an edition
+    lat-check delivery.ags --show-fyi --out report.txt
+    lat-check delivery.ags --fix                # → delivery.fixed.ags
+    lat-check delivery.ags --fix --in-place     # repair in place
+    lat-check delivery.ags --fix-risky --fix-out clean.ags
+
+> The clean-room boundary, licence, and bundled-dictionary provenance
+> are documented in the crate's `README.md` and `data/PROVENANCE.md`.