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

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

Total release size: 12.6 MB

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

Download URL parsanol-0.1.34-py3-none-win_arm64.whl
Size 877.2 kB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
80a84bf8f87840e6830a454a343c7757f59f46cdd60009e6518044fcf9fc644e
BLAKE2b-256 checksum
How to use checksums
590b1cd2fc8eb892acd742a99965c07e9881a1cc4278c3cc4872982cda664d84
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.34-py3-none-win_amd64.whl

Download URL parsanol-0.1.34-py3-none-win_amd64.whl
Size 950.3 kB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
badcc1727a2a7e46cebe7d9c2dda7597f149c8ba8869c0e371795cb8a3385167
BLAKE2b-256 checksum
How to use checksums
54ac6cff226af566eb2861692832d177bf2d76257b81d9d0a8e6fda29f5f4d77
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.34-py3-none-win32.whl

Download URL parsanol-0.1.34-py3-none-win32.whl
Size 884.1 kB
Tags Python 3 Windows x86-32
SHA-256 checksum
How to use checksums
9dc0a41f729f76e31752af9a7cd1b98dd40eca01d52b7273a5a6bef84c83190f
BLAKE2b-256 checksum
How to use checksums
7077da8a88c330a78345ea72ccdd11bba1f7030bb63413e77754bd16a3e771ea
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.34-py3-none-musllinux_1_2_riscv64.whl

Download URL parsanol-0.1.34-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
b885175f8679c4f5ee8faf2658b183440f650926c51dab427adb0a5dad05ed14
BLAKE2b-256 checksum
How to use checksums
259ac0ec99e3f5ca729ddce16196fd4cca230fba776e38cad6387fb513643a66
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.34-py3-none-musllinux_1_2_aarch64.whl

Download URL parsanol-0.1.34-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
4434ef79c8dfd1c7f37beca3cfbc985a6e8cda66bdd45c1e4eed6405d77803c8
BLAKE2b-256 checksum
How to use checksums
7935091a15b5321aabb763a799b609701357f030deec290f288c540f9f62fbcd
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.34-py3-none-manylinux_2_35_x86_64.whl

Download URL parsanol-0.1.34-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
d6a89242f96fde32a4f1879dbedd5f5210b89af63e3d8e4e1fd0bd4b4c66e003
BLAKE2b-256 checksum
How to use checksums
38ac42381db21f05297c1733cd164120f01c6d3aa52baa1dfe4038e3e9808d4a
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.34-py3-none-manylinux_2_35_aarch64.whl

Download URL parsanol-0.1.34-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
efafa17a12173837c228b8148cb063666876cd2792cb6c1c9ecbabe2d2ad9849
BLAKE2b-256 checksum
How to use checksums
a677bd9c312cad423d61ef3d3ce2c31a3814115fe58915eca57111dc6369a055
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.34-py3-none-manylinux_2_28_s390x.whl

Download URL parsanol-0.1.34-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
b2b3a10fbe7f25fefecb6bff07260b47d499ab7e2a342cc64fc8b28d2b818220
BLAKE2b-256 checksum
How to use checksums
76ccd0de366e309a1fef74dc999c7386210d1ed453d0cc9e721e2b0360d53624
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.34-py3-none-manylinux_2_28_ppc64le.whl

Download URL parsanol-0.1.34-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
323d534d01c38118a2ba15fe61dfd93ca94b6f916ca7a385adba5869afdac349
BLAKE2b-256 checksum
How to use checksums
30e329036f326b0504cc3ec259c4d7a764ba2a75adc74b545a1f904948cfe33f
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.34-py3-none-manylinux_2_28_i686.whl

Download URL parsanol-0.1.34-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
7d08b259221aa0130c4730a34a64884f3d26076c884d4085088aba25f2d72695
BLAKE2b-256 checksum
How to use checksums
fa8b478c601b525026a6bba29a22fa9e62b69455b65f3e0c8295f3e88395829c
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.34-py3-none-macosx_11_0_universal2.whl

Download URL parsanol-0.1.34-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
c6e57ccbd346cf9ef9680e5de67e600ed78a1f3e124b974ac15b3f067068a241
BLAKE2b-256 checksum
How to use checksums
1397ac4b9638d6df4b3a4a1495cae6b39b426f6dbe6d5122ac84b8d47bcf13f1
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.34

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