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

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

Total release size: 11.5 MB

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

Download URL parsanol-0.1.30-py3-none-win_arm64.whl
Size 877.0 kB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
2635221b8545b0b30f9420ad00827d435bf3edb1a34d12fcf1d53277d57a57f7
BLAKE2b-256 checksum
How to use checksums
7b8659c5aaed7230886c9f72b5fe072a2f20cc5545b758de0ce0cff8cac2e808
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 13, 2026.

Transparency log

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

Download URL parsanol-0.1.30-py3-none-win_amd64.whl
Size 949.7 kB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
41190867b73e2ce928c53fd89eb65811e40327c270703b8a35a3d9216ef72bf4
BLAKE2b-256 checksum
How to use checksums
25c5707a81c38dd93b9b6db9cb2bf6ca210e03a7865a2c466f7e7bdfffd8a1d2
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 13, 2026.

Transparency log

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

Download URL parsanol-0.1.30-py3-none-win32.whl
Size 882.7 kB
Tags Python 3 Windows x86-32
SHA-256 checksum
How to use checksums
ce03bc2672d8369cf5b9ef420172c08b504ebd1c3bb7d2718c68e809c7c4a194
BLAKE2b-256 checksum
How to use checksums
be1cedb2a6e1aad8c50264760d8f288f2b6e939fa673960858255ff8fa477d45
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 13, 2026.

Transparency log

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

Download URL parsanol-0.1.30-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
c91cb69ecbec4c85967dac042f94fd863854d2b878cb8bc2860ef548e16166e8
BLAKE2b-256 checksum
How to use checksums
38637f674f4e08342dde47c957032b234ce121f233baaac8c5ec7cbb3cad4221
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 13, 2026.

Transparency log

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

Download URL parsanol-0.1.30-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
f554519251fa2387c9a75720a249aa5b323f83ebccafe82d69932e29b42aadb6
BLAKE2b-256 checksum
How to use checksums
e89d2012dc6e8013535111be0d5c6a0baa4e08610352a77d13929abb817de62b
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 13, 2026.

Transparency log

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

Download URL parsanol-0.1.30-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
6f9bd3f5f5ec0140cb9d2e330326d3571c1ff644fb740dafa4568460002ba4fd
BLAKE2b-256 checksum
How to use checksums
3b3fa92a56d9f2caaa62c61f143d54cec0c29566d0cbeec3a71a749f0a2ddc1c
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 13, 2026.

Transparency log

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

Download URL parsanol-0.1.30-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
e5f8e87e7d50150046934405788306c98813604bbf36d06c86876b6a8a30310c
BLAKE2b-256 checksum
How to use checksums
24c2e523547dc6f3b861c9a9463ca5d7016016743cd9d0bd640881671940fe51
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 13, 2026.

Transparency log

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

Download URL parsanol-0.1.30-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
97ca35cbb4af4e645c1e71f49021cfc7adb2d12a36950a1a89b3cd7f52f6e1b8
BLAKE2b-256 checksum
How to use checksums
c308fba9a795b77c6ea5b2ef14584f06d32901dfd7c9c2922c44a22eb5d69d59
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 13, 2026.

Transparency log

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

Download URL parsanol-0.1.30-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
ad1aeba2dd0d4d8cb12e4266294ef43c0a14935b37d238725ab8620ffb5e4d62
BLAKE2b-256 checksum
How to use checksums
5573fcc320df1bb82a712438d75af1c95b26a7c467beee6063bf15d4bc2c6c5f
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 13, 2026.

Transparency log

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

Download URL parsanol-0.1.30-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
869c4493d9fe438df6b615a5de7badea1b19a4eae5e8a6bfb3dde28eebca1bc0
BLAKE2b-256 checksum
How to use checksums
1475340c417d0bfcfbb0cc2693bf93a2604719509aef1c49640a7fbd1dc4a888
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 13, 2026.

Transparency log

Security for parsanol 0.1.30

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-0.1.30-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 13, 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.30 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