+
2i1 c s a 0 t $ R t^ RIHt ^ RIHt ^ RIHtHtH t H
t
H t H t H
t
^ RIt^ RIHt ]
' d ^ RIHt ^ RIHt ^ RIHtHt R ]R
& ^ RIt ! R R
]4 t R# ] d Rt]P4 ! R 4 L*i ; i)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 s ] tR t^-tRtRR R lltR R ltR R ltR R
ltRR R llt RR
R llt
R R R llt R R R llt RR R llt
RR R lltRR R lltRtR# ) CSSat 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 V ^8 d QhRRRR/# ) tagz element.Tagapir Zformat ",/usr/lib/python3.14/site-packages/bs4/css.py __annotate__CSS.__annotate__; s K .B c sP Vf \ pVf \ R4 hW n Wn R # )NzLCannot execute CSS selectors because the soupsieve package is not installed.)r NotImplementedErrorr r )selfr r &&&r __init__Z CSS.__init__; s- ;C ;%^
r c s V ^8 d QhRRRR/# )r identstrreturnr r r r r r E s
1
1C
1C
1r c
sz \ f \ R4 h\ \ V P P V4 4 # )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 r! r escape)r r s &&r r# Z
CSS.escapeE s6 %_
C /00r c s$ V ^8 d QhRRRRRR/# )r nsOptional[_NamespaceMapping]selectr! r" r r r r r r Q s$ - 7: $ r c
s \ W P P 4 ' g Vf V P P pV# )z%Normalize a dictionary of namespaces.)Z
isinstancer r
r Z _namespaces)r r$ r& r r _nsZCSS._nsQ s3 &(("4"455"* %%B r c r )r resultszMutableSequence[Tag]r" zResultSet[Tag]r r r r r r \ s ( (/ (N (r c
s ^ RI Hp V! RV4 # )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 N)bs4r )r r( r s && r _rsZCSS._rs\ s "w''r c
, V ^8 d QhRRRRRRRRR R
/# ) r r& r!
namespacesr% flagsintkwargsr r" r
r r r r r r i sC W WW 0W W
W
Wr c
s\ V P P ! WP W!4 V3/ VB # )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& r, r- r/ &&&&,r r0 Z CSS.compilei s) 2 xx (DeVvVVr c
r+ ) r r& r! r, r% r- r. r/ r r" zelement.Tag | Noner r r r r r s<
0
r c
r V P P ! WP V P W!4 V3/ VB # )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' r1 r2 r r4 ZCSS.select_one s7 4 xx"" HHdhhz :E
EK
r c 0 V ^8 d QhRRRRRRRRRR R
R /# ) r r& r! r, r% limitr. r- r/ r r" ResultSet[element.Tag]r r r r r r sF #
#
#
0#
#
#
#
#
r c
s Vf ^ pV P V P P ! WP V P W!4 W43/ VB 4 # )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, r6 r- r/ &&&&&,r r& Z
CSS.select sK 8 =Exx HHOO$((:">
PV
r c r5 ) r r& r! r, r% r6 r. r- r/ r r" zIterator[element.Tag]r r r r r r sF !
!
!
0!
!
!
!
!
r c
sr V P P ! WP V P W!4 W43/ VB # )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' r8 r9 r r: Z CSS.iselect s7 > xx HHdhhz :E
LR
r c
r+ ) r r& r! r, r% r- r. r/ r r" zOptional[element.Tag]r r r r r r s<
0
r c
r3 )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' r1 r2 r r; Z CSS.closest s7 8 xx HHdhhz :E
EK
r c
r+ ) r r& r! r, r% r- r. r/ r r" boolr r r r r r
s< $
$
$
0$
$
$
$
r c
s \ \ V P P ! WP V P W!4 V3/ VB 4 # )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 r< r matchr r' r1 r2 r r= Z CSS.match
s@ > HHNN$((:">
IO
r c
r+ ) r r& r! r, r% r- r. r/ r r" r7 r r r r r r 0 s< #
#
#
0#
#
#
#
r c
s V P V P P ! WP V P W!4 V3/ VB 4 # )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' r1 r2 r r> Z
CSS.filter0 sA > xx HHOO$((:">
IO
r )r r )N)N )Nr? r? )Z__name__Z
__module__Z __qualname__Z__firstlineno____doc__r r# r' r* r0 r4 r& r: r; r= r> Z__static_attributes__r r r r r - sH
1 (W6
<#
J!
F
@$
L#
#
r r ) __conditional_annotations__r@ Z
__future__r Ztypesr Ztypingr r r r r r r ZwarningsZ bs4._typingr r r
r) r Z bs4.elementr r
Z__annotations__Z ImportErrorZwarnZobjectr )rA s @r rB sw # )#* f
& f
I MMOs A" "B ?B