Parshred

High-performance SIMD-accelerated XML parser for C++20 and Python.

Parshred is built from the ground up for modern CPUs: it scans XML structure with AVX-512/AVX2/SSE4.2/NEON, keeps data in zero-copy string_view ranges, and offers a compact 32-byte DOM node. The result is a small, fast, standards-focused library that works well for both C++ and Python applications.

Feature Highlights

2.5–2.7 GB/s DOM parsing on x86-64 with AVX2; matches RapidXML at small/mid sizes (within ~5%) and is 1.5–2.4x faster at 64 MB+, where RapidXML's allocation pattern thrashes. Parshred's compact 32-byte DOM node keeps the large-file advantage consistent across machines.
5–8x faster than lxml in Python, with competitive or better memory efficiency.
Multiple APIs: DOM, SAX, Pull Parser (StAX-style), and a streaming pipeline for files larger than memory.
XPath 1.0 with full operator, function, and predicate support.
XML Namespace 1.0, internal DTD validation, and XSD simple type validation.
SIMD acceleration: AVX-512, AVX2, SSE4.2, and ARM NEON with runtime dispatch.
32-byte compact DOM nodes — roughly 3x less memory than traditional node-based parsers.
573 unit tests, fuzz-tested, and run against the official W3C XML Conformance Test Suite in CI (results published as a workflow artifact; see Conformance for the current pass/fail breakdown by category).

Performance

All numbers below are measured, not projected. They vary by CPU, memory subsystem, and compiler; rerun bench/bench_dom and bench/bench_python.py on your target hardware for accurate figures. See docs/performance.md for methodology and the benchmark-regression CI job that guards against perf regressions.

C++ DOM throughput (x86-64, AVX2)

Reference machine: AMD Ryzen 5 7640U, 12 threads, GCC 16.1 -O3, single thread. Median of repeated runs; bench/bench_dom.

Size	Parshred (FastDOM)	RapidXML	pugixml	vs RapidXML
64 KB	2572 MB/s	2477	1465	1.04x
1 MB	2722 MB/s	2757	821	0.99x
16 MB	2519 MB/s	2421	1585	1.04x
64 MB	1678 MB/s	915	641	1.83x
128 MB	1317 MB/s	866	712	1.52x

Reading the table: at 64 KB–16 MB both parsers are bound by the same scalar setup and run within ~5% of each other — Parshred does not claim a win there. The gap opens at 64 MB+ because RapidXML allocates per-node on the heap while Parshred packs nodes into a single malloc'd array, so cache behavior and allocator pressure diverge. On machines with more cache or a faster allocator the large-file ratio trends higher (we have observed up to 2.4x); on this laptop it is 1.5–1.8x.

Python throughput

Reference machine: as above, Python 3.14, lxml 6.1.1, single thread. Median of 3 runs; bench/bench_python.py.

Size	Parshred	lxml (DOM)	lxml (iterparse)	vs lxml (DOM)
10 MB	527 MB/s	91	106	5.8x
100 MB	575 MB/s	90	101	6.4x

lxml's iterparse streaming mode is its fastest path for large files; Parshred's full-DOM path still beats it because the DOM build is zero-copy into string_view ranges with no per-node allocation.

Quick Start

CMake (FetchContent)

include(FetchContent)
FetchContent_Declare(parshred
    GIT_REPOSITORY https://github.com/gregghy/parshred.git
    GIT_TAG v0.1.0
)
FetchContent_MakeAvailable(parshred)
target_link_libraries(myapp PRIVATE parshred::parshred)

Build from Source

git clone https://github.com/gregghy/parshred.git
cd parshred
cmake --preset release
cmake --build build/release
sudo cmake --install build/release

Python

pip install parshred

Usage Examples

DOM Parsing (C++)

#include <parshred/parshred.hpp>

std::string xml = "<catalog><book id=\"1\">Title</book></catalog>";
auto dom = parshred::fast_dom_parse<0>(xml.data(), xml.size());

// XPath queries
auto title = parshred::xpath::evaluate_string(dom, "/catalog/book/text()");
auto id = parshred::xpath::evaluate_string(dom, "/catalog/book/@id");

Pull Parser (C++)

#include <parshred/pull_parser.hpp>

parshred::XmlReader reader(xml);
while (reader.next()) {
    if (reader.is_start_element("book")) {
        auto id = reader.attribute("id");
        auto text = reader.read_element_text();
    }
}

Python

import parshred

