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

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

Total release size: 12.6 MB

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

Download URL parsanol-0.1.33-py3-none-win_arm64.whl
Size 877.2 kB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
f8455fa6c30b9f0e80ff5796d3c816fcbcc65853763797453c76770b7e518cb4
BLAKE2b-256 checksum
How to use checksums
e6e4cf1bef678b8acced9ec83d2281994ff490db8f43e561ea8b8fff5a57f271
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.1.33-py3-none-win_amd64.whl

Download URL parsanol-0.1.33-py3-none-win_amd64.whl
Size 950.4 kB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
fcd452b34029167b5b59dc046f9f84bf9ff24637106e0fff98992d159b310ddc
BLAKE2b-256 checksum
How to use checksums
22d3573eab175d591a26997f0bf5bf03dda13393505d20338a089711d60d07b2
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.1.33-py3-none-win32.whl

Download URL parsanol-0.1.33-py3-none-win32.whl
Size 884.1 kB
Tags Python 3 Windows x86-32
SHA-256 checksum
How to use checksums
4b302404df08a37d28715937a74f3dcf2ddac51934747693e786503208116f64
BLAKE2b-256 checksum
How to use checksums
81d4f33a040666b5b46e6da1af7aba4e8b46e3f60f05a15de24e31db630e6562
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.1.33-py3-none-musllinux_1_2_riscv64.whl

Download URL parsanol-0.1.33-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
3d19dd823eabc58a5bc1e2ab6683f0a9b19d9648ec7eb49ed75983227f998371
BLAKE2b-256 checksum
How to use checksums
e74817b48dea4ab6ebcf96113238c9b738f1a5a463da52debd317e417839936a
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.1.33-py3-none-musllinux_1_2_aarch64.whl

Download URL parsanol-0.1.33-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
ad351cdc1812aa175e70351cf4b8e53dc55ac5c4eaac66d4f0e10365bff1d14c
BLAKE2b-256 checksum
How to use checksums
26d87dfce011b186318a1cda140902a5ac9fa74162fa39db2f2df652c90c7d6a
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.1.33-py3-none-manylinux_2_35_x86_64.whl

Download URL parsanol-0.1.33-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
65d5ca015b89df90486ebd88c717ca5ace0966d559d0260a7946ab619315ed69
BLAKE2b-256 checksum
How to use checksums
1905af056f0a52f7a86b84dc8a6f0506104ea1b85fcc764dd50e294a597071dd
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.1.33-py3-none-manylinux_2_35_aarch64.whl

Download URL parsanol-0.1.33-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
bba414893f73109602a4d2814163337fecac51b4e3608160d5479fc7e98731b0
BLAKE2b-256 checksum
How to use checksums
5717c569f709266326b9ee7535112e7ba3715c7601d516850c5425a6d6fc00e5
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.1.33-py3-none-manylinux_2_28_s390x.whl

Download URL parsanol-0.1.33-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
851bf75d33648d6d5735ee40d62da35139c81f341c968343100c92e4b58761c0
BLAKE2b-256 checksum
How to use checksums
e26e37d00d94f86a771e96d995a49348cbe9b95cbd81fe369c3a7ed82744be41
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.1.33-py3-none-manylinux_2_28_ppc64le.whl

Download URL parsanol-0.1.33-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
ed04b94796c56e8c4c7b16845fdd515bc7e1795609668519b4dec65879a916aa
BLAKE2b-256 checksum
How to use checksums
a08a7addda45aaa4d97d74e7e661d5ef2e898043a8b9afb2ca333d56ec90be2e
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.1.33-py3-none-manylinux_2_28_i686.whl

Download URL parsanol-0.1.33-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
00e2eea36d004e6f768e652e725fbe0d7e21412ccb8e4f872d447a1151d649c9
BLAKE2b-256 checksum
How to use checksums
ccf3199e2240c98359e1f4afa1cc8363cc4731949f00c35c5fe8945b5a452df6
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.1.33-py3-none-macosx_11_0_universal2.whl

Download URL parsanol-0.1.33-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
d8cfd1eeb57dbf4cbe9c75d23d550f0e0f5795ce34ff67f91951e82aa79b4489
BLAKE2b-256 checksum
How to use checksums
8a37c028f0751146fe70a60b0148d8fa61a8c35ae67bef19a43c8d3417694c1f
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.1.33

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