Skip to main content

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.

Metadata

Release files for parsanol 1.5.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for parsanol 1.5.1.0
File Actions
parsanol-1.5.1.0-py3-none-win_arm64.whl Python 3 none Windows ARM64 Details for parsanol-1.5.1.0-py3-none-win_arm64.whl
parsanol-1.5.1.0-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for parsanol-1.5.1.0-py3-none-win_amd64.whl
parsanol-1.5.1.0-py3-none-win32.whl Python 3 none Windows x86-32 Details for parsanol-1.5.1.0-py3-none-win32.whl
parsanol-1.5.1.0-py3-none-musllinux_1_2_riscv64.whl Python 3 none Linux musl 1.2+ RISC-V 64 Details for parsanol-1.5.1.0-py3-none-musllinux_1_2_riscv64.whl
parsanol-1.5.1.0-py3-none-musllinux_1_2_aarch64.whl Python 3 none Linux musl 1.2+ ARM64 Details for parsanol-1.5.1.0-py3-none-musllinux_1_2_aarch64.whl
parsanol-1.5.1.0-py3-none-manylinux_2_35_x86_64.whl Python 3 none Linux glibc 2.35+ x86-64 Details for parsanol-1.5.1.0-py3-none-manylinux_2_35_x86_64.whl
parsanol-1.5.1.0-py3-none-manylinux_2_35_aarch64.whl Python 3 none Linux glibc 2.35+ ARM64 Details for parsanol-1.5.1.0-py3-none-manylinux_2_35_aarch64.whl
parsanol-1.5.1.0-py3-none-manylinux_2_28_s390x.whl Python 3 none Linux glibc 2.28+ IBM System/390x Details for parsanol-1.5.1.0-py3-none-manylinux_2_28_s390x.whl
parsanol-1.5.1.0-py3-none-manylinux_2_28_ppc64le.whl Python 3 none Linux glibc 2.28+ PowerPC 64-le Details for parsanol-1.5.1.0-py3-none-manylinux_2_28_ppc64le.whl
parsanol-1.5.1.0-py3-none-manylinux_2_28_i686.whl Python 3 none Linux glibc 2.28+ x86-32 Details for parsanol-1.5.1.0-py3-none-manylinux_2_28_i686.whl
parsanol-1.5.1.0-py3-none-macosx_11_0_universal2.whl Python 3 none macOS 11.0+ universal2 (ARM64, x86-64) Details for parsanol-1.5.1.0-py3-none-macosx_11_0_universal2.whl

Total release size: 12.7 MB

Release files / parsanol-1.5.1.0-py3-none-win_arm64.whl

Download URL parsanol-1.5.1.0-py3-none-win_arm64.whl
Size 883.6 kB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
e4a470c78202148bdadee3cf2ac9d0c3fff1fe147e462a53cacb26624ece0202
BLAKE2b-256 checksum
How to use checksums
d72942b9b2c08ccdbbdd94032faa0440b7f7b25fcd70000968422e7bb955d13e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / parsanol-1.5.1.0-py3-none-win_amd64.whl

Download URL parsanol-1.5.1.0-py3-none-win_amd64.whl
Size 956.3 kB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
be4bc4aff3dbd3efb7837b9f84ec3129033cd2e0275320e84960fa9d787f8c12
BLAKE2b-256 checksum
How to use checksums
bb21bb5737e0e4e0d60dce48d9128cf6aa968929e64014f17dcc398a907f0190
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / parsanol-1.5.1.0-py3-none-win32.whl

Download URL parsanol-1.5.1.0-py3-none-win32.whl
Size 888.9 kB
Tags Python 3 Windows x86-32
SHA-256 checksum
How to use checksums
c435093609d897dffc8fa2de2ab02b7234311a48fa32a0d5b19a0498245900bc
BLAKE2b-256 checksum
How to use checksums
560a5be4655684e3674a037b137bedf9a6e0ee2985a6b37dd58b378c5827f56d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / parsanol-1.5.1.0-py3-none-musllinux_1_2_riscv64.whl

Download URL parsanol-1.5.1.0-py3-none-musllinux_1_2_riscv64.whl
Size 1.1 MB
Tags Linux musl 1.2+ RISC-V 64 Python 3
SHA-256 checksum
How to use checksums
ec53126b54a252253aac53b8bc7edaf1cb1093518774d36d1c1fee0467c29013
BLAKE2b-256 checksum
How to use checksums
746c0f1a712ba4f927529da4b6b803c9474c3bfe58871a7c163156b18c99ad01
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / parsanol-1.5.1.0-py3-none-musllinux_1_2_aarch64.whl

