U
|
¡ý°d]' ã
|
@ s^ d Z ddlZz ddlZW n0 ek
|
rH Z zdZe d¡ W 5 dZ[X Y nX G dd deZdS )zFIntegration code for CSS selectors using Soup Sieve (pypi: soupsieve).é NzEThe soupsieve package is not installed. CSS selectors cannot be used.c @ sz e Zd ZdZefddZdd Zdd Zdd Zdd d Z dddZ
|
d ddZ d ddZ d ddZ d ddZd ddZd
|
S )!ÚCSSa± A proxy object against the soupsieve library, to simplify its
|
CSS selector API.
|
|
Acquire this object through the .css attribute on the
|
BeautifulSoup object, or on the Tag you want to use as the
|
starting point for a CSS selector.
|
|
The main advantage of doing this is that the tag to be selected
|
against doesn't need to be explicitly specified in the function
|
calls, since it's already scoped to a tag.
|
c C s |dkrt d|| _|| _dS )a¹ Constructor.
|
|
You don't need to instantiate this class yourself; instead,
|
access the .css attribute on the BeautifulSoup object, or on
|
the Tag you want to use as the starting point for your CSS
|
selector.
|
|
:param tag: All CSS selectors will use this as their starting
|
point.
|
|
:param api: A plug-in replacement for the soupsieve module,
|
designed mainly for use in tests.
|
NzLCannot execute CSS selectors because the soupsieve package is not installed.)ÚNotImplementedErrorÚapiÚtag)Úselfr r © r ú>d:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\bs4/css.pyÚ__init__ s ÿz CSS.__init__c C s t dkrtd| j |¡S )z¥Escape a CSS identifier.
|
|
This is a simple wrapper around soupselect.escape(). See the
|
documentation for that function for more information.
|
NzMCannot escape CSS identifiers because the soupsieve package is not installed.)Ú soupsiever r Úescape)r Úidentr r r r / s
|
ÿz
|
CSS.escapec C s" t || jjs |dkr | jj}|S )z%Normalize a dictionary of namespaces.N)Ú
|
isinstancer Z SoupSiever Ú _namespaces)r ÚnsÚselectr r r Ú_ns; s zCSS._nsc C s ddl m} |d|S )a Normalize a list of results to a Resultset.
|
|
A ResultSet is more consistent with the rest of Beautiful
|
Soup's API, and ResultSet.__getattr__ has a helpful error
|
message if you try to treat a list of results as a single
|
result (a common mistake).
|
r )Ú ResultSetN)Z bs4.elementr )r Úresultsr r r r Ú_rsD s zCSS._rsNr 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() method.
|
|
:param kwargs: Keyword arguments to be passed into SoupSieve's
|
soupsieve.compile() method.
|
|
:return: A precompiled selector object.
|
:rtype: soupsieve.SoupSieve
|
)r Úcompiler ©r r Ú
|
namespacesÚflagsÚkwargsr r r r P s
|
ÿÿz CSS.compilec K s | j j|| j| ||¡|f|S )aK Perform a CSS selection operation on the current Tag and return the
|
first result.
|
|
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 SoupSieve's
|
soupsieve.select_one() method.
|
|
:return: A Tag, or None if the selector has no match.
|
:rtype: bs4.element.Tag
|
|
)r Ú
|
select_oner r r r r r r g s
|
ÿÿzCSS.select_onec K s4 |dkr d}| | jj|| j| ||¡||f|¡S )aw Perform a CSS selection operation on the current Tag.
|
|
This uses the Soup Sieve library. For more information, see
|
that library's documentation for the soupsieve.select()
|
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 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 SoupSieve's
|
soupsieve.select() method.
|
|
:return: A ResultSet of Tag objects.
|
:rtype: bs4.element.ResultSet
|
|
Nr )r r r r r ©r r r Úlimitr r r r r r s
|
ÿþÿz
|
CSS.selectc K s" | j j|| j| ||¡||f|S )a¹ Perform a CSS selection operation on the current 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 SoupSieve's
|
soupsieve.iselect() method.
|
|
:return: A generator
|
:rtype: types.GeneratorType
|
)r Úiselectr r r r r r r ¨ s
|
ÿÿz CSS.iselectc K s | j j|| j| ||¡|f|S )a6 Find the 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 SoupSieve's
|
soupsieve.closest() method.
|
|
:return: A Tag, or None if there is no match.
|
:rtype: bs4.Tag
|
|
)r Úclosestr r r r r r r Æ s
|
ÿÿz CSS.closestc K s | j j|| j| ||¡|f|S )a Check whether this 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.
|
|
:return: True if this Tag matches the selector; False otherwise.
|
:rtype: bool
|
)r Úmatchr r r r r r r â s
|
ÿÿz CSS.matchc K s& | | jj|| j| ||¡|f|¡S )aW Filter this Tag's direct children based on the given CSS selector.
|
|
This uses the Soup Sieve library. It works the same way as
|
passing this Tag into that library's soupsieve.filter()
|
method. More information, 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.
|
|
:return: A ResultSet of Tag objects.
|
:rtype: bs4.element.ResultSet
|
|
)r r Úfilterr r r r r r r ý s
|
ÿÿÿz
|
CSS.filter)Nr )Nr )Nr r )Nr r )Nr )Nr )Nr )Ú__name__Ú
|
__module__Ú __qualname__Ú__doc__r
|
r r r r r r r r r r r r r r r r s
|
|
|
$
|
|
|
r )r$ Úwarningsr
|
Ú ImportErrorÚeÚwarnÚobjectr r r r r Ú<module> s ÿ
|
