eaiovnaovbqoebvqoeavibavo
3
6]t @ s
d Z dZddlZddlmZ ddlZddlZddlZdZyddl Z dd Z
W nF e k
r yddl Z dd Z
W n e k
r dd Z
Y nX Y nX y ddl
Z
W n e k
r Y nX ejd j ejZejd
j ejZG d d d eZG d
d dZG dd dZdS )aB Beautiful Soup bonus library: Unicode, Dammit
This library converts a bytestream to Unicode through any means
necessary. It is heavily based on code from Mark Pilgrim's Universal
Feed Parser. It works best on XML and HTML, but it does not rewrite the
XML or HTML to reflect a new encoding; that's the tree builder's job.
ZMIT N)codepoint2namec C s t j| d S )Nencoding)cchardetdetect)s r /usr/lib/python3.6/dammit.pychardet_dammit s r c C s t j| d S )Nr )chardetr )r r r r r ! s c C s d S )Nr )r r r r r ' s z!^<\?.*encoding=['"](.*?)['"].*\?>z0<\s*meta[^>]+charset\s*=\s*["']?([^>]*?)[ /;'">]c @ s e Zd ZdZdd Ze \ZZZdddddd Ze j
d
Z e j
d Z e
d d
Ze
dd Ze
dd Ze
dddZe
dddZe
dd ZdS ) EntitySubstitutionzASubstitute XML or HTML entities for the corresponding characters.c C sn i } i }g }xBt tj D ]2\}}t|}|dkrD|j| || |< |||< qW ddj| }| |tj|fS )N" z[%s] )listr itemschrappendjoinrecompile)lookupZreverse_lookupZcharacters_for_reZ codepointname characterZ
re_definitionr r r _populate_class_variables9 s
z,EntitySubstitution._populate_class_variablesZaposZquotZampltgt)'"&<>z&([<>]|&(?!#\d+;|#x[0-9a-fA-F]+;|\w+;))z([<>&])c C s | j j|jd}d| S )Nr z&%s;)CHARACTER_TO_HTML_ENTITYgetgroup)clsmatchobjentityr r r _substitute_html_entityZ s z*EntitySubstitution._substitute_html_entityc C s | j |jd }d| S )zmUsed with a regular expression to substitute the
appropriate XML entity for an XML special character.r z&%s;)CHARACTER_TO_XML_ENTITYr" )r# r$ r% r r r _substitute_xml_entity_ s z)EntitySubstitution._substitute_xml_entityc C s6 d}d|kr*d|kr&d}|j d|}nd}|| | S )a* Make a value into a quoted XML attribute, possibly escaping it.
Most strings will be quoted using double quotes.
Bob's Bar -> "Bob's Bar"
If a string contains double quotes, it will be quoted using
single quotes.
Welcome to "my bar" -> 'Welcome to "my bar"'
If a string contains both single and double quotes, the
double quotes will be escaped, and the string will be quoted
using double quotes.
Welcome to "Bob's Bar" -> "Welcome to "Bob's bar"
r r z")replace)selfvalueZ
quote_withZ replace_withr r r quoted_attribute_valuef s z)EntitySubstitution.quoted_attribute_valueFc C s" | j j| j|}|r | j|}|S )a Substitute XML entities for special XML characters.
:param value: A string to be substituted. The less-than sign
will become <, the greater-than sign will become >,
and any ampersands will become &. If you want ampersands
that appear to be part of an entity definition to be left
alone, use substitute_xml_containing_entities() instead.
:param make_quoted_attribute: If True, then the string will be
quoted, as befits an attribute value.
)AMPERSAND_OR_BRACKETsubr( r, )r# r+ make_quoted_attributer r r substitute_xml s
z!EntitySubstitution.substitute_xmlc C s" | j j| j|}|r | j|}|S )a Substitute XML entities for special XML characters.
:param value: A string to be substituted. The less-than sign will
become <, the greater-than sign will become >, and any
ampersands that are not part of an entity defition will
become &.
:param make_quoted_attribute: If True, then the string will be
quoted, as befits an attribute value.
)BARE_AMPERSAND_OR_BRACKETr. r( r, )r# r+ r/ r r r "substitute_xml_containing_entities s
z5EntitySubstitution.substitute_xml_containing_entitiesc C s | j j| j|S )a Replace certain Unicode characters with named HTML entities.
This differs from data.encode(encoding, 'xmlcharrefreplace')
in that the goal is to make the result more readable (to those
with ASCII displays) rather than to recover from
errors. There's absolutely nothing wrong with a UTF-8 string
containg a LATIN SMALL LETTER E WITH ACUTE, but replacing that
character with "é" will make it more readable to some
people.
)CHARACTER_TO_HTML_ENTITY_REr. r& )r# r r r r substitute_html s z"EntitySubstitution.substitute_htmlN)F)F)__name__
__module__ __qualname____doc__r r ZHTML_ENTITY_TO_CHARACTERr3 r' r r r1 r- classmethodr& r( r, r0 r2 r4 r r r r r 5 s$
% r c @ sH e Zd ZdZdddZdd Zedd Zed
d Z edd d
Z
dS )EncodingDetectora^ Suggests a number of possible encodings for a bytestring.
Order of precedence:
1. Encodings you specifically tell EncodingDetector to try first
(the override_encodings argument to the constructor).
2. An encoding declared within the bytestring itself, either in an
XML declaration (if the bytestring is to be interpreted as an XML
document), or in a tag (if the bytestring is to be
interpreted as an HTML document.)
3. An encoding detected through textual analysis by chardet,
cchardet, or a similar external library.
4. UTF-8.
5. Windows-1252.
NFc C sN |pg | _ |pg }tdd |D | _d | _|| _d | _| j|\| _| _d S )Nc S s g | ] }|j qS r )lower).0xr r r
s z-EncodingDetector.__init__..) override_encodingssetexclude_encodingschardet_encodingis_htmldeclared_encodingstrip_byte_order_markmarkupsniffed_encoding)r* rF r? rC rA r r r __init__ s
zEncodingDetector.__init__c C s8 |d k r4|j }|| jkr dS ||kr4|j| dS dS )NFT)r; rA add)r* r triedr r r _usable s
zEncodingDetector._usablec c s t }x | jD ]}| j||r|V qW | j| j|r>| jV | jdkrZ| j| j| j| _| j| j|rp| jV | jdkrt | j| _| j| j|r| jV x dD ]}| j||r|V qW dS )z tag, hopefully near the
beginning of the document.
i i g?N)endposr asciir) ) rV maxintxml_encoding_research html_meta_regroupsdecoder; )r# rF rC Zsearch_entire_documentZ
xml_endposZ html_endposrD Zdeclared_encoding_matchr r r rN + s
z'EncodingDetector.find_declared_encoding)NFN)FF) r5 r6 r7 r8 rH rK propertyrP r9 rE rN r r r r r: s
! r: c @ sR e Zd ZdZdddZdddgZg dd g fd
d Zd d
Zd ddZd ddZ e
dd Z dd Z dd Z
d dd d!d"d#d$d%d&d'd(d)d*d2d+d2d2d,d-d.d/d0d1d2d3d4d5d6d7d2d8d9dQ ZdRddSdTdUdVdWdXdYdZd[d\d]d2d^d2d2d_d_d`d`dadbdcdddedfdgdhd2didjddkdldmdndodpd[dqdPdrdsdkddtdbdudvdwdxd:dzd{dadSd|drd}d~ddd2ddddddddddddddddddddddddaddddddjddddddddddlddddddddduddudududududdudzdzdzdzddddZddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd ddddddddd d
d d d
dzZd;d<d=gZed d Zed> d Zed?dd ZdS (@
UnicodeDammitzA class for detecting the encoding of a *ML document and
converting it to a Unicode string. If the source encoding is
windows-1252, can replace MS smart quotes with their HTML or XML
equivalents.z mac-romanz shift-jis) macintoshzx-sjis windows-1252z
iso-8859-1z
iso-8859-2NFc C s || _ g | _d| _|| _tjt| _t||||| _ t
|t sF|dkr`|| _ t || _
d | _d S | j j | _ d }x,| j jD ] }| j j }| j|}|d k rxP qxW |sx@| j jD ]4}|dkr| j|d}|d k r| jjd d| _P qW || _
|sd | _d S )NFr
rY r) zSSome characters could not be decoded, and were replaced with REPLACEMENT CHARACTER.T)smart_quotes_totried_encodingsZ contains_replacement_charactersrC loggingZ getLoggerr5 logr: detectorrT rU rF Zunicode_markuporiginal_encodingrP
_convert_fromZwarning)r* rF r? re rC rA ur r r r rH X s>
zUnicodeDammit.__init__c C s |j d}| jdkr&| jj|j }nf| jj|}t|tkr| jdkrfdj |d j dj }qdj |d j dj }n|j }|S )z[Changes a MS smart quote character to an XML or HTML
entity, or an ASCII character. rY Zxmlz&#x;r r )r" re MS_CHARS_TO_ASCIIr! encodeMS_CHARStypetuple)r* matchZorigr. r r r _sub_ms_char s
zUnicodeDammit._sub_ms_charstrictc C s | j |}| s ||f| jkr"d S | jj||f | j}| jd k rh|| jkrhd}tj|}|j| j |}y | j
|||}|| _|| _ W n t k
r } zd S d }~X nX | jS )Ns ([-]))
find_codecrf r rF re ENCODINGS_WITH_SMART_QUOTESr r r. ru _to_unicoderj Exception)r* ZproposederrorsrF Zsmart_quotes_reZsmart_quotes_compiledrl rO r r r rk s"
zUnicodeDammit._convert_fromc C s t |||S )zGiven a string and its encoding, decodes the string into Unicode.
%encoding is a string recognized by encodings.aliases)rU )r* rW r r{ r r r ry s zUnicodeDammit._to_unicodec C s | j s
d S | jjS )N)rC ri rD )r* r r r declared_html_encoding s z$UnicodeDammit.declared_html_encodingc C s` | j | jj||pN|r*| j |jddpN|r@| j |jddpN|rL|j pN|}|r\|j S d S )N-r
_)_codecCHARSET_ALIASESr! r) r; )r* charsetr+ r r r rw s zUnicodeDammit.find_codecc C s< |s|S d }yt j| |}W n ttfk
r6 Y nX |S )N)codecsr LookupError
ValueError)r* r codecr r r r s
zUnicodeDammit._codeceuro20AC sbquo201Afnof192bdquo201Ehellip2026dagger2020Dagger2021circ2C6permil2030Scaron160lsaquo2039OElig152?#x17D17Dlsquo2018rsquo2019ldquo201Crdquo201Dbull2022ndash2013mdash2014tilde2DCtrade2122scaron161rsaquo203Aoelig153#x17E17EYumlr
) ZEUR,fz,,z...+z++^%Sr ZOEZr r *r} z--~z(TM)r r ZoezY!cZGBP$ZYEN|z..z(th)z<>z1/4z1/2z3/4AZAECEIDNOUbBaZaerO in/y)r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r s €s ‚s ƒs „s …s †s ‡s ˆs ‰s Šs ‹s Œs Žs ‘s ’s “s ”s •s –s —s ˜s ™s šs ›s œs žs Ÿs s ¡s ¢s £s ¤s ¥s ¦s §s ¨s ©s ªs «s ¬s s ®s ¯s °s ±s ²s ³s ´s µs ¶s ·s ¸s ¹s ºs »s ¼s ½s ¾s ¿s Às Ás Âs Ãs Äs Ås Æs Çs Ès És Ês Ës Ìs Ís Îs Ïs Ðs Ñs Òs Ós Ôs Õs Ös ×s Øs Ùs Ús Ûs Üs Ýs Þs ßs àr s âs ãs äs ås æs çs ès és ês ës ìs ís îs ïs ðs ñs òs ós ôs õs ös ÷s øs ùs ús ûs üs ýs þ)z r r rR r r rS r r rQ r rm utf8c C s$ |j ddj dkr td|j dkr0tdg }d }d }x|t|k r|| }t|tsft|}|| jkr|| jkrxz| j D ]$\}} }
||kr|| kr||
7 }P qW q>|d
kr|| j
kr|j ||| |j | j
| |d 7 }|}q>|d 7 }q>W |d kr|S |j ||d d
j |S )a Fix characters from one encoding embedded in some other encoding.
Currently the only situation supported is Windows-1252 (or its
subset ISO-8859-1), embedded in UTF-8.
The input must be a bytestring. If you've already converted
the document to Unicode, you're too late.
The output is a bytestring in which `embedded_encoding`
characters have been converted to their `main_encoding`
equivalents.
r~ r} windows-1252 windows_1252zPWindows-1252 and ISO-8859-1 are the only currently supported embedded encodings.r utf-8z4UTF-8 is the only currently supported main encoding.r ra rm N )r r )r r )
r) r; NotImplementedErrorrV rT r[ ordFIRST_MULTIBYTE_MARKERLAST_MULTIBYTE_MARKERMULTIBYTE_MARKERS_AND_SIZESWINDOWS_1252_TO_UTF8r r ) r# Zin_bytesZ
main_encodingZembedded_encodingZ byte_chunksZ chunk_startposZbytestartendsizer r r detwingle s<
zUnicodeDammit.detwingle)rv )rv )r r )r r )r r )r r )r r )r r )r r )r r )r r )r r )r r )r r )r r )r r )r r )r r )r r )r r )r r )r r )r r )r r )r r )r r )r r )r r )r r
)r r )r r rR )r r rS )r r rQ )r rd )r5 r6 r7 r8 r rx rH ru rk ry ra r| rw r rq ro r r r r r9 r r r r r rb E s` 1
rb )r8 Z __license__r Z
html.entitiesr r rg stringZ chardet_typer r ImportErrorr
Z iconv_codecr rp r r\ r^ objectr r: rb r r r r s8