a
    hbòfF#  ã                   @   sÒ   d dl Z d dlZd dlmZ ddlmZmZmZmZ ddl	m
Z G dd„ dejejejejejƒZeejƒZe  de d	 ¡ZG d
d„ deƒZG dd„ deƒZG dd„ deƒZG dd„ deƒZG dd„ deƒZdS )é    N)ÚOptionalé   )ÚcolÚlineÚlinenoÚ_collapse_string_to_ranges)Úpyparsing_unicodec                   @   s   e Zd ZdS )ÚExceptionWordUnicodeN)Ú__name__Ú
__module__Ú__qualname__© r   r   ú]/home/httpd/docs/test/DocsMgr/lib/python3.9/site-packages/pip/_vendor/pyparsing/exceptions.pyr	      s   r	   z([z
]{1,16})|.c                   @   sÌ   e Zd ZdZd eeee dœdd„Zed!dd	„ƒZ	e
d
d„ ƒZeedœdd„ƒZeedœdd„ƒZeedœdd„ƒZeedœdd„ƒZedœdd„Zdd„ Zd"ddœeedœdd„Zd#edœdd„ZeZdS )$ÚParseBaseExceptionz7base exception class for all parsing runtime exceptionsr   N)ÚpstrÚlocÚmsgc                 C   sD   || _ |d u r|| _d| _n|| _|| _| | _| _|||f| _d S )NÚ )r   r   r   Úparser_elementÚparserElementÚargs)Úselfr   r   r   Úelemr   r   r   Ú__init__   s    zParseBaseException.__init__é   c                 C   s„  ddl }ddlm} |du r$t ¡ }g }t| tƒrV| | j¡ | d| j	d  d ¡ | d 
t| ƒj| ¡¡ |dk�rz|j| j|d�}tƒ }t|| d… ƒD ]Ø\}}|d }	|	j d	d¡}
t|
|ƒ�r|	jjd
vrØq t|
ƒ|v ræq | t|
ƒ¡ t|
ƒ}| d 
|j|j|
¡¡ nP|
du�r@t|
ƒ}| d 
|j|j¡¡ n&|	j}|jdv �rTq | d 
|j¡¡ |d8 }|s  �qzq d |¡S )aì  
        Method to take an exception and translate the Python internal traceback into a list
        of the pyparsing expressions that caused the exception to be raised.

        Parameters:

        - exc - exception raised during parsing (need not be a ParseException, in support
          of Python exceptions that might be raised in a parse action)
        - depth (default=16) - number of levels back in the stack trace to list expression
          and function names; if None, the full stack trace names will be listed; if 0, only
          the failing input line, marker, and exception string will be shown

        Returns a multi-line string listing the ParserElements and/or function names in the
        exception's stack trace.
        r   Nr   )ÚParserElementú ú^z{}: {})Úcontextr   )Ú	parseImplÚ_parseNoCachez
{}.{} - {}z{}.{})Úwrapperz<module>z{}Ú
)ÚinspectÚcorer   ÚsysÚgetrecursionlimitÚ
isinstancer   Úappendr   ÚcolumnÚformatÚtyper
   ÚgetinnerframesÚ__traceback__ÚsetÚ	enumerateÚf_localsÚgetÚf_codeÚco_nameÚidÚaddr   Újoin)ÚexcÚdepthr#   r   ÚretÚcallersÚseenÚiÚffÚfrmÚf_selfÚ	self_typeÚcoder   r   r   Úexplain_exception)   sL    


ÿÿ
z$ParseBaseException.explain_exceptionc                 C   s   | |j |j|j|jƒS )z¬
        internal factory method to simplify creating one type of ParseException
        from another - avoids having __init__ signature conflicts among subclasses
        )r   r   r   r   )ÚclsÚper   r   r   Ú_from_exceptionk   s    z"ParseBaseException._from_exception©Úreturnc                 C   s   t | j| jƒS )zG
        Return the line of text where the exception occurred.
        )r   r   r   ©r   r   r   r   r   s   s    zParseBaseException.linec                 C   s   t | j| jƒS )zV
        Return the 1-based line number of text where the exception occurred.
        )r   r   r   rH   r   r   r   r   z   s    zParseBaseException.linenoc                 C   s   t | j| jƒS ©z]
        Return the 1-based column on the line of text where the exception occurred.
        ©r   r   r   rH   r   r   r   r   �   s    zParseBaseException.colc                 C   s   t | j| jƒS rI   rJ   rH   r   r   r   r)   ˆ   s    zParseBaseException.columnc                 C   s†   | j rh| jt| j ƒkrd}qlt | j | j¡}|d ur@| d¡}n| j | j| jd … }d|  dd¡}nd}d | j|| j| j	| j
