a
    .PÎjå*  ã                   @  s
  d dl m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 ddlm	Z	 ddl
mZ ddlmZmZmZmZmZ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 )é    )ÚannotationsN)Úcached_propertyé   )ÚPyparsingDeprecationWarning)Úpyparsing_unicode)Ú_collapse_string_to_rangesÚcolÚdeprecate_argumentÚlineÚlinenoÚreplaced_by_pep8c                   @  s   e Zd ZdS )Ú_ExceptionWordUnicodeSetN)Ú__name__Ú
__module__Ú__qualname__© r   r   úd/mounts/lovelace/software/anaconda3/envs/metadmg/lib/python3.9/site-packages/pyparsing/exceptions.pyr      s   r   z([z
]{1,16})|.c                   @  sL  e Zd ZU dZded< ded< ded< ded< d	ed
< dZd7dddddœdd„Zed8ddddœdd„ƒZe	d dœdd„ƒZ
eddœdd„ƒZeddœdd„ƒZeddœdd „ƒZeddœd!d"„ƒZeddœd#d$„ƒZed%d&„ ƒZejd'd&„ ƒZd(d)„ Zddœd*d+„Zddœd,d-„Zd.d/„ Zd9ddd0œd1d2„Zd:ddd3œd4d5„Zed6eƒZdS );ÚParseBaseExceptionz7base exception class for all parsing runtime exceptionsÚintÚlocÚstrÚmsgÚpstrz
typing.AnyÚparser_elementz%tuple[str, int, typing.Optional[str]]Úargs©r   r   r   r   r   r   Nztyping.Optional[str]ÚNone)r   r   r   Úreturnc                 C  s:   |d u r|d }}|| _ || _|| _|| _|||f| _d S )NÚ r   )Úselfr   r   r   Úelemr   r   r   Ú__init__4   s    
zParseBaseException.__init__é   Ú	Exception)ÚexcÚdepthr   c                 C  s’  ddl }ddlm} |du r$t ¡ }g }t| tƒrT| | j¡ | dd| j	› �›¡ | t
| ƒj› d| › �¡ |dks€| jdu rŠd |¡S |j| j|d	�}tƒ }|| d… D ]Ø}|d }|j d
d¡}	t|	|ƒ�r(|jj d¡säq®t|	ƒ|v ròq®| t|	ƒ¡ t
|	ƒ}
| |
j› d|
j› d|	› �¡ nL|	du�rTt
|	ƒ}
| |
j› d|
j› �¡ n |j}|jdv �rhq®| |j¡ |d8 }|s® �qˆq®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ú^ú>ú: Ú
)Úcontextr   )Z	parseImplZ_parseNoCacheÚ.z - )Úwrapperz<module>)ÚinspectÚcorer&   ÚsysÚgetrecursionlimitÚ
isinstancer   Úappendr
   ÚcolumnÚtyper   Ú__traceback__ÚjoinÚgetinnerframesÚsetÚf_localsÚgetÚf_codeÚco_nameÚ
startswithÚidÚaddr   )r$   r%   r.   r&   ÚretZcallersÚseenÚffZfrmZf_selfZ	self_typeÚcoder   r   r   Úexplain_exceptionD   sF    

 
z$ParseBaseException.explain_exception©r   c                 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   )ÚclsZper   r   r   Ú_from_exception„   s    z"ParseBaseException._from_exceptionc                 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    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   rI   r   r   r   r   “   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   rI   r   r   r   r   š   s    zParseBaseException.colc                 C  s   t | j| jƒS rJ   rK   rI   r   r   r   r4   ¡   s    zParseBaseException.columnc                 C  sf   | j s
dS | jt| j ƒkrdS t | j | j¡}|d ur@|d }n| j | j| jd … }t|ƒ dd¡S )Nr   zend of textr   r   z\\ú\)r   r   ÚlenÚ_exception_word_extractorÚmatchÚreprÚreplace)r   Zfound_matchZ
found_textr   r   r   Úfound¨   s    
zParseBaseException.foundc                 C  s   t jdtdd� | jS ©Nz/parserElement is deprecated, use parser_elementé   )Ú
stacklevel©ÚwarningsÚwarnr   r   rI   r   r   r   ÚparserElementº   s    ýz ParseBaseException.parserElementc                 C  s   t jdtdd� || _d S rS   rV   )r   r    r   r   r   rY   Ã   s    ýc                 C  s
   t   | ¡S ©N)ÚcopyrI   r   r   r   r[   Ì   s    zParseBaseException.copyc              	   C  s>   | j rd| j › �nd}| j› |› d| j› d| j› d| j› d�	S )z¥
        Output the formatted exception message.
        Can be overridden to customize the message formatting or contents.

        .. versionadded:: 3.2.0
        z, found r   z  (at char z	), (line:z, col:ú))rR   r   r   r   r4   )r   Zfound_phraser   r   r   Úformatted_messageÏ   s    z$ParseBaseException.formatted_messagec                 C  s^   z
