codekingpro/portable-devtools
114k
1�
2 ��j�k � � � % S SK Jr S SKrS SKJrJrJrJrJr S SK r S SK3J r SSK J
r
JrJr \\4rS\S' \" S S4 5 5 r\" S5 rS \S ' " S
S5 r " S S5 r\R4 " \5 \R4 " \5 g)� )� annotationsN)�MutableMapping�Mapping�MutableSequence�Iterator�Iterable)�Any� )�deprecate_argument� _is_iterable�_flattenztuple[type, ...]�str_typec # �$ # � U H ov � M g 7f�N� )�.0�_s �WD:\code\apps\devtools\python\user_packages\Python313\site-packages\pyparsing/results.py� <genexpr>r s � � ��2�a��2�s �r �slice�5NULL_SLICEc �B � \ rS rSr% S\S' S/rS6S jrS rS rS r Sr7g ) �_ParseResultsWithOffset� ztuple[ParseResults, int]�tupc � � X4U l g r �r )�self�p1�p2s r �__init__� _ParseResultsWithOffset.__init__ s � �.0�X��� c � � U R U $ r r �r �is r � __getitem__�#_ParseResultsWithOffset.__getitem__ s � ��x�x��{�r# c � � U R $ r r �r s r � __getstate__�$_ParseResultsWithOffset.__getstate__" s � ��x�x�r# c � � US U l g �Nr r )r �argss r � __setstate__�$_ParseResultsWithOffset.__setstate__% s
� ���7��r# r N)r � ParseResultsr �int�return�None) �__name__�8__module__� __qualname__�__firstlineno__�__annotations__� __slots__r! r' r+ r0 �__static_attributes__r r# r r r s# � � !�!���I�6���r# r c � � \ rS rSr% SrS/ S4rS\S' S\S' S \S ' S9\S ' S \S
' S\S' S\S' Sr " S S\5 r S@S jr10SSSS\ 4 SAS jjr S r
\ 4S jrS rSBS jrSCS jrSBS jrSDS jrSDS jrS rS! rS" rSBS# jrS$ rSES% jrS& rS' r S( r S) r S* r SFS+ jr SFS, jr!SGS- jr"SHS. jr#SHS/ jr$SIS0 jr%S1S2.SJS3 jjr&SKS4 jr'SGS5 jr(SGS6 jr)SLS7 jr*SMSHS8 jjr+S9 r,S: r-S; r.S< r/S= r0\1SESGS> jj5 r2\&r3 \'r4 \*r5S?r6g)Nr2 �) a� Structured parse results, to provide multiple means of access to11the parsed data:12 13- as a list (``len(results)``)14- by list index (``results[0], results[1]``, etc.)15- by attribute (``results.<results_name>`` - see :class:`ParserElement.set_results_name`)16 17Example:18 19.. testcode::20 21 integer = Word(nums)22 date_str = (integer.set_results_name("year") + '/'23 + integer.set_results_name("month") + '/'24 + integer.set_results_name("day"))25 # equivalent form:26 # date_str = (integer("year") + '/'27 # + integer("month") + '/'28 # + integer("day"))29 30 # parse_string returns a ParseResults object31 result = date_str.parse_string("1999/12/31")32 33 def test(s, fn=repr):34 print(f"{s} -> {fn(eval(s))}")35 36 test("list(result)")37 test("result[0]")38 test("result['month']")39 test("result.day")40 test("'month' in result")41 test("'minutes' in result")42 test("result.dump()", str)43 44prints:45 46.. testoutput::47 48 list(result) -> ['1999', '/', '12', '/', '31']49 result[0] -> '1999'50 result['month'] -> '12'51 result.day -> '31'52 'month' in result -> True53 'minutes' in result -> False54 result.dump() -> ['1999', '/', '12', '/', '31']55 - day: '31'56 - month: '12'57 - year: '1999'58 59Nr ztuple[Any, ...]� _null_values�str�_name�_parentzset[str]�60_all_names�bool�_modalz list[Any]�_toklistzdict[str, Any]�_tokdict)rA rB rC rE rF rG c �" � \ rS rSrSrSS jrSrg)�ParseResults.List�o a� 61Simple wrapper class to distinguish parsed list results that should be preserved62as actual Python lists, instead of being converted to :class:`ParseResults`:63 64.. testcode::65 66 import pyparsing as pp67 ppc = pp.common68 69 LBRACK, RBRACK, LPAR, RPAR = pp.Suppress.using_each("[]()")70 element = pp.Forward()71 item = ppc.integer72 item_list = pp.DelimitedList(element)73 element_list = LBRACK + item_list + RBRACK | LPAR + item_list + RPAR74 element <<= item | element_list75 76 # add parse action to convert from ParseResults77 # to actual Python collection types78 @element_list.add_parse_action79 def as_python_list(t):80 return pp.ParseResults.List(t.as_list())81 82 element.run_tests('''83 10084 [2,3,4]85 [[2, 1],3,4]86 [(2, 1),3,4]87 (2,3,4)88 ([2, 3], 4)89 ''', post_parse=lambda s, r: (r[0], type(r[0]))90 )91 92prints:93 94.. testoutput::95 :options: +NORMALIZE_WHITESPACE96 97 98 10099 (100, <class 'int'>)100 101 [2,3,4]102 ([2, 3, 4], <class 'list'>)103 104 [[2, 1],3,4]105 ([[2, 1], 3, 4], <class 'list'>)106 107 [(2, 1),3,4]108 ([[2, 1], 3, 4], <class 'list'>)109 110 (2,3,4)111 ([2, 3, 4], <class 'list'>)112 113 ([2, 3], 4)114 ([[2, 3], 4], <class 'list'>)115 116(Used internally by :class:`Group` when `aslist=True`.)117Nc � � Uc / n[ U[ 5 ( d- [ U R S[ U5 R 35 e[ R U 5 $ )Nz* may only be constructed with a list, not )�118isinstance�list� TypeErrorr6 �type�__new__)�cls� containeds r rP �ParseResults.List.__new__� sW � �� � � � �i��.�.� ��|�|�n�$N�t�T]��Og�Og�Nh�i�� � �<�<��$� $r# r r )r6 r7 r8 r9 �__doc__rP r< r r# r �ListrI o s
� �9 �v %r# rU c �~ � [ U[ 5 ( a U$ [ R U 5 nS Ul S Ul [
5 Ul Uc / Ul OY[ U[ [ 45 ( a6 [ U[ R 5 ( a US S /O119[ U5 Ul OU/Ul [ 5 Ul
U$ r )rL r2 �objectrP rA rB �setrC rF rM �_generator_typerU �dictrG )rQ �toklist�name�kwargsr s r rP �ParseResults.__new__� s� � � �g�|� ,� ,��N��~�~�c�"����120��� � �%��� �?� �D�M�
��$��!8�
9�
9� �g�|�'8�'8�9�9� ��� ��'�]�
�M� %�I�D�M� ���
�� r# Tc �4 � [ USSSS9nU=( a UnU X@l Ub US:X a g U" U[ 5 ( a [ U5 nU( d U1U l X l XR ; a g U" U[ [ 45 ( a U/nU( aX U" U[ 5 ( a" [ [ UR 5 S5 X' O[ [ US 5 S5 X' X U l g US X' g ! [ [ [ 4 a XLa XU' g X l g f = f)N�asListT�aslist)�new_name� r )r rE r3 r@ rC rA r? r rO r2 r rF �KeyErrorrN �121IndexError)r r[ r\ ra �modalrL r] r` s r r! �ParseResults.__init__� s � � $�F�H�d�X�N���"�F�� �� � �<�4�2�:� � �d�C� � ��t�9�D�� #�f�D�O��122� �'�'� '� � �g��$� /� 0� 0� �i�G� ��'�<�0�0� 4�\�'�BR�BR�5S�UV� W��123� 4�\�'�!�*�5M�q� Q��124� #��J� � � "� ���D�J���)�Z�0� "��"� $�T�125� !�126� "�s �'C/ �/ D�D�Dc �� � [ U[ [ 45 ( a U R U $ XR ; a U R127 U S S $ [
U R128 U Vs/ s H o"S PM sn5 $ s snf )N�����r )rL r3 r rF rC rG r2 )r r& �vs r r' �ParseResults.__getitem__� so � � �a�#�u� � &� &��=�=��#� #� �O�O� #��=�=��#�B�'��*� *��4�=�=��+;� <�+;�a�q�T�+;� <�=�=�� <s �%A:c � � U" U[ 5 ( a; U R R U[ 5 5 U/- U R U' US nObU" U[ [129 45 ( a X R U' UnO9U R R U/ 5 [ US5 /- U R U' UnU" U[ 5 ( a Xl g g r. ) r rG �getrM r3 r rF r2 rB )r �krj rL �subs r � __setitem__�ParseResults.__setitem__ s� � � �a�0� 1� 1� #�}�}� 0� 0��D�F� ;�q�c� A�D�M�M�!� ��A�$�C�
��C��<�
(�
(� �M�M�!� ��C� #�}�}� 0� 0��B� 7�'��1�-�;� �D�M�M�!� � �C� �c�<� (� (� �K� )r# c �D � [ U[ [ 45 ( d U R U g U[ :X a U R130 R
5 g [ U R131 5 nU R132 U [ U[ 5 ( a US: a X-
n[ XS- 5 n[ [ UR U5 6 5 nUR 5 U R R 5 H5 nU H, n[ U5 H u nu px[ XxX�:� -133 5 XF' M M. M7 g )Nr r134 )rL r3 r rG r rF �clear�lenrM �range�indices�reverse�values� enumerater ) r r& �mylen�removed� occurrences�jrn �value�positions r � __delitem__�ParseResults.__delitem__ s� � ��!�c�5�\�*�*��
�
�a� � �
�135�?� �M�M� � � !� ��D�M�M�"�� �M�M�!� � �a�� � ��1�u��136���a�Q���A��u�a�i�i�� .�/�0������ �=�=�/�/�1�K� ��,5�k�,B�(�A�(��%<� �8�<� 8�&�K�N� -C� � 2r# c � � XR ; $ r �rG )r rn s r � __contains__�ParseResults.__contains__2 s � ��M�M�!�!r# c �, � [ U R 5 $ r )rt rF r* s r �__len__�ParseResults.__len__5 s � ��4�=�=�!�!r# c �H � U R =( d U R ( $ r )rF rG r* s r �__bool__�ParseResults.__bool__8 s � � �
�
�6�� � �7�7r# c �, � [ U R 5 $ r ��iterrF r* s r �__iter__�ParseResults.__iter__; � � ��D�M�M�"�"r# c �8 � [ U R S S S2 5 $ )Nri r� r* s r � __reversed__�ParseResults.__reversed__> s � ��D�M�M�$�B�$�'�(�(r# c �, � [ U R 5 $ r )r� rG r* s r �keys�ParseResults.keysA r� r# c �8 ^ � U 4S jT R 5 5 $ )Nc 3 �. ># � U H137 nTU v � M g 7fr r �r rn r s �r r �&ParseResults.values.<locals>.<genexpr>E s �� � �-��A��Q���s ��r� r* s `r rx �ParseResults.valuesD s �� �-�����-�-r# c �8 ^ � U 4S jT R 5 5 $ )Nc 3 �0 ># � U H oTU 4v � M
g 7fr r r� s �r r �%ParseResults.items.<locals>.<genexpr>H s �� � �2�k��D��G� �k�s �r� r* s `r �items�ParseResults.itemsG s �� �2�d�i�i�k�2�2r# c �" � U R ( $ )z�138Since ``keys()`` returns an iterator, this method is helpful in bypassing139code that looks for the existence of any defined results names.r� r* s r �haskeys�ParseResults.haskeysJ s � � �}�}�$�$r# c � � U( d S/nUR 5 H! u p4US:X a US U4nM [ SU< 35 e [ US [ 5 ( d [ U5 S:X d US U ; a
US nX nX U$ US nU$ )af 140Removes and returns item at specified index (default= ``last``).141Supports both ``list`` and ``dict`` semantics for ``pop()``. If142passed no argument or an integer argument, it will use ``list``143semantics and pop tokens from the list of parsed tokens. If passed144a non-integer argument (most likely a string), it will use ``dict``145semantics and pop the corresponding value from any defined results146names. A second default return value argument is supported, just as in147``dict.pop()``.148 149Example:150 151.. doctest::152 153 >>> numlist = Word(nums)[...]154 >>> print(numlist.parse_string("0 123 321"))155 ['0', '123', '321']156 157 >>> def remove_first(tokens):158 ... tokens.pop(0)159 ...160 >>> numlist.add_parse_action(remove_first)161 [W:(0-9)]...162 >>> print(numlist.parse_string("0 123 321"))163 ['123', '321']164 165 >>> label = Word(alphas)166 >>> patt = label("LABEL") + Word(nums)[1, ...]167 >>> print(patt.parse_string("AAB 123 321").dump())168 ['AAB', '123', '321']169 - LABEL: 'AAB'170 171 >>> # Use pop() in a parse action to remove named result172 >>> # (note that corresponding value is not173 >>> # removed from list form of results)174 >>> def remove_LABEL(tokens):175 ... tokens.pop("LABEL")176 ... return tokens177 ...178 >>> patt.add_parse_action(remove_LABEL)179 {W:(A-Za-z) {W:(0-9)}...}180 >>> print(patt.parse_string("AAB 123 321").dump())181 ['AAB', '123', '321']182 183ri �defaultr z)pop() got an unexpected keyword argument r184 )r� rN rL r3 rt )r r/ r] rn rj �index�ret� defaultvalues r �pop�ParseResults.popP s� � �\ ��4�D��L�L�N�D�A��I�~� �Q���|�� �"K�A�5� Q�R�R� #�185 �d�1�g�s� #� #�s�4�y�A�~��a��D� ���G�E��+�C�� ��J� ��7�L� � r# c � � X; a X $ U$ )a� 186Returns named result matching the given key, or if there is no187such name, then returns the given ``default_value`` or ``None`` if no188``default_value`` is specified.189 190Similar to ``dict.get()``.191 192Example:193 194.. doctest::195 196 >>> integer = Word(nums)197 >>> date_str = integer("year") + '/' + integer("month") + '/' + integer("day")198 199 >>> result = date_str.parse_string("1999/12/31")200 >>> result.get("year")201 '1999'202 >>> result.get("hour", "not specified")203 'not specified'204 >>> result.get("hour")205 206r )r �key�
default_values r rm �ParseResults.get� s � �. �;��9� � � r# c �� � U R R X5 U R R 5 H, n[ U5 H u nu pV[ XVXa:� - 5 X4' M M. g)a" 207Inserts new element at location index in the list of parsed tokens.208 209Similar to ``list.insert()``.210 211Example:212 213.. doctest::214 215 >>> numlist = Word(nums)[...]216 >>> print(numlist.parse_string("0 123 321"))217 ['0', '123', '321']218 219 >>> # use a parse action to insert the parse location220 >>> # in the front of the parsed results221 >>> def insert_locn(locn, tokens):222 ... tokens.insert(0, locn)223 ...224 >>> numlist.add_parse_action(insert_locn)225 [W:(0-9)]...226 >>> print(numlist.parse_string("0 123 321"))227 [0, '0', '123', '321']228 229N)rF �insertrG rx ry r )r r� �230ins_stringr| rn r~ r s r r� �ParseResults.insert� s[ � �2
�
�
� � �U�/� �=�=�/�/�1�K�(1�+�(>�$��$�E�!8��x�'7�8�"� �� )?� 2r# c �: � U R R U5 g)a 231Add single element to end of ``ParseResults`` list of elements.232 233Example:234 235.. doctest::236 237 >>> numlist = Word(nums)[...]238 >>> print(numlist.parse_string("0 123 321"))239 ['0', '123', '321']240 241 >>> # use a parse action to compute the sum of the parsed integers,242 >>> # and add it to the end243 >>> def append_sum(tokens):244 ... tokens.append(sum(map(int, tokens)))245 ...246 >>> numlist.add_parse_action(append_sum)247 [W:(0-9)]...248 >>> print(numlist.parse_string("0 123 321"))249 ['0', '123', '321', 444]250N)rF �append)r �items r r� �ParseResults.append� s � �,
�
�
� � �T�"r# c � � [ U[ 5 ( a U R U5 gU R R U5 g)a� 251Add sequence of elements to end of :class:`ParseResults` list of elements.252 253Example:254 255.. testcode::256 257 patt = Word(alphas)[1, ...]258 259 # use a parse action to append the reverse of the matched strings,260 # to make a palindrome261 def make_palindrome(tokens):262 tokens.extend(reversed([t[::-1] for t in tokens]))263 return ''.join(tokens)264 265 patt.add_parse_action(make_palindrome)266 print(patt.parse_string("lskdj sdlkjf lksd"))267 268prints:269 270.. testoutput::271 272 ['lskdjsdlkjflksddsklfjkldsjdksl']273N)rL r2 �__iadd__rF �extend)r �itemseqs r r� �ParseResults.extend� s/ � �2 �g�|� ,� ,� �M�M�'� "� �M�M� � �� )r# c �V � U R SS2 U R R 5 g)z'274Clear all elements and results names.275N)rF rG rs r* s r rs �ParseResults.clear s � �
�M�M�!� � �
�
��� r# c �n � X $ ! [ a$ UR S5 ( a [ U5 e gf = f)N�__rc )rd �276startswith�AttributeError)r r\ s r � __getattr__�ParseResults.__getattr__ s; � � ��:� ��� ����t�$�$�$�T�*�*�� �s � �+4�4c �. � U R 5 nX!-
nU$ r )�copy)r �otherr� s r �__add__�ParseResults.__add__ s � ��i�i�k�� � ���277r# c � ^� U( d U $ UR ( a� [ U R 5 mU4S jnUR R 5 nU VVVs/ s H) u pEU H nU[ US U" US 5 5 4PM M+ nnnnU H, u pFX`U' [ US [ 5 ( d M# XS l M. U =R UR -
sl U =R UR - sl U $ s snnnf )Nc � >� U S: a T$ U T- $ r. r )�a�offsets �r �<lambda>�'ParseResults.__iadd__.<locals>.<lambda> s �� �A��E�&�"A�q�6�z�"Ar# r r278 ) rG rt rF r� r rL r2 rB rC ) r r� � addoffset�279otheritemsrn �vlistrj �otherdictitemsr� s @r r� �ParseResults.__iadd__ s� �� ���K� �>�>��� � �'�F�A�I� � � �-�-�/�J� !+� � *�H�A� �A� �+�A�a�D�)�A�a�D�/�B�C� � D� *�
� �280 '����Q�� �a��d�L�1�1�#'�a�D�L� '�281
�
�
�� � �'�
� ���5�+�+�+��� �� s �0C=c �` � [ U[ 5 ( a US:X a U R 5 $ X- $ r. )rL r3 r� )r r� s r �__radd__�ParseResults.__radd__+ s+ � � �e�S� !� !�e�q�j��9�9�;� � �<� r# c �p � [ U 5 R SU R < SU R 5 S3$ )N�(�, �))rO r6 rF �as_dictr* s r �__repr__�ParseResults.__repr__3 s2 � ��t�*�%�%�&�a��
�
�'8��4�<�<�>�:J�!�L�Lr# c 282 �� � SSR U R Vs/ s H. n[ U[ 5 ( a [ U5 O283[ U5 PM0 sn5 - S- $ s snf )N�[r� �])�joinrF rL r2 r@ �reprr% s r �__str__�ParseResults.__str__6 sd � � ��i�i� "�]�]�� *�� )��L� 9� 9�C��F�t�A�w�F� *���
� �
� 284��s �5A 285c �� � / nU R He nU( a U( a UR U5 [ U[ 5 ( a X#R 5 -
nMK UR [ U5 5 Mg U$ r )rF r� rL r2 �
_asStringListr@ )r �sep�outr� s r r� �ParseResults._asStringListB sZ � ����M�M�D��s��286�287�3���$� �-�-��)�)�+�+���288�289�3�t�9�%�
"� �290r# F)�flattenc � � U( a
/ [ U 5 Q$ U R Vs/ s H* n[ U[ 5 ( a UR 5 OUPM, sn$ s snf )a 291Returns the parse results as a nested list of matching tokens, all converted to strings.292If ``flatten`` is True, all the nesting levels in the returned list are collapsed.293 294Example:295 296.. doctest::297 298 >>> patt = Word(alphas)[1, ...]299 >>> result = patt.parse_string("sldkj lsdkj sldkj")300 >>> # even though the result prints in string-like form,301 >>> # it is actually a pyparsing ParseResults302 >>> type(result)303 <class 'pyparsing.results.ParseResults'>304 >>> print(result)305 ['sldkj', 'lsdkj', 'sldkj']306 307.. doctest::308 309 >>> # Use as_list() to create an actual list310 >>> result_list = result.as_list()311 >>> type(result_list)312 <class 'list'>313 >>> print(result_list)314 ['sldkj', 'lsdkj', 'sldkj']315 316.. versionchanged:: 3.2.0317 New ``flatten`` argument.318)r
rF rL r2 �as_list)r r� �ress r r� �ParseResults.as_listM sX � �> �$�X�d�^�$� $� �=�=��(�C� ",�C� �!>�!>�� � �
�C�G�(��
�� s �1Ac �V ^� U4S jm[ U4S jU R 5 5 5 $ )a� 319Returns the named parse results as a nested dictionary.320 321Example:322 323.. doctest::324 325 >>> integer = pp.Word(pp.nums)326 >>> date_str = integer("year") + '/' + integer("month") + '/' + integer("day")327 328 >>> result = date_str.parse_string('1999/12/31')329 >>> type(result)330 <class 'pyparsing.results.ParseResults'>331 >>> result332 ParseResults(['1999', '/', '12', '/', '31'], {'year': '1999', 'month': '12', 'day': '31'})333 334 >>> result_dict = result.as_dict()335 >>> type(result_dict)336 <class 'dict'>337 >>> result_dict338 {'year': '1999', 'month': '12', 'day': '31'}339 340 >>> # even though a ParseResults supports dict-like access,341 >>> # sometime you just need to have a dict342 >>> import json343 >>> print(json.dumps(result))344 Traceback (most recent call last):345 TypeError: Object of type ParseResults is not JSON serializable346 >>> print(json.dumps(result.as_dict()))347 {"year": "1999", "month": "12", "day": "31"}348c � >� [ U [ 5 ( a> U R 5 ( a U R 5 $ U Vs/ s H nT" U5 PM
sn$ U $ s snf r )rL r2 r� r� )�objrj �to_items �r r� �%ParseResults.as_dict.<locals>.to_item� sL �� ��#�|�,�,�(+� � �
�
�s�{�{�}�T�PS�;T�PS�1�G�A�J�PS�;T�T��349�� <Us � Ac 3 �< ># � U H u pUT" U5 4v � M g 7fr r )r rn rj r� s �r r �'ParseResults.as_dict.<locals>.<genexpr>� s �� � �=� ���Q���350�O� �s � )rZ r� )r r� s @r r� �ParseResults.as_dictt s" �� �B � �=��351�352� �=�=�=r# c �� � [ U R 5 nU R R 5 Ul U R Ul U=R353 U R354 - sl U R Ul U$ )z�355Returns a new shallow copy of a :class:`ParseResults` object.356:class:`ParseResults` items contained within the source are357shared with the copy. Use :meth:`ParseResults.deepcopy` to358create a copy with its own separate content values.359)r2 rF rG r� rB rC rA )r r� s r r� �ParseResults.copy� sS � � �4�=�=�)���}�}�)�)�+�� ��l�l�� � ���$�/�/�)���J�J�� ��360r# c �p � U R 5 n[ U R 5 GH u p#[ U[ 5 ( a UR 5 UR U' M: [ U[ [ 45 ( a MW [ U[ 5 ( ac [ U5 " 5 =UR U' nUR 5 H. u pV[ U[ 5 ( a UR 5 OUXE' M0 M� [ U[ 5 ( d M� [ U5 " S U 5 5 UR U' GM U$ )zU361Returns a new deep copy of a :class:`ParseResults` object.362 363.. versionadded:: 3.1.0364c 3 �p # � U H, n[ U[ 5 ( a UR 5 OUv � M. g 7fr )rL r2 �deepcopy)r rj s r r �(ParseResults.deepcopy.<locals>.<genexpr>� s+ � � � ,�PS�1�J�q�,�$?�$?�A�J�J�L�Q�F�PS�s �46) r� ry rF rL r2 r� r@ �bytesr rO r� r )r r� r& r� �destrn rj s r r� �ParseResults.deepcopy� s� � � �i�i�k�� ��
�
�.�F�A��#�|�,�,�"%�,�,�.�� � �Q���C�#�u� �.�.���C� �0�0�)-�c���4�� � �Q��$� �I�I�K�D�A�.8��L�.I�.I�a�j�j�l�q�D�G� (��C��*�*�"&�s�)� ,�PS�,� #�� � �Q�� /� �365r# c �� ^ � T R ( a T R $ T R ( a< T R nUR R 5 n[ U 4S jU 5 S5 $ [ T 5 S:X a{ [ T R 5 S:X ab [ [
T R R 5 5 5 S S S; a, [ [
T R R 5 5 5 $ g)a� 366Returns the results name for this token expression.367 368Useful when several different expressions might match369at a particular location.370 371Example:372 373.. testcode::374 375 integer = Word(nums)376 ssn_expr = Regex(r"\d\d\d-\d\d-\d\d\d\d")377 house_number_expr = Suppress('#') + Word(nums, alphanums)378 user_data = (Group(house_number_expr)("house_number")379 | Group(ssn_expr)("ssn")380 | Group(integer)("age"))381 user_info = user_data[1, ...]382 383 result = user_info.parse_string("22 111-22-3333 #221B")384 for item in result:385 print(item.get_name(), ':', item[0])386 387prints:388 389.. testoutput::390 391 age : 22392 ssn : 111-22-3333393 house_number : 221B394 395c 3 �R ># � U H u pU H u p4UTL d M Uv � M M g 7fr r )r rn r� rj �locr s �r r �(ParseResults.get_name.<locals>.<genexpr>� s2 �� � � �$8���"'����D�y� �A�"'� �$8�s �'�
'Nr396 r )r ri ) rA rB rG r� �nextrt r� rx r� )r �par�parent_tokdict_itemss ` r �get_name�ParseResults.get_name� s� �� �@ �:�:��:�:� �
�\�\� $� � �C�#&�<�<�#5�#5�#7� ���$8�� ��
�
��I��N��D�M�M�"�a�'��T�$�-�-�.�.�0�1�2�1�5�a�8�G�C���T�]�]� /� /� 1�2�3� 3�r# c � � / nSnUR U( a U[ U R 5 5 - OS5 U( d SR U5 $ U R 5 ( a� [ S U R
5 5 5 nU H� u p�U( a UR U5 UR U SU- SU S35 [ U [ 5 ( d UR [ U 5 5 Mj U ( d UR [ U 5 5 M� UR U R UUUUS- S95 M� [ S U 5 5 ( d SR U5 $ U n Sn397Sn [ U 5 H� u p�[ U
[ 5 ( aA U
R UUUUS- S9nUR U U X�- S398U S U U X�S- - U 33995 M[ UR U U X�- S400U S U U X�S- - U
34015 M� SR U5 $ ) a� 402Diagnostic method for listing out the contents of403a :class:`ParseResults`. Accepts an optional ``indent`` argument so404that this string can be embedded in a nested display of other data.405 406Example:407 408.. testcode::409 410 integer = Word(nums)411 date_str = integer("year") + '/' + integer("month") + '/' + integer("day")412 413 result = date_str.parse_string('1999/12/31')414 print(result.dump())415 416prints:417 418.. testoutput::419 420 ['1999', '/', '12', '/', '31']421 - day: '31'422 - month: '12'423 - year: '1999'424�425rc c 3 �@ # � U H u p[ U5 U4v � M g 7fr )r@ )r rn rj s r r �$ParseResults.dump.<locals>.<genexpr> s � � �@�<�4�1�C��F�A�;�<�s � z z- z: r426 )�indent�full� include_list�_depthc 3 �B # � U H n[ U[ 5 v � M g 7fr )rL r2 )r �vvs r r r / s � � �?�$�B�:�b�,�/�/�$�s � r� z]:)
r� r@ r� r� r� �sortedr� rL r2 r� �dump�anyry )r r r r r r� �NLr� rn rj �incr�nlr& r �vv_dumps r r �ParseResults.dump� s � �2 ��
�� �427�428�<�6�C�� � �� /�/�R�H���7�7�3�<� � �<�<�>�>��@�4�:�:�<�@�@�E� �����J�J�r�N��429�430�f�X�t�f�}�%6�b���2�>�?�!�!�\�2�2��J�J�t�A�w�'� ���J�J�s�1�v�&� ��431�432��F�F� %� !�%1� %��z� � �� �( �?�$�?�?�?��7�7�3�<� � ����
�� �q�\�E�A��"�l�+�+� �'�'�!� �!-�!�A�:� "� �� �433�434��d�6�(�4�=�/��1�#�R��t�F�8�D�UV�J�DW�CX�Y`�Xa�b�� �435�436��d�6�(�4�=�/��1�#�R��t�F�8�D�UV�J�DW�CX�Y[�X\�]�� "� �w�w�s�|�r# c �T � [ R " U R 5 /UQ70 UD6 g)a� 437Pretty-printer for parsed results as a list, using the438`pprint <https://docs.python.org/3/library/pprint.html>`_ module.439Accepts additional positional or keyword args as defined for440`pprint.pprint <https://docs.python.org/3/library/pprint.html#pprint.pprint>`_ .441 442Example:443 444.. testcode::445 446 ident = Word(alphas, alphanums)447 num = Word(nums)448 func = Forward()449 term = ident | num | Group('(' + func + ')')450 func <<= ident + Group(Optional(DelimitedList(term)))451 result = func.parse_string("fna a,b,(fnb c,d,200),100")452 result.pprint(width=40)453 454prints:455 456.. testoutput::457 458 ['fna',459 ['a',460 'b',461 ['(', 'fnb', ['c', 'd', '200'], ')'],462 '100']]463N)�pprintr� )r r/ r] s r r �ParseResults.pprintG s � �: �
�
�d�l�l�n�6�t�6�v�6r# c �~ � U R U R R 5 S U R U R 44$ r )rF rG r� rC rA r* s r r+ �ParseResults.__getstate__g s9 � � �M�M��
�
�"�"�$������464�465�
�466� 467r# c �b � Uu U l u U l p#U l [ U5 U l S U l g r )rF rG rA rX rC rB )r �stater � inAccumNamess r r0 �ParseResults.__setstate__r s, � �HM�E��
�E��
�s�$�*� �l�+����� r# c �2 � U R U R 4$ r )rF rA r* s r �__getnewargs__�ParseResults.__getnewargs__w s � ��}�}�d�j�j�(�(r# c �^ � [ [ U 5 5 [ U R 5 5 - $ r )�dirrO rM r� r* s r �__dir__�ParseResults.__dir__z s � ��4��:���d�i�i�k�!2�2�2r# c �� � U " / 5 nUR 5 HA u pE[ U[ 5 ( a X0R XTS9-
nM- X0" U/U[ U5 S9-
nMC Ub U " U/US9nU$ )z�468Helper classmethod to construct a :class:`ParseResults` from a ``dict``, preserving the469name-value relations as results names. If an optional ``name`` argument is470given, a nested :class:`ParseResults` will be returned.471)r\ )r\ ra )r� rL r � from_dictr )rQ r� r\ r� rn rj s r r. �ParseResults.from_dict} ss � � �"�g���K�K�M�D�A��!�W�%�%��}�}�Q�}�/�/���s�A�3�Q�|�A��?�?�� "�472 � ��s�e�$�'�C��473r# )rC rE rA rB rG rF )NN)r4 r5 )r4 rD )r4 r3 )r4 r r )r� r2 r4 r2 )r4 r2 )r4 r@ )rc )r� rD r4 rM )r4 rZ )r4 z474str | None)rc TTr )7r6 r7 r8 r9 rT r? r: r; rM rU rP rL r! r' rp r� r� r� r� r� r� r� rx r� r� r� rm r� r� r� rs r� r� r� r� r� r� r� r� r� r� r� r r r r+ r0 r' r+ � classmethodr. r` �asDict�getNamer< r r# r r2 r2 ) sw � �1�f &*�2�r�N�L�/�2� �J�
���� �L��� � ��I�E%�t� E%�N�2 �
��� �
."� 475�."�`>� ,6�
� �:"�"�8�#�)�#�.�3�%� < �|!�8 �B#�0 *�< ���476�, �M�477478� � */� %�N'>�R � �.5�nL �\ 7�@ 479� �480)�3� �� �� �F�� �F�� �G�r# r2 )�481__future__r � collections�collections.abcr r r r r r �typingr �utilr r r
r@ r� r r: rO rY r r r r2 �registerr r# r �<module>r9 s� �� #� �� � � � <� <� "�5�\��482� )���2��'���$�K�483�E� �� �"s
� s
�l � � � � %� � � � � &r#