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

Total release size: 13.3 MB

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

Download URL parsanol-1.5.4.0-py3-none-win_arm64.whl
Size 1.0 MB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
de259a272c3a6a6936fda7ca8c4949db199285b7203280764d9d205a6100a06f
BLAKE2b-256 checksum
How to use checksums
ce14af3b814351b63b32101ba19db2e869a9a223a03aecdd6dfed02a2e85c9e3
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 17, 2026.

Transparency log

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

Download URL parsanol-1.5.4.0-py3-none-win_amd64.whl
Size 1.1 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
d513d557b9a401379cdcd3b7289f2b1b0053118292eb3b81658cd691f2e8916c
BLAKE2b-256 checksum
How to use checksums
b3146b5382ec145097ebb6fca98f5ca3c38c4bb1763262f2d1f34fc51c51793d
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 17, 2026.

Transparency log

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

Download URL parsanol-1.5.4.0-py3-none-win32.whl
Size 1.0 MB
Tags Python 3 Windows x86-32
SHA-256 checksum
How to use checksums
366694783f77b3871004ab11767394b1d4d0c7956468037eede2a027535d8bf2
BLAKE2b-256 checksum
How to use checksums
2049167c78ee5ac640a50be18ad5babd9484dde0b99ab80c81d5915db3776548
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 17, 2026.

Transparency log

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

Download URL parsanol-1.5.4.0-py3-none-musllinux_1_2_riscv64.whl
Size 1.3 MB
Tags Linux musl 1.2+ RISC-V 64 Python 3
SHA-256 checksum
How to use checksums
1e4090d8dcaf03e8a288b3526cf2997c1e0c897bdaaa21e0a2187f66e1f732f4
BLAKE2b-256 checksum
How to use checksums
e2064504d7b8027fd2fb51f370c79aa307162c3f9fb7e518ecbaac22375d35a8
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 17, 2026.

Transparency log

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

Download URL parsanol-1.5.4.0-py3-none-musllinux_1_2_aarch64.whl
Size 1.2 MB
Tags Linux musl 1.2+ ARM64 Python 3
SHA-256 checksum
How to use checksums
c4b0827b0ef60c3eb8f1bb0e26bf6129d498900d49cf64047a2f104b059d801e
BLAKE2b-256 checksum
How to use checksums
0f39daf69ed2e61344ef16fae27e78274831c8d28808bbbbc952a807885bb329
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 17, 2026.

Transparency log

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

Download URL parsanol-1.5.4.0-py3-none-manylinux_2_35_x86_64.whl
Size 1.3 MB
Tags Linux glibc 2.35+ x86-64 Python 3
SHA-256 checksum
How to use checksums
f564a092a758850f5ab9d4990ade225425ec288bda3065a3fad16b2860e24ce5
BLAKE2b-256 checksum
How to use checksums
b74cd560f384129f1962ffca31103bace17a938b5cadf55dcd291c24f4fc3555
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 17, 2026.

Transparency log

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

Download URL parsanol-1.5.4.0-py3-none-manylinux_2_35_aarch64.whl
Size 1.2 MB
Tags Linux glibc 2.35+ ARM64 Python 3
SHA-256 checksum
How to use checksums
aa648e620cde7a2c5e178a22b9d38b3db5fc52a590c2163ac59f847b0f443397
BLAKE2b-256 checksum
How to use checksums
37795e9159fbd4489ba32d179dde7f6cbea9b8afa88dd587d8b3364197135b99
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 17, 2026.

Transparency log

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

Download URL parsanol-1.5.4.0-py3-none-manylinux_2_28_s390x.whl
Size 1.4 MB
Tags Linux glibc 2.28+ IBM System/390x Python 3
SHA-256 checksum
How to use checksums
1956893e8a172153e47336b306697daef10344a05844a02780847cda29f2cbc1
BLAKE2b-256 checksum
How to use checksums
fc1154b407c4cb361137e40837fafc04d9406364741e112dc6a71108e6011612
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 17, 2026.

Transparency log

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

Download URL parsanol-1.5.4.0-py3-none-manylinux_2_28_ppc64le.whl
Size 1.3 MB
Tags Linux glibc 2.28+ PowerPC 64-le Python 3
SHA-256 checksum
How to use checksums
dbb22167f632721835cdb5700001177f982d9f1e220e1bacbacb8f1eaa057b72
BLAKE2b-256 checksum
How to use checksums
82fda1883e01f96d6476d8a83159591687389d7570f0daadccb7d15153149333
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 17, 2026.

Transparency log

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

Download URL parsanol-1.5.4.0-py3-none-macosx_11_0_universal2.whl
Size 2.3 MB
Tags Python 3 macOS 11.0+ universal2 (ARM64, x86-64)
SHA-256 checksum
How to use checksums
c794d38f548ed9e11cc6521b8ad5ed4b21d9c9f596fc1f76cab67b081394efc8
BLAKE2b-256 checksum
How to use checksums
e21c17258172d7ba52fbbec372de35d8376ed18637605ab4e32b97f247fb252c
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 17, 2026.

Transparency log

Security for parsanol 1.5.4.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 10 files in this release have been uploaded with provenance metadata.

Select from 10 files

Attestation for parsanol-1.5.4.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 17, 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.4.0 This release

10 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