U }g1@sUdZddlmZddlmZddlmZmZmZm Z m Z m Z ddl Z ddl mZe r~ddlmZddlmZdd lmZmZd ed <z ddlZWn"ek rdZe d YnXGd ddeZdS)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@seZdZdZd.dddddZddd d d Zd dd d ddZdddddZd/dd ddddddZd0dd ddddddZ d1dd ddddd d!d"Z d2dd dddd#d d$d%Z d3dd ddd&dd'd(Z d4dd ddd)dd*d+Z d5dd ddddd,d-ZdS)6CSSaA 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)tagapicCs,|dkr t}|dkrtd||_||_dS)NzLCannot execute CSS selectors because the soupsieve package is not installed.)rNotImplementedErrorrr)selfrrr+/tmp/pip-unpacked-wheel-kgiupv3k/bs4/css.py__init__:sz CSS.__init__str)identreturncCs"tdkrtdtt|j|S)zEscape a CSS identifier. This is a simple wrapper around `soupsieve.escape() `_. See the documentation for that function for more information. NzMCannot escape CSS identifiers because the soupsieve package is not installed.)rrrrrescape)rrrrrrDs z CSS.escapezOptional[_NamespaceMapping])nsselectrcCs"t||jjs|dkr|jj}|S)z%Normalize a dictionary of namespaces.N) isinstancerr r _namespaces)rrrrrr_nsPszCSS._nsz Iterable[Tag]zResultSet[Tag])resultsrcCsddlm}|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 )rr"r rrr_rs[s zCSS._rsrintrr )r namespacesflagskwargsrcKs|jj|||||f|S)aPre-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 )rcompiler!rrr&r'r(rrrr)hsz CSS.compilezelement.Tag | NonecKs |jj||j||||f|S)aPerform 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_onerr!r*rrrr+s zCSS.select_onezResultSet[element.Tag])rr&limitr'r(rc Ks4|dkr d}||jj||j|||||f|S)aPerform 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. Nr)r$rrrr!rrr&r,r'r(rrrrs z CSS.selectzIterator[element.Tag]cKs"|jj||j|||||f|S)aUPerform 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. )riselectrr!r-rrrr.s z CSS.iselectzOptional[element.Tag]cKs |jj||j||||f|S)aFind 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. )rclosestrr!r*rrrr/s z CSS.closestboolc Ks&tt|jj||j||||f|S)aCheck 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. )rr0rmatchrr!r*rrrr1 s z CSS.matchc Ks&||jj||j||||f|S)aNFilter 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$rfilterrr!r*rrrr2/s z CSS.filter)N)Nr)Nr)Nrr)Nrr)Nr)Nr)Nr)__name__ __module__ __qualname____doc__rrr!r$r)r+rr.r/r1r2rrrrr,s8    !(&#)r)r6 __future__rtypesrtypingrrrrrr warningsZ bs4._typingr rr r#r Z bs4.elementr r__annotations__ ImportErrorwarnobjectrrrrrs$