U
    %´ci©1  ã                   @  sÎ   U d Z ddlmZ ddlmZ ddlmZmZmZm	Z	m
Z
mZmZ ddlZddlmZ er‚ddlmZ ddlmZ dd	lmZmZ d
ed< zddlZW n" ek
r¸   dZe d¡ Y nX G dd„ deƒZdS )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ÚMutableSequenceÚOptionalÚTYPE_CHECKINGN)Ú_NamespaceMapping)Ú	SoupSieve)Úelement)Ú	ResultSetÚTagúOptional[ModuleType]Ú	soupsievezEThe soupsieve package is not installed. CSS selectors cannot be used.c                   @  s   e Zd ZdZd.dddœdd„Zddd	œd
d„Zddddœdd„Zdddœdd„Zd/ddddddœdd„Zd0ddddddœdd„Z	d1ddddddd œd!d"„Z
d2dddddd#d œd$d%„Zd3ddddd&dœd'd(„Zd4ddddd)dœd*d+„Zd5ddddddœd,d-„ZdS )6ÚCSSa”  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.
    Nzelement.Tagr   )ÚtagÚapic                 C  s,   |d krt }|d krtdƒ‚|| _|| _d S )NzLCannot execute CSS selectors because the soupsieve package is not installed.)r   ÚNotImplementedErrorr   r   )Úselfr   r   © r   ú+/tmp/pip-unpacked-wheel-6b7fkh1g/bs4/css.pyÚ__init__;   s    ÿzCSS.__init__Ústr)ÚidentÚreturnc                 C  s"   t dkrtdƒ‚tt| j |¡ƒS )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.
        NzMCannot escape CSS identifiers because the soupsieve package is not installed.)r   r   r   r   r   Úescape)r   r   r   r   r   r   E   s
    ÿz
CSS.escapezOptional[_NamespaceMapping])ÚnsÚselectr   c                 C  s"   t || jjƒs|dkr| jj}|S )z%Normalize a dictionary of namespaces.N)Ú
isinstancer   r   r   Ú_namespaces)r   r   r   r   r   r   Ú_nsQ   s    zCSS._nszMutableSequence[Tag]zResultSet[Tag])Úresultsr   c                 C  s   ddl m} |d|ƒS )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   r#   r   r   r   r   Ú_rs\   s    	zCSS._rsr   Úintr   r   )r   Ú
namespacesÚflagsÚkwargsr   c                 K  s   | j j||  ||¡|f|ŽS )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   r'   r(   r)   r   r   r   r*   i   s    zCSS.compilezelement.Tag | Nonec                 K  s    | j j|| j|  ||¡|f|ŽS )aÁ  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"   r+   r   r   r   r,   „   s      
 ÿÿzCSS.select_onezResultSet[element.Tag])r   r'   Úlimitr(   r)   r   c              	   K  s4   |dkrd}|   | jj|| j|  ||¡||f|Ž¡S )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.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.
        Nr   )r%   r   r   r   r"   ©r   r   r'   r-   r(   r)   r   r   r   r   ¢   s      
  ÿÿÿz
CSS.selectzIterator[element.Tag]c                 K  s"   | j j|| j|  ||¡||f|ŽS )aU  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.   r   r   r   r/   Ç   s      
  ÿÿzCSS.iselectzOptional[element.Tag]c                 K  s    | j j|| j|  ||¡|f|ŽS )aÅ  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"   r+   r   r   r   r0   ê   s      
 ÿÿzCSS.closestÚboolc              	   K  s&   t t| jj|| j|  ||¡|f|ŽƒS )aÇ  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   r1   r   Úmatchr   r"   r+   r   r   r   r2   
  s      
 ÿÿþz	CSS.matchc              	   K  s&   |   | jj|| j|  ||¡|f|Ž¡S )aN  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"   r+   r   r   r   r3   0  s      
 ÿÿÿz
CSS.filter)N)Nr   )Nr   )Nr   r   )Nr   r   )Nr   )Nr   )Nr   )Ú__name__Ú
__module__Ú__qualname__Ú__doc__r   r   r"   r%   r*   r,   r   r/   r0   r2   r3   r   r   r   r   r   -   s8   
  ü  ü!   û(   û&  ü#  ü)  ür   )r7   Ú
__future__r   Útypesr   Útypingr   r   r   r   r   r	   r
   ÚwarningsZbs4._typingr   r   r   r$   r   Zbs4.elementr   r   Ú__annotations__ÚImportErrorÚwarnÚobjectr   r   r   r   r   Ú<module>   s$   $	ÿ