¡S )	Nz, found end of textr   r   z
, found %rz\\ú\r   z%{}{}  (at char {}), (line:{}, col:{}))r   r   ÚlenÚ_exception_word_extractorÚmatchÚgroupÚreplacer*   r   r   r)   )r   ÚfoundstrÚfound_matchÚfoundr   r   r   Ú__str__�   s    ÿzParseBaseException.__str__c                 C   s   t | ƒS ©N)ÚstrrH   r   r   r   Ú__repr__¡   s    zParseBaseException.__repr__z>!<)ÚmarkerString)Úmarker_stringrG   c                C   sL   |dur|n|}| j }| jd }|rDd |d|… |||d… f¡}| ¡ S )z‹
        Extracts the exception line from the input string, and marks
        the location of the exception with a special symbol.
        Nr   r   )r   r)   r6   Ústrip)r   rY   rX   Úline_strÚline_columnr   r   r   Úmark_input_line¤   s    
ÿz"ParseBaseException.mark_input_linec                 C   s   |   | |¡S )a  
        Method to translate the Python internal traceback into a list
        of the pyparsing expressions that caused the exception to be raised.

        Parameters:

        - depth (default=16) - number of levels back in the stack trace to list expression
          and function names; if None, the full stack trace names will be listed; if 0, only
          the failing input line, marker, and exception string will be shown

        Returns a multi-line string listing the ParserElements and/or function names in the
        exception's stack trace.

        Example::

            expr = pp.Word(pp.nums) * 3
            try:
                expr.parse_string("123 456 A789")
            except pp.ParseException as pe:
                print(pe.explain(depth=0))

        prints::

            123 456 A789
                    ^
            ParseException: Expected W:(0-9), found 'A'  (at char 8), (line:1, col:9)

        Note: the diagnostic output will include string representations of the expressions
        that failed to parse. These representations will be more helpful if you use `set_name` to
        give identifiable names to your expressions. Otherwise they will use the default string
        forms, which may be cryptic to read.

        Note: pyparsing's default truncation of exception tracebacks may also truncate the
        stack of expressions that are displayed in the ``explain`` output. To get the full listing
        of parser expressions, you may have to set ``ParserElement.verbose_stacktrace = True``
        )rB   )r   r8   r   r   r   Úexplain²   s    %zParseBaseException.explain)r   NN)r   )N)r   )r
   r   r   Ú__doc__rV   Úintr   r   ÚstaticmethodrB   ÚclassmethodrE   Úpropertyr   r   r   r)   rT   rW   r]   r^   ÚmarkInputliner   r   r   r   r      s4      ûüA
'r   c                   @   s   e Zd ZdZdS )ÚParseExceptionaq  
    Exception thrown when a parse expression doesn't match the input string

    Example::

        try:
            Word(nums).set_name("integer").parse_string("ABC")
        except ParseException as pe:
            print(pe)
            print("column: {}".format(pe.column))

    prints::

       Expected integer (at char 0), (line:1, col:1)
        column: 1

    N©r
   r   r   r_   r   r   r   r   re   Ü   s   re   c                   @   s   e Zd ZdZdS )ÚParseFatalExceptionzu
    User-throwable exception thrown when inconsistent parse content
    is found; stops all parsing immediately
    Nrf   r   r   r   r   rg   ð   s   rg   c                   @   s   e Zd ZdZdS )ÚParseSyntaxExceptionzó
    Just like :class:`ParseFatalException`, but thrown internally
    when an :class:`ErrorStop<And._ErrorStop>` ('-' operator) indicates
    that parsing is to stop immediately because an unbacktrackable
    syntax error has been found.
    Nrf   r   r   r   r   rh   ÷   s   rh   c                   @   s&   e Zd ZdZdd„ Zedœdd„ZdS )ÚRecursiveGrammarExceptionzî
    Exception thrown by :class:`ParserElement.validate` if the
    grammar could be left-recursive; parser may need to enable
    left recursion using :class:`ParserElement.enable_left_recursion<ParserElement.enable_left_recursion>`
    c                 C   s
   || _ d S rU   )ÚparseElementTrace)r   ÚparseElementListr   r   r   r     s    z"RecursiveGrammarException.__init__rF   c                 C   s   d  | j¡S )NzRecursiveGrammarException: {})r*   rj   rH   r   r   r   rT   
  s    z!RecursiveGrammarException.__str__N)r
   r   r   r_   r   rV   rT   r   r   r   r   ri      s   ri   )Úrer%   Útypingr   Úutilr   r   r   r   Úunicoder   ÚppuÚLatin1ÚLatinAÚLatinBÚGreekÚCyrillicr	   Ú	alphanumsÚ_extract_alphanumsÚcompilerM   Ú	Exceptionr   re   rg   rh   ri   r   r   r   r   Ú<module>   s   "
 J	