
    \i4                    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      T/var/www/html/kml_chatgpt/mouzaenv/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
: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                
   > T/$ )Nr.   )r   r   r   repl_strs      r   <lambda>replace_with.<locals>.<lambda>L   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, 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   s      r   remove_quotesr@   O   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.

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
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   f   s=    R )+J$)//+,	 Ir   c                6    U(       a  U S3OSn[        S0 X 0D6$ )ay  
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classr.   )rC   )	classname	namespace	classattrs      r   
with_classrT      s&    l )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
&(.Zz "8 74x }l;> .A[*5	!"24EFr   