Skip to content

About

Python runtime for parsanol PARG artifacts — checksum-verified load and native parsing through the parsanol C ABI

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

parsanol (Python)

Python runtime for PARG artifacts — checksummed parsanol-tree/v2 envelopes that Ruby, Rust, WebAssembly, TypeScript, and now Python all parse identically.

The engine is the real one: this package drives libparsanol (the pure-portable C ABI cdylib, the same binary the Ruby ffi tier ships) via ctypes. No second parser, no reimplementation.

pip install parsanol

Each platform wheel vendors the cdylib, and the full conformance suite runs on every wheel platform at build time (the emulated legs included):

platform tag proof
Linux x86_64 (glibc) manylinux_2_35 full suite, native runner
Linux aarch64 (glibc) manylinux_2_35 full suite, native arm runner
Linux aarch64 (musl) musllinux_1_2 full suite, native arm runner
Linux i686 (glibc) manylinux_2_35 full suite under qemu
Linux armv7l (musl) musllinux_1_2 full suite under qemu
Linux ppc64le manylinux_2_35 full suite under qemu
Linux s390x manylinux_2_35 big-endian; full suite under qemu
Linux riscv64 manylinux_2_35 full suite under qemu
macOS x86_64 + arm64 macosx_11_0_universal2 lipo'd engine; native runners
Windows x64 / ARM64 / x86 win_amd64 / win_arm64 / win32 full suite, native runner

There is no sdist — the Rust sources are a submodule of the repository, not of the archive, so a source install could never load the engine. Point a locally built library at the runtime with PARSANOL_CDYLIB=/path/to/libparsanol.

from parsanol import PargArtifact

artifact = PargArtifact.from_path("demo.artifact.json")  # verifies sha256
tree = artifact.parse("iso 12345", "identifier")         # shaped tree
run = artifact.run_tests()                               # embedded tests replayed

On rejection, parse raises ParseFailed carrying the engine's failure wire (offset, ranked positions, expected set).

Releases

parsanol is one product on four runtimes: rs (crates.io + @parsanol/wasm + release binaries), ruby (rubygems), python (PyPI, this package), and typescript (npm, parsanol — the wasm-backed runtime). Every engine update releases all four together; a release that ships some runtimes and not the rest is incomplete.

Status and honest boundaries (v0.1)

Capability State
Artifact load + sha256 verification works — the canonical-form port is byte-exact against the reference compiler (all 39 corpus checksums verify)
Native parse (shaped tree, slice wire) works
Failure wire works
Embedded tests: accept / reject / capture works — all 155 corpus cases replay with zero failures
Embedded tests: example / shape works — the bindings/flattening port landed (ticket 0003)
parse_recovering not yet — needs a C-ABI export (ticket 0002)
Dynamic / runtime-state artifacts rejected upstream by contract (Ruby-tier)
Wheels on PyPI published — platform wheels with the vendored cdylib; a post-publish audit replays the corpus through the wheel installed from PyPI (ticket 0001)

Development

cargo build -p parsanol-ffi --release          # in parsanol-rs
export PARSANOL_CDYLIB=$RS/target/release/libparsanol.dylib
ln -s ../parsanol-rs/corpus corpus             # for the corpus gate
python3 -m pip install -e . pytest
python3 -m pytest tests -q

The corpus gate (tests/test_corpus.py) pins the size: 155 cases, zero skips — when it moves, this repo moves with it deliberately.

Explicit native libraries

PargArtifact.from_path(path, library_path="/absolute/path/to/library") uses an independent native context. It never changes the process environment or the default runtime, and an invalid explicit path never falls back to another library. The library loads lazily on the first native operation.

To share one engine between artifacts, create NativeContext(library_path) and pass native_context=context to their constructors or from_path. Each context binds its own parse, error, recovery and free functions; every owned result is freed through the context that created it, including read failures. context.engine_version() identifies that engine. Pass either library_path or native_context. Existing constructors and module-level functions keep their default lookup and singleton behavior.

About

Python runtime for parsanol PARG artifacts — checksum-verified load and native parsing through the parsanol C ABI

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages