�
��g�1 � � � % 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 <https://facelessuser.github.io/soupsieve/>`_ (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)�Any�cast�Iterable�Iterator�Optional�
TYPE_CHECKINGN)�_NamespaceMapping)� SoupSieve)�element)� ResultSet�Tag�Optional[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 �NotImplementedError�api�tag)�selfr r s �)/usr/lib/python3/dist-packages/bs4/css.py�__init__� CSS.__init__: s- � � �;��C� �;�%�^��
� ���� c �x � [ c [ S5 e[ [ U R R U5 5 $ )z�Escape a CSS identifier.
This is a simple wrapper around `soupsieve.escape() <https://facelessuser.github.io/soupsieve/api/#soupsieveescape>`_. 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���� � ��/�0�0r c � � [ X R R 5 ( d Uc U R R nU$ )z%Normalize a dictionary of namespaces.)�
isinstancer r r � _namespaces)r �ns�selects r �_ns�CSS._nsP s3 � � �&�(�(�"4�"4�5�5�"�*� ���%�%�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 �_rs�CSS._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() <https://facelessuser.github.io/soupsieve/api/#soupsievecompile>`_ method.
:param kwargs: Keyword arguments to be passed into Soup Sieve's
`soupsieve.compile() <https://facelessuser.github.io/soupsieve/api/#soupsievecompile>`_ method.
:return: A precompiled selector object.
:rtype: soupsieve.SoupSieve
)r �compiler( �r r' �
namespaces�flags�kwargss r r0 � CSS.compileh s) � �2 �x�x� � �����(D�e�V�v�V�Vr 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() <https://facelessuser.github.io/soupsieve/api/#soupsieveselect_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() <https://facelessuser.github.io/soupsieve/api/#soupsieveselect_one>`_ method.
:param kwargs: Keyword arguments to be passed into Soup Sieve's
`soupsieve.select_one() <https://facelessuser.github.io/soupsieve/api/#soupsieveselect_one>`_ method.
)r �
select_oner r( r1 s r r7 �CSS.select_one� s7 � �4 �x�x�"�"� �H�H�d�h�h�z� :�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() <https://facelessuser.github.io/soupsieve/api/#soupsieveselect>`_ 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() <https://facelessuser.github.io/soupsieve/api/#soupsieveselect>`_ method.
:param kwargs: Keyword arguments to be passed into Soup Sieve's
`soupsieve.select() <https://facelessuser.github.io/soupsieve/api/#soupsieveselect>`_ method.
r )r- r r' r r( �r r' r2 �limitr3 r4 s r r' �
CSS.select� sK � �8 �=��E��x�x� �H�H�O�O����$�(�(�:�">��
�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()
<https://facelessuser.github.io/soupsieve/api/#soupsieveiselect>`_
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() <https://facelessuser.github.io/soupsieve/api/#soupsieveiselect>`_ method.
:param kwargs: Keyword arguments to be passed into Soup Sieve's
`soupsieve.iselect() <https://facelessuser.github.io/soupsieve/api/#soupsieveiselect>`_ method.
)r �iselectr r( r: s r r> � CSS.iselect� s7 � �> �x�x� � � �H�H�d�h�h�z� :�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()
<https://facelessuser.github.io/soupsieve/api/#soupsieveclosest>`_
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() <https://facelessuser.github.io/soupsieve/api/#soupsieveclosest>`_ method.
:param kwargs: Keyword arguments to be passed into Soup Sieve's
`soupsieve.closest() <https://facelessuser.github.io/soupsieve/api/#soupsieveclosest>`_ method.
)r �closestr r( r1 s r rA � CSS.closest� s7 � �8 �x�x� � � �H�H�d�h�h�z� :�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()
<https://facelessuser.github.io/soupsieve/api/#soupsievematch>`_
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()
<https://facelessuser.github.io/soupsieve/api/#soupsievematch>`_
method.
:param kwargs: Keyword arguments to be passed into SoupSieve's
`soupsieve.match()
<https://facelessuser.github.io/soupsieve/api/#soupsievematch>`_
method.
)r �boolr �matchr r( r1 s r rE � CSS.match s@ � �> � � �H�H�N�N����$�(�(�:�">��
�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()
<https://facelessuser.github.io/soupsieve/api/#soupsievefilter>`_
method. For more information, see the documentation for
`soupsieve.filter()
<https://facelessuser.github.io/soupsieve/api/#soupsievefilter>`_.
: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()
<https://facelessuser.github.io/soupsieve/api/#soupsievefilter>`_
method.
:param kwargs: Keyword arguments to be passed into SoupSieve's
`soupsieve.filter()
<https://facelessuser.github.io/soupsieve/api/#soupsievefilter>`_
method.
)r- r �filterr r( r1 s r rH �
CSS.filter/ sA � �> �x�x� �H�H�O�O����$�(�(�:�">��
�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�� W��W� 0�W� � 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__� ImportError�warn�objectr rT r r �<module>r_ sq �� � #� �� � � )��#��*� � ���f
�&� f
�� � ��I� �M�M�O���s � A �A8�7A8