CSS selector support for BeautifulSoup.
Switch branches/tags
Nothing to show
Latest commit 83cb691 Mar 28, 2013 @simonw Merge pull request #5 from peteboere/patch-1
Attribute names (e.g aria-*) now match - thanks, Pete Boere
Failed to load latest commit information.
__init__.py __init__.py file, so checkouts can be treated as Python packages Feb 28, 2007
soupselect.py Attribute names (e.g aria-*) now match. Mar 22, 2013


A single function, select(soup, selector), that can be used to select items
from a BeautifulSoup instance using CSS selector syntax.

Currently supports type selectors, class selectors, id selectors, attribute
selectors and the descendant combinator.

soupselect requires BeautifulSoup v3.0.3 or above; it will not work with v2.x

Example usage:

    >>> from BeautifulSoup import BeautifulSoup as Soup
    >>> from soupselect import select
    >>> import urllib
    >>> soup = Soup(urllib.urlopen('http://slashdot.org/'))
    >>> select(soup, 'div.title h3')
    <span><a href='//science.slashdot.org/'>Science</a>:</span> ...
    </h3>, <h3>
    <a href='//slashdot.org/articles/07/02/28/0120220.shtml'>Star Trek To ...
    ... ]

You can also monkey-patch the BeautifulSoup class itself:

    >>> from BeautifulSoup import BeautifulSoup as Soup
    >>> import soupselect; soupselect.monkeypatch()
    >>> import urllib
    >>> soup = Soup(urllib.urlopen('http://slashdot.org/'))
    >>> soup.findSelect('div.title h3')