~i1 % S r SSKJr SSKJr SSKJrJrJrJ r J
r
J r J r SSK
r
SSKJr \ ( a SSKJr SSKJr SS KJrJr S
\S ' SSKr " S
S\5 rg! \ a Sr\
R2 " S 5 N(f = f)a, Integration code for CSS selectors using `Soup Sieve `_ (pypi: ``soupsieve``).
Acquire a `CSS` object through the `element.Tag.css` attribute of
the starting point of your CSS selector, or (if you want to run a
selector against the entire document) of the `BeautifulSoup` object
itself.
The main advantage of doing this instead of using ``soupsieve``
functions is that you don't need to keep passing the `element.Tag` to be
selected against, since the `CSS` object is permanently scoped to that
`element.Tag`.
) annotations)
ModuleType)AnycastIterableIteratorMutableSequenceOptional
TYPE_CHECKINGN)_NamespaceMapping) SoupSieve)element) ResultSetTagOptional[ModuleType] soupsievezEThe soupsieve package is not installed. CSS selectors cannot be used.c X \ rS rSrSrSSS jjrSS jr SS jrSS jr S SS jjr S SS jjr
S SS
jjr S SS jjr S SS jjr
S S S
jjr S S S jjrSrg) CSS- at A proxy object against the ``soupsieve`` library, to simplify its
CSS selector API.
You don't need to instantiate this class yourself; instead, use
`element.Tag.css`.
:param tag: All CSS selectors run by this object will use this as
their starting point.
:param api: An optional drop-in replacement for the ``soupsieve`` module,
intended for use in unit tests.
Nc J Uc [ nUc [ S5 eX l Xl g )NzLCannot execute CSS selectors because the soupsieve package is not installed.)r NotImplementedErrorapitag)selfr r s D/home/mande/repo/quber/.venv/lib/python3.13/site-packages/bs4/css.py__init__ CSS.__init__; s- ;C ;%^
c x [ c [ S5 e[ [ U R R U5 5 $ )zEscape a CSS identifier.
This is a simple wrapper around `soupsieve.escape() `_. See the
documentation for that function for more information.
zMCannot escape CSS identifiers because the soupsieve package is not installed.)r r r strr escape)r idents r r!
CSS.escapeE s6 %_
C /00r c [ X R R 5 ( d Uc U R R nU$ )z%Normalize a dictionary of namespaces.)
isinstancer r
r _namespaces)r nsselects r _nsCSS._nsQ s3 &(("4"455"* %%B r c SSK Jn U" SU5 $ )a Normalize a list of results to a py:class:`ResultSet`.
A py:class:`ResultSet` is more consistent with the rest of
Beautiful Soup's API, and :py:meth:`ResultSet.__getattr__` has
a helpful error message if you try to treat a list of results
as a single result (a common mistake).
r )r N)bs4r )r resultsr s r _rsCSS._rs\ s "w''r c \ U R R " XR X!5 U40 UD6$ )a Pre-compile a selector and return the compiled object.
:param selector: A CSS selector.
:param namespaces: A dictionary mapping namespace prefixes
used in the CSS selector to namespace URIs. By default,
Beautiful Soup will use the prefixes it encountered while
parsing the document.
:param flags: Flags to be passed into Soup Sieve's
`soupsieve.compile() `_ method.
:param kwargs: Keyword arguments to be passed into Soup Sieve's
`soupsieve.compile() `_ method.
:return: A precompiled selector object.
:rtype: soupsieve.SoupSieve
)r compiler) r r(
namespacesflagskwargss r r1 CSS.compilei s) 2 xx (DeVvVVr c r U R R " XR U R X!5 U40 UD6$ )aY Perform a CSS selection operation on the current Tag and return the
first result, if any.
This uses the Soup Sieve library. For more information, see
that library's documentation for the `soupsieve.select_one() `_ method.
:param selector: A CSS selector.
:param namespaces: A dictionary mapping namespace prefixes
used in the CSS selector to namespace URIs. By default,
Beautiful Soup will use the prefixes it encountered while
parsing the document.
:param flags: Flags to be passed into Soup Sieve's
`soupsieve.select_one() `_ method.
:param kwargs: Keyword arguments to be passed into Soup Sieve's
`soupsieve.select_one() `_ method.
)r
select_oner r) r2 s r r8 CSS.select_one s7 4 xx"" HHdhhz :E
EK
r c
Uc SnU R U R R " XR U R X!5 X440 UD65 $ )aq Perform a CSS selection operation on the current `element.Tag`.
This uses the Soup Sieve library. For more information, see
that library's documentation for the `soupsieve.select() `_ method.
:param selector: A CSS selector.
:param namespaces: A dictionary mapping namespace prefixes
used in the CSS selector to namespace URIs. By default,
Beautiful Soup will pass in the prefixes it encountered while
parsing the document.
:param limit: After finding this number of results, stop looking.
:param flags: Flags to be passed into Soup Sieve's
`soupsieve.select() `_ method.
:param kwargs: Keyword arguments to be passed into Soup Sieve's
`soupsieve.select() `_ method.
r )r. r r( r r) r r( r3 limitr4 r5 s r r(
CSS.select sK 8 =Exx HHOO$((:">
PV
r c r U R R " XR U R X!5 X440 UD6$ )a Perform a CSS selection operation on the current `element.Tag`.
This uses the Soup Sieve library. For more information, see
that library's documentation for the `soupsieve.iselect()
`_
method. It is the same as select(), but it returns a generator
instead of a list.
:param selector: A string containing a CSS selector.
:param namespaces: A dictionary mapping namespace prefixes
used in the CSS selector to namespace URIs. By default,
Beautiful Soup will pass in the prefixes it encountered while
parsing the document.
:param limit: After finding this number of results, stop looking.
:param flags: Flags to be passed into Soup Sieve's
`soupsieve.iselect() `_ method.
:param kwargs: Keyword arguments to be passed into Soup Sieve's
`soupsieve.iselect() `_ method.
)r iselectr r) r; s r r? CSS.iselect s7 > xx HHdhhz :E
LR
r c r U R R " XR U R X!5 U40 UD6$ )aU Find the `element.Tag` closest to this one that matches the given selector.
This uses the Soup Sieve library. For more information, see
that library's documentation for the `soupsieve.closest()
`_
method.
:param selector: A string containing a CSS selector.
:param namespaces: A dictionary mapping namespace prefixes
used in the CSS selector to namespace URIs. By default,
Beautiful Soup will pass in the prefixes it encountered while
parsing the document.
:param flags: Flags to be passed into Soup Sieve's
`soupsieve.closest() `_ method.
:param kwargs: Keyword arguments to be passed into Soup Sieve's
`soupsieve.closest() `_ method.
)r closestr r) r2 s r rB CSS.closest s7 8 xx HHdhhz :E
EK
r c [ [ U R R " XR U R X!5 U40 UD65 $ )a7 Check whether or not this `element.Tag` matches the given CSS selector.
This uses the Soup Sieve library. For more information, see
that library's documentation for the `soupsieve.match()
`_
method.
:param: a CSS selector.
:param namespaces: A dictionary mapping namespace prefixes
used in the CSS selector to namespace URIs. By default,
Beautiful Soup will pass in the prefixes it encountered while
parsing the document.
:param flags: Flags to be passed into Soup Sieve's
`soupsieve.match()
`_
method.
:param kwargs: Keyword arguments to be passed into SoupSieve's
`soupsieve.match()
`_
method.
)r boolr matchr r) r2 s r rF CSS.match
s@ > HHNN$((:">
IO
r c
U R U R R " XR U R X!5 U40 UD65 $ )a Filter this `element.Tag`'s direct children based on the given CSS selector.
This uses the Soup Sieve library. It works the same way as
passing a `element.Tag` into that library's `soupsieve.filter()
`_
method. For more information, see the documentation for
`soupsieve.filter()
`_.
:param namespaces: A dictionary mapping namespace prefixes
used in the CSS selector to namespace URIs. By default,
Beautiful Soup will pass in the prefixes it encountered while
parsing the document.
:param flags: Flags to be passed into Soup Sieve's
`soupsieve.filter()
`_
method.
:param kwargs: Keyword arguments to be passed into SoupSieve's
`soupsieve.filter()
`_
method.
)r. r filterr r) r2 s r rI
CSS.filter0 sA > xx HHOO$((:">
IO
r )r r )N)r z element.Tagr r )r" r returnr )r' Optional[_NamespaceMapping]r( r rK rL )r- zMutableSequence[Tag]rK zResultSet[Tag])Nr )
r( r r3 rL r4 intr5 r rK r
)
r( r r3 rL r4 rM r5 r rK zelement.Tag | None)Nr r ) r( r r3 rL r< rM r4 rM r5 r rK ResultSet[element.Tag]) r( r r3 rL r< rM r4 rM r5 r rK zIterator[element.Tag])
r( r r3 rL r4 rM r5 r rK zOptional[element.Tag])
r( r r3 rL r4 rM r5 r rK rE )
r( r r3 rL r4 rM r5 r rK rN )__name__
__module__ __qualname____firstlineno____doc__r r! r) r. r1 r8 r( r? rB rF rI __static_attributes__ r r r r - s
1 - 7: $ ( 37 WW 0W W
W
W< 37
0
B 37 #
#
0#
#
#
#
#
P 37 !
!
0!
!
!
!
!
L 37
0
F 37 $
$
0$
$
$
$
R 37 #
#
0#
#
#
#
#
r r ) rS
__future__r typesr typingr r r r r r
r warnings bs4._typingr r r
r, r bs4.elementr r __annotations__ ImportErrorwarnobjectr rU r r r` sv # )#* f
& f
I MMOs
A A:9A: