docutils-rust
A standalone Rust port of python/docutils: reStructuredText parser + transform pipeline + HTML publisher, with Sphinx-compatible doctree behavior as the parity bar. Clean-room implementation (see NOTICE); MIT licensed.
Layout
docutils-core/— reusable Rust core: parser, transforms, publishers (docutils_core), no Python dependency.src/lib.rs+ rootCargo.toml— the PyO3 binding crate (docutils-py), compiled as thedocutils_rust._coreextension module.docutils_rust/— Python shim (publish_string,publish_doctree).tests/corpus/*.rst— equivalence fixtures;tests/equiv.pydiffs doctree text, message levels, and HTML tag profile against the oracle.benches/two_track.py— two-track wall/RSS bench (measured only).
Parity
venv/bin/python tests/equiv.py (needs the oracle docutils installed):
7/7 corpus files green — doctree text and message levels exact, HTML tag
profile exact except one accepted environmental divergence (.. math::
kept as literal <pre> instead of MathML; oracle pygments highlight spans
are stripped on both sides before comparison).
Benches
venv/bin/python benches/two_track.py (same settings both sides:
report_level 1, halt_level 4; fresh process per input for honest RSS):
| input | size | python wall | rust wall | python peak RSS | rust peak RSS |
|---|---|---|---|---|---|
| directives.rst | 1.2 KiB | 6.02 ms | 0.15 ms | 30312 KiB | 2264 KiB |
| errors.rst | 0.3 KiB | 3.72 ms | 0.10 ms | 28988 KiB | 2348 KiB |
| inline.rst | 0.7 KiB | 3.48 ms | 0.20 ms | 29132 KiB | 2268 KiB |
| lists.rst | 0.6 KiB | 5.30 ms | 0.15 ms | 29668 KiB | 2308 KiB |
| refs.rst | 0.9 KiB | 5.30 ms | 0.15 ms | 29968 KiB | 2280 KiB |
| smoke.rst | 1.1 KiB | 6.85 ms | 0.25 ms | 30560 KiB | 2348 KiB |
| tables.rst | 0.5 KiB | 5.21 ms | 0.10 ms | 30020 KiB | 2268 KiB |
| big.rst (tiled smoke) | 256.3 KiB | 7769.57 ms | 115.30 ms | 625908 KiB | 47300 KiB |
67x bulk (256 KiB), 17-52x small docs; ~13x lower peak RSS.
Measured 2026-10-17 on AMD Ryzen 9 5950X (this machine): medians of 3
fresh-process runs, 2 iters each (benches/two_track.py --iters 2 --big-kb 256), CPython 3.12 + docutils 0.23 vs release bench example.
Python RSS includes the interpreter baseline (~29 MB on tiny inputs).
Install
Published as docutils-rust (version 0.1.0). The 0.1.0 files land on
TestPyPI first (same wheel + sdist, same SHA-256) and are promoted to PyPI;
until the production landing completes, install from TestPyPI:
pip install --index-url https://test.pypi.org/simple/ docutils-rust==0.1.0
pip install docutils-rust==0.1.0 # PyPI, once promoted
The Rust core is on crates.io as docutils-core 0.1.0
(cargo add docutils-core).
The port covers the reStructuredText parser, the transform pipeline, and the
HTML publisher. It is a clean-room implementation of a subset of docutils,
not a drop-in replacement: the upstream import name stays with upstream, so
this package imports as docutils_rust.
Release
0.1.0 ships the docutils-rust Python distribution (wheel + sdist) and
the docutils-core Rust crate. Release scope, artifacts, and the
verification battery are recorded in specs/release.md; the lane config is
release.toml; upstream attribution and the accepted divergences are in
NOTICE.
1 maintainer
Metadata
1 maintainer
Release files for docutils-rust 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| docutils_rust-0.1.0.tar.gz | 70.7 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| docutils_rust-0.1.0-cp312-cp312-manylinux_2_34_x86_64.whl | CPython 3.12 | CPython 3.12 | Linux glibc 2.34+ x86-64 | Details |
Total release size: 557.7 kB
Release files / docutils_rust-0.1.0.tar.gz
| Download URL | docutils_rust-0.1.0.tar.gz |
|---|---|
| Size | 70.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a16eed3a91f34d0415c0238475d8270c6f4f32ceea71fca7bb45c54d7fe97730
|
|
BLAKE2b-256 checksum How to use checksums |
086c9fb2218e0697254f65ac308000d81a29a9bf5aa766f25dab9ddf3e842787
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.2
|
Release files / docutils_rust-0.1.0-cp312-cp312-manylinux_2_34_x86_64.whl
| Download URL | docutils_rust-0.1.0-cp312-cp312-manylinux_2_34_x86_64.whl |
|---|---|
| Size | 487.1 kB |
| Tags | CPython 3.12 Linux glibc 2.34+ x86-64 |
|
SHA-256 checksum How to use checksums |
11b19bbbe4deb93c13e252abd8429d514b945bcf071bfe5da3052082c32bd572
|
|
BLAKE2b-256 checksum How to use checksums |
1bd08f7307e48ad7cf59de9def41a21228cdd391c3fcf7187fee4c815e3c34a5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.2
|
Security for docutils-rust 0.1.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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
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.
