High-performance HTML parsing library with BeautifulSoup4-compatible API

These details have not been verified by PyPI

Project links

Project description

CutySoup

High-performance HTML parsing for Python with a BeautifulSoup4-compatible API (Gumbo + C++ via pybind11).

Why CutySoup

If you like the BeautifulSoup4 API but need more throughput, CutySoup moves the heavy work (parsing and common queries) into a native extension while keeping the same mental model: find, find_all, select, get_text, navigation, and DOM manipulation.

Status: 100% BeautifulSoup4 API compatibility with 148/148 tests passing in this repo.

Install

pip install cutysoup

If you're installing from source (or no wheel exists for your platform), you'll need a C++ toolchain and CMake.

Platforms: macOS, Linux, and Windows (binary wheels when available; otherwise builds from source).

Quickstart

from cutysoup import CutySoup

soup = CutySoup("<html><body><p class='intro'>Hello</p></body></html>")

print(soup.p.text)                 # Hello
print(soup.find("p", class_="intro"))
print(soup.select_one("p.intro"))

Performance

Benchmarks vary by hardware, Python version, and document shape:

cutysoup==0.1.0 (this repo build)
beautifulsoup4==4.13.4
Python 3.8.20

Command:

uv run python benchmarks/portable_benchmark.py --sizes l

For the l fixture (about 639 KB HTML, 2000 repeated <article> blocks), the mean speedups vs BeautifulSoup4 (html.parser) were:

Operation	Speedup
`parse`	7.5x
`parse_and_scrape_articles(loop)`	3.8x
`find_all_tag(p)`	178x
`find_all_class(.text)`	1762x
`select_descendant(article .link)`	7.3x
`href_batch(all a href)`	18.8x

To reproduce the full table (including s and m sizes) and write a JSON report:

uv run python benchmarks/portable_benchmark.py --sizes s,m,l --json-out /tmp/cutysoup_portable_benchmark.json

Extra APIs (Optional)

CutySoup includes some convenience helpers that are not part of BeautifulSoup4 but are useful for performance-sensitive scraping:

from cutysoup import CutySoup

soup = CutySoup('<a href="/one">One</a><a href="/two">Two</a>')
print(soup.get_all_hrefs())  # ['/one', '/two']

There is also a structured extraction helper (soup.query(...)) for extracting data using CSS selectors and transforms. See docs/CSQL_GUIDE.md.

Development

Recommended (creates an env and builds the extension):

uv sync

Run tests:

uv run pytest tests/

Local build script (alternative):

python dev_build.py

License

MIT

Project details

These details have not been verified by PyPI

Project links

Release history Release notifications | RSS feed

This version

0.1.1

Mar 26, 2026

Download files

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

Source Distribution

cutysoup-0.1.1.tar.gz (614.1 kB view details)

Uploaded Mar 26, 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.

cutysoup-0.1.1-cp313-cp313-win_amd64.whl (388.5 kB view details)

Uploaded Mar 26, 2026 CPython 3.13Windows x86-64

cutysoup-0.1.1-cp313-cp313-musllinux_1_2_x86_64.whl (1.5 MB view details)

Uploaded Mar 26, 2026 CPython 3.13musllinux: musl 1.2+ x86-64

cutysoup-0.1.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl (456.4 kB view details)

Uploaded Mar 26, 2026 CPython 3.13manylinux: glibc 2.17+ x86-64

cutysoup-0.1.1-cp313-cp313-macosx_11_0_arm64.whl (394.4 kB view details)

Uploaded Mar 26, 2026 CPython 3.13macOS 11.0+ ARM64

cutysoup-0.1.1-cp313-cp313-macosx_10_13_x86_64.whl (404.8 kB view details)

Uploaded Mar 26, 2026 CPython 3.13macOS 10.13+ x86-64

cutysoup-0.1.1-cp312-cp312-win_amd64.whl (388.5 kB view details)

Uploaded Mar 26, 2026 CPython 3.12Windows x86-64

cutysoup-0.1.1-cp312-cp312-musllinux_1_2_x86_64.whl (1.5 MB view details)

