Fast HTML parsing for Python with BeautifulSoup-style ergonomics.

These details have been verified by PyPI

Project links

GitHub Statistics

Maintainers

joaonevess

These details have not been verified by PyPI

Project description

rustysoup

BeautifulSoup ergonomics. Rust-speed HTML extraction.

rustysoup is for scrapers, crawlers, and data pipelines that like BeautifulSoup's API but need much higher throughput. Keep the workflow you know: parse HTML, find tags, select with CSS, read attributes, and extract text.

from rustysoup import BeautifulSoup

soup = BeautifulSoup(html)

products = [
    {
        "name": card.select_one("a").get_text(strip=True),
        "url": card.select_one("a")["href"],
        "price": card.select_one(".price").get_text(strip=True),
    }
    for card in soup.select(".product")
]

Install

pip install rustysoup

Requires Python 3.10+.

Why rustysoup

Use BeautifulSoup-style code when BeautifulSoup is the bottleneck.
Move existing scrapers over with a small import change.
Rust parser core built for high-throughput extraction.
Fast CSS selectors, traversal, attributes, and text extraction.
Wheels for Python 3.10+ on Linux, macOS, and Windows.

Usage

from rustysoup import BeautifulSoup

html = """
<html>
  <head><title>Catalog</title></head>
  <body>
    <div class="product" data-id="1">
      <a href="/products/1">Coffee grinder</a>
      <span class="price">$39</span>
    </div>
  </body>
</html>
"""

soup = BeautifulSoup(html)

assert soup.title.text == "Catalog"
assert soup.find("div", class_="product").get("data-id") == "1"
assert soup.find("a")["href"] == "/products/1"
assert soup.select("div.product a[href]")[0].get_text(strip=True) == "Coffee grinder"
assert soup.find("missing") is None

For new code, Soup is the same parser with a shorter name:

from rustysoup import Soup

soup = Soup("<p>Hello <strong>Rust</strong></p>")
print(soup.find("p").get_text(" ", strip=True))

BeautifulSoup Migration

Most extraction code can start with a single import change:

# Before
from bs4 import BeautifulSoup

# After
from rustysoup import BeautifulSoup

Common constructor forms are supported:

BeautifulSoup(html)
BeautifulSoup(html, "html.parser")
BeautifulSoup(html, "lxml")
BeautifulSoup(html, features="html.parser")

Parser names such as "html.parser" and "lxml" are accepted as compatibility hints and routed through the Rust engine.

Common APIs:

soup.find("a")
soup.find("div", class_="product")
soup.find_all("a", href=True)
soup.select("div.product a[href]")
soup.get_text(" ", strip=True)

Benchmarks

rustysoup is built for high-throughput extraction without forcing users into a low-level parser API.

Measured on 104 public HTML pages, 19.83 MiB total, release build, CPython 3.14.5, macOS arm64. Lower is better.

Parser	Parse only	Page summary	Link graph	Selector-heavy
rustysoup	`65.47 ms`	`92.36 ms`	`292.60 ms`	`93.14 ms`
selectolax Lexbor	`168.72 ms`	`223.97 ms`	`415.35 ms`	`246.28 ms`
selectolax Modest	`213.64 ms`	`275.98 ms`	`458.94 ms`	`286.66 ms`
lxml.html	`268.88 ms`	`345.77 ms`	`526.00 ms`	`517.36 ms`
html5_parser	`380.05 ms`	`453.78 ms`	`632.53 ms`	`624.89 ms`
BeautifulSoup `lxml`	`1773.66 ms`	`1958.49 ms`	`2105.44 ms`	`4197.38 ms`
BeautifulSoup `html.parser`	`2342.20 ms`	`2529.23 ms`	`2676.43 ms`	`4755.78 ms`

Architecture

The Python API runs on a custom Rust arena DOM optimized for parsing, traversal, selector matching, and Python object creation.

Development

maturin develop
pytest

Release checks:

cargo fmt --check
cargo clippy --all-targets --all-features -- -D warnings
cargo test --all-features
maturin develop --release
pytest

Status

rustysoup is early, active, and designed for production-style extraction workloads. If you find a parser difference, missing BeautifulSoup API, or performance regression, please open an issue with a small HTML sample and expected output.

