a
    .PÎj¨  ã                   @  s(  d dl mZ d dlmZmZmZ ddlmZ ddlm	Z	m
Z
 ddlmZ eeg ef eegef eeegef eeeegef f ZG dd„ dƒZd	d
dœdd„Zdd
dœdd„Zdd	dddœdd„Zdd
dœdd„Zeƒ e_d%ddd
dœdd„Ze
deƒZe
d eƒZe
d!eƒZe
d"eƒZe
d#eƒZd$S )&é    )Úannotations)ÚUnionÚCallableÚAnyé   )ÚParseException)ÚcolÚreplaced_by_pep8)ÚParseResultsc                   @  s<   e Zd ZdZdddœdd„Zddd	d	d
œdd„Zdd„ ZdS )ÚOnlyOncezˆ
    Wrapper for parse actions, to ensure they are only called once.
    Note: parse action signature must include all 3 arguments.
    z'Callable[[str, int, ParseResults], Any]ÚNone)Úmethod_callÚreturnc                 C  s    ddl m} ||ƒ| _d| _d S )Nr   )Ú_trim_arityF)Úcorer   ÚcallableÚcalled)Úselfr   r   © r   úa/mounts/lovelace/software/anaconda3/envs/metadmg/lib/python3.9/site-packages/pyparsing/actions.pyÚ__init__   s    
zOnlyOnce.__init__ÚstrÚintr
   ©ÚsÚlÚtr   c                 C  s.   | j s|  |||¡}d| _ |S t||dƒ‚d S )NTz.OnlyOnce obj called multiple times w/out reset)r   r   r   )r   r   r   r   Úresultsr   r   r   Ú__call__   s
    zOnlyOnce.__call__c                 C  s
   d| _ dS )zK
        Allow the associated parse action to be called once more.
        FN)r   )r   r   r   r   Úreset&   s    zOnlyOnce.resetN)Ú__name__Ú
__module__Ú__qualname__Ú__doc__r   r   r   r   r   r   r   r      s   r   r   ÚParseAction)Únr   c                   s   dddddœ‡ fdd„}|S )zt
    Helper method for defining parse actions that require matching at
    a specific column in the input text.
    r   r   r
   r   )ÚstrgÚlocnÚtoksr   c                   s$   t || ƒˆ kr t| |dˆ › �ƒ‚d S )Nzmatched token not at column )r   r   )r&   r'   r(   ©r%   r   r   Ú
