HEX

File: //usr/lib/python3/dist-packages/bs4/__pycache__/dammit.cpython-38.pyc
U

t�^N��@sDdZdZddlZddlmZddlZddlZddlZdZzddl	Z	dd�Z
WnFek
r�zddlZdd�Z
Wnek
r�dd�Z
YnXYnXzddl
Z
Wnek
r�YnXd	Zd
Ze�Ze�e�d�ej�e�e�d�ej�d�ee<e�eej�e�eej�d�ee<Gd
d�de�ZGdd�d�ZGdd�d�ZdS)aBBeautiful 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)�codepoint2namecCst|t�rdSt�|�dS�N�encoding)�
isinstance�str�cchardet�detect��s�r�,/usr/lib/python3/dist-packages/bs4/dammit.py�chardet_dammits
r
cCst|t�rdSt�|�dSr)rr�chardetrr	rrrr
"s
cCsdS�Nrr	rrrr
*sz$^\s*<\?.*encoding=['"](.*?)['"].*\?>z0<\s*meta[^>]+charset\s*=\s*["']?([^>]*?)[ /;'">]�ascii)�html�xmlc@s�eZdZdZdd�Ze�\ZZZdddddd	�Ze	�
d
�Ze	�
d�Ze
dd
��Ze
dd��Ze
dd��Ze
ddd��Ze
ddd��Ze
dd��ZdS)�EntitySubstitutionzFThe ability to substitute XML or HTML entities for certain characters.cCsti}i}g}dg}tt���|D]2\}}t|�}|dkrL|�|�|||<|||<q"dd�|�}||t�|�fS)N)�'�apos)�"rz[%s]�)�listr�items�chr�append�join�re�compile)�lookupZreverse_lookupZcharacters_for_reZextraZ	codepoint�name�	characterZ
re_definitionrrr�_populate_class_variablesGs

z,EntitySubstitution._populate_class_variablesrZquotZamp�lt�gt)�'�"�&�<�>z&([<>]|&(?!#\d+;|#x[0-9a-fA-F]+;|\w+;))z([<>&])cCs|j�|�d��}d|S)ziUsed with a regular expression to substitute the
        appropriate HTML entity for a special character.r�&%s;)�CHARACTER_TO_HTML_ENTITY�get�group��clsZmatchobjZentityrrr�_substitute_html_entityqsz*EntitySubstitution._substitute_html_entitycCs|j|�d�}d|S)zhUsed with a regular expression to substitute the
        appropriate XML entity for a special character.rr*)�CHARACTER_TO_XML_ENTITYr-r.rrr�_substitute_xml_entityxsz)EntitySubstitution._substitute_xml_entitycCs6d}d|kr*d|kr&d}|�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 &quot;Bob's bar&quot;
        r&r%z&quot;)�replace)�self�valueZ
quote_withZreplace_withrrr�quoted_attribute_valuesz)EntitySubstitution.quoted_attribute_valueFcCs"|j�|j|�}|r|�|�}|S)aSubstitute XML entities for special XML characters.

        :param value: A string to be substituted. The less-than sign
          will become &lt;, the greater-than sign will become &gt;,
          and any ampersands will become &amp;. 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_BRACKET�subr2r6�r/r5Zmake_quoted_attributerrr�substitute_xml�s�
z!EntitySubstitution.substitute_xmlcCs"|j�|j|�}|r|�|�}|S)a�Substitute XML entities for special XML characters.

        :param value: A string to be substituted. The less-than sign will
          become &lt;, the greater-than sign will become &gt;, and any
          ampersands that are not part of an entity defition will
          become &amp;.

        :param make_quoted_attribute: If True, then the string will be
         quoted, as befits an attribute value.
        )�BARE_AMPERSAND_OR_BRACKETr8r2r6r9rrr�"substitute_xml_containing_entities�s�
z5EntitySubstitution.substitute_xml_containing_entitiescCs|j�|j|�S)aReplace 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 "&eacute;" will make it more readable to some
        people.

        :param s: A Unicode string.
        )�CHARACTER_TO_HTML_ENTITY_REr8r0)r/r
rrr�substitute_html�s�z"EntitySubstitution.substitute_htmlN)F)F)�__name__�
__module__�__qualname__�__doc__r"r+ZHTML_ENTITY_TO_CHARACTERr=r1rrr;r7�classmethodr0r2r6r:r<r>rrrrrDs4��




$�rc@sHeZdZdZddd�Zdd�Zedd	��Zed
d��Z	eddd
��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 <meta> 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.
    NFcCsN|pg|_|pg}tdd�|D��|_d|_||_d|_|�|�\|_|_dS)a�Constructor.

        :param markup: Some markup in an unknown encoding.
        :param override_encodings: These encodings will be tried first.
        :param is_html: If True, this markup is considered to be HTML. Otherwise
            it's assumed to be XML.
        :param exclude_encodings: These encodings will not be tried, even
            if they otherwise would be.
        cSsg|]}|���qSr)�lower)�.0�xrrr�
<listcomp>sz-EncodingDetector.__init__.<locals>.<listcomp>N)	�override_encodings�set�exclude_encodings�chardet_encoding�is_html�declared_encoding�strip_byte_order_mark�markup�sniffed_encoding)r4rPrIrMrKrrr�__init__�s
zEncodingDetector.__init__cCs8|dk	r4|��}||jkrdS||kr4|�|�dSdS)z�Should we even bother to try this encoding?

        :param encoding: Name of an encoding.
        :param tried: Encodings that have already been tried. This will be modified
            as a side effect.
        NFT)rErK�add)r4r�triedrrr�_usable
s

zEncodingDetector._usableccs�t�}|jD]}|�||�r|Vq|�|j|�r:|jV|jdkrV|�|j|j�|_|�|j|�rl|jV|jdkr�t	|j�|_|�|j|�r�|jVdD]}|�||�r�|Vq�dS)zmYield a number of encodings that might work for this markup.

        :yield: A sequence of strings.
        N)�utf-8�windows-1252)
rJrIrUrQrN�find_declared_encodingrPrMrLr
)r4rT�errr�	encodingss(

�
zEncodingDetector.encodingscCs�d}t|t�r||fSt|�dkrT|dd�dkrT|dd�dkrTd}|dd�}n�t|�dkr�|dd�dkr�|dd�dkr�d}|dd�}nd|dd	�d
kr�d}|d	d�}nB|dd�dkr�d
}|dd�}n |dd�dkr�d}|dd�}||fS)z�If a byte-order mark is present, strip it and return the encoding it implies.

        :param data: Some markup.
        :return: A 2-tuple (modified data, implied encoding)
        N��s��zzutf-16bes��zutf-16le�srVs��zutf-32bes��zutf-32le)rr�len)r/�datarrrrrO>s.
��z&EncodingDetector.strip_byte_order_markcCs�|rt|�}}nd}tdtt|�d��}t|t�r@tt}ntt}|d}|d}d}	|j||d�}
|
s�|r�|j||d�}
|
dk	r�|
��d}	|	r�t|	t�r�|	�	d	d
�}	|	�
�SdS)a�Given a document, tries to find its declared encoding.

        An XML encoding is declared at the beginning of the document.

        An HTML encoding is declared in a <meta> tag, hopefully near the
        beginning of the document.

        :param markup: Some markup.
        :param is_html: If True, this markup is considered to be HTML. Otherwise
            it's assumed to be XML.
        :param search_entire_document: Since an encoding is supposed to declared near the beginning
            of the document, most of the time it's only necessary to search a few kilobytes of data.
            Set this to True to force this method to search the entire document.
        iig�������?rrN)�endposrrr3)r^�max�intr�bytes�encoding_resr�search�groups�decoderE)r/rPrMZsearch_entire_documentZ
xml_endposZhtml_endpos�resZxml_reZhtml_rerNZdeclared_encoding_matchrrrrX\s(


z'EncodingDetector.find_declared_encoding)NFN)FF)r?r@rArBrRrU�propertyrZrCrOrXrrrrrD�s�

#
rDc�@s�eZdZdZddd�ZdddgZgdd	gfd
d�Zdd
�Zd�dd�Zd�dd�Z	e
dd��Zdd�Zdd�Z
dddddddd d!d"d#d$d%d&d'd&d&d(d)d*d+d,d-d.d/d0d1d2d3d&d4d5d6� Zd7dd8d9d:d;d<d=d>d?d@dAdBd&dCd&d&dDdDdEdEdFdGdHdIdJdKdLdMd&dNdOddPdQdRdSdTdUd@dVdWdXdYdPddZdGd[d\d]d^d_d`dadFd8dbdXdcdddedfd&dgdgdgdgdgdgdhdidjdjdjdjdkdkdkdkdldmdndndndndndFdndododododOdpdqdrdrdrdrdrdrdsdQdtdtdtdtdudududud[dvd[d[d[d[d[dwd[d`d`d`d`dxdpdxdy��Zdzd{d|d}d~dd�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�zZd�d�d�gZed�d�Zed�d�Ze�dd�d���ZdS(�
UnicodeDammitz�A 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-sjisrWz
iso-8859-1z
iso-8859-2NFcCs�||_g|_d|_||_t�t�|_t||||�|_	t
|t�sF|dkr`||_t|�|_
d|_dS|j	j|_d}|j	jD]"}|j	j}|�|�}|dk	rvq�qv|s�|j	jD]6}|dkr�|�|d�}|dk	r�|j�d�d|_q�q�||_
|s�d|_dS)aPConstructor.

        :param markup: A bytestring representing markup in an unknown encoding.
        :param override_encodings: These encodings will be tried first,
           before any sniffing code is run.

        :param smart_quotes_to: By default, Microsoft smart quotes will, like all other characters, be converted
           to Unicode characters. Setting this to 'ascii' will convert them to ASCII quotes instead.
           Setting it to 'xml' will convert them to XML entity references, and setting it to 'html'
           will convert them to HTML entity references.
        :param is_html: If True, this markup is considered to be HTML. Otherwise
            it's assumed to be XML.
        :param exclude_encodings: These encodings will not be considered, even
            if the sniffing code thinks they might make sense.
        FrNrr3zSSome characters could not be decoded, and were replaced with REPLACEMENT CHARACTER.T)�smart_quotes_to�tried_encodingsZcontains_replacement_charactersrM�loggingZ	getLoggerr?�logrD�detectorrrrPZunicode_markup�original_encodingrZ�
_convert_fromZwarning)r4rPrIrlrMrK�urrrrrR�sH�


�zUnicodeDammit.__init__cCs�|�d�}|jdkr&|j�|���}nf|j�|�}t|�tkr�|jdkrfd��|d��d��}q�d��|d��d��}n|��}|S)z[Changes a MS smart quote character to an XML or HTML
        entity, or an ASCII character.�rrz&#x�;r'r)r-rl�MS_CHARS_TO_ASCIIr,�encode�MS_CHARS�type�tuple)r4�matchZorigr8rrr�_sub_ms_char�s


zUnicodeDammit._sub_ms_char�strictc
Cs�|�|�}|r||f|jkr dS|j�||f�|j}|jdk	rf||jkrfd}t�|�}|�|j	|�}z|�
|||�}||_||_Wn(tk
r�}z
WY�dSd}~XYnX|jS)z|Attempt to convert the markup to the proposed encoding.

        :param proposed: The name of a character encoding.
        Ns([�-�]))
�
find_codecrmrrPrl�ENCODINGS_WITH_SMART_QUOTESrrr8r|�_to_unicoderq�	Exception)r4Zproposed�errorsrPZsmart_quotes_reZsmart_quotes_compiledrsrYrrrrr�s$

�

zUnicodeDammit._convert_fromcCst|||�S)z}Given a string and its encoding, decodes the string into Unicode.

        :param encoding: The name of an encoding.
        )r)r4r_rr�rrrr�	szUnicodeDammit._to_unicodecCs|js
dS|jjS)zhIf the markup is an HTML document, returns the encoding declared _within_
        the document.
        N)rMrprN)r4rrr�declared_html_encodingsz$UnicodeDammit.declared_html_encodingcCs`|�|j�||��pN|r*|�|�dd��pN|r@|�|�dd��pN|rL|��pN|}|r\|��SdS)z�Convert the name of a character set to a codec name.

        :param charset: The name of a character set.
        :return: The name of a codec.
        �-r�_N)�_codec�CHARSET_ALIASESr,r3rE)r4�charsetr5rrrr~s��
��zUnicodeDammit.find_codecc	Cs<|s|Sd}zt�|�|}Wnttfk
r6YnX|Sr)�codecsr�LookupError�
ValueError)r4r��codecrrrr�)s
zUnicodeDammit._codec)ZeuroZ20AC� )ZsbquoZ201A)ZfnofZ192)ZbdquoZ201E)ZhellipZ2026)ZdaggerZ2020)ZDaggerZ2021)ZcircZ2C6)ZpermilZ2030)ZScaronZ160)ZlsaquoZ2039)ZOEligZ152�?)z#x17DZ17D)ZlsquoZ2018)ZrsquoZ2019)ZldquoZ201C)ZrdquoZ201D)ZbullZ2022)ZndashZ2013)ZmdashZ2014)�tildeZ2DC)ZtradeZ2122)ZscaronZ161)ZrsaquoZ203A)ZoeligZ153)z#x17EZ17E)ZYumlr) ����������������������������������������������������������������ZEUR�,�fz,,z...�+z++�^�%�Sr(ZOE�Zr%r&�*r�z--�~z(TM)r
r)Zoe�z�Y�!�cZGBP�$ZYEN�|z..rz(th)z<<z(R)�oz+-�2�3)r%Zacuters�P�1z>>z1/4z1/2z3/4�AZAE�C�E�I�D�N�O�U�b�B�aZaerY�i�n�/�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¬ss®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�����������������������������������������������������������������������������������������������������������������������������������������������������������������������������)rpr�r\)r�r�r])r�r�r[r���rt�utf8cCs|�dd���dkrtd��|��dkr0td��g}d}d}|t|�kr�||}t|t�sbt|�}||jkr�||jkr�|j	D]&\}}	}
||kr|||	kr|||
7}q�q|q<|dkr�||j
kr�|�|||��|�|j
|�|d	7}|}q<|d	7}q<|dk�r|S|�||d
��d�|�S)aFix 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.

        :param in_bytes: A bytestring that you suspect contains
            characters from multiple encodings. Note that this _must_
            be a bytestring. If you've already converted the document
            to Unicode, you're too late.
        :param main_encoding: The primary encoding of `in_bytes`.
        :param embedded_encoding: The encoding that was used to embed characters
            in the main document.
        :return: A bytestring in which `embedded_encoding`
          characters have been converted to their `main_encoding`
          equivalents.
        r�r�)rW�windows_1252zPWindows-1252 and ISO-8859-1 are the only currently supported embedded encodings.)r�rVz4UTF-8 is the only currently supported main encoding.rr3rtN�)
r3rE�NotImplementedErrorr^rrb�ord�FIRST_MULTIBYTE_MARKER�LAST_MULTIBYTE_MARKER�MULTIBYTE_MARKERS_AND_SIZES�WINDOWS_1252_TO_UTF8rr)r/Zin_bytesZ
main_encodingZembedded_encodingZbyte_chunksZchunk_start�posZbyte�start�end�sizerrr�	detwingleis@��

�

zUnicodeDammit.detwingle)r})r})r�rW)r?r@rArBr�rrRr|rrr�rir�r~r�rxrvr�r�r�r�rCr�rrrrrj�sz	���
A



�%���~��rj)rBZ__license__r�Z
html.entitiesrrrn�stringZchardet_typerr
�ImportErrorrZiconv_codecZxml_encodingZ	html_meta�dictrdrrwr�rcr�objectrrDrjrrrr�<module>sD�
�
%