Uploaded Mar 26, 2026 CPython 3.12musllinux: musl 1.2+ x86-64

cutysoup-0.1.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl (456.4 kB view details)

Uploaded Mar 26, 2026 CPython 3.12manylinux: glibc 2.17+ x86-64

cutysoup-0.1.1-cp312-cp312-macosx_11_0_arm64.whl (394.4 kB view details)

Uploaded Mar 26, 2026 CPython 3.12macOS 11.0+ ARM64

cutysoup-0.1.1-cp312-cp312-macosx_10_13_x86_64.whl (404.8 kB view details)

Uploaded Mar 26, 2026 CPython 3.12macOS 10.13+ x86-64

cutysoup-0.1.1-cp311-cp311-win_amd64.whl (387.3 kB view details)

Uploaded Mar 26, 2026 CPython 3.11Windows x86-64

cutysoup-0.1.1-cp311-cp311-musllinux_1_2_x86_64.whl (1.5 MB view details)

Uploaded Mar 26, 2026 CPython 3.11musllinux: musl 1.2+ x86-64

cutysoup-0.1.1-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl (456.5 kB view details)

Uploaded Mar 26, 2026 CPython 3.11manylinux: glibc 2.17+ x86-64

cutysoup-0.1.1-cp311-cp311-macosx_11_0_arm64.whl (393.3 kB view details)

Uploaded Mar 26, 2026 CPython 3.11macOS 11.0+ ARM64

cutysoup-0.1.1-cp311-cp311-macosx_10_9_x86_64.whl (403.1 kB view details)

Uploaded Mar 26, 2026 CPython 3.11macOS 10.9+ x86-64

cutysoup-0.1.1-cp310-cp310-win_amd64.whl (386.5 kB view details)

Uploaded Mar 26, 2026 CPython 3.10Windows x86-64

cutysoup-0.1.1-cp310-cp310-musllinux_1_2_x86_64.whl (1.5 MB view details)

Uploaded Mar 26, 2026 CPython 3.10musllinux: musl 1.2+ x86-64

cutysoup-0.1.1-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.whl (455.0 kB view details)

Uploaded Mar 26, 2026 CPython 3.10manylinux: glibc 2.17+ x86-64

cutysoup-0.1.1-cp310-cp310-macosx_11_0_arm64.whl (391.9 kB view details)

Uploaded Mar 26, 2026 CPython 3.10macOS 11.0+ ARM64

cutysoup-0.1.1-cp310-cp310-macosx_10_9_x86_64.whl (401.8 kB view details)

Uploaded Mar 26, 2026 CPython 3.10macOS 10.9+ x86-64

cutysoup-0.1.1-cp39-cp39-win_amd64.whl (391.8 kB view details)

Uploaded Mar 26, 2026 CPython 3.9Windows x86-64

cutysoup-0.1.1-cp39-cp39-musllinux_1_2_x86_64.whl (1.5 MB view details)

Uploaded Mar 26, 2026 CPython 3.9musllinux: musl 1.2+ x86-64

cutysoup-0.1.1-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.whl (455.6 kB view details)

Uploaded Mar 26, 2026 CPython 3.9manylinux: glibc 2.17+ x86-64

cutysoup-0.1.1-cp39-cp39-macosx_11_0_arm64.whl (392.1 kB view details)

Uploaded Mar 26, 2026 CPython 3.9macOS 11.0+ ARM64

cutysoup-0.1.1-cp39-cp39-macosx_10_9_x86_64.whl (401.9 kB view details)

Uploaded Mar 26, 2026 CPython 3.9macOS 10.9+ x86-64

cutysoup-0.1.1-cp38-cp38-win_amd64.whl (386.3 kB view details)

Uploaded Mar 26, 2026 CPython 3.8Windows x86-64

cutysoup-0.1.1-cp38-cp38-musllinux_1_2_x86_64.whl (1.5 MB view details)

Uploaded Mar 26, 2026 CPython 3.8musllinux: musl 1.2+ x86-64