For benchmark methodology and corpus collection, see docs/benchmarks.md and docs/corpus.md.

Project details

These details have been verified by PyPI

Project links

GitHub Statistics

Maintainers

joaonevess

These details have not been verified by PyPI

Release history Release notifications | RSS feed

0.1.2

May 20, 2026

0.1.1

May 18, 2026

This version

0.1.0

May 18, 2026

Download files

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

Source Distribution

rustysoup-0.1.0.tar.gz (115.5 kB view details)

Uploaded May 18, 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.

rustysoup-0.1.0-cp314-cp314-win_amd64.whl (1.4 MB view details)

Uploaded May 18, 2026 CPython 3.14Windows x86-64

rustysoup-0.1.0-cp314-cp314-manylinux_2_28_x86_64.whl (1.5 MB view details)

Uploaded May 18, 2026 CPython 3.14manylinux: glibc 2.28+ x86-64

rustysoup-0.1.0-cp314-cp314-macosx_11_0_arm64.whl (1.3 MB view details)

Uploaded May 18, 2026 CPython 3.14macOS 11.0+ ARM64

rustysoup-0.1.0-cp314-cp314-macosx_10_15_x86_64.whl (1.4 MB view details)

Uploaded May 18, 2026 CPython 3.14macOS 10.15+ x86-64

rustysoup-0.1.0-cp313-cp313-win_amd64.whl (1.4 MB view details)

Uploaded May 18, 2026 CPython 3.13Windows x86-64

rustysoup-0.1.0-cp313-cp313-manylinux_2_28_x86_64.whl (1.5 MB view details)

Uploaded May 18, 2026 CPython 3.13manylinux: glibc 2.28+ x86-64

rustysoup-0.1.0-cp313-cp313-macosx_11_0_arm64.whl (1.3 MB view details)

Uploaded May 18, 2026 CPython 3.13macOS 11.0+ ARM64

rustysoup-0.1.0-cp313-cp313-macosx_10_15_x86_64.whl (1.4 MB view details)

Uploaded May 18, 2026 CPython 3.13macOS 10.15+ x86-64

rustysoup-0.1.0-cp312-cp312-win_amd64.whl (1.4 MB view details)

Uploaded May 18, 2026 CPython 3.12Windows x86-64

rustysoup-0.1.0-cp312-cp312-manylinux_2_28_x86_64.whl (1.5 MB view details)

Uploaded May 18, 2026 CPython 3.12manylinux: glibc 2.28+ x86-64

rustysoup-0.1.0-cp312-cp312-macosx_11_0_arm64.whl (1.3 MB view details)

Uploaded May 18, 2026 CPython 3.12macOS 11.0+ ARM64

rustysoup-0.1.0-cp312-cp312-macosx_10_15_x86_64.whl (1.4 MB view details)

Uploaded May 18, 2026 CPython 3.12macOS 10.15+ x86-64

rustysoup-0.1.0-cp311-cp311-win_amd64.whl (1.4 MB view details)

Uploaded May 18, 2026 CPython 3.11Windows x86-64

rustysoup-0.1.0-cp311-cp311-manylinux_2_28_x86_64.whl (1.5 MB view details)

Uploaded May 18, 2026 CPython 3.11manylinux: glibc 2.28+ x86-64

rustysoup-0.1.0-cp311-cp311-macosx_11_0_arm64.whl (1.3 MB view details)

Uploaded May 18, 2026 CPython 3.11macOS 11.0+ ARM64

rustysoup-0.1.0-cp311-cp311-macosx_10_15_x86_64.whl (1.4 MB view details)

Uploaded May 18, 2026 CPython 3.11macOS 10.15+ x86-64

rustysoup-0.1.0-cp310-cp310-win_amd64.whl (1.4 MB view details)

Uploaded May 18, 2026 CPython 3.10Windows x86-64

rustysoup-0.1.0-cp310-cp310-manylinux_2_28_x86_64.whl (1.5 MB view details)

Uploaded May 18, 2026 CPython 3.10manylinux: glibc 2.28+ x86-64

rustysoup-0.1.0-cp310-cp310-macosx_11_0_arm64.whl (1.3 MB view details)

Uploaded May 18, 2026 CPython 3.10macOS 11.0+ ARM64

