U
    ;»{j/'  ã                   @   s6  d Z ddlZddlmZ e d¡Ze dejejB ejB ¡Z	e dej
ejB ejB ¡Ze dej¡ZG dd	„ d	eƒZG d
d„ deƒZd2dd„Zd3dd„Zd4dd„Zd5dd„Zdd„ Zdd„ Zdd„ Zdd„ Zdd„ Zi Zdd „ Zd!d"„ Zd6d#d$„Zd7d&d'„ZG d(d)„ d)ƒZ d*d+„ Z!d,d-„ Z"d.d/„ Z#G d0d1„ d1eƒZ$dS )8z±
    pygments.util
    ~~~~~~~~~~~~~

    Utility functions.

    :copyright: Copyright 2006-2024 by the Pygments team, see AUTHORS.
    :license: BSD, see LICENSE for details.
é    N)ÚTextIOWrapperz[/\\ ]z”
    <!DOCTYPE\s+(
     [a-zA-Z_][a-zA-Z0-9]*
     (?: \s+      # optional in HTML5
     [a-zA-Z_][a-zA-Z0-9]*\s+
     "[^"]*")?
     )
     [^>]*>
z<(.+?)(\s.*?)?>.*?</.+?>z\s*<\?xml[^>]*\?>c                   @   s   e Zd ZdZdS )ÚClassNotFoundzCRaised if one of the lookup functions didn't find a matching class.N©Ú__name__Ú
__module__Ú__qualname__Ú__doc__© r	   r	   ú:/tmp/pip-install-zsn1f9xv/pip/pip/_vendor/pygments/util.pyr      s   r   c                   @   s   e Zd ZdZdS )ÚOptionErrorzƒ
    This exception will be raised by all option processing functions if
    the type or value of the argument is not correct.
    Nr   r	   r	   r	   r
   r   "   s   r   Fc              	   C   s@   |   ||¡}|r| ¡ }||kr<td |d tt|ƒ¡¡ƒ‚|S )z}
    If the key `optname` from the dictionary is not in the sequence
    `allowed`, raise an error, otherwise return it.
    z%Value for option {} must be one of {}z, )ÚgetÚlowerr   ÚformatÚjoinÚmapÚstr)ÚoptionsÚoptnameÚallowedÚdefaultÚnormcaseÚstringr	   r	   r
   Úget_choice_opt(   s    r   c                 C   sˆ   |   ||¡}t|tƒr|S t|tƒr,t|ƒS t|tƒsNtd|›d|› d�ƒ‚n6| ¡ dkr^dS | ¡ dkrndS td|›d|› d�ƒ‚d	S )
a@  
    Intuitively, this is `options.get(optname, default)`, but restricted to
    Boolean value. The Booleans can be represented as string, in order to accept
    Boolean value from the command line arguments. If the key `optname` is
    present in the dictionary `options` and is not associated with a Boolean,
    raise an `OptionError`. If it is absent, `default` is returned instead.

    The valid string values for ``True`` are ``1``, ``yes``, ``true`` and
    ``on``, the ones for ``False`` are ``0``, ``no``, ``false`` and ``off``
    (matched case-insensitively).
    úInvalid type ú for option z%; use 1/0, yes/no, true/false, on/off)Ú1ÚyesÚtrueÚonT)Ú0ÚnoÚfalseÚoffFúInvalid value N)r   Ú
isinstanceÚboolÚintr   r   r   ©r   r   r   r   r	   r	   r
   Úget_bool_opt5   s    


r(   c              	   C   sn   |   ||¡}z
t|ƒW S  tk
r@   td|›d|› d�ƒ‚Y n* tk
rh   td|›d|› d�ƒ‚Y nX dS )z?As :func:`get_bool_opt`, but interpret the value as an integer.r   r   z ; you must give an integer valuer#   N)r   r&   Ú	TypeErrorr   Ú
ValueErrorr'   r	   r	   r
   Úget_int_optR   s    
r+   c                 C   sN   |   ||¡}t|tƒr| ¡ S t|ttfƒr4t|ƒS td|›d|› d�ƒ‚dS )zµ
    If the key `optname` from the dictionary `options` is a string,
    split it at whitespace and return it. If it is already a list
    or a tuple, it is returned as a list.
    r   r   z; you must give a list valueN)r   r$   r   ÚsplitÚlistÚtupler   )r   r   r   Úvalr	   r	   r
   Úget_list_opt^   s    
r0   c                 C   sP   | j s
dS g }| j  ¡  ¡ D ]$}| ¡ r<| d| ¡  ¡ q qBqd |¡ ¡ S )NÚ ú )r   ÚstripÚ
splitlinesÚappendr   Úlstrip)ÚobjÚresÚliner	   r	   r
   Údocstring_headlinen   s    r:   c                    s   ‡ fdd„}ˆ j |_ t|ƒS )zAReturn a static text analyser function that returns float values.c              	      sb   zˆ | ƒ}W n t k
r"   Y dS X |s,dS ztdtdt|ƒƒƒW S  ttfk
r\   Y dS X d S )Ng        g      ð?)Ú	ExceptionÚminÚmaxÚfloatr*   r)   )ÚtextÚrv©Úfr	   r
   Útext_analyse|   s    z%make_analysator.<locals>.text_analyse)r   Ústaticmethod)rB   rC   r	   rA   r
   Úmake_analysatorz   s    rE   c                 C   s¢   |   d¡}|dkr$| d|…  ¡ }n|  ¡ }| d¡ržz(dd„ t |dd…  ¡ ¡D ƒd }W n tk
rt   Y d	S X t d
|› d�tj	¡}| 
|¡dk	rždS d	S )aò  Check if the given regular expression matches the last part of the
    shebang if one exists.

        >>> from pygments.util import shebang_matches
        >>> shebang_matches('#!/usr/bin/env python', r'python(2\.\d)?')
        True
        >>> shebang_matches('#!/usr/bin/python2.4', r'python(2\.\d)?')
        True
        >>> shebang_matches('#!/usr/bin/python-ruby', r'python(2\.\d)?')
        False
        >>> shebang_matches('#!/usr/bin/python/ruby', r'python(2\.\d)?')
        False
        >>> shebang_matches('#!/usr/bin/startsomethingwith python',
        ...                 r'python(2\.\d)?')
        True

    It also checks for common windows executable file extensions::

        >>> shebang_matches('#!C:\\Python2.4\\Python.exe', r'python(2\.\d)?')
        True

    Parameters (``'-f'`` or ``'--foo'`` are ignored so ``'perl'`` does
    the same as ``'perl -e'``)

    Note that this method automatically searches the whole string (eg:
    the regular expression is wrapped in ``'^$'``)
    Ú
r   Nz#!c                 S   s   g | ]}|r|  d ¡s|‘qS )ú-)Ú
startswith)Ú.0Úxr	   r	   r
   Ú
<listcomp>®   s     
ÿz#shebang_matches.<locals>.<listcomp>é   éÿÿÿÿFú^z(\.(exe|cmd|bat|bin))?$T)Úfindr   rH   Úsplit_path_rer,   r3   Ú
IndexErrorÚreÚcompileÚ
IGNORECASEÚsearch)r?   ÚregexÚindexÚ
first_lineÚfoundr	   r	   r
   Úshebang_matches‹   s    

ÿrZ   c                 C   s<   t  | ¡}|dkrdS | d¡}t |tj¡ | ¡ ¡dk	S )zÁCheck if the doctype matches a regular expression (if present).

    Note that this method only checks the first part of a DOCTYPE.
    eg: 'html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"'
    NFé   )Údoctype_lookup_rerU   ÚgrouprR   rS   ÚIÚmatchr3   )r?   rV   ÚmÚdoctyper	   r	   r
   Údoctype_matches¸   s
    

rb   c                 C   s
   t | dƒS )z3Check if the file looks like it has a html doctype.Úhtml)rb   )r?   r	   r	   r
   Úhtml_doctype_matchesÅ   s    rd   c                 C   st   t  | ¡rdS t| ƒ}z
t| W S  tk
rn   t | ¡}|dk	rHY dS t | dd… ¡dk	}|t|< | Y S X dS )z2Check if a doctype exists or if we have some tags.TNiè  )Úxml_decl_rer_   ÚhashÚ_looks_like_xml_cacheÚKeyErrorr\   rU   Útag_re)r?   Úkeyr`   r@   r	   r	   r
   Úlooks_like_xmlÍ   s    


rk   c                 C   s   d| d?  d| d@  fS )zoGiven a unicode character code with length greater than 16 bits,
    return the two 16 bit surrogate pair.
    iÀ×  é
   i Ü  iÿ  r	   )Úcr	   r	   r
   ÚsurrogatepairÝ   s    rn   c           	      C   s¤   g }d| d }d|d  d }|  ||  d ¡ |rT|D ]}|  || d ¡ q:n8|D ]2}t|d ƒ}|  ||dd…  |d	  d ¡ qX|  |d
 ¡ d |¡S )z)Formats a sequence of strings for output.r2   é   r[   z = (ú,ú"NéþÿÿÿrM   ú)rF   )r5   Úreprr   )	Úvar_nameÚseqÚrawÚindent_levelÚlinesZbase_indentZinner_indentÚiÚrr	   r	   r
   Úformat_linesæ   s    $r|   r	   c                 C   s>   g }t ƒ }| D ]*}||ks||kr$q| |¡ | |¡ q|S )za
    Returns a list with duplicates removed from the iterable `it`.

    Order is preserved.
    )Úsetr5   Úadd)ÚitZalready_seenÚlstÚseenrz   r	   r	   r
   Úduplicates_removedù   s    
r‚   c                   @   s   e Zd ZdZdd„ ZdS )ÚFuturez‡Generic class to defer some work.

    Handled specially in RegexLexerMeta, to support regex string construction at
    first use.
    c                 C   s   t ‚d S ©N)ÚNotImplementedError©Úselfr	   r	   r
   r     s    z
Future.getN)r   r   r   r   r   r	   r	   r	   r
   rƒ   	  s   rƒ   c                 C   s„   z|   d¡} | dfW S  tk
r~   z&ddl}| ¡ }|   ¡ } | |fW  Y S  ttfk
rx   |   d¡} | df Y  Y S X Y nX dS )zÃDecode *text* with guessed encoding.

    First try UTF-8; this should fail for non-UTF-8 encodings.
    Then try the preferred locale encoding.
    Fall back to latin-1, which always works.
    zutf-8r   NÚlatin1)ÚdecodeÚUnicodeDecodeErrorÚlocaleÚgetpreferredencodingÚLookupError)r?   r‹   Zprefencodingr	   r	   r
   Úguess_decode  s    


rŽ   c                 C   sD   t |ddƒr<z|  |j¡} W n tk
r0   Y nX | |jfS t| ƒS )zÊDecode *text* coming from terminal *term*.

    First try the terminal encoding, if given.
    Then try UTF-8.  Then try the preferred locale encoding.
    Fall back to latin-1, which always works.
    ÚencodingN)Úgetattrr‰   r�   rŠ   rŽ   )r?   Útermr	   r	   r
   Úguess_decode_from_terminal(  s    
r’   c                 C   s"   t | ddƒr| jS ddl}| ¡ S )z7Return our best guess of encoding for the given *term*.r�   Nr   )r�   r�   r‹   rŒ   )r‘   r‹   r	   r	   r
   Úterminal_encoding9  s    r“   c                   @   s   e Zd Zdd„ ZdS )ÚUnclosingTextIOWrapperc                 C   s   |   ¡  d S r„   )Úflushr†   r	   r	   r
   ÚcloseC  s    zUnclosingTextIOWrapper.closeN)r   r   r   r–   r	   r	   r	   r
   r”   A  s   r”   )NF)N)N)N)Fr   )r	   )%r   rR   Úior   rS   rP   ÚDOTALLÚ	MULTILINEÚVERBOSEr\   rT   ri   r^   re   r*   r   r;   r   r   r(   r+   r0   r:   rE   rZ   rb   rd   rg   rk   rn   r|   r‚   rƒ   rŽ   r’   r“   r”   r	   r	   r	   r
   Ú<module>   s>   

ø	ÿ



-	