cutysoup-0.1.1-cp38-cp38-manylinux2014_x86_64.manylinux_2_17_x86_64.whl (454.9 kB view details)

Uploaded Mar 26, 2026 CPython 3.8manylinux: glibc 2.17+ x86-64

cutysoup-0.1.1-cp38-cp38-macosx_10_9_x86_64.whl (401.6 kB view details)

Uploaded Mar 26, 2026 CPython 3.8macOS 10.9+ x86-64

File details

Details for the file cutysoup-0.1.1.tar.gz.

File metadata

Download URL: cutysoup-0.1.1.tar.gz
Upload date: Mar 26, 2026
Size: 614.1 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for cutysoup-0.1.1.tar.gz
Algorithm	Hash digest
SHA256	`1d570b1acf5596517e04bf0814f5e3e716366684748c21040387ef3bb7d9a33b`
MD5	`50145ce01abbed3fbf459c05a18ceba3`
BLAKE2b-256	`8f71ec601c2d29462b8d7101bd5824f808ed12b92745a58a6bbbc34afbe0c8b4`

Algorithm	Hash digest
SHA256	`dbdc7e05fcc9d2cf084466cb5fc68c9a7eb0f7d14b15a260f33a96658bf0e840`
MD5	`b48e7187c93e55bfa4f575f547660c7e`
BLAKE2b-256	`2ee51fbdd2b5ef3596673434c6d9ac0dd300a3e9a2c6a2bda23b68fd24af81ea`

Algorithm	Hash digest
SHA256	`8c9238c4c2f57fe833131a0006499aa9001f0f99ed49a42b85bdc63b9db01d26`
MD5	`0c8a4501e356568ac1899ce824865ec7`
BLAKE2b-256	`5f662bc96c92797861c2338f647a05727e861e90d95388eeec3dcc867efd920e`

Algorithm	Hash digest
SHA256	`bc7b2d8127d67cacf140817dd2c9c2adfe91b41142fcf2c764f76ee88e37a982`
MD5	`35eeaebfa4c9c239f20d1f8aea802a1a`
BLAKE2b-256	`8f2d52888adfc181fcb7c20debe96fe6df1a45b5ac09f2f065da671c7bf5cabd`

Algorithm	Hash digest
SHA256	`1399dca8ee67081b28b584b2ba6d90a0f4a8189b4c82455a14d7482ad2a56fc8`
MD5	`299e91bb4a8035dcd69baffac3995278`
BLAKE2b-256	`e79845fba20b47a35a0cc2c41a8160260a132bdd1b56f819688caeb3ca88d901`

Algorithm	Hash digest
SHA256	`6a595a482b216b5f680ec827929213715671d9a99728855a2fbda9169e2bcd88`
MD5	`77e1dc107d00a34efe2b7a01337ffe29`
BLAKE2b-256	`68642edfd430b331333e4a911895fc8fa99bf56b18c9dc60ea391c5420915d1e`

Algorithm	Hash digest
SHA256	`49283efc60b33bbb533bf80d3e151708f14f1f3dd3165de1422e81e0467a1eae`
MD5	`b2fd30938e4836cdc211662a2ca6b0e0`
BLAKE2b-256	`5c08447539f7366b497f2e6f5b2a674c8abdae82cd7c238efc7c7dc24010e50d`

Algorithm	Hash digest
SHA256	`2829248bde188dc9d66977f8f875fa07a7e241ee744d525d3364315e4ab74118`
MD5	`e7d24270547527f6063a99d8854f71bc`
BLAKE2b-256	`fb7d1ed1635cdeba5b1edb5c51bc1b27f5e816fc8cfd434bc12822c7b084cf3e`

Algorithm	Hash digest
SHA256	`e1b78d77fb710878299f3fbd1a274a5787bfe93d767ca9bce7cf81a3ba102cf2`
MD5	`cd6dee047ca69c25389be555c75fe8da`
BLAKE2b-256	`c50b4479ca5a1d2aa9323371e7b9aeea40b6e2e26d9566bc0fa172e76f834e6c`

