soupsieve

library2.9.2pypypi✓ verified 25d ago

SoupSieve is a modern CSS selector implementation for Beautiful Soup, currently at version 2.8.3. It is actively maintained and follows a regular release cadence, with recent updates addressing various fixes and improvements.

web-framework data

pip install soupsieve

github ↗package ↗

INSTALL

IMPORT

SIG · SOUPSIEVE

soupsieve

web-frameworkpythonv2.9.2

Install

1.6s avg

Import

—

Disk

16MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v2.9.2 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 18MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 1.6s · import 0.000s · 19MB

16MB installed

● package 16MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

SoupSieve

✓ import soupsieve

✗ from soupsieve import SoupSieve

A simple example demonstrating how to use SoupSieve to parse HTML and select elements using CSS selectors.

from soupsieve import SoupSieve # Example usage of SoupSieve html = '<html><body><div class="content">Hello, World!</div></body></html>' soup = SoupSieve(html) elements = soup.select('.content') print(elements[0].text) # Output: Hello, World!

Debug

Known issues

breakingSoupSieve 2.8 drops support for Python 3.8 and earlier versions.

fix

Upgrade your Python environment to version 3.9 or later to ensure compatibility.

affects: 2.8

deprecatedThe ':in-range' and ':out-of-range' pseudo-classes are deprecated in SoupSieve 2.8.

fix

Avoid using ':in-range' and ':out-of-range' pseudo-classes in your CSS selectors.

affects: 2.8

breakingThe `soupsieve` library requires `beautifulsoup4` as a dependency. `ModuleNotFoundError: No module named 'bs4'` indicates that `beautifulsoup4` is not installed in the environment.

fix

Ensure `beautifulsoup4` is installed. You can install it using `pip install beautifulsoup4`.

affects: 2.8

breakingSoupSieve requires Beautiful Soup 4 ('bs4') as a dependency. The module 'bs4' was not found.

fix

Install the 'beautifulsoup4' package using 'pip install beautifulsoup4'.

affects: 2.8

Upgrade

Version history

2.9.2latest on PyPI · released Aug 7, 2026

Audit

Dependencies

beautifulsoup4requiredSoupSieve is designed to work seamlessly with Beautiful Soup, enhancing its CSS selector capabilities.

Agent activity

14 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/facelessuser/soupsieve ↗

packagehttps://pypi.org/project/soupsieve/ ↗