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

Total release size: 13.3 MB

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

Download URL parsanol-1.5.6.0-py3-none-win_arm64.whl
Size 1.0 MB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
e31685390c3db70171dbd437e0bd58fd274633f54af79e30b8e692a34acc1de8
BLAKE2b-256 checksum
How to use checksums
b9e6f2303a0653a5013b13f89b88aa605521e19ad0de99353818b05208fc34d3
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 18, 2026.

Transparency log

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

Download URL parsanol-1.5.6.0-py3-none-win_amd64.whl
Size 1.1 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
3fb33e47168c90ee440454b019648332e7d80fe8a868f040b7761d7b61336948
BLAKE2b-256 checksum
How to use checksums
e3ab753aa426699b05d9a2925cff9b4fa3aafae8e9ed977b7d4751d595786ca0
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 18, 2026.

Transparency log

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

Download URL parsanol-1.5.6.0-py3-none-win32.whl
Size 1.0 MB
Tags Python 3 Windows x86-32
SHA-256 checksum
How to use checksums
dac976032ca446d2443da1a6945cc8b8c10c1ebfa117e52f74c63500bb46bbf2
BLAKE2b-256 checksum
How to use checksums
01080329ced74f8a12a6a15943a345b0c65d4fd6d5a1a81a93b12ff7d0e163bd
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 18, 2026.

Transparency log

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

Download URL parsanol-1.5.6.0-py3-none-musllinux_1_2_riscv64.whl
Size 1.3 MB
Tags Linux musl 1.2+ RISC-V 64 Python 3
SHA-256 checksum
How to use checksums
8e25ee6dea2173ea1c5526a6e055569d61b38166808acb7deeb3855193bea761
BLAKE2b-256 checksum
How to use checksums
1f4db93a1257fed0e70cd674d9ea457140f0e678fd34fb2bc01d68598965ef89
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 18, 2026.

Transparency log

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

Download URL parsanol-1.5.6.0-py3-none-musllinux_1_2_aarch64.whl
Size 1.2 MB
Tags Linux musl 1.2+ ARM64 Python 3
SHA-256 checksum
How to use checksums
9ed111502b150f94f8782c5b423b262f075e3942ac146710a2aa29d429fe69bf
BLAKE2b-256 checksum
How to use checksums
8a72600cc6da5d883729d30a2589bf4f1c7321da71123ec9461d059bbb390a96
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 18, 2026.

Transparency log

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

Download URL parsanol-1.5.6.0-py3-none-manylinux_2_35_x86_64.whl
Size 1.3 MB
Tags Linux glibc 2.35+ x86-64 Python 3
SHA-256 checksum
How to use checksums
8187ad0b4345e8c2bccbfa4fd73f9fd04ca2a68a573057d133b1cbfa50eecb47
BLAKE2b-256 checksum
How to use checksums
641ca5e4ae8881552903cef33855a51dcc946510d6ad144bcbf11e424340e80c
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 18, 2026.

Transparency log

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

Download URL parsanol-1.5.6.0-py3-none-manylinux_2_35_aarch64.whl
Size 1.2 MB
Tags Linux glibc 2.35+ ARM64 Python 3
SHA-256 checksum
How to use checksums
167bb758ba7022d105ffaed53ed4c2ad92528d26954f8c1865378882603db5f8
BLAKE2b-256 checksum
How to use checksums
12978ac6961daf1de4bbb9c62f69c2d58e0901f9c7d1bbe717e031a6d5eaa751
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 18, 2026.

Transparency log

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

Download URL parsanol-1.5.6.0-py3-none-manylinux_2_28_s390x.whl
Size 1.4 MB
Tags Linux glibc 2.28+ IBM System/390x Python 3
SHA-256 checksum
How to use checksums
563ad90866e6658397ae7d3802f0552b519cf226428d17883ae0e6a8a9175107
BLAKE2b-256 checksum
How to use checksums
43dc20f541e23779bbf51af1175e30900ae21c86066f78670185ccae16494231
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 18, 2026.

Transparency log

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

Download URL parsanol-1.5.6.0-py3-none-manylinux_2_28_ppc64le.whl
Size 1.3 MB
Tags Linux glibc 2.28+ PowerPC 64-le Python 3
SHA-256 checksum
How to use checksums
5de38a477b72e00348753f2b21a04ef6fe41c5c7335aab322f8769bfe8c34156
BLAKE2b-256 checksum
How to use checksums
bba97612f28e37586be2b3e81afec04280affbce530bc73defc500581a8d0e5b
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 18, 2026.

Transparency log

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

Download URL parsanol-1.5.6.0-py3-none-macosx_11_0_universal2.whl
Size 2.3 MB
Tags Python 3 macOS 11.0+ universal2 (ARM64, x86-64)
SHA-256 checksum
How to use checksums
155e712eb61dfcdec65b49884314fb262e99ba404261bba9d67358bd2c1ef66f
BLAKE2b-256 checksum
How to use checksums
56043073b3485f2900093ac2c5c93f8f90e67bb86da547cb43008c255f00e50a
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 18, 2026.

Transparency log

Security for parsanol 1.5.6.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 10 files in this release have been uploaded with provenance metadata.

Select from 10 files

Attestation for parsanol-1.5.6.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 18, 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.6.0 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