+
Ci1 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 ] 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 )formats ")/usr/lib/python3/dist-packages/bs4/css.py __annotate__CSS.__annotate__; s K .B c P Vf \ pVf \ R4 hW n Wn R # )NzLCannot execute CSS selectors because the soupsieve package is not installed.)r NotImplementedErrorr r )selfr r s &&&r __init__ CSS.__init__; s- ;C ;%^
r c V ^8 d QhRRRR/# )r identstrreturnr )r s "r r r E s
1
1C
1C
1r c
z \ 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(
CSS.escapeE s6 %_
C /00r c $ V ^8 d QhRRRRRR/# )r nsOptional[_NamespaceMapping]selectr% r& r )r s "r r r Q s$ - 7: $ r c
\ W P P 4 ' g Vf V P P pV# )z%Normalize a dictionary of namespaces.)
isinstancer r r _namespaces)r r+ r- s &&&r _nsCSS._nsQ s3 &(("4"455"* %%B r c V ^8 d QhRRRR/# )r resultszMutableSequence[Tag]r& zResultSet[Tag]r )r s "r r r \ s ( (/ (N (r c
^ 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 r4 r s && r _rsCSS._rs\ s "w''r c
, V ^8 d QhRRRRRRRRR R
/# ) r r- r%
namespacesr, flagsintkwargsr r& r r )r s "r r r i sC W WW 0W W
W
Wr c
\ 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 compiler1 r r- r: r; r= s &&&&,r r? CSS.compilei s) 2 xx (DeVvVVr c
, V ^8 d QhRRRRRRRRR R
/# ) r r- r% r: r, r; r< r= r r& zelement.Tag | Noner )r s "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 r1 r@ s &&&&,r rD CSS.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 s "r r r sF #
#
#
0#
#
#
#
#
r c
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.
)r7 r r- r r1 r r- r: rG r; r= s &&&&&,r r-
CSS.select sK 8 =Exx HHOO$((:">
PV
r c 0 V ^8 d QhRRRRRRRRRR R
R /# ) r r- r% r: r, rG r< r; r= r r& zIterator[element.Tag]r )r s "r r r sF !
!
!
0!
!
!
!
!
r c
r 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 r1 rJ s &&&&&,r rN CSS.iselect s7 > xx HHdhhz :E
LR
r c
, V ^8 d QhRRRRRRRRR R
/# ) r r- r% r: r, r; r< r= r r& zOptional[element.Tag]r )r s "r r r s<
0
r c
r V P P ! WP V P W!4 V3/ VB # )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 r1 r@ s &&&&,r rR CSS.closest s7 8 xx HHdhhz :E
EK
r c
, V ^8 d QhRRRRRRRRR R
/# ) r r- r% r: r, r; r< r= r r& boolr )r s "r r r
s< $
$
$
0$
$
$
$
r c
\ \ 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 rU r matchr r1 r@ s &&&&,r rW CSS.match
s@ > HHNN$((:">
IO
r c
, V ^8 d QhRRRRRRRRR R
/# ) r r- r% r: r, r; r< r= r r& rH r )r s "r r r 0 s< #
#
#
0#
#
#
#
r c
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.
)r7 r filterr r1 r@ s &&&&,r r[
CSS.filter0 sA > xx HHOO$((:">
IO
r )r r )N)N )Nr] r] )__name__
__module__ __qualname____firstlineno____doc__r! r( r1 r7 r? rD r- rN rR rW r[ __static_attributes__r r r r r - sH
1 (W6
<#
J!
F
@$
L#
#
r r ) __conditional_annotations__rb
__future__r typesr typingr r r r r r r
warnings bs4._typingr r r r6 r
bs4.elementr r __annotations__ ImportErrorwarnobjectr )rd s @r ro sw # )#* f
& f
I MMOs A" "B ?B