doc = parshred.parse_file("catalog.xml")
for book in doc.xpath("//book"):
    print(book.attr("id"), book.text)

Build XML Programmatically

#include <parshred/writer.hpp>

parshred::DomBuilder builder;
builder.start_element("catalog");
builder.start_element("book");
builder.add_attribute("id", "1");
builder.add_text("Title");
builder.end_element();
builder.end_element();

auto dom = builder.build();
parshred::XmlWriter writer;
std::string xml = writer.serialize(dom);

Documentation

Requirements

C++20 compiler: GCC 12+, Clang 15+, or MSVC 2022+
CMake 3.20+
x86-64 with SSE4.2 minimum (AVX2/AVX-512 recommended) or ARM64 with NEON
Python 3.9+ (for the optional Python bindings)

License

Parshred is licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later) for open-source use. See LICENSE for the full license text.

A commercial license is available for proprietary use. See COMMERCIAL_LICENSE.md for details.

Contributing

Contributions are welcome. Please see CONTRIBUTING.md for guidelines on code style, testing, and submitting pull requests.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

parshred-0.1.6.tar.gz (228.7 kB view details)

Uploaded Jul 29, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

parshred-0.1.6-cp313-cp313-musllinux_1_2_x86_64.whl (1.2 MB view details)

Uploaded Jul 29, 2026 CPython 3.13musllinux: musl 1.2+ x86-64

parshred-0.1.6-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl (188.3 kB view details)

Uploaded Jul 29, 2026 CPython 3.13manylinux: glibc 2.17+ x86-64

parshred-0.1.6-cp312-cp312-win_amd64.whl (342.5 kB view details)

Uploaded Jul 29, 2026 CPython 3.12Windows x86-64

parshred-0.1.6-cp312-cp312-musllinux_1_2_x86_64.whl (1.2 MB view details)

Uploaded Jul 29, 2026 CPython 3.12musllinux: musl 1.2+ x86-64

parshred-0.1.6-cp312-cp312-musllinux_1_2_aarch64.whl (1.1 MB view details)

Uploaded Jul 29, 2026 CPython 3.12musllinux: musl 1.2+ ARM64

parshred-0.1.6-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl (188.3 kB view details)

Uploaded Jul 29, 2026 CPython 3.12manylinux: glibc 2.17+ x86-64

parshred-0.1.6-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl (177.5 kB view details)

Uploaded Jul 29, 2026 CPython 3.12manylinux: glibc 2.17+ ARM64

parshred-0.1.6-cp312-cp312-macosx_11_0_arm64.whl (141.3 kB view details)

Uploaded Jul 29, 2026 CPython 3.12macOS 11.0+ ARM64

parshred-0.1.6-cp312-cp312-macosx_10_15_x86_64.whl (154.6 kB view details)

Uploaded Jul 29, 2026 CPython 3.12macOS 10.15+ x86-64

parshred-0.1.6-cp311-cp311-musllinux_1_2_x86_64.whl (1.2 MB view details)

Uploaded Jul 29, 2026 CPython 3.11musllinux: musl 1.2+ x86-64

parshred-0.1.6-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl (189.0 kB view details)

Uploaded Jul 29, 2026 CPython 3.11manylinux: glibc 2.17+ x86-64

parshred-0.1.6-cp310-cp310-musllinux_1_2_x86_64.whl (1.2 MB view details)

Uploaded Jul 29, 2026 CPython 3.10musllinux: musl 1.2+ x86-64

parshred-0.1.6-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.whl (188.3 kB view details)

Uploaded Jul 29, 2026 CPython 3.10manylinux: glibc 2.17+ x86-64

parshred-0.1.6-cp39-cp39-win_amd64.whl (343.6 kB view details)

Uploaded Jul 29, 2026 CPython 3.9Windows x86-64

parshred-0.1.6-cp39-cp39-musllinux_1_2_x86_64.whl (1.2 MB view details)

Uploaded Jul 29, 2026 CPython 3.9musllinux: musl 1.2+ x86-64

parshred-0.1.6-cp39-cp39-musllinux_1_2_aarch64.whl (1.1 MB view details)

Uploaded Jul 29, 2026 CPython 3.9musllinux: musl 1.2+ ARM64

parshred-0.1.6-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.whl (188.7 kB view details)

Uploaded Jul 29, 2026 CPython 3.9manylinux: glibc 2.17+ x86-64

parshred-0.1.6-cp39-cp39-manylinux2014_aarch64.manylinux_2_17_aarch64.whl (178.2 kB view details)

Uploaded Jul 29, 2026 CPython 3.9manylinux: glibc 2.17+ ARM64

parshred-0.1.6-cp39-cp39-macosx_11_0_arm64.whl (139.6 kB view details)

Uploaded Jul 29, 2026 CPython 3.9macOS 11.0+ ARM64

parshred-0.1.6-cp39-cp39-macosx_10_15_x86_64.whl (152.6 kB view details)

Uploaded Jul 29, 2026 CPython 3.9macOS 10.15+ x86-64

File details

Details for the file parshred-0.1.6.tar.gz.

File metadata

Download URL: parshred-0.1.6.tar.gz
Upload date: Jul 29, 2026
Size: 228.7 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for parshred-0.1.6.tar.gz
Algorithm	Hash digest
SHA256	`8eb0dc0509993692d5053b860b73659fcaea0755e8b5f5c1c6dec6a41eb4f893`
MD5	`263860ce9447a6f7553d5cb7ec45e397`
BLAKE2b-256	`56c42bce0cfbc2ce8320cbf96c27e84334c4fe5881c442ba465490552332e18c`

Algorithm	Hash digest
SHA256	`22c23bd65bebdeb67a6118eb93b8d0e175fd9b6655e32195405f3f0f5aa7bbbb`
MD5	`2f7a05a1d65105f6e98c416d498da14a`
BLAKE2b-256	`17442c538622c9f4657f5c95e7454e5e6c122546a738698b5d2b8df1e2a8a075`

Algorithm	Hash digest
SHA256	`bc540000761c9b02d09b05989c852050922d1ff53290674d173aa3f03d438dec`
MD5	`4d26050e18866cd6ac2bb4489bafd6e4`
BLAKE2b-256	`cabd96fb2ff4c65b7e705d21158e9aacf8be3c5b2abd810fd7d602f98379462f`

Algorithm	Hash digest
SHA256	`a294dbcda8b5c69f23fd718f4414df3b5bf2c23a48a3c73f42409e85b7d004f9`
MD5	`97b02b85465c62c80de38af19bcd5ea4`
BLAKE2b-256	`dca800b6a6bde5acdabb517daacd66ce8d9d1a4826d5c501ce1e0aa03d0ba527`

Algorithm	Hash digest
SHA256	`e9015619ed6ae4c98b8ae8acd05dd4793c5d29f0fcfa6ba6e12b209438ba165e`
MD5	`e7a62983e73020fdf0c91356ce8be504`
BLAKE2b-256	`b4a1798390f5566e7bb4e1c572099ece2b94ffb6366e978de0e3cd472cdbf900`

Algorithm	Hash digest
SHA256	`8821b8e6ff37fc0292b84b9fb079368a7cdf5372e018432f3d604367982939f1`
MD5	`20c71df501b26189cb234b61a4ca090c`
BLAKE2b-256	`1feb408d355568f543862588691aa828c5492afc7250227dc79cf092ec6a1842`

Algorithm	Hash digest
SHA256	`9c16b68dcce6a5ebd6ee1a831814e49903e4d63c77673e9d3a8726cbd2688f29`
MD5	`49f5135aac081e1e92f66fa3609146f5`
BLAKE2b-256	`212717dc71dd11893e56d0d07863d8d1c054af5638523b5ae7b1ace30dc08813`

Algorithm	Hash digest
SHA256	`8345693d2db1697725ac99437b8b002e2fecf20e50a1fdfc8005ca14a47d6738`
MD5	`dcba64f2c32daff63ca39092d20df568`
BLAKE2b-256	`3b32ed26b48aaa4d5da4e93ad82be39dc4c870a9a48b40b934d5d6d798d41c92`

Algorithm	Hash digest
SHA256	`33a469bd82d02e02b82c2b3b08bb894d0974be6e00d7357e74f8336fe0184b25`
MD5	`319d601c6f5bd034d1d595267d8b1be1`
BLAKE2b-256	`ddeb0679d0971b00012e10c4bae81c736bb62561ba4e3c363db4eff0e6b3de30`

Algorithm	Hash digest
SHA256	`b2e0f9ea5cce08aef0001ecef4eca320070bb468e00af4a9cc10c92809ae6b4b`
MD5	`928b53ea0a9ee30a44c0c684e6bbed8a`
BLAKE2b-256	`6b26a1e62161c4968ee6648e24cb97f35b4b320246a298b85fb97fba6bb66712`

Algorithm	Hash digest
SHA256	`f4b13133044444eabf318433738be23cefeb57e4ffc1ad6498862be50e0c08b9`
MD5	`778fd5ba942df0bb65d6ffe3a0e96a7a`
BLAKE2b-256	`a795c390d42822b5b1b795b7eb562a109ae85b83dc4cacba85a8ae2e86e65568`

Algorithm	Hash digest
SHA256	`c9f554f525e400087fde82c1e60ab81e2b44fab8fa165c8ce31ae503832db162`
MD5	`0e2d6017614f2f908c6c79c628caab1a`
BLAKE2b-256	`db29037e067c80bce9e0fcb7b02e8ef1f2f45b671b66fe2f6283ea763a927a23`

Algorithm	Hash digest
SHA256	`723d23923dd138852e1d471ba481c274f66c77f850f624e442a54908ce5dafc7`
MD5	`607df9e40e5d12bebd1a3ed0b3387007`
BLAKE2b-256	`b7ecf0bd7499db6f99e2b96ac34a2b26effd168cd8a80ed85a002dd0336d4140`

Algorithm	Hash digest
SHA256	`541bf43c55ac48fe31c1a9baa6608bed1ef710ba1c5d0167a3c1e32d92c66e0e`
MD5	`5cf624c9852660ed159f7419a5350a5e`
BLAKE2b-256	`7fda14df6329e1cf49592acd06b296109a99fb75ea698e61de9d15aba22a9bac`

Algorithm	Hash digest
SHA256	`39037d1966486993e481d230fddc9a5340f7ce51baab01cd10a3ccc4c672813e`
MD5	`1cac1a203a80fdef0f5247a3004baa65`
BLAKE2b-256	`f4cff4c023e62f2b0a4a5a2407f85ce7f8cf63f778a63c1d692c9e270d24c04f`

Algorithm	Hash digest
SHA256	`357846a9d6aebc410416a65c04aec22dd57c572afeb4b2f4e8b2774c692331c9`
MD5	`ce068d4f60edcde6b5c559f2ff597b14`
BLAKE2b-256	`8b3e78e6f8c52b0178d86508e1dfbb1acbb43b8b2598800852fcd22ac5d1463f`

Algorithm	Hash digest
SHA256	`729189c6c18b6ff3d08fc9f1c168e7770f7845cb6f16cdbf2d3ce3216384c42b`
MD5	`a7c7c6d1e757926d5164f1dfbaa3f8c8`
BLAKE2b-256	`10ed94912887307cc1f9710c8b3b530ded5e24c0206e251c03396e18d4ff4fb7`

Algorithm	Hash digest
SHA256	`1235da3ff7e32b941bd88b15cabebcd0dad9c90224adf1383faf0afd41193ed8`
MD5	`a857ae76a03cc83e9beb0e017bb83211`
BLAKE2b-256	`5cdda3c00d7ecc446706681c2fb19260d7149931dbd201319bed94706b54e7ac`

Algorithm	Hash digest
SHA256	`12dc43b4140fda282db8fed4b1263d6aaad0ab2fa62bf1ca4f709ad85091491c`
MD5	`9e2518e81ebf04c2129e1ebe913fcb69`
BLAKE2b-256	`11a5504cb3be969c047eb43eea693e8942f30477e65617c077fa168378b19733`

Algorithm	Hash digest
SHA256	`7aaff1fbb35487ed4eb7e39ede8dfbccc90387833eb78c95a7569f7f52f4dbb2`
MD5	`d364efc7c241ed8afdcf00fabcb8d311`
BLAKE2b-256	`0efd95edf5e847ad07183d21cfd7b50133c27a6eb777459d67851127f6c4515d`

Algorithm	Hash digest
SHA256	`20b28a936ef8a400e17996f91e69267e60d2b0eba6ac9fda104e36b814efbaa4`
MD5	`aed425894e2f83d4c93c8d3fc7d12b2f`
BLAKE2b-256	`8a93590321b0c1f1bacbaa16f2b60739bfefff29acae785b0e8c0b699a83f2f5`

parshred 0.1.6

Parshred

Feature Highlights

Performance

C++ DOM throughput (x86-64, AVX2)

Python throughput

Quick Start

CMake (FetchContent)

Build from Source

Python

Usage Examples

DOM Parsing (C++)

Pull Parser (C++)

Python

Build XML Programmatically

Documentation

Requirements

License

Contributing

Project links

Key dates

1 maintainer

Credits

GitHub Statistics

License

Requires

Tags

Classifiers

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details