rustysoup-0.1.0-cp310-cp310-macosx_10_15_x86_64.whl (1.4 MB view details)

Uploaded May 18, 2026 CPython 3.10macOS 10.15+ x86-64

File details

Details for the file rustysoup-0.1.0.tar.gz.

File metadata

Download URL: rustysoup-0.1.0.tar.gz
Upload date: May 18, 2026
Size: 115.5 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for rustysoup-0.1.0.tar.gz
Algorithm	Hash digest
SHA256	`cafd5b5cefb0a1af9e84111806f1bbe2e89bd2671d25af17e153e97a017bb435`
MD5	`b69a38063cff5ce660016959f97f524b`
BLAKE2b-256	`920b3328647225def8f65da9e38e2c0fb6249df3cfbbba32efeef8572bf02eda`

Algorithm	Hash digest
SHA256	`ea7b9f0dd538667bb9b50e9275a41b6f9a894ac467adad86d0581cd0dd510f14`
MD5	`63fd2c9e087a29a52cbc644eaf9cfc05`
BLAKE2b-256	`2c556dcafd791233ff81027a38c83799c5214294684818729adbbdca4550844b`

Algorithm	Hash digest
SHA256	`c2ebb31c31d1134bbc7b3f86ab552f2309731b96ea7643ddfc5a3355de0b7b90`
MD5	`3eebad8ac54edacfea9967e6aa03fe2b`
BLAKE2b-256	`32f5350a513483c9ee0b69e14dd6b0c01add17c219586e2e37fab3a0f5118adf`

Algorithm	Hash digest
SHA256	`109bae7e1426355ad00dd2f5ec81551a069850071003edb9a09cf28c2194407e`
MD5	`26a229cb5a3f4a2c35c76ce4514a3f02`
BLAKE2b-256	`4024b86ba6b3ae5a268242cfd41ef5ac3e152bbfcafd4323c59218487efba64f`

Algorithm	Hash digest
SHA256	`267afaffd7e80188bef770784e025520a40df35cf3cde19d5bda59a63e957143`
MD5	`301b08601b62139c9f29034b6362a9f7`
BLAKE2b-256	`78638c5cd8daabdaa24bd462d099fbefed25f46e70f9b190c7d3947b4591aeb0`

Algorithm	Hash digest
SHA256	`9b49c6d34501e77e42946e8c2f51f4e3d5e5c4c54fe3978af2c6a6fa8cd6e688`
MD5	`9e4dd16be31223d183bddb91f9374902`
BLAKE2b-256	`ed8081570515702c3b375cf2ab885a21a13bb507e9250e1324fd9dd46f818105`

Algorithm	Hash digest
SHA256	`1a0a52cb451023916986c4c173fe0caa6b6c2c5a60c0908fc3b6f13f29c267f8`
MD5	`546e3273ea10d404929ed9f2d43d347e`
BLAKE2b-256	`448c79e3743c8c192f536c5235439b7e1006896c00c2c49eda7f3d844aad4df4`

Algorithm	Hash digest
SHA256	`57bcf99a899cca4ecbe8bf353b8dc47ead974130864b5833ca75d370b4e52153`
MD5	`dc1a18c88ef27e510b0de1fd9ca9862c`
BLAKE2b-256	`1d52e9abd431f387e6d0fcd1da9b61df6c847f8ac1f70f78ef6460227951ca5b`

Algorithm	Hash digest
SHA256	`1a3b8f7f40e10f18f5749b27c02f94f2207ce69d7fe39c50a7ad6c15e96089cd`
MD5	`7b617fb9610cd0ab9792027d2195cb35`
BLAKE2b-256	`0f8a0bd941b107c6c0c0390db889a34ca47d936cf516ae48e17b90497c38012d`

Algorithm	Hash digest
SHA256	`c06c3d3cdddec7d4bb6c6fa966eec641317a18f7968d51e6d9211dfa21264c87`
MD5	`16eb37d736c8de62f88fd61e9e5f0a94`
BLAKE2b-256	`9c6a7ef0bfc85bbff56a7ee4afee432a9bd8868c0bb32eb85891b9eb7c53bd15`

