dS q0dS )zyReturns true iff this Tag has the same name, the same attributes,
and the same contents (recursively) as `other`.Tr' r rM F)r r' r rp rt rM )r
otherr my_childr r r __eq__ s
z
Tag.__eq__c C s
| |k S )zTReturns true iff this Tag is not identical to `other`,
as defined in __eq__.r )r
r_ r r r __ne__ rH z
Tag.__ne__r c C s t r| S | |S )zRenders this PageElement as a string.
:param encoding: The encoding to use (Python 2 only).
:return: Under Python 2, a bytestring; under Python 3,
a Unicode string.
PY3Kdecoder9 r7 r r r __repr__ s
z Tag.__repr__c C s | S )z-Renders this PageElement as a Unicode string.)re r r r r __unicode__& s zTag.__unicode__c C s t r| S | S )zRenders this PageElement as a generic string.
:return: Under Python 2, a UTF-8 bytestring; under Python 3,
a Unicode string.
rc r r r r __str__* s z Tag.__str__r xmlcharrefreplacec C s | |||}|||S )a Render a bytestring representation of this PageElement and its
contents.
:param encoding: The destination encoding.
:param indent_level: Each line of the rendering will be
indented this many spaces. Used internally in
recursive calls while pretty-printing.
:param formatter: A Formatter object, or a string naming one of
the standard formatters.
:param errors: An error handling strategy such as
'xmlcharrefreplace'. This value is passed along into
encode() and its value should be one of the constants
defined by Python.
:return: A bytestring.
re r9 )r
r8 indent_levelrS errorsr r r r r9 8 s z
Tag.encodec C s t |ts
| |}|| }g }|D ]H\}}|du r |}n8t |ts(t |tr.d|}nt |ts8t|}nt |trF|durF| |}|
|} t|d | | }| | qd}
d} d} | j
rj| j
d } | jrs|jpqd}
nd| | jf } | |}
d}d}|durd|d }|
r|}|d }nd}| |||}| jr|}|S g }d}|rdd| }|dur| | | d| | j||
f |
r| d | | |
r|r|d
d kr| d |
r| r| | | | |dur| r| jr| d d|}|S ) a Render a Unicode representation of this PageElement and its
contents.
:param indent_level: Each line of the rendering will be
indented this many spaces. Used internally in
recursive calls while pretty-printing.
:param eventual_encoding: The tag is destined to be
encoded into this encoding. This method is _not_
responsible for performing that encoding. This information
is passed in so that it can be substituted in if the
document contains a tag that mentions the document's
encoding.
:param formatter: A Formatter object, or a string naming one of
the standard formatters.
N =r5 r# zr> z
<%s%s%s%s>
rG )rO r rP
attributesr tuplere r$ r1 r9 attribute_valuequoted_attribute_valuer r& r3 void_element_close_prefixr' _should_pretty_printdecode_contentsr) rK )r
rk eventual_encodingrS rp r r@ valdecodedr closecloseTagr& pretty_printspace indent_spaceindent_contentsrM rR attribute_stringr r r re P s
z
Tag.decodec C s |duo
| j p
| j| j vS )zShould this tag be pretty-printed?
Most of them should, but some (such as in HTML
documents) should not.
N)r+ r' )r
rk r r r ru s
zTag._should_pretty_printc C s& |du r | j d|dS | j|d|dS )a Pretty-print this PageElement as a string.
:param encoding: The eventual encoding of the string. If this is None,
a Unicode string will be returned.
:param formatter: A Formatter object, or a string naming one of
the standard formatters.
:return: A Unicode string (if encoding==None) or a bytestring
(otherwise).
NT)rS rj )r
r8 rS r r r prettify s
z Tag.prettifyc C s t |ts
| |}|du}g }| D ]N}d}t |tr!||}nt |tr0||||| | jo8| j | jv }|rC|rC|sC|
}|r`|rR|sR|d|d || |r`|s`|d qd |S )a Renders the contents of this tag as a Unicode string.
:param indent_level: Each line of the rendering will be
indented this many spaces. Used internally in
recursive calls while pretty-printing.
:param eventual_encoding: The tag is destined to be
encoded into this encoding. decode_contents() is _not_
responsible for performing that encoding. This information
is passed in so that it can be substituted in if the
document contains a tag that mentions the document's
encoding.
:param formatter: A Formatter object, or a string naming one of
the standard Formatters.
Nrm r> ro r5 ) rO r rP r r r r re r+ r' r] re ) r
rk rw rS r| rR rY r preserve_whitespacer r r rv s0
zTag.decode_contentsc C s | |||}||S )a Renders the contents of this PageElement as a bytestring.
:param indent_level: Each line of the rendering will be
indented this many spaces. Used internally in
recursive calls while pretty-printing.
:param eventual_encoding: The bytestring will be in this encoding.
:param formatter: A Formatter object, or a string naming one of
the standard Formatters.
:return: A bytestring.
)rv r9 )r
rk r8 rS rM r r r encode_contents s
zTag.encode_contentsr c C s |sd}| j ||dS )z(Deprecated method for BS3 compatibility.N)rk r8 )r )r
r8 prettyPrint indentLevelr r r renderContents s
zTag.renderContentsTc K s. d}| j ||||dfi |}|r|d }|S )a Look in the children of this PageElement and find the first
PageElement that matches the given criteria.
All find_* methods take a common set of arguments. See the online
documentation for detailed explanations.
:param name: A filter on tag name.
:param attrs: A dictionary of filters on attribute values.
:param recursive: If this is True, find() will perform a
recursive search of this PageElement's children. Otherwise,
only the direct children will be considered.
:param limit: Stop looking after finding this many results.
:kwargs: A dictionary of filters on attribute values.
:return: A PageElement.
:rtype: bs4.element.Tag | bs4.element.NavigableString
Nr> r rS )r
r' r recursiver r r r r r r r\ s
zTag.findc K s* | j }|s| j}| j|||||fi |S )a Look in the children of this PageElement and find all
PageElements that match the given criteria.
All find_* methods take a common set of arguments. See the online
documentation for detailed explanations.
:param name: A filter on tag name.
:param attrs: A dictionary of filters on attribute values.
:param recursive: If this is True, find_all() will perform a
recursive search of this PageElement's children. Otherwise,
only the direct children will be considered.
:param limit: Stop looking after finding this many results.
:kwargs: A dictionary of filters on attribute values.
:return: A ResultSet of PageElements.
:rtype: bs4.element.ResultSet
)r5 childrenr )r
r' r r r r r r r r r rT 7 s z Tag.find_allc C rI )zkIterate over all direct children of this PageElement.
:yield: A sequence of PageElements.
rJ r r r r r Q s
z Tag.childrenc c sH t | jsdS | j}| jd }||ur"|V |j}||usdS dS )zIterate over all children of this PageElement in a
breadth-first sequence.
:yield: A sequence of PageElements.
Nr )rp rM r rJ )r
stopNodecurrentr r r r5 Z s
zTag.descendantsc K s& | j ||dfi |}|r|d S dS )a Perform a CSS selection operation on the current element.
: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 kwargs: Keyword arguments to be passed into SoupSieve's
soupsieve.select() method.
:return: A Tag.
:rtype: bs4.element.Tag
r> r N)select)r
selector
namespacesr r r r r
select_onej s zTag.select_onec K sL |du r| j }|du r
d}tdu rtdtj|| ||fi |}td|S )a Perform a CSS selection operation on the current element.
This uses the SoupSieve library.
: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 use the prefixes it encountered while
parsing the document.
:param limit: After finding this number of results, stop looking.
:param kwargs: Keyword arguments to be passed into SoupSieve's
soupsieve.select() method.
:return: A ResultSet of Tags.
:rtype: bs4.element.ResultSet
Nr zLCannot execute CSS selectors because the soupsieve package is not installed.) _namespaces soupsiever\ r r )r
r r r r r r r r r s
z
Tag.selectc C r zDeprecated generator.)r r r r r childGenerator zTag.childGeneratorc C r r )r5 r r r r recursiveChildGenerator r zTag.recursiveChildGeneratorc C s t d| | |S )zDeprecated method. This was kind of misleading because has_key()
(attributes) was different from __in__ (contents).
has_key() is gone in Python 3, anyway.
z2has_key is deprecated. Use has_attr("%s") instead.)rZ r[ rE rD r r r has_key s
z Tag.has_key)NNNNNNNNNNNNNNN)Fr )r )Nr r+ )?r, r- r. r/ r1 r parserClassr r r3
isSelfClosingra r r r r rF r r_ r r: r4 r; rr r? rA rE rF rG rL rM rN rO rP rR rU r ra rb rf rg rh rd r r9 re ru r rv r r r\ findChildrT findAll findChildrenr r5 r r r r r r r r r r x s
p
$
&
e
/
% r c @ sT e Zd ZdZdi dfddZdd Zdd Zdi fd d
ZeZd d Z dd
dZ
dS )r a& Encapsulates a number of ways of matching a markup element (tag or
string).
This is primarily used to underpin the find_* methods, but you can
create one yourself and pass it in as `parse_only` to the
`BeautifulSoup` constructor, to parse a subset of a large
document.
Nc K s | || _t|ts||d< d}d|v r |d |d< |d= |r.|r,| }|| n|}i }t| D ] \}}| |||< q6|| _| || _ dS )a Constructor.
The SoupStrainer constructor takes the same arguments passed
into the find_* methods. See the online documentation for
detailed explanations.
:param name: A filter on tag name.
:param attrs: A dictionary of filters on attribute values.
:param text: A filter for a NavigableString with specific text.
:kwargs: A dictionary of filters on attribute values.
classNclass_)
_normalize_search_valuer' rO r( copyupdater itemsr r )r
r' r r r normalized_attrsr@ r r r r r1 s"
zSoupStrainer.__init__c C s t |tst |tst|dst |ts|d u r|S t |tr$|dS t|drOg }|D ] }t|drDt |tsDt |tsD|| q-|| | q-|S tt|S )Nr= utf8rL ) rO r$ r r boolbytesre r r )r
r new_valuevr r r r s"
z$SoupStrainer._normalize_search_valuec C s | j r| j S d| j| jf S )z5A human-readable representation of this SoupStrainer.z%s|%s)r r' r r r r r rh s zSoupStrainer.__str__c
C s8 d}d}t |tr
|}|}t | jtr |r |js | j|jkr dS t | jto+t |t }| jrC|sC|r:| || jsC|s| || jr|rL| ||}n6d}d}t| j D ]*\}} |srt
|dre|}n
i }|D ]\}
} | ||
< qi| |} | | | sd} nqW|r|r|}n|}|r| j r| |j
| j sd}|S )a Check whether a Tag with the given name and attributes would
match this SoupStrainer.
Used prospectively to decide whether to even bother creating a Tag
object.
:param markup_name: A tag name as found in some markup.
:param markup_attrs: A dictionary of attributes as found in some markup.
:return: True if the prospective tag would match this SoupStrainer;
False otherwise.
NFTr? )rO r r' r$ r& r _matchesr r r r r? r ra )
r
markup_name markup_attrsr markupcall_function_with_tag_datar= markup_attr_mapr
match_againstkr
attr_valuer r r
search_tag sZ
zSoupStrainer.search_tagc C s d}t |dr$t|ttfs$|D ]}t|tr!| |r!|} |S q|S t|tr9| jr2| js2| jr7| |}|S t|tsCt|trT| jsR| jsR|
|| jrR|}|S t d|j )zFind all items in `markup` that match this SoupStrainer.
Used by the core _find_all() method, which is ultimately
called by all find_* methods.
:param markup: A PageElement or a list of them.
NrL z&I don't know how to match against a %s)
r rO r r$ r r< r r' r r r Exceptionr )r
r r r r r r r< K s0
zSoupStrainer.searchc C sf d}t |ts t |tr'|D ] }| ||r dS q| d||r%dS dS |du r/|d uS t |tr8||S |}t |trB|j}| |}|d u rN| S t |drt |t
s|s]t }|D ] }|j rg|}nt
|}||v rpq_|| | |||r dS q_dS d}|st |t
r||k}|st |dr||S |st |tr|jr| |jd |j |S |S )NFTrm rL r< r# )rO r rq r re r r r' r r r$ setrF idaddr< r& ) r
r r
already_triedr itemoriginal_markupr@ r= r r r r l sb
zSoupStrainer._matchesr ) r, r- r. r/ r1 r rh r searchTagr< r r r r r r s & =!r c s* e Zd ZdZd fdd Zdd Z ZS )r zTA ResultSet is just a list that keeps track of the SoupStrainer
that created it.r c s t t| | || _dS )zlConstructor.
:param source: A SoupStrainer.
:param result: A list of PageElements.
N)superr r1 source)r
r r r r r r1 s
zResultSet.__init__c C s t d| )z7Raise a helpful exception to explain a common code fix.zResultSet object has no attribute '%s'. You're probably treating a list of elements like a single element. Did you call find_all() when you meant to call find()?r rD r r r r s zResultSet.__getattr__)r )r, r- r. r/ r1 r
__classcell__r r r r r s r ). __license__collections.abcr ImportErrore collectionsrC sysrZ r r[
bs4.formatterr r r r version_inford rD nonwhitespace_re
whitespace_rer r r6 r$ r" r1 r3 r: r rF r r r r r r r r r r r! r r r r r r r r sv
t E