Download URL parsanol-1.5.1.0-py3-none-musllinux_1_2_aarch64.whl
Size 1.1 MB
Tags Linux musl 1.2+ ARM64 Python 3
SHA-256 checksum
How to use checksums
5700a96c2558d97483fe0dcf085099d79f1ab2cb8b806712a7fe8fb9cbc6e316
BLAKE2b-256 checksum
How to use checksums
01d71c9a00fea6716928c2f19e0b4ef4fd1c1f878266167b064987ffdbbf3f86
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / parsanol-1.5.1.0-py3-none-manylinux_2_35_x86_64.whl

Download URL parsanol-1.5.1.0-py3-none-manylinux_2_35_x86_64.whl
Size 1.1 MB
Tags Linux glibc 2.35+ x86-64 Python 3
SHA-256 checksum
How to use checksums
5618a65eab27030107ebcaa2e2b559f592ac1daeb489c026f748ecb8d5934c9d
BLAKE2b-256 checksum
How to use checksums
f482b0fd6c59b9a33dbddda2fe51999994dbb2a6abe6fe53a55996a7cc8b5dde
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / parsanol-1.5.1.0-py3-none-manylinux_2_35_aarch64.whl

Download URL parsanol-1.5.1.0-py3-none-manylinux_2_35_aarch64.whl
Size 1.1 MB
Tags Linux glibc 2.35+ ARM64 Python 3
SHA-256 checksum
How to use checksums
53766735759de5e17c718f6e4abf4d20701f39e07bd41af7499cea2b5649797c
BLAKE2b-256 checksum
How to use checksums
b690f1f64bb6bc0732032b102266a76fb8dc1367cd8d7fdbd256f4fe275e572a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / parsanol-1.5.1.0-py3-none-manylinux_2_28_s390x.whl

Download URL parsanol-1.5.1.0-py3-none-manylinux_2_28_s390x.whl
Size 1.2 MB
Tags Linux glibc 2.28+ IBM System/390x Python 3
SHA-256 checksum
How to use checksums
efb9850c45b34e2dac7e20f512f48bc5c7a2d3688c7bc3addbd9e2b5a8f109db
BLAKE2b-256 checksum
How to use checksums
1dba4eb94e4c35a8c5a22eba261520cd6c7d5d9483adf5e01539b78045f26253
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / parsanol-1.5.1.0-py3-none-manylinux_2_28_ppc64le.whl

Download URL parsanol-1.5.1.0-py3-none-manylinux_2_28_ppc64le.whl
Size 1.2 MB
Tags Linux glibc 2.28+ PowerPC 64-le Python 3
SHA-256 checksum
How to use checksums
86e5da8c3afd610d729c0cd4646ce261cff9a799d1e155f781306ecb40880f4d
BLAKE2b-256 checksum
How to use checksums
68d883ca8769cd982175ec9dafcdf9241e2609056f26bcba612da55e0ecba471
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / parsanol-1.5.1.0-py3-none-manylinux_2_28_i686.whl

Download URL parsanol-1.5.1.0-py3-none-manylinux_2_28_i686.whl
Size 1.1 MB
Tags Linux glibc 2.28+ x86-32 Python 3
SHA-256 checksum
How to use checksums
5728e7dffb51cf5c912d366affc57fda47a2b995afff2ffca2e502e66678985c
BLAKE2b-256 checksum
How to use checksums
c267e2ed72aebb4e6bc2445735551e933950a0c8c732eab81044f4a6241b2502
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / parsanol-1.5.1.0-py3-none-macosx_11_0_universal2.whl

Download URL parsanol-1.5.1.0-py3-none-macosx_11_0_universal2.whl
Size 2.0 MB
Tags Python 3 macOS 11.0+ universal2 (ARM64, x86-64)
SHA-256 checksum
How to use checksums
0d104e169ea8d26b934f6584ec9d5cf74d5a9a944377ba37546af43e3b179ac2
BLAKE2b-256 checksum
How to use checksums
642da8b2433927b2859862161652d8658651e594aac44fe8d2123407856d4e07
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Security for parsanol 1.5.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 11 files in this release have been uploaded with provenance metadata.

Select from 11 files

Attestation for parsanol-1.5.1.0-py3-none-win_arm64.whl

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.5.1.0 This release

11 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page