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

Total release size: 12.7 MB

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

Download URL parsanol-1.5.0.0-py3-none-win_arm64.whl
Size 883.4 kB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
38a1e3ac54b658729e6a26130ef0909448b3a19e281857db4298cddaa2fdd37b
BLAKE2b-256 checksum
How to use checksums
23a14c4817023dbd117cdb98b3a3f357b286f27ff11f130d4581f4256c6cff53
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.0.0-py3-none-win_amd64.whl

Download URL parsanol-1.5.0.0-py3-none-win_amd64.whl
Size 956.4 kB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
5479a9d2ee0545599c603c2e882fc7ad8c52ddbe6b9d9cd626cbc61749a1e0f7
BLAKE2b-256 checksum
How to use checksums
3ae07a289925d1ac4487de4b6537642ca14ec0ef5420ff465b461f82bf3b8c13
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.0.0-py3-none-win32.whl

Download URL parsanol-1.5.0.0-py3-none-win32.whl
Size 889.1 kB
Tags Python 3 Windows x86-32
SHA-256 checksum
How to use checksums
f023b15f5a6acdff90cbe77a891ea3840c812088f2149285f24d71486ceb2c0b
BLAKE2b-256 checksum
How to use checksums
1a1806d886cf7a46747f06bf602e06112266e19c10ea4a5ef11e0df9c3baedb8
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.0.0-py3-none-musllinux_1_2_riscv64.whl

Download URL parsanol-1.5.0.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
d93a23a205ad4a96c54fb2e1679502575f4037164ae7c12b5380460523b577f3
BLAKE2b-256 checksum
How to use checksums
9287ce85070e3b175bf95e81d2ac2dd5ca5b827a06e0347ac5ed24bf71386874
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.0.0-py3-none-musllinux_1_2_aarch64.whl

Download URL parsanol-1.5.0.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
d6400b28bf0e21e791377a712c472ffb459bbb6162fa6884bcee5eb90f54e072
BLAKE2b-256 checksum
How to use checksums
065bc5788868161546355d08eddda976d849310fadcf4d8a646c31eef161a363
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.0.0-py3-none-manylinux_2_35_x86_64.whl

Download URL parsanol-1.5.0.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
0525fbddb8982fe779eeece2d39db31c6fec3f6dd2e42ebc271561ea9231fc25
BLAKE2b-256 checksum
How to use checksums
25bfdfe0ec48f39202d42fec5a693367f83bad48b5ea7a880abb66f28f34dca9
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.0.0-py3-none-manylinux_2_35_aarch64.whl

Download URL parsanol-1.5.0.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
adbd39feb743982c0f17af81880590e5a31c3499ce15f1d609e5b4e23ac5ee9e
BLAKE2b-256 checksum
How to use checksums
47fe06252b4b2aee33b2ed7d5f2595a2a5eb12ce4bd219b18af0fb8ca6739eb4
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.0.0-py3-none-manylinux_2_28_s390x.whl

Download URL parsanol-1.5.0.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
ff6d3219812030437dd2737cb42bbb7f6e0eb5917ef18cbe829d3c87d9b9d14a
BLAKE2b-256 checksum
How to use checksums
4d9fd533e0436919e56f22eccd619852d7f1ff4daf6c9cecd6c397b81f693dfb
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.0.0-py3-none-manylinux_2_28_ppc64le.whl

Download URL parsanol-1.5.0.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
7e758c4f48c13c539bea75a8dbfecc174d3b3b5a2dd68e03acf6369d4d5f5f4d
BLAKE2b-256 checksum
How to use checksums
cd65a3d31164691b3702f9dcd1a0aae7654c511340b14e6fbe2f4d5445c5201d
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.0.0-py3-none-manylinux_2_28_i686.whl

Download URL parsanol-1.5.0.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
78ce98ad50c1baabb3c954b830f8f5f63112bd4af58e53fdf28f8cf6e2341493
BLAKE2b-256 checksum
How to use checksums
21ac792b1a4b6f73e5a803af24163130149434b85de22dabe393a66129b3b375
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.0.0-py3-none-macosx_11_0_universal2.whl

Download URL parsanol-1.5.0.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
a4a1e70ba4e6a0d430e8c69b6a98c46b99bdc0c4471a092afd6ce395b6903adb
BLAKE2b-256 checksum
How to use checksums
ab5e89fd9a9727859b7e6fe51bdca61a706e99a93af21b0842babe68bde76244
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.0.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.0.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.0.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