|   ¡ W S  tyX } z6t| ƒj› d| j› dt|ƒj› d|› d�W  Y d}~S d}~0 0 dS )zl
        .. versionchanged:: 3.2.0
           Now uses :meth:`formatted_message` to format message.
        r)   z (z while formatting message)N)r]   r#   r5   r   r   )r   Úexr   r   r   Ú__str__Ù   s    
ÿÿÿzParseBaseException.__str__c                 C  s   t | ƒS rZ   )r   rI   r   r   r   Ú__repr__æ   s    zParseBaseException.__repr__)Úmarker_stringr   c                 K  sX   t |ddƒ}|dur|n|}| j}| jd }|rP|d|… › |› ||d… › �}| ¡ S )z‹
        Extracts the exception line from the input string, and marks
        the location of the exception with a special symbol.
        ÚmarkerStringz>!<Nr   )r	   r
   r4   Ústrip)r   ra   Úkwargsrb   Zline_strÚline_columnr   r   r   Úmark_input_lineé   s    
 z"ParseBaseException.mark_input_line)r%   r   c                 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:

        .. testcode::

            # an expression to parse 3 integers
            expr = pp.Word(pp.nums) * 3
            try:
                # a failing parse - the third integer is prefixed with "A"
                expr.parse_string("123 456 A789")
            except pp.ParseException as pe:
                print(pe.explain(depth=0))

        prints:

        .. testoutput::

            123 456 A789
                    ^
            ParseException: Expected W:(0-9), found 'A789'  (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``
        )rE   )r   r%   r   r   r   Úexplainù   s    +zParseBaseException.explainÚmarkInputline)r   NN)r"   )N)r"   )r   r   r   Ú__doc__Ú__annotations__Ú	__slots__r!   ÚstaticmethodrE   ÚclassmethodrH   r   r
   r   r   r4   rR   ÚpropertyrY   Úsetterr[   r]   r_   r`   rf   rg   r   rh   r   r   r   r   r   !   sJ   
   û?


 ÿ/r   c                   @  s   e Zd ZdZdS )ÚParseExceptiona�  
    Exception thrown when a parse expression doesn't match the input string

    Example:

    .. testcode::

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

    prints:

    .. testoutput::

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

    N©r   r   r   ri   r   r   r   r   rp   ,  s   rp   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
    Nrq   r   r   r   r   rr   C  s   rr   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.
    Nrq   r   r   r   r   rs   J  s   rs   c                   @  s,   e Zd ZdZddœdd„Zddœdd„Zd	S )
ÚRecursiveGrammarExceptionaL  
    .. deprecated:: 3.0.0
       Only used by the deprecated :meth:`ParserElement.validate`.

    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>`
    r   rF   c                 C  s
   || _ d S rZ   ©ZparseElementTrace)r   ZparseElementListr   r   r   r!   ]  s    z"RecursiveGrammarException.__init__r   c                 C  s   d| j › �S )NzRecursiveGrammarException: ru   rI   r   r   r   r_   `  s    z!RecursiveGrammarException.__str__N)r   r   r   ri   r!   r_   r   r   r   r   rt   S  s   	rt   )$Ú
__future__r   r[   Úrer0   ÚtypingrW   Ú	functoolsr   r   Úunicoder   ZppuÚutilr   r   r	   r
   r   r   ZLatin1ZLatinAZLatinBÚGreekZCyrillicr   Z	alphanumsZ_extract_alphanumsÚcompilerN   r#   r   rp   rr   rs   rt   r   r   r   r   Ú<module>   s*    

ÿ
  	