
    ha                    N   S SK Jr  S SKJrJrJr  SSKJr  SSKJ	r	J
r
  SSKJr  \\/ \4   \\/\4   \\\/\4   \\\\/\4   4   r " S S5      rSS	 jrSS
 jrSS jrSS jr\" 5       \l        SSS jjr\
" S\5      r\
" S\5      r\
" S\5      r\
" S\5      r\
" S\5      rg)    )annotations)UnionCallableAny   )ParseException)colreplaced_by_pep8)ParseResultsc                  2    \ rS rSrSrSS jrS	S jrS rSrg)
OnlyOnce   z|
Wrapper for parse actions, to ensure they are only called once.
Note: parse action signature must include all 3 arguments.
c                8    SSK Jn  U" U5      U l        SU l        g )Nr   )_trim_arityF)corer   callablecalled)selfmethod_callr   s      C/var/www/html/env/lib/python3.13/site-packages/pyparsing/actions.py__init__OnlyOnce.__init__   s    %#K0    c                r    U R                   (       d  U R                  XU5      nSU l         U$ [        XS5      e)NTz.OnlyOnce obj called multiple times w/out reset)r   r   r   )r   sltresultss        r   __call__OnlyOnce.__call__   s3    {{mmA!,GDKNQ#STTr   c                    SU l         g)z;
Allow the associated parse action to be called once more.
FN)r   )r   s    r   resetOnlyOnce.reset&   s    
 r   )r   r   N)r   z'Callable[[str, int, ParseResults], Any]returnNone)r   strr   intr   r   r$   r   )	__name__
__module____qualname____firstlineno____doc__r   r   r"   __static_attributes__ r   r   r   r      s    
Ur   r   c                   ^  SU 4S jjnU$ )zh
Helper method for defining parse actions that require matching at
a specific column in the input text.
c                B   > [        X5      T:w  a  [        XST 35      eg )Nzmatched token not at column )r	   r   )strglocntoksns      r   
verify_col%match_only_at_col.<locals>.verify_col4   s)    t?a /KA3-OPP  r   )r1   r&   r2   r'   r3   r   r$   r%   r.   )r4   r5   s   ` r   match_only_at_colr7   .   s    Q r   c                   ^  U 4S j$ )a  
Helper method for common parse actions that simply return
a literal value.  Especially useful when used with
:class:`transform_string<ParserElement.transform_string>` ().

Example::

    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") # -> [324, 234, nan, 234]
c                
   > T/$ )Nr.   )r   r   r   repl_strs      r   <lambda>replace_with.<locals>.<lambda>I   s    H:r   r.   )r:   s   `r   replace_withr=   ;   s     &%r   c                    US   SS $ )a  
Helper parse action for removing quotation marks from parsed
quoted strings.

Example::

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

    # use remove_quotes to strip quotation marks from parsed results
    quoted_string.set_parse_action(remove_quotes)
    quoted_string.parse_string("'Now is the Winter of our Discontent'") # -> ["Now is the Winter of our Discontent"]
r   r   r.   )r   r   r   s      r   remove_quotesr@   L   s     Q4":r   c                    ^ / mU (       a  TR                  U 5        OTR                  UR                  5       5        SU4S jjnU$ )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.

Example::

    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"
    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)

    # construct a match with any div tag having a type attribute, regardless of the value
    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::

    1 4 0 1 0

    1 4 0 1 0
    1,3 2,3 1,1
c                   > T HR  u  p4X2;  a  [        XSU-   5      eU[        R                  :w  d  M/  X#   U:w  d  M9  [        U USU< SX#   < SU< 35      e   g )Nzno matching attribute z
attribute z has value z
, must be )r   with_attribute	ANY_VALUE)r   r   tokensattrName	attrValue
attrs_lists        r   pawith_attribute.<locals>.pa   sp    #-H%$Q+Ch+NOON4449IY9V$ K8H7K:V_Ubc 	 $.r   )r   r&   r   r'   rE   r   r$   r%   )extenditems)args	attr_dictrI   rH   s      @r   rC   rC   ]   s=    p )+J$)//+,	 Ir   c                6    U(       a  U S3OSn[        S0 X 0D6$ )aq  
Simplified version of :class:`with_attribute` when
matching on a div class - made difficult because ``class`` is
a reserved word in Python.

Example::

    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")
    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)

    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::

    1 4 0 1 0

    1 4 0 1 0
    1,3 2,3 1,1
z:classclassr.   )rC   )	classname	namespace	classattrs      r   
with_classrT      s&    H )29+V$wI3Y233r   replaceWithremoveQuoteswithAttribute	withClassmatchOnlyAtColN)r4   r'   r$   ParseAction)r:   r&   r$   rZ   )r   r&   r   r'   r   r   r$   r   )rM   ztuple[str, str]r$   rZ   ) )rQ   r&   rR   r&   r$   rZ   )
__future__r   typingr   r   r   
exceptionsr   utilr	   r
   r   r   r'   r&   rZ   r   r7   r=   r@   rC   objectrD   rT   rU   rV   rW   rX   rY   r.   r   r   <module>ra      s    " ' ' & ' ! RWl^S !c< #%&c3%s*+- 6
&""IX "8 %4T }l;> .A[*5	!"24EFr   