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

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

Total release size: 12.6 MB

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

Download URL parsanol-0.1.31-py3-none-win_arm64.whl
Size 876.4 kB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
6d58420aaf2ba981a5e6f1af7651e7742564860fcb702fd33a653fee57f2eae0
BLAKE2b-256 checksum
How to use checksums
5866fc003f239e709473b01f1eb273a41be13cfe0c12c37f92d684c88b37ff0c
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 14, 2026.

Transparency log

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

Download URL parsanol-0.1.31-py3-none-win_amd64.whl
Size 949.4 kB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
7a92c05b2990ff2915197d2763ecde76814ec97fb64c36bf1ca3938d3df9ceab
BLAKE2b-256 checksum
How to use checksums
3d2d465f90ed997808464cae05263a158c58f442e1245362cf760619c8f672cf
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 14, 2026.

Transparency log

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

Download URL parsanol-0.1.31-py3-none-win32.whl
Size 883.2 kB
Tags Python 3 Windows x86-32
SHA-256 checksum
How to use checksums
cba4e0ce4243f5dcaf8cd8c6cf6dece167598ce8521c049a1b61b901ecd74110
BLAKE2b-256 checksum
How to use checksums
06eb9f319ffb6697a400d33bcdf81b1d8f5beb3224244181dfbea6670407ee2b
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 14, 2026.

Transparency log

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

Download URL parsanol-0.1.31-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
124303546a4a62172812f77ea27439ea285dbc5be3334b1c6a783c17df9955e5
BLAKE2b-256 checksum
How to use checksums
05cc13e848c75264d6c9d6594e94c313b39efc4bd0820bcd6871a35d4334fef3
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 14, 2026.

Transparency log

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

Download URL parsanol-0.1.31-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
dca0ad2ba12657616488bf84b66c3798a7460673593f570f0bdd0940968a816c
BLAKE2b-256 checksum
How to use checksums
3517fe8479bff66c3af810b1e67d6ab032f7d293d35ea70fd01c5917cd40f1e7
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 14, 2026.

Transparency log

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

Download URL parsanol-0.1.31-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
dad25e751084b70c2bb161591be4b5ffb82635a3e667cabdd90d0d133d8144a4
BLAKE2b-256 checksum
How to use checksums
d08517f2f414e902bd23acf84a47476ae3eb7bf22bb3d9ce088b45d7898925d6
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 14, 2026.

Transparency log

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

Download URL parsanol-0.1.31-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
32195940b07a4ce864ce67dd20c8927b6a7cd05078835e93b760b11ba41ffb6b
BLAKE2b-256 checksum
How to use checksums
03c57071a37485e32f948999e3af35a3735180f376c9cc0304656b0881ab6785
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 14, 2026.

Transparency log

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

Download URL parsanol-0.1.31-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
72d7152a3c773f13b8fcfeb96d70e9394da5cc239a4b26554b4505286120c06f
BLAKE2b-256 checksum
How to use checksums
da2b97130ce3857181aef20b51fe900f08e6f6ff42c08cc3f2fb805d6cdff3d0
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 14, 2026.

Transparency log

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

Download URL parsanol-0.1.31-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
26518dbb6f57973774340e8af5b60afe341d9f2fa8b12bb5b370ac145c4493af
BLAKE2b-256 checksum
How to use checksums
c637195952281175d8f08bab7fa44eb6873f9fe0b8ce181e7bdd6ca7930094ad
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 14, 2026.

Transparency log

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

Download URL parsanol-0.1.31-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
7ad1398ed15732c9b596465e4bc013c8b97742c2967081778bef05c03f54bcfd
BLAKE2b-256 checksum
How to use checksums
110f212f0a22ce0a909dab3d7f0edb96f53417113ae3aba26de76e99da20cdbe
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 14, 2026.

Transparency log

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

Download URL parsanol-0.1.31-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
5fdfaedae7101a2061364c72a8715452fd38667190020e51981318f72ddb00b0
BLAKE2b-256 checksum
How to use checksums
505d574fae5ef6ffc92fb5e6741e97d1dac489090f111dd1995e4a2692d6220f
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 14, 2026.

Transparency log

Security for parsanol 0.1.31

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.31-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 14, 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.31 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