verify_col4   s    z%match_only_at_col.<locals>.verify_colr   )r%   r*   r   r)   r   Úmatch_only_at_col.   s    r+   r   )Úrepl_strr   c                   s   ‡ fdd„S )aÜ  
    Helper method for common parse actions that simply return
    a literal value.  Especially useful when used with
    :meth:`~ParserElement.transform_string`.

    Example:

    .. doctest::

       >>> num = Word(nums).set_parse_action(lambda toks: int(toks[0]))
       >>> na = one_of("N/A NA").set_parse_action(replace_with(math.nan))
       >>> term = na | num

       >>> term[1, ...].parse_string("324 234 N/A 234")
       ParseResults([324, 234, nan, 234], {})
    c                   s   ˆ gS )Nr   ©r   r   r   ©r,   r   r   Ú<lambda>L   ó    zreplace_with.<locals>.<lambda>r   r.   r   r.   r   Úreplace_with;   s    r1   r   r
   r   c                 C  s   |d dd… S )a   
    Helper parse action for removing quotation marks from parsed
    quoted strings, that use a single character for quoting. For parsing
    strings that may have multiple characters, use the :class:`QuotedString`
    class.

    Example:

    .. doctest::

       >>> # by default, quotation marks are included in parsed results
       >>> quoted_string.parse_string("'Now is the Winter of our Discontent'")
       ParseResults(["'Now is the Winter of our Discontent'"], {})

       >>> # use remove_quotes to strip quotation marks from parsed results
       >>> dequoted = quoted_string().set_parse_action(remove_quotes)
       >>> dequoted.parse_string("'Now is the Winter of our Discontent'")
       ParseResults(['Now is the Winter of our Discontent'], {})
    r   r   éÿÿÿÿr   r-   r   r   r   Úremove_quotesO   s    r3   ztuple[str, str])Úargsr   c                    s>   g ‰ | rˆ   | ¡ nˆ   | ¡ ¡ dddddœ‡ fdd„}|S )aï  
    Helper to create a validating parse action to be used with start
    tags created with :class:`make_xml_tags` or
    :class:`make_html_tags`. Use ``with_attribute`` to qualify
    a starting tag with a required attribute value, to avoid false
    matches on common tags such as ``<TD>`` or ``<DIV>``.

    Call ``with_attribute`` with a series of attribute names and
    values. Specify the list of filter attributes names and values as:

    - keyword arguments, as in ``(align="right")``, or
    - as an explicit dict with ``**`` operator, when an attribute
      name is also a Python reserved word, as in ``**{"class":"Customer", "align":"right"}``
    - a list of name-value tuples, as in ``(("ns1:class", "Customer"), ("ns2:align", "right"))``

    For attribute names with a namespace prefix, you must use the second
    form.  Attribute names are matched insensitive to upper/lower case.

    If just testing for ``class`` (with or without a namespace), use
    :class:`with_class`.

    To verify that the attribute exists, but without specifying a value,
    pass ``with_attribute.ANY_VALUE`` as the value.

    The next two examples use the following input data and tag parsers:

    .. testcode::

       html = '''
           <div>
           Some text
           <div type="grid">1 4 0 1 0</div>
           <div type="graph">1,3 2,3 1,1</div>
           <div>this has no type</div>
           </div>
       '''
       div,div_end = make_html_tags("div")

    Only match div tag having a type attribute with value "grid":

    .. testcode::

       div_grid = div().set_parse_action(with_attribute(type="grid"))
       grid_expr = div_grid + SkipTo(div | div_end)("body")
       for grid_header in grid_expr.search_string(html):
           print(grid_header.body)

    prints:

    .. testoutput::

       1 4 0 1 0

    Construct a match with any div tag having a type attribute,
    regardless of the value:

    .. testcode::

       div_any_type = div().set_parse_action(
           with_attribute(type=with_attribute.ANY_VALUE)
       )
       div_expr = div_any_type + SkipTo(div | div_end)("body")
       for div_header in div_expr.search_string(html):
           print(div_header.body)

    prints:

    .. testoutput::

       1 4 0 1 0
       1,3 2,3 1,1
    r   r   r
   r   )r   r   Útokensr   c              
     sd   ˆ D ]Z\}}||vr&t | |d|›�ƒ‚|tjkr|| |krt | |d|›d|| ›d|›�ƒ‚qd S )Nzno matching attribute z
attribute z has value z
, must be )r   Úwith_attributeÚ	ANY_VALUE)r   r   r5   ZattrNameZ	attrValue©Z
attrs_listr   r   Úpaµ   s    ýzwith_attribute.<locals>.pa)ÚextendÚitems)r4   Z	attr_dictr9   r   r8   r   r6   f   s    Ir6   Ú )Ú	classnameÚ	namespacer   c                 C  s$   |r|› d�nd}t f i || i¤ŽS )a  
    Simplified version of :meth:`with_attribute` when
    matching on a div class - made difficult because ``class`` is
    a reserved word in Python.

    Using similar input data to the :meth:`with_attribute` examples:

    .. testcode::

       html = '''
           <div>
           Some text
           <div class="grid">1 4 0 1 0</div>
           <div class="graph">1,3 2,3 1,1</div>
           <div>this &lt;div&gt; has no class</div>
           </div>
       '''
       div,div_end = make_html_tags("div")

    Only match div tag having the "grid" class:

    .. testcode::

       div_grid = div().set_parse_action(with_class("grid"))
       grid_expr = div_grid + SkipTo(div | div_end)("body")
       for grid_header in grid_expr.search_string(html):
           print(grid_header.body)

    prints:

    .. testoutput::

       1 4 0 1 0

    Construct a match with any div tag having a class attribute,
    regardless of the value:

    .. testcode::

       div_any_type = div().set_parse_action(
           with_class(withAttribute.ANY_VALUE)
       )
       div_expr = div_any_type + SkipTo(div | div_end)("body")
       for div_header in div_expr.search_string(html):
           print(div_header.body)

    prints:

    .. testoutput::

       1 4 0 1 0
       1,3 2,3 1,1
    z:classÚclass)r6   )r=   r>   Z	classattrr   r   r   Ú
with_classÇ   s    6r@   ÚreplaceWithÚremoveQuotesÚwithAttributeÚ	withClassÚmatchOnlyAtColN)r<   )Ú
__future__r   Útypingr   r   r   Ú
exceptionsr   Úutilr   r	   r   r
   r   r   r$   r   r+   r1   r3   r6   Úobjectr7   r@   rA   rB   rC   rD   rE   r   r   r   r   Ú<module>   s.   
ýÿ]<



