V]c @ s| d Z d Z d Z d Z d Z d g Z d d l Z d d l Z d d l Z d d l Z d d l
Z
d d l m Z m
Z
d d
l m Z d d l m Z m Z m Z m Z m Z m Z m Z m Z m Z m Z m Z d d
k d e f d YZ e Z e Z d e f d YZ d e f d YZ! d e" f d YZ# e$ d k rxd d l Z e e j% Z& e& j' GHn d S( sH Beautiful Soup
Elixir and Tonic
"The Screen-Scraper's Friend"
http://www.crummy.com/software/BeautifulSoup/
Beautiful Soup uses a pluggable XML or HTML parser to parse a
(possibly invalid) document into a tree representation. Beautiful Soup
provides methods and Pythonic idioms that make it easy to navigate,
search, and modify the parse tree.
Beautiful Soup works with Python 2.7 and up. It works better if lxml
and/or html5lib is installed.
For more than you ever wanted to know about Beautiful Soup, see the
documentation:
http://www.crummy.com/software/BeautifulSoup/bs4/doc/
s* Leonard Richardson (leonardr@segfault.org)s 4.8.0s* Copyright (c) 2004-2019 Leonard Richardsont MITt
BeautifulSoupiNi ( t builder_registryt ParserRejectedMarkup( t
UnicodeDammit( t CDatat Commentt DEFAULT_OUTPUT_ENCODINGt Declarationt Doctypet NavigableStringt PageElementt ProcessingInstructiont ResultSett SoupStrainert Tags` You are trying to run the Python 2 version of Beautiful Soup under Python 3. This will not work.su You need to convert the code, either by installing it (`python setup.py install`) or by running 2to3 (`2to3 -w bs4`).c B s e Z d Z d Z d d g Z d Z d Z d d d d d d d Z d Z d Z
e d
Z d Z
d Z d d i d
Z e d Z d Z d Z d Z d Z e d Z d d d Z d Z d e d Z d Z d d Z d Z e e d d Z RS( s
This class defines the basic interface called by the tree builders.
These methods will be called by the parser:
reset()
feed(markup)
The tree builder may call these methods from its feed() implementation:
handle_starttag(name, attrs) # See note about return value
handle_endtag(name)
handle_data(data) # Appends to the current data node
endData(containerClass=NavigableString) # Ends the current data node
No matter how complicated the underlying parser is, you should be
able to build a tree using 'start tag' events, 'end tag' events,
'data' events, and "done with data" events.
If you encounter an empty-element tag (aka a self-closing tag,
like HTML's
tag), call handle_starttag and then
handle_endtag.
u
[document]t htmlt fasts
s No parser was explicitly specified, so I'm using the best available %(markup_type)s parser for this system ("%(parser)s"). This usually isn't a problem, but if you run this code on another system, or in a different virtual environment, it may use a different parser and behave differently.
The code that caused this warning is on line %(line_number)s of the file %(filename)s. To get rid of this warning, pass the additional argument 'features="%(parser)s"' to the BeautifulSoup constructor.
t c s d k r# d =t j d n d k rF d =t j d n d k ri d =t j d n d k r d =t j d n d k r d =t j d
n f d } | p | d d
} | p | d d } | rt | t rt j d d) } n | } | }
t | t r=| } d) } n | d) k rt | t rd| g } n | d) k st | d k r| j } n t j
| } | d) k rt d d j | qn | d) k r| } | r|
| j
k p|
| j k r| j rd } n d } d) }
y t j d }
Wn t k
rJn X|
rf|
j } |
j } n t j } d } | j d } | r| j } | j d* r| d } qn | rt d | d | d | j
d | } t j | j | d d qqn rt j d! n | | _ | j | _ | j | _ t | _ | | _ | j j | t | d" r|| j! } n t | d# k rut | t" rd$ | k st | t rud% | k rut | t rt# j$ j% r| j& d& } n | } t' } y t# j$ j( | } Wn t) k
r)} n X| ret | t rQ| j& d& } n t j d' | n | j* | n xh | j j+ | | d( | D]K \ | _, | _- | _. | _/ | j0 y | j1 PWqt2 k
rqXqWd) | _, d) | j _3 d) S(+ s Constructor.
:param markup: A string or a file-like object representing
markup to be parsed.
:param features: Desirable features of the parser to be used. This
may be the name of a specific parser ("lxml", "lxml-xml",
"html.parser", or "html5lib") or it may be the type of markup
to be used ("html", "html5", "xml"). It's recommended that you
name a specific parser, so that Beautiful Soup gives you the
same results across platforms and virtual environments.
:param builder: A TreeBuilder subclass to instantiate (or
instance to use) instead of looking one up based on
`features`. You only need to use this if you've implemented a
custom TreeBuilder.
:param parse_only: A SoupStrainer. Only parts of the document
matching the SoupStrainer will be considered. This is useful
when parsing part of a document that would otherwise be too
large to fit into memory.
:param from_encoding: A string indicating the encoding of the
document to be parsed. Pass this in if Beautiful Soup is
guessing wrongly about the document's encoding.
:param exclude_encodings: A list of strings indicating
encodings known to be wrong. Pass this in if you don't know
the document's encoding but you know Beautiful Soup's guess is
wrong.
:param kwargs: For backwards compatibility purposes, the
constructor accepts certain keyword arguments used in
Beautiful Soup 3. None of these arguments do anything in
Beautiful Soup 4; they will result in a warning and then be ignored.
Apart from this, any keyword arguments passed into the BeautifulSoup
constructor are propagated to the TreeBuilder constructor. This
makes it possible to configure a TreeBuilder beyond saying
which one to use.
t convertEntitiess BS4 does not respect the convertEntities argument to the BeautifulSoup constructor. Entities are always converted to Unicode characters.t
markupMassages BS4 does not respect the markupMassage argument to the BeautifulSoup constructor. The tree builder is responsible for any necessary markup massage.t
smartQuotesTos BS4 does not respect the smartQuotesTo argument to the BeautifulSoup constructor. Smart quotes are always converted to Unicode characters.t selfClosingTagss BS4 does not respect the selfClosingTags argument to the BeautifulSoup constructor. The tree builder is responsible for understanding self-closing tags.t isHTMLs BS4 does not respect the isHTML argument to the BeautifulSoup constructor. Suggest you use features='lxml' for HTML and features='lxml-xml' for XML.c s< | k r8 t j d | | f | } | =| Sd S( NsL The "%s" argument to the BeautifulSoup constructor has been renamed to "%s."( t warningst warnt None( t old_namet new_namet value( t kwargs( s+ lib/python2.7/site-packages/bs4/__init__.pyt deprecated_argument s
t parseOnlyTheset
parse_onlyt fromEncodingt
from_encodingsl You provided Unicode markup but also provided a value for from_encoding. Your from_encoding will be ignored.i sj Couldn't find a tree builder with the features you requested: %s. Do you need to install a parser library?t ,t XMLt HTMLi t __file__s .pycs .pyoit filenamet line_numbert parsert markup_typet
stackleveli s Keyword arguments to the BeautifulSoup constructor will be ignored. These would normally be passed into the TreeBuilder constructor, but a TreeBuilder instance was passed in as `builder`.t readi t [ s s utf-8t replaces "%s" looks like a URL. Beautiful Soup is not an HTTP client. You should probably use an HTTP client like requests to get the document behind the URL, and feed that document to Beautiful Soup.( s http:s https:( u http:u https:( R1 RM R2 t anyt decodeR R ( RW t spacet cant_start_witht decoded_markup( ( RW s+ lib/python2.7/site-packages/bs4/__init__.pyRU L s c C sT | j j | j j | j | j x# | j j | j k rO | j q- Wd S( N( RH R[ t feedRW t endDatat
currentTagt namet
ROOT_TAG_NAMEt popTag( R^ ( ( s+ lib/python2.7/site-packages/bs4/__init__.pyR\ h s
c C sg t j | | | j | j d | _ | j j g | _ d | _ g | _ g | _
| j | d S( Ni ( R Rj RH R~ t hiddenR[ t current_dataR R| t tagStackt preserve_whitespace_tag_stackt pushTag( R^ ( ( s+ lib/python2.7/site-packages/bs4/__init__.pyR[ r s
c K s) | j | t d | j | | | | S( s+ Create a new tag associated with this soup.N( t updateR R RH ( R^ R} t namespacet nsprefixt attrst kwattrs( ( s+ lib/python2.7/site-packages/bs4/__init__.pyt new_tag| s
c C s
| | S( s7 Create a new NavigableString associated with this soup.( ( R^ t st subclass( ( s+ lib/python2.7/site-packages/bs4/__init__.pyt
new_string s c C s t d d S( Ns4 BeautifulSoup objects don't support insert_before().( t NotImplementedError( R^ t successor( ( s+ lib/python2.7/site-packages/bs4/__init__.pyt
insert_before s c C s t d d S( Ns3 BeautifulSoup objects don't support insert_after().( R ( R^ R ( ( s+ lib/python2.7/site-packages/bs4/__init__.pyt insert_after s c C s^ | j j } | j r; | | j d k r; | j j n | j rW | j d | _ n | j S( Ni( R t popR R| ( R^ t tag( ( s+ lib/python2.7/site-packages/bs4/__init__.pyR s c C sq | j d k r% | j j j | n | j j | | j d | _ | j | j j k rm | j j | n d S( Ni( R| R t contentst appendR R} RH t preserve_whitespace_tagsR ( R^ R ( ( s+ lib/python2.7/site-packages/bs4/__init__.pyR s c C s | j r d j | j } | j s{ t } x' | D] } | | j k r1 t } Pq1 q1 W| r{ d | k ro d } qx d } q{ n g | _ | j r t | j d k r | j j s | j j
| r d S| | } | j | n d S( Nu s
Rp i ( R R9 R t Truet ASCII_SPACESRR R! R5 R t textt searcht object_was_parsed( R^ t containerClassR t
strippablet it o( ( s+ lib/python2.7/site-packages/bs4/__init__.pyR{ s&
c C s | d k r | j } n | d k r- | } n | j } d } } } t | t r | j } | j } | j } | d k r | j } q n | j d k } | j | | | | | | | _ | j
j | | r | j | n d S( s Add an object to the parse tree.N(
R R| t _most_recent_elementR1 R t next_elementt next_siblingt previous_siblingt previous_elementt setupR R t _linkage_fixer( R^ R t parentt most_recent_elementR R R R t fix( ( s+ lib/python2.7/site-packages/bs4/__init__.pyR s$ c C s& | j d } | j d } | } | | k r | j d k r | | _ | j } | d k rq | | k rq d | _ n | | _ d | _ n d | _ t | t r | j r | j t
} n d | _ d | _ | } xN t r!| d k r Pn+ | j d k r| j | _ | | j _ Pn | j } q Wd S( s, Make sure linkage of this fragment is sound.i iN( R R R R R R R R1 R t _last_descendantRR R ( R^ t elt firstt childt
descendantt prev_elt target( ( s+ lib/python2.7/site-packages/bs4/__init__.pyR s0
c C s | | j k r d Sd } t | j } xn t | d d d D]V } | j | } | | j k r | | j k r | r | j } n Pn | j } q? W| S( s Pops the tag stack up to and including the most recent
instance of the given tag. If inclusivePop is false, pops the tag
stack up to but *not* including the most recent instqance of
the given tag.Ni i i( R~ R R5 R t rangeR} Rs R ( R^ R} R t inclusivePopt most_recently_poppedt
stack_sizeR t t( ( s+ lib/python2.7/site-packages/bs4/__init__.pyt _popToTag s
c C s | j | j rN t | j d k rN | j j sJ | j j | | rN d St | | j | | | | | j | j
} | d k r | S| j
d k r | | j
_ n | | _
| j | | S( s Push a start tag on to the stack.
If this method returns None, the tag was rejected by the
SoupStrainer. You should proceed as if the tag had not occurred
in the document. For instance, if this was a self-closing tag,
don't call handle_endtag.
i N(
R{ R! R5 R R t
search_tagR R RH R| R R R ( R^ R} R R R R ( ( s+ lib/python2.7/site-packages/bs4/__init__.pyt handle_starttag s
c C s | j | j | | d S( N( R{ R ( R^ R} R ( ( s+ lib/python2.7/site-packages/bs4/__init__.pyt
handle_endtag1 s
c C s | j j | d S( N( R R ( R^ t data( ( s+ lib/python2.7/site-packages/bs4/__init__.pyt handle_data6 s t minimalc C sp | j r5 d } | d k r( d | } n d | } n d } | sJ d } n d } | t t | j | | | S( sl Returns a string or Unicode representation of this document.
To get Unicode, pass None for encoding.R s encoding="%s"u
u i N( R< R t superR Rv ( R^ t pretty_printt eventual_encodingt formattert
encoding_partRs t indent_level( ( s+ lib/python2.7/site-packages/bs4/__init__.pyRv 9 s
N(! t __name__t
__module__t __doc__R~ R6 R RG R Rj Rl Ro t staticmethodRU R\ R[ R R
R R R R R R{ R R R R R R R RR R Rv ( ( ( s+ lib/python2.7/site-packages/bs4/__init__.pyR 6 s8
( t BeautifulStoneSoupc B s e Z d Z d Z RS( s& Deprecated interface to an XML parser.c O s4 d | d s4 L