~gfUddlmZddlZddlmZmZmZmZmZddl Z ddl m Z ddl m Z eefZded<ed d DZGd d ZGd dZejeejedS)) annotationsN)MutableMappingMappingMutableSequenceIteratorIterable)Any)replaced_by_pep8ztuple[type, ...]str_typec#K|]}|VdSN).0_s G/granary/edev/quantum/lib/python3.11/site-packages/pyparsing/results.py rsarc:eZdZUded<dgZd dZdZd Zd Zd S) _ParseResultsWithOffsetztuple[ParseResults, int]tupp1 ParseResultsp2intc||f|_dSrr)selfrrs r__init__z _ParseResultsWithOffset.__init__s.0"Xrc|j|Srrris r __getitem__z#_ParseResultsWithOffset.__getitem__sx{rc|jSrrrs r __getstate__z$_ParseResultsWithOffset.__getstate__ s xrc |d|_dSNrr)rargss r __setstate__z$_ParseResultsWithOffset.__setstate__#s7rN)rrrr) __name__ __module__ __qualname____annotations__ __slots__rr#r&r*rrrrrsj!!!!I6666rrceZdZUdZdgdfZded<ded<ded<d ed <d ed <d ed<ded<dZGddeZdIdZ dddde fdJdZ dZ e fdZ dZdKdZdLdZdKdZdMd!ZdMd"Zd#Zd$Zd%ZdKd&Zd'ZdNd(Zd)Zd*Zd+Zd,Zd-ZdOd/ZdOd0Z dPd1Z!dQd2Z"dQd3Z#dRd5Z$d6d7dSd:Z%dTd<Z&dPd=Z'dPd>Z(dUd@Z)dVdQdBZ*dCZ+dDZ,dEZ-dFZ.dGZ/e0dNdPdHZ1e%Z2 e&Z3 e)Z4dS)Wra{Structured parse results, to provide multiple means of access to the parsed data: - as a list (``len(results)``) - by list index (``results[0], results[1]``, etc.) - by attribute (``results.`` - see :class:`ParserElement.set_results_name`) Example:: integer = Word(nums) date_str = (integer.set_results_name("year") + '/' + integer.set_results_name("month") + '/' + integer.set_results_name("day")) # equivalent form: # date_str = (integer("year") + '/' # + integer("month") + '/' # + integer("day")) # parse_string returns a ParseResults object result = date_str.parse_string("1999/12/31") def test(s, fn=repr): print(f"{s} -> {fn(eval(s))}") test("list(result)") test("result[0]") test("result['month']") test("result.day") test("'month' in result") test("'minutes' in result") test("result.dump()", str) prints:: list(result) -> ['1999', '/', '12', '/', '31'] result[0] -> '1999' result['month'] -> '12' result.day -> '31' 'month' in result -> True 'minutes' in result -> False result.dump() -> ['1999', '/', '12', '/', '31'] - day: '31' - month: '12' - year: '1999' Nrztuple[Any, ...] _null_valuesstr_name_parentzset[str] _all_namesbool_modalz list[Any]_toklistzdict[str, Any]_tokdict)r3r4r5r7r8r9ceZdZdZddZdS)ParseResults.Lista Simple wrapper class to distinguish parsed list results that should be preserved as actual Python lists, instead of being converted to :class:`ParseResults`:: LBRACK, RBRACK = map(pp.Suppress, "[]") element = pp.Forward() item = ppc.integer element_list = LBRACK + pp.DelimitedList(element) + RBRACK # add parse actions to convert from ParseResults to actual Python collection types def as_python_list(t): return pp.ParseResults.List(t.as_list()) element_list.add_parse_action(as_python_list) element <<= item | element_list element.run_tests(''' 100 [2,3,4] [[2, 1],3,4] [(2, 1),3,4] (2,3,4) ''', post_parse=lambda s, r: (r[0], type(r[0]))) prints:: 100 (100, ) [2,3,4] ([2, 3, 4], ) [[2, 1],3,4] ([[2, 1], 3, 4], ) (Used internally by :class:`Group` when `aslist=True`.) Nc|g}t|ts+t|jdt |jt|S)Nz* may only be constructed with a list, not ) isinstancelist TypeErrorr+type__new__)cls containeds rrAzParseResults.List.__new__sb  i.. |iitT]Ogii<<$$ $rr)r+r,r-__doc__rArrrListr;gs3$ $ L % % % % % %rrEc t|tr|St|}d|_d|_t |_|g|_n^t|ttfr:t|tj r |ddgnt||_n|g|_t|_ |Sr)r=robjectrAr3r4setr5r8r>_generator_typerEdictr9)rBtoklistnamekwargsrs rrAzParseResults.__new__s g| , , N~~c""  %% ?DMM $!8 9 9 &g|'899# ']] MM %IDM  rTreturnNonec0|||_||dkrdS||trt|}|s|h|_||_||jvrdS||t tfr|g}|rl||tr&tt|j d||<n&tt|dd||<|||_dS |d||<dS#tttf$r||ur|||<YdS||_YdSwxYw)Nr)r7rr2r5r3r1r r@rrr8KeyErrorr? IndexError)rrKrLasListmodalr=s rrzParseResults.__init__sZ 9 <42:: F :dC  t99D %#fDO d' ' ' F :g$/ 0 0 iG  z'<00 R4\'BR5S5SUVWWT 4\'!*5M5MqQQT #DJ  F " DJJJ)Z0 " " "d""$T !  "s C'' D DDct|ttfr |j|S||jvr|j|ddSt d|j|DS)Nrcg|] }|d S)rrrvs r z,ParseResults.__getitem__..s<<rr\r8rr4)rkrZr=subs r __setitem__zParseResults.__setitem__s :a0 1 1 #}00DFF;;qcADM! A$CC ZC< ( (  DM! CC#}00B77'1--; DM! C :c< ( ( CKKK  rc t|ttfs |j|=dSt |j}|j|=t|tr|dkr||z }t||dz}t t||}| |j D]9}|D]4}t|D]"\}\}}t||||kz ||<#5:dS)Nrr ) r=rr\r9lenr8r>rangeindicesreversevalues enumerater) rr"mylenremoved occurrencesjr_valuepositions r __delitem__zParseResults.__delitem__s)!c5\**  a FDM"" M!  a   1uuU aQAuaii../00=//11  K  ,5k,B,B(A(x%<x8a<8&&KNN   rc||jvSrr9)rr_s r __contains__zParseResults.__contains__sDM!!rrc*t|jSr)rcr8r%s r__len__zParseResults.__len__ s4=!!!rc"|jp|j Sr)r8r9r%s r__bool__zParseResults.__bool__ s 6777rrc*t|jSriterr8r%s r__iter__zParseResults.__iter__DM"""rc<t|jdddSNrWrxr%s r __reversed__zParseResults.__reversed__sDM$$B$'(((rc*t|jSr)ryr9r%s rkeyszParseResults.keysr{rcDfdDS)Nc3(K|] }|V dSrrrr_rs rrz&ParseResults.values..s'--AQ------rrr%s`rrgzParseResults.valuess%--------rcDfdDS)Nc3,K|]}||fVdSrrrs rrz%ParseResults.items..s+22DG 222222rrr%s`ritemszParseResults.itemss%2222diikk2222rc|j S)z Since ``keys()`` returns an iterator, this method is helpful in bypassing code that looks for the existence of any defined results names.rqr%s rhaskeyszParseResults.haskeyss}$$$rc2|sdg}|D]'\}}|dkr |d|f}td|t|dtst |dks |d|vr|d}||}||=|S|d}|S)a Removes and returns item at specified index (default= ``last``). Supports both ``list`` and ``dict`` semantics for ``pop()``. If passed no argument or an integer argument, it will use ``list`` semantics and pop tokens from the list of parsed tokens. If passed a non-integer argument (most likely a string), it will use ``dict`` semantics and pop the corresponding value from any defined results names. A second default return value argument is supported, just as in ``dict.pop()``. Example:: numlist = Word(nums)[...] print(numlist.parse_string("0 123 321")) # -> ['0', '123', '321'] def remove_first(tokens): tokens.pop(0) numlist.add_parse_action(remove_first) print(numlist.parse_string("0 123 321")) # -> ['123', '321'] label = Word(alphas) patt = label("LABEL") + Word(nums)[1, ...] print(patt.parse_string("AAB 123 321").dump()) # Use pop() in a parse action to remove named result (note that corresponding value is not # removed from list form of results) def remove_LABEL(tokens): tokens.pop("LABEL") return tokens patt.add_parse_action(remove_LABEL) print(patt.parse_string("AAB 123 321").dump()) prints:: ['AAB', '123', '321'] - LABEL: 'AAB' ['AAB', '123', '321'] rWdefaultrz)pop() got an unexpected keyword argument r )rr?r=rrc)rr)rMr_rZindexret defaultvalues rpopzParseResults.pop%sP 4DLLNN S SDAqI~~Q| QA Q QRRR d1gs # # s4yyA~~aDGEu+CU J7L rc||vr||S|S)a^ Returns named result matching the given key, or if there is no such name, then returns the given ``default_value`` or ``None`` if no ``default_value`` is specified. Similar to ``dict.get()``. Example:: integer = Word(nums) date_str = integer("year") + '/' + integer("month") + '/' + integer("day") result = date_str.parse_string("1999/12/31") print(result.get("year")) # -> '1999' print(result.get("hour", "not specified")) # -> 'not specified' print(result.get("hour")) # -> None r)rkey default_values rr^zParseResults.get]s$ $;;9  rc|j|||jD]4}t |D]"\}\}}t ||||kz||<#5dS)a; Inserts new element at location index in the list of parsed tokens. Similar to ``list.insert()``. Example:: numlist = Word(nums)[...] print(numlist.parse_string("0 123 321")) # -> ['0', '123', '321'] # use a parse action to insert the parse location in the front of the parsed results def insert_locn(locn, tokens): tokens.insert(0, locn) numlist.add_parse_action(insert_locn) print(numlist.parse_string("0 123 321")) # -> [0, '0', '123', '321'] N)r8insertr9rgrhr)rr ins_stringrkr_rmrns rrzParseResults.insertts" UJ///=//11  K(1+(>(>  $$E8!88x%'78"" A   rc:|j|dS)a Add single element to end of ``ParseResults`` list of elements. Example:: numlist = Word(nums)[...] print(numlist.parse_string("0 123 321")) # -> ['0', '123', '321'] # use a parse action to compute the sum of the parsed integers, and add it to the end def append_sum(tokens): tokens.append(sum(map(int, tokens))) numlist.add_parse_action(append_sum) print(numlist.parse_string("0 123 321")) # -> ['0', '123', '321', 444] N)r8append)ritems rrzParseResults.appends  T"""""rct|tr||dS|j|dS)a Add sequence of elements to end of ``ParseResults`` list of elements. Example:: patt = Word(alphas)[1, ...] # use a parse action to append the reverse of the matched strings, to make a palindrome def make_palindrome(tokens): tokens.extend(reversed([t[::-1] for t in tokens])) return ''.join(tokens) patt.add_parse_action(make_palindrome) print(patt.parse_string("lskdj sdlkjf lksd")) # -> 'lskdjsdlkjflksddsklfjkldsjdksl' N)r=r__iadd__r8extend)ritemseqs rrzParseResults.extendsJ g| , , * MM' " " " " " M  ) ) ) ) )rcL|jdd=|jdS)z7 Clear all elements and results names. N)r8r9clearr%s rrzParseResults.clears, M!!!  rc~ ||S#t$r(|drt|YdSwxYw)N__rQ)rR startswithAttributeError)rrLs r __getattr__zParseResults.__getattr__sU :    t$$ +$T***22 s  .<<otherc8|}||z }|Sr)copy)rrrs r__add__zParseResults.__add__siikk u  rc^|s|S|jrut|jfd|j}fd|D}|D]2\}}|||<t |dt r ||d_3|xj|jz c_|xj|jzc_|S)Nc|dkrn|zSr(r)aoffsets rz'ParseResults.__iadd__..sAEE&&q6zrc ng|]1\}}|D])}|t|d|df*2S)rr )r)rr_vlistrZ addoffsets rr[z)ParseResults.__iadd__..sdAu+AaD))AaD//BBCrr)r9rcr8rr=rr4r5)rr otheritemsotherdictitemsr_rZrrs @@rrzParseResults.__iadd__s K > (''FAAAAI--//J *N ' ( (1QadL11(#'AaDL '  5++ rcjt|tr|dkr|S||zSr()r=rr)rrs r__radd__zParseResults.__radd__s6 eS ! ! eqjj99;; 4< rcjt|jd|jd|dS)N(, ))r@r+r8as_dictr%s r__repr__zParseResults.__repr__s4t**%LL LL4<<>>LLLLrcVddd|jDzdzS)N[rctg|]5}t|trt|nt|6Sr)r=rr2repr)rr"s rr[z(ParseResults.__str__..sG)L99FCFFFtAwwr])joinr8r%s r__str__zParseResults.__str__sH ii!]   rrQcg}|jD]j}|r|r||t|tr||z }H|t |k|Sr)r8rr=r _asStringListr2)rsepoutrs rrzParseResults._asStringListsM & &D s  3$ -- &t))+++ 3t99%%%% rF)flattenrr>cNfd}|r g|SdjDS)a Returns the parse results as a nested list of matching tokens, all converted to strings. If flatten is True, all the nesting levels in the returned list are collapsed. Example:: patt = Word(alphas)[1, ...] result = patt.parse_string("sldkj lsdkj sldkj") # even though the result prints in string-like form, it is actually a pyparsing ParseResults print(type(result), result) # -> ['sldkj', 'lsdkj', 'sldkj'] # Use as_list() to create an actual list result_list = result.as_list() print(type(result_list), result_list) # -> ['sldkj', 'lsdkj', 'sldkj'] c3Ktjg}|rP|}t|tr||dddn|V|NdSdSr}) collectionsdequepopleftr=r extendleft)prto_visitto_dors r flattenedz'ParseResults.as_list..flatteneds"(411H  ((**e\22 ''ddd 4444KKK      rcdg|]-}t|tr|n|.Sr)r=ras_list)rress rr[z(ParseResults.as_list..sC",C!>!>G Cr)r8)rrrs` rrzParseResults.as_lists\"       %YYt__% %= rrJchfdtfd|DS)a Returns the named parse results as a nested dictionary. Example:: integer = Word(nums) date_str = integer("year") + '/' + integer("month") + '/' + integer("day") result = date_str.parse_string('12/31/1999') print(type(result), repr(result)) # -> (['12', '/', '31', '/', '1999'], {'day': [('1999', 4)], 'year': [('12', 0)], 'month': [('31', 2)]}) result_dict = result.as_dict() print(type(result_dict), repr(result_dict)) # -> {'day': '1999', 'year': '12', 'month': '31'} # even though a ParseResults supports dict-like access, sometime you just need to have a dict import json print(json.dumps(result)) # -> Exception: TypeError: ... is not JSON serializable print(json.dumps(result.as_dict())) # -> {"month": "31", "day": "1999", "year": "12"} ct|tr6|r|n fd|DS|S)Nc&g|] }|Srr)rrZto_items rr[z9ParseResults.as_dict..to_item..7s!;T;T;T1GGAJJ;T;T;Tr)r=rrr)objrs rrz%ParseResults.as_dict..to_item5sO#|,, (+ Ts{{}}};T;T;T;TPS;T;T;TT rc38K|]\}}||fVdSrr)rr_rZrs rrz'ParseResults.as_dict..;s3==1Q O======r)rJr)rrs @rrzParseResults.as_dict sI*      ==== ======rct|j}|j|_|j|_|xj|jzc_|j|_|S)a Returns a new shallow copy of a :class:`ParseResults` object. `ParseResults` items contained within the source are shared with the copy. Use :class:`ParseResults.deepcopy()` to create a copy with its own separate content values. )rr8r9rr4r5r3)rrs rrzParseResults.copy=sQ4=))}))++ l  $/)J  rc|}t|jD]\}}t|tr||j|<8t|t tfrUt|trjt|x|j|<}| D]3\}}t|tr|n|||<4t|tr*t|d|D|j|<|S)zL Returns a new deep copy of a :class:`ParseResults` object. c3lK|]/}t|tr|n|V0dSr)r=rdeepcopyrYs rrz(ParseResults.deepcopy..[sN,,KLJq,$?$?FAJJLLLQ,,,,,,r) rrhr8r=rrr2bytesrr@rr)rrr"rdestr_rZs rrzParseResults.deepcopyKs8iikk ..  FAs#|,, "%,,.. QC#u.. C00 )2c4 Q$IIKKQQDAq.8L.I.IPajjlllqDGGQC** "+$s)),,PS,,,## Q r str | NonecjrjSjr<j}|j}t fd|DdSt dkrt jdkrtt t jdddvr3t t jSdS)a Returns the results name for this token expression. Useful when several different expressions might match at a particular location. Example:: integer = Word(nums) ssn_expr = Regex(r"\d\d\d-\d\d-\d\d\d\d") house_number_expr = Suppress('#') + Word(nums, alphanums) user_data = (Group(house_number_expr)("house_number") | Group(ssn_expr)("ssn") | Group(integer)("age")) user_info = user_data[1, ...] result = user_info.parse_string("22 111-22-3333 #221B") for item in result: print(item.get_name(), ':', item[0]) prints:: age : 22 ssn : 111-22-3333 house_number : 221B c3:K|]\}}|D] \}}|u |VdSrr)rr_rrZlocrs rrz(ParseResults.get_name..sS 5"'3Dyy!yyyy rNr r)rrW) r3r4r9rnextrcryrgr)rparparent_tokdict_itemss` rget_namezParseResults.get_name`s2 : :  \  $ C#&<#5#5#7#7 $8   IINNDM""a''T$-..00112215a8GCCT]//112233 34rrcg}d}||r$|t|znd|sd|S|rt d|D}|D]\}} |r||||d|zd|dt| ts#|t| t| s#|t| || ||||dztd |Dsd|S|} d} d} t| D]\} } t| trM| ||||dz}|| || |zd | d | || |dzz| g|| || |zd | d | || |dzz| d|S) aM Diagnostic method for listing out the contents of a :class:`ParseResults`. Accepts an optional ``indent`` argument so that this string can be embedded in a nested display of other data. Example:: integer = Word(nums) date_str = integer("year") + '/' + integer("month") + '/' + integer("day") result = date_str.parse_string('1999/12/31') print(result.dump()) prints:: ['1999', '/', '12', '/', '31'] - day: '31' - month: '12' - year: '1999'  rQc3>K|]\}}t||fVdSr)r2)rr_rZs rrz$ParseResults.dump..s0@@41aCFFA;@@@@@@rz z- z: r )indentfull include_list_depthc3@K|]}t|tVdSr)r=r)rvvs rrz$ParseResults.dump..s,??B:b,//??????rrz]:) rr2rrrsortedrr=rrdumpanyrh)rrrrrrNLrr_rZincrnlr"rvv_dumps rrzParseResults.dumps*  <G6C ////RHHH 773<<  <<>> @@4::<<@@@@@E  1#JJrNNN f>tf}>>>>>???!!\22JJtAww'''JJs1vv&&& FF%!%1%z ??$????? 773<<   q\\  EAr"l++ ''!!-!A: "  b6b4&=bb1bbbFbDFUVJDWbY`bb ]6]4&=]]1]]]F]DFUVJDW]Y[]]wws||rcTtj|g|Ri|dS)a$ Pretty-printer for parsed results as a list, using the `pprint `_ module. Accepts additional positional or keyword args as defined for `pprint.pprint `_ . Example:: ident = Word(alphas, alphanums) num = Word(nums) func = Forward() term = ident | num | Group('(' + func + ')') func <<= ident + Group(Optional(DelimitedList(term))) result = func.parse_string("fna a,b,(fnb c,d,200),100") result.pprint(width=40) prints:: ['fna', ['a', 'b', ['(', 'fnb', ['c', 'd', '200'], ')'], '100']] N)pprintr)rr)rMs rrzParseResults.pprints22  dllnn6t666v66666rc^|j|jd|j|jffSr)r8r9rr5r3r%s rr&zParseResults.__getstate__s4 M ""$$    rcn|\|_\|_}}|_t||_d|_dSr)r8r9r3rHr5r4)rstater inAccumNamess rr*zParseResults.__setstate__s5HME E sL$*l++ rc|j|jfSr)r8r3r%s r__getnewargs__zParseResults.__getnewargs__s}dj((rc~tt|t|zSr)dirr@r>rr%s r__dir__zParseResults.__dir__ s)4::diikk!2!222rc  d}|g}|D]P\}}t|tr||||z }5|||g|||z }Q|||g|}|S)z Helper classmethod to construct a ``ParseResults`` from a ``dict``, preserving the name-value relations as results names. If an optional ``name`` argument is given, a nested ``ParseResults`` will be returned. cp t|t|t S#t$rYdSwxYw)NF)ryr=r Exception)rs r is_iterablez+ParseResults.from_dict..is_iterablesK 5S &c84444    uu s ' 55)rL)rLrT)rr=r from_dict)rBrrLrrr_rZs rrzParseResults.from_dict s 5 5 5c"ggKKMM ? ?DAq!W%% ?s}}QQ}///ssA3Q{{1~~>>>>  #se$'''C r)NN)rNrO)rNr6)rNr)rNrr)rrrNr)rNr)rNr2)rQ)rr6rNr>)rNrJ)rNr)rQTTr)5r+r,r-rDr1r.r/r>rErAr=rr#rarorrrtrvrzr~rrgrrrr^rrrrrrrrrrrrrrrrrrr&r*rr classmethodrrTasDictgetNamerrrrr's++Z&*2rNL2222JJJLLLI0%0%0%0%0%t0%0%0%d0d$:%"%"%"%"%"N>>>,6    0""""""""8888####))))###...333%%%% 6 6 6 p!!!!.2###"***( ,    MMMM         */      D>>>>:    *....`HHHHHT7778     )))333[4F+ F+G,,rr) __future__rrcollections.abcrrrrrrtypingr utilr r2rr r.r@rIrrregisterrrrrsR""""""" """""""5\))))$2''"E -E -E -E -E -E -E -E -P %%%&&&&&r