�

Ȗ0i4�
�B
�dd
lm
Z

ddlmZmZmZ
ddlmZ
ddlm	Z	m
Z

ddlmZ
eegefeeg
efee
egefeee
egeffZGd�d�Zdd	�Zdd
�Zdd�Zdd�Ze�e_ddd
�Ze
de�Ze
de�Ze
de�Ze
de�Ze
de�Zy)�)
�annotations)�Union�Callable�Any�
)
�ParseException)�col�replaced_by_pep8)
�ParseResultsc
�&�eZ
dZd
Zdd�Zdd�Zd�Zy)�OnlyOncez�
    Wrapper for parse actions, to ensure they are only called once.
    Note: parse action signature must include all 3 arguments.
    c
�8�d
dlm
}
||
�
|_d|_y)Nr)
�_trim_arityF)�corer�callable�called)�self�method_callrs   ��/build/snapcraft-certbot-3159324ea1206d36e7f0992193f2ac71/parts/certbot/install/lib/python3.12/site-packages/pyparsing/actions.py�__init__zOnlyOnce.__init__s��%�#�K�0��
����c
�l�|js|j|
||�}d
|_|St|
|d��
)NTz.OnlyOnce obj called multiple times w/out reset)rrr)r�
s�
l�
t�resultss     r�__call__zOnlyOnce.__call__s7���{�{��m�m�A�q�!�,�G��D�K��N��Q�
�#S�T�Trc

��d
|_y)zK
        Allow the associated parse action to be called once more.
        FN)
r)
rs
 r�resetzOnlyOnce.reset&s��
��rN)rz'Callable[[str, int, ParseResults], Any]�return�None)r�strr�intrrr r)�__name__�
__module__�__qualname__�__doc__rrr�rrr
r
s���
�U
�rr
c

���d�f
d
�}
|
S)zt
    Helper method for defining parse actions that require matching at
    a specific column in the input text.
    c
�D�
�t
|
|��k7rt||
d
�����
y)Nzmatched token not at column )r	r)�strg�locn�toks�
ns   �r�
verify_colz%match_only_at_col.<locals>.verify_col4s-����t�T�?�a�� ��t�/K�A�3�-O�P�P� r)r+r"r,r#r-rr r!r()r.r/s` r�match_only_at_colr0.s���Q
��rc

����f
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

�
�
��g
S)
Nr()rrr�repl_strs   �r�<lambda>zreplace_with.<locals>.<lambda>Ls	���H�:�rr()
r3s
`r�replace_withr5;s���"&�%rc
��|d
ddS)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'], {})
    rr���r()rrrs   r�
remove_quotesr8Os��(
�Q�4�
�"�:�rc
�~��g�|r�j
|�

n�j
|
j��

d�f
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
    c
��
��D]N\}}||v
rt
||
d
|z��
|tjk7s
�.|||k7s
�7t
||
d|�d||�d|����
y)Nzno matching attribute z
attribute z has value z
, must be )r�with_attribute�	ANY_VALUE)rr�tokens�attrName�	attrValue�
attrs_lists     �r�pazwith_attribute.<locals>.pa�s���#-�	��H�i��v�%�$�Q�
�+C�h�+N�O�O��N�4�4�4���9I�Y�9V�$��� ���K��x�8H�7K�:�V_�Ub�c���		r)rr"rr#r=rr r!)�extend�items)�args�	attr_dictrAr@s   @rr;r;fs=���R)+�J�����$�����)�/�/�+�,�	��Irc
�.�|
r|
�d
�n
d}t
di||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�classr()
r;)�	classname�	namespace�	classattrs   r�
with_classrK�s(��l
)2�9�+�V�$�w�I��3�Y�	�2�3�3r�replaceWith�removeQuotes�
withAttribute�	withClass�matchOnlyAtColN)r.r#r �ParseAction)r3rr rQ)rr"rr#rrr r)rDztuple[str, str]r rQ)
�)rHr"rIr"r rQ)�
__future__r�typingrrr�
exceptionsr�utilr	r
rrr#r"rQr
r0r5r8r;�objectr<rKrLrMrNrOrPr(rr�<module>rX
s��


�"�'�'�&�'�!���R��W���l�^�S�
 �!��c�<�
 �#�
%�&��c�3��
%�s�
*�+�-���
�
�6

�
&�(
�.Z

�z"�8���7
4�x
�}�l�;����
�>�� ��.�A�
��[�*�5�	�!�"2�4E�F�r