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 0.20.23.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 0.20.23.0
File Actions
parsanol-0.20.23.0-py3-none-win_arm64.whl Python 3 none Windows ARM64 Details for parsanol-0.20.23.0-py3-none-win_arm64.whl
parsanol-0.20.23.0-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for parsanol-0.20.23.0-py3-none-win_amd64.whl
parsanol-0.20.23.0-py3-none-win32.whl Python 3 none Windows x86-32 Details for parsanol-0.20.23.0-py3-none-win32.whl
parsanol-0.20.23.0-py3-none-musllinux_1_2_riscv64.whl Python 3 none Linux musl 1.2+ RISC-V 64 Details for parsanol-0.20.23.0-py3-none-musllinux_1_2_riscv64.whl
parsanol-0.20.23.0-py3-none-musllinux_1_2_aarch64.whl Python 3 none Linux musl 1.2+ ARM64 Details for parsanol-0.20.23.0-py3-none-musllinux_1_2_aarch64.whl
parsanol-0.20.23.0-py3-none-manylinux_2_35_x86_64.whl Python 3 none Linux glibc 2.35+ x86-64 Details for parsanol-0.20.23.0-py3-none-manylinux_2_35_x86_64.whl
parsanol-0.20.23.0-py3-none-manylinux_2_35_aarch64.whl Python 3 none Linux glibc 2.35+ ARM64 Details for parsanol-0.20.23.0-py3-none-manylinux_2_35_aarch64.whl
parsanol-0.20.23.0-py3-none-manylinux_2_28_s390x.whl Python 3 none Linux glibc 2.28+ IBM System/390x Details for parsanol-0.20.23.0-py3-none-manylinux_2_28_s390x.whl
parsanol-0.20.23.0-py3-none-manylinux_2_28_ppc64le.whl Python 3 none Linux glibc 2.28+ PowerPC 64-le Details for parsanol-0.20.23.0-py3-none-manylinux_2_28_ppc64le.whl
parsanol-0.20.23.0-py3-none-manylinux_2_28_i686.whl Python 3 none Linux glibc 2.28+ x86-32 Details for parsanol-0.20.23.0-py3-none-manylinux_2_28_i686.whl
parsanol-0.20.23.0-py3-none-macosx_11_0_universal2.whl Python 3 none macOS 11.0+ universal2 (ARM64, x86-64) Details for parsanol-0.20.23.0-py3-none-macosx_11_0_universal2.whl

Total release size: 12.6 MB

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

Download URL parsanol-0.20.23.0-py3-none-win_arm64.whl
Size 877.0 kB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
152b03f8da9c4ef253f8939aa101944cdedb102b07e4c8ec53349d25ebbf6454
BLAKE2b-256 checksum
How to use checksums
5c5b172b42831a8dc491c8f7d095f10c120158883d361e2b94ffc2fce484fbde
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-0.20.23.0-py3-none-win_amd64.whl

Download URL parsanol-0.20.23.0-py3-none-win_amd64.whl
Size 950.3 kB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
a03214f66afb09cb99a45c6619fbf5b59e657b1522c1799a2b04de308c8b1b9a
BLAKE2b-256 checksum
How to use checksums
a479322b52b2656d90dfc70ade7b39de840edc82e01c9262f5d94b7e138a6fe9
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-0.20.23.0-py3-none-win32.whl

Download URL parsanol-0.20.23.0-py3-none-win32.whl
Size 884.1 kB
Tags Python 3 Windows x86-32
SHA-256 checksum
How to use checksums
e96c782f9c9f02f74fa480da64de4101fc2415a348a0173762f04b7ac6636756
BLAKE2b-256 checksum
How to use checksums
7f157edf9c03f24c9894ac007fefeb679650f4b0cfca79b5c85faea78aa2aad3
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-0.20.23.0-py3-none-musllinux_1_2_riscv64.whl

Download URL parsanol-0.20.23.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
1fba74333815611f0e015916ac4e26cb325dced8341dca6c4fdbbc90831e1bc0
BLAKE2b-256 checksum
How to use checksums
b0ee177ec81d5550e907b71c371e44c1af0ca0f957fee2a0f5a70b3c153f5a56
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-0.20.23.0-py3-none-musllinux_1_2_aarch64.whl

Download URL parsanol-0.20.23.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
8a2f3897f466cb99a888e40cb8b7b63b61710a12749317eba4a96a7950151df8
BLAKE2b-256 checksum
How to use checksums
ec7aa302fa2a3498dd8bb93f31356894fcf0d6856bfdc63c30a3b57e16e4bae8
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-0.20.23.0-py3-none-manylinux_2_35_x86_64.whl

Download URL parsanol-0.20.23.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
5ac2a370ee471d413b09962ce0c2e96f9cad594e44aa04ea998f55fe22d1592b
BLAKE2b-256 checksum
How to use checksums
9b15596956b13cd144a19885c5b5f1807487d7e1bc8b5e95a1335d0f8f034b5a
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-0.20.23.0-py3-none-manylinux_2_35_aarch64.whl

Download URL parsanol-0.20.23.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
88d61e8d1d59e7b21bb857f3bc5e9c9a3541ba279b426c33ad8b8806e403c0a0
BLAKE2b-256 checksum
How to use checksums
2893297751a19689ad90885e78f505add585bec96bcdde395b33e89845df4617
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-0.20.23.0-py3-none-manylinux_2_28_s390x.whl

Download URL parsanol-0.20.23.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
5f26a11268ad5f632334214c3a84ab1aed5ae20ac19f84584d5dc34ea8847a07
BLAKE2b-256 checksum
How to use checksums
3adf541e377c80d58806764562cef638497e1ab539fdfe9bdb612d93db820881
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-0.20.23.0-py3-none-manylinux_2_28_ppc64le.whl

Download URL parsanol-0.20.23.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
2fcb70b923ce2cda65bdd1498b7cdac2fa2d3cfe60833b0feb630719fade5023
BLAKE2b-256 checksum
How to use checksums
4791dba4bccd4278a9c250cdc19cb4c0ed3e81c4e4409ce3b67c591124010dd8
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-0.20.23.0-py3-none-manylinux_2_28_i686.whl

Download URL parsanol-0.20.23.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
1ad9305ce5d8bc5224362247d87f66873aff2e4385b1f113cfd26d8190def76d
BLAKE2b-256 checksum
How to use checksums
80ef0c4154fae5f7d8c1666a6b41a839931df71097fa4d648adf207e5e57b9bc
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-0.20.23.0-py3-none-macosx_11_0_universal2.whl

Download URL parsanol-0.20.23.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
e697c2e2ddb07210151940bc6a5528f63b714f222989269c81eee4db4b41c579
BLAKE2b-256 checksum
How to use checksums
f7df39b6d5ae0ad79b36ddd5064924710b71232f60c27a39d2f68816624d58cd
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 0.20.23.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-0.20.23.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

0.20.23.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