(ph1 % S r SSKJr SSKJr SSKJrJrJrJ r J
r
J r SSK r SSK
Jr \ ( a SSKJr SSKJr SS KJrJr S
\S ' SSKr " S
S\5 rg! \ a Sr\ R0 " 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)AnycastIterableIteratorOptional
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 :/var/www/html/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.escapeD 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._nsP 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 r0 CSS.compileh 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( r1 s r r7 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' r2 limitr3 r4 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( r1 s r rA 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( r1 s r rE 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( r1 s r rH
CSS.filter/ sA > xx HHOO$((:">
IO
r )r r )N)r z element.Tagr r )r! r returnr )r& Optional[_NamespaceMapping]r' r rJ rK )r, z
Iterable[Tag]rJ zResultSet[Tag])Nr )
r' r r2 rK r3 intr4 r rJ r )
r' r r2 rK r3 rL r4 r rJ zelement.Tag | None)Nr r ) r' r r2 rK r; rL r3 rL r4 r rJ ResultSet[element.Tag]) r' r r2 rK r; rL r3 rL r4 r rJ zIterator[element.Tag])
r' r r2 rK r3 rL r4 r rJ zOptional[element.Tag])
r' r r2 rK r3 rL r4 r rJ rD )
r' r r2 rK r3 rL r4 r rJ rM )__name__
__module__ __qualname____firstlineno____doc__r r r( r- r0 r7 r' r> rA rE rH __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 )rR
__future__r typesr typingr r r r r r
warnings bs4._typingr r r r+ r
bs4.elementr r __annotations__ ImportErrorwarnobjectr rT r r r_ sq # )#* f
& f
I MMOs A A87A8