Your IP : 216.73.217.13
�
&�j� � �D � d dl mZ d dlmZmZmZ ddlmZ ddlm Z m
Z
ddl m Z eeg ef ee gef ee
e gef eee
e gef f Z G d� d� Zdd �Zdd
�Zdd �Zdd �Z e� e_ ddd
�Z e
de� Z e
de� Z e
de� Z e
de� Z e
de� Z y)� )� annotations)�Union�Callable�Any� )�ParseException)�col�replaced_by_pep8)� ParseResultsc �& � e Zd ZdZdd�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 � ddl m} ||� | _ d| _ y )Nr )� _trim_arityF)�corer �callable�called)�self� method_callr s ��/build/snapcraft-certbot-54d6d23c1eba5f776fc280588daee8b3/parts/certbot/install/lib/python3.12/site-packages/pyparsing/actions.py�__init__zOnlyOnce.__init__ s � �%�#�K�0��
��� � c �l � | j s | j |||� }d| _ |S t ||d� �)NTz.OnlyOnce obj called multiple times w/out reset)r r r )r �s�l�t�resultss r �__call__zOnlyOnce.__call__ s7 � ��{�{��m�m�A�q�!�,�G� �D�K��N� �Q��#S�T�Tr c � � d| _ y)zK
Allow the associated parse action to be called once more.
FN)r )r s r �resetzOnlyOnce.reset& s � �
�� r N)r z'Callable[[str, int, ParseResults], Any]�return�None)r �strr �intr r r r )�__name__�
__module__� __qualname__�__doc__r r r � r r r
r
s � ��
� U� r r
c � � � d� fd� }|S )zt
Helper method for defining parse actions that require matching at
a specific column in the input text.
c �D �� t || � �k7 rt | |d�� �� �y )Nz matched token not at column )r r )�strg�locn�toks�ns �r �
verify_colz%match_only_at_col.<locals>.verify_col4 s- �� � �t�T�?�a� � ��t�/K�A�3�-O�P� P� r )r+ r" r, r# r- r r r! r( )r. r/ s ` r �match_only_at_colr0 . s �� � Q� �r c � � � � fd�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 �
�� �gS )Nr( )r r r �repl_strs �r �<lambda>z replace_with.<locals>.<lambda>L s �� �H�:� r r( )r3 s `r � replace_withr5 ; s �� �" &�%r c � � |d dd 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_quotesr8 O s � �(
�Q�4��"�:�r c �~ �� g �| r�j | � n �j |j � � d�fd� }|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 \ }}||vrt | |d|��� �|t j k7 s�.|| |k7 s�7t | |d|�d|| �d|��� � y )Nzno matching attribute z
attribute z has value z
, must be )r �with_attribute� ANY_VALUE)r r �tokens�attrName� attrValue�
attrs_lists �r �pazwith_attribute.<locals>.pa� s� �� �#-� � �H�i��v�%�$�Q��-C�H�<�+P�Q�Q��N� 4� 4�4���9I�Y�9V�$��� �� �K��x�8H�7K�:�V_�Ub�c�� � r )r r" r r# r= r r r! )�extend�items)�args� attr_dictrA r@ s @r r; r; f s= �� �R )+�J� ����$� ����)�/�/�+�,� � �Ir c �. � |r|� d�nd}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 <div> 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)r3 r r rQ )r r" r r# r r r r )rD ztuple[str, str]r rQ )� )rH r" rI r" r rQ ) �
__future__r �typingr r r �
exceptionsr �utilr r
r r r# r" rQ r
r0 r5 r8 r; �objectr< rK rL rM rN rO rP r( r r �<module>rX s� �� "� '� '� &� '� !� � �R��W�� �l�^�S�
�!� �c�<�
�#�
%�&� �c�3� �
%�s�
*�+�-�� � � �6
�&�(�.Z�z "�8�� � q�74�x �}�l�;� � ��
�>� � � �.�A�
� �[�*� 5� �!�"2�4E�F�r