o MK&h1@sUdZddlmZddlmZddlmZmZmZm Z m Z m Z ddl Z ddl mZe r?ddlmZddlmZdd lmZmZd ed <zddlZWneyYdZe d YnwGd 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@seZdZdZd3d4ddZd5d d Zd6ddZd7ddZ  d8d9dd Z  d8d:d"d#Z   d;dd,d-Z  d8d?d/d0Z  d8d@d1d2ZdS)ACSSaA 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. Ntag element.TagapircCs,|durt}|durtd||_||_dS)NzLCannot execute CSS selectors because the soupsieve package is not installed.)rNotImplementedErrorrr)selfrrr:/var/www/html/venv/lib/python3.10/site-packages/bs4/css.py__init__:s z CSS.__init__identstrreturncCs"tdurtdtt|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.escapensOptional[_NamespaceMapping]selectcCs"t||jjs|dur|jj}|S)z%Normalize a dictionary of namespaces.N) isinstancerr r _namespaces)rrr rrr_nsPszCSS._nsresults Iterable[Tag]ResultSet[Tag]cCsddlm}|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._rsr namespacesflagsintkwargsrr cKs |jj|||||fi|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#rr r)r*r,rrrr-hs z CSS.compileelement.Tag | NonecK$|jj||j||||fi|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.rrrr1s zCSS.select_onelimitResultSet[element.Tag]c Ks8|durd}||jj||j|||||fi|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(rr rr#rr r)r2r*r,rrrr sz CSS.selectIterator[element.Tag]cKs&|jj||j|||||fi|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#r4rrrr6s z CSS.iselectOptional[element.Tag]cKr0)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.rrrr8s z CSS.closestboolc Ks*tt|jj||j||||fi|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. )rr9rmatchrr#r.rrrr: sz CSS.matchc Ks*||jj||j||||fi|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.rrrr;/sz CSS.filter)N)rrrr)rrrr)rrr rrr)r$r%rr&)Nr) r rr)rr*r+r,rrr ) r rr)rr*r+r,rrr/)Nrr) r rr)rr2r+r*r+r,rrr3) r rr)rr2r+r*r+r,rrr5) r rr)rr*r+r,rrr7) r rr)rr*r+r,rrr9) r rr)rr*r+r,rrr3)__name__ __module__ __qualname____doc__rrr#r(r-r1r r6r8r:r;rrrrr,s:   ! ( & # )r)r? __future__rtypesrtypingrrrrrr warnings bs4._typingr rr r'r bs4.elementr r__annotations__ ImportErrorwarnobjectrrrrrs(