Algorithm	Hash digest
SHA256	`237aadb3ae52ff8d693967c1c204d74754a99b2141bcb6241ad380493992db7a`
MD5	`d606b7b2e4cc2e3a4c11196ea7fec79e`
BLAKE2b-256	`88361aad24ddf315192e413cf6614ac8e60d5fa4ad7bcd3cc73963bffe47467c`

Algorithm	Hash digest
SHA256	`27e083b8c2b60a4f9ae64142f87742fbb3349e19bab89efd8d1ce0ee6a90746c`
MD5	`e506e6d6c82d25805dc74f4570b219e8`
BLAKE2b-256	`a4898f928373a1e8071f848809081649f459fccc18b2770d204da47b316f6c6b`

Algorithm	Hash digest
SHA256	`8379582a6fc249280c81c70c7778f2531cacd97c2f3f17ad5085e06357bdc2e6`
MD5	`81db33ec60e1d21d4621b5e87868fb1f`
BLAKE2b-256	`ad1966e185d90f2e09d0ba6e3d4ddd6f392628da2ea537dffe1568be0d8db15a`

Algorithm	Hash digest
SHA256	`b7032c9fbc551e457ed717b84f885bb74ec9bf8325182789ffcf080f972f1f03`
MD5	`e0820bb6ef243980c63381c76871778b`
BLAKE2b-256	`6a11cd8f8fed0cd08546d80cb8f2643450cfaa7b33454715f97a39b14b7add6f`

Algorithm	Hash digest
SHA256	`895dd1bab04f731fa0f6812a7f44084deeb40a2492d1227c321d5a3b513d69e3`
MD5	`0986aefef0bc866fd39ef92aee3b447b`
BLAKE2b-256	`087e472e4fed17eb254f7d765638e11787e1161794b7bb44eb1a2a11caef10ce`

Algorithm	Hash digest
SHA256	`26c4c501e151a3cf9f470126da14e875739764c3da9d94806c41271319c7fa49`
MD5	`44aba7eff003378131a2f5b851e961b5`
BLAKE2b-256	`cb640c4de5c7f82cd30a11ecedb9176dc0ae010dbf8c99bee8fc29e4af9df1de`

Algorithm	Hash digest
SHA256	`b5c7102e067837f0a271b79140605f8dc566b4ca435d72ba1ae18122e62dca82`
MD5	`31b609fcec16520bbd546fe65c4c82cc`
BLAKE2b-256	`436c9723b420dd6f4f91a0912f591d97875178a72ad6bbf887c36859d59d1a58`

Algorithm	Hash digest
SHA256	`b973a56e44a694e9691585483060bd2fa049cfff9bcf71a88cd83959ec57c7c5`
MD5	`dfcd5836cb3de2a9ae6dac1d08c6f8e4`
BLAKE2b-256	`567fabd5fc1421a43898acd9ed4598530e429e465bb69e1be5f3a41165c7b820`

Algorithm	Hash digest
SHA256	`1ee0783c736f0c30e03c3e085db945e5ba7d1357dcca926508b396c6d5b75267`
MD5	`725953785c50044c2f59337c8e0ee7eb`
BLAKE2b-256	`d4c6d85b1655b8f2e1a912f335146f15211aaf555fc52caac8eebcfaf79238d0`

Algorithm	Hash digest
SHA256	`b019391b59111d2e5a6ee8908146da0a80cfc3e045a697e92bdae69e19c9aaeb`
MD5	`203742abd168b4ef6b1af956eedf60ff`
BLAKE2b-256	`37bbb3bb9d6cb09e549a1a9e73125901f22dedfd2e8e3fce5b96840b342d83b3`

Algorithm	Hash digest
SHA256	`39d59620c799c4b79fa246a740412ee1044a18b9ae2417e336e79c2f0c4b1fea`
MD5	`6d2c02a463000e0af052055182baf4fd`
BLAKE2b-256	`774a1ac67ae8add97081698f1da71839c94cdf1ec081bdc8c9241596dd092105`

rustysoup 0.1.0

Navigation

Verified details

Project links

GitHub Statistics

Maintainers

Unverified details

Meta

Classifiers

Project description

rustysoup

Install

Why rustysoup

Usage

BeautifulSoup Migration

Benchmarks

Architecture

Development

Status

Project details

Verified details

Project links

GitHub Statistics

Maintainers

Unverified details

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