Algorithm	Hash digest
SHA256	`ba6981e89c133e5c4193f0f7a8bf537a272b073de456997178e8ab87bba65a6f`
MD5	`c882dba667c3e4ffd0fb3931903633f7`
BLAKE2b-256	`3f9288dda6bfb55a61d8a144d714a48454005465256bdf70f487372d4fd0bee1`

Algorithm	Hash digest
SHA256	`e75927293612a8e3410dfb240765a4791b8147f4baec00cb6160ee102a0fc343`
MD5	`b43ee590e0dfc1bfe236b19cacc6d23a`
BLAKE2b-256	`6c8d287fc5a2a3dee773ef8b084382dc448ecdd79afd8b00ddedab683fc85d60`

Algorithm	Hash digest
SHA256	`740dbc4be797de069d88fa567d8811f2532747adc8d52f2c76066e328ce8ce74`
MD5	`059ed2137a5a8f4443e13fd179a1ad70`
BLAKE2b-256	`efee6ec7ff44252e03a39b93530bcf79e15b007e85582136a7975a65001c02ba`

Algorithm	Hash digest
SHA256	`bd79af0a81b79e212d76b4d07c4bfaf4e8024d11fe03549b92afc8c6febb6ec9`
MD5	`52fa567168a899ff8e30491ed40b14f8`
BLAKE2b-256	`7b555be9ffb70729a038bab2f559ca9473acba5b06105738f95e4c0942e9760e`

Algorithm	Hash digest
SHA256	`0cfc73ebc1a2f2724ddf28d3f7f0fd02da9dfc5081e93f693178e9d3d20bae8f`
MD5	`384dbecc8e401535bea24bcb990f2845`
BLAKE2b-256	`0af0ce96f039d4e6beb1a0ba3d225cd03a14e91e3f9e6d5032fe1de7b6f3b2e2`

Algorithm	Hash digest
SHA256	`b1ff4695773baf6991b43dc5ede1282289984cc4fc6a3a99e97cfb9cd6f90d78`
MD5	`9541eda458303d0b6893ee34d0c5bcb0`
BLAKE2b-256	`fd812020137ed2b5bdf6f27f8d7cb0d40e79fd945e3e60b73c210e301da892ed`

Algorithm	Hash digest
SHA256	`b0af7d6d2737a742f5ba9872d5cf56b70ba9c78c7e03248b91e5b90514e16b8f`
MD5	`09fd397a58f1889ed20a6923e930249a`
BLAKE2b-256	`f3c334d4c5ed9cec7d5963bfec3ede42ba7cff9e70e6cd4840969a968a0b9790`

Algorithm	Hash digest
SHA256	`61bb44588b3b74b52b50506af0c7c68a9b945f8542daf354367eea8efd7c3a58`
MD5	`d4ce93f469b5c48e0bf91e038367acee`
BLAKE2b-256	`4db2d32cc1deaf98bbe19727dfe9531b52e0151bd47026520bc598fb58196aec`

Algorithm	Hash digest
SHA256	`45d80ab8be411b55a2a887a442c11e385df01cbbc38f1b39796bde4db37dff4a`
MD5	`d839198437e1ea877d0e5b4d598bd074`
BLAKE2b-256	`2ccebacff3e3ea9d4dcf9b9d18166cf2859f7c468e356bf41496e5bd8ff1d2e9`

Algorithm	Hash digest
SHA256	`15e44e9847a3107bbe21c7272757291fea979b1d5f19e80a562de86797c3fe22`
MD5	`54fc7971c60d47e72ab8aeb1fdab63dc`
BLAKE2b-256	`2b784cf1234652e8affbbe76d31a13f982040fe68105d65a3dace6ce93f0b616`

Algorithm	Hash digest
SHA256	`02eae4f7b7df5150a906e5e59d89c3db2c800f6a0b3a5c492da4f74843b07389`
MD5	`93aac37ca4782c47713c6af98fc819e8`
BLAKE2b-256	`451582872d20c21018b64d86359bd299b5508318c12bc9651a64f46523dbc8ea`

Algorithm	Hash digest
SHA256	`acc63126281f6dfdbfc16fde689dfc59c7bf6a602270aceaf52e18141d746eb6`
MD5	`6a638a7e476502235cf21cb62c70cc77`
BLAKE2b-256	`5df38effc788020f9d62cec8eaa23ed10eb4f7abe5a05f34f05568522af99765`

cutysoup 0.1.1

Navigation

Verified details

Maintainers

Unverified details

Project links

Meta

Classifiers

Project description

CutySoup

Why CutySoup

Install

Quickstart

Performance

Extra APIs (Optional)

Development

License

Project details

Verified details

Maintainers

Unverified details

Project links

Meta

Classifiers

Release history Release notifications | RSS feed

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

File metadata

File hashes

Provenance

Algorithm	Hash digest
SHA256	`6b120950b9561c814c3407f1971f88e25e15f97dda510676268eb2051aaa4f59`
MD5	`f2142411366f88c6d6ba3e0e112d248d`
BLAKE2b-256	`8f2c7867a8f9ed8ac7c317d37d2af60f476165d7c05c11a1e80f6b980236e3ca`

Algorithm	Hash digest
SHA256	`aceb2bbfd2c6d4b81c758f102a821605d4b851fc5a98de0d9872f2c31037d00e`
MD5	`a26f0eff9c60477d194c5c51be0b6a52`
BLAKE2b-256	`3acc4971e5051df24c42ef0884c7cf20215968aa746590964eeee359d91cbf72`

Algorithm	Hash digest
SHA256	`a1e79a54d83673286a8ad7cda4da6df934c067e6b3a16a038c05e95f2b1d2ae8`
MD5	`d4def7ff663e38da95016161f537a32f`
BLAKE2b-256	`e43ee0ec76f5106036ea59a2dc3330516aff269edd121f618f8690603fb9f9c4`

Algorithm	Hash digest
SHA256	`1bb658332baba8339d263e29873c0717bf199c493de8d5c628d290c36bfb94c4`
MD5	`24e216a09f3b829faf192157470e9bdb`
BLAKE2b-256	`f38d25dbce5f50e9e3bf538542b3f2a26759eb4ae3e17efb33448d6e1f184120`

Algorithm	Hash digest
SHA256	`374449bee0bda5f8e856c2841dd02f922dc1fb5c72f3229da544c41a760d55a3`
MD5	`0835a2249887dfbb350d4e7d845efe4b`
BLAKE2b-256	`9394641fe9a9505bcfb2af0bdb4f8f1abfe6de395c486888538092de0f7f489a`

Algorithm	Hash digest
SHA256	`661b74691a780a10c3fc151fde4c9e3bc5a6fb8565d8146caf73947cee295386`
MD5	`aefc8cc5dbdfa7a9025d737b0f62dc38`
BLAKE2b-256	`a72c820ce8389397e065800d2c7c9f43fd7bfd999fdb828ea812b0d565d4d412`

Algorithm	Hash digest
SHA256	`2d852a133dae61adab8817e783144ce8a42e1ad766f86f2021b5dfd50becf8d6`
MD5	`5e61b7472e484bfd1f2652a177f36e8c`
BLAKE2b-256	`1f5318b6e7c4e4e9f469fdb791ab2575fd96018e9d9cc4cc348c1a311cb4c6d0`

Algorithm	Hash digest
SHA256	`68c6672d6100770cfe1d0ccfc985ecabaf2b90b3815127d54fd56b7c786b34af`
MD5	`5507588f3db425598c6c12f11d9126e2`
BLAKE2b-256	`670dfcf186124b4e4877410cdecd589e0306fcdb0baecce473fb3975ed83b5dd`

Algorithm	Hash digest
SHA256	`54019a333dcb97dc48331eea5027bc07a262344a0a7bceb141f39a57c17a1ac6`
MD5	`5267dc34dce3c37f5450c9edbac6dc1e`
BLAKE2b-256	`72b5580d7d38bbebfc5b310d05d1217b75c61a0791d628689f03f7c4d9034c34`