3jBtSSKrSSKrSSKJr SSKJr \R "\5rSr Sr "SS5r \ "S5r \ "S 5r "S S \5r"S S \5rSrS\ 4r\"SS9\4Sj5rS"SjrSrSrS"SjrSr\S4SjrS"Sjr\S4Sjr\R8"S5rSr"SS 5rS!r g)#N) literal_eval) lru_cacheGETATTRGETc0\rSrSrSrSrSrSrSrSr g) _WildcardToken zSentinel object for wildcard path tokens. Using a dedicated class (instead of plain strings) ensures that a literal dict key ``'*'`` (parsed from ``root['*']``) is never confused with the wildcard ``*`` (parsed from ``root[*]``). cXlgN_symbol)selfsymbols G/home/wildlama/miniconda3/lib/python3.13/site-packages/deepdiff/path.py__init___WildcardToken.__init__s cUR$r r rs r__repr___WildcardToken.__repr__s ||rcb[U[5=(a URUR:H$r ) isinstancerr )rothers r__eq___WildcardToken.__eq__s!%0RT\\U]]5RRrc0[SUR45$)Nr)hashr rs r__hash___WildcardToken.__hash__s%t||455rr N) __name__ __module__ __qualname____firstlineno____doc__rrrr__static_attributes__rrrr s S6rr***c\rSrSrSrg)PathExtractionError$r'Nr!r"r#r$r&r'rrr+r+$rr+c\rSrSrSrg)RootCanNotBeModified(r'Nr-r'rrr0r0(r.rr0cU(dgURS5(dUS;a6US:Xa[O[nURUS:Xa[O[ U45 gSnSU;dSU;aSnO[ U5nSnU(aUS US :XaUS S ;aUS S nUS:Xa[O[nURX45 gg![[4a SnN[f=f) N__)r(r).r(F𝆺𝅥𝅯\Tr"') startswithrrappendSINGLE_WILDCARDMULTI_WILDCARDr ValueError SyntaxError)elementseleminsideaction remove_quotess r_add_to_elementsrG,s  ??4  ;  &# W3F OO _QWX Y  T>TT\ M %#D) %  T!WR0T!W 5J2;D"cMs'/ !$ , % $  %s- CCCrooti)maxsizec[U[[45(aU$/nU(aURU5 SnSnSnUSSn/nSnSnUGHn US:XaX9- nOU S;a2X9- nU(aX:wd!U(+nU(aU nO[ X#U5 SnSnOU(aX9- nOU S:Xa8US:Xa[ X#U5 SnSnOUS:XaX9- nOSnURS5 SnOrU S:Xa%US:XaX9- nOaUS:Xa[ X#U5 SnOLSnSnOGU S :Xa=U(aUS S:XaUR 5 U(aX9- nO[ X#U5 SnSnOX9- nU nGM U(a [ X#U5 [U5$) a& Given a path, it extracts the elements that form the path and their relevant most likely retrieval action. >>> from deepdiff import _path_to_elements >>> path = "root[4.3].b['a3']" >>> _path_to_elements(path, root_element=None) [(4.3, 'GET'), ('b', 'GETATTR'), ('a3', 'GET')] FNr5r8[r4]r7)rtuplelistr=rGpop) path root_elementrBrCrD prev_charbrackets inside_quotes quote_usedchars r_path_to_elementsrYMs$ && H % D FI 8DHMJ   LD Z  LD Z%7$1 1  !%J$XV<D!#J  LD S[} 83 $ S[} 3 8 S[HRLC/   8 LD ab 0 ?rcUH7up4[U5 U[:XaXnM U[:XdM,[X5nM9 U$r ) check_elemrrgetattr)objrB next_elementrCrEs r_get_nested_objr_s="4 S=)C w #$C # Jrc\U[U5S- :a0$[U[5(a/$0$)Nr;)lenrint)rBrCindexr^s r _guess_typerds/ s8}q   ,$$ Irc[U[5(a9URS5(a"URS5(a [ S5eggg)Nr3z+traversing dunder attributes is not allowed)rstrr<endswithr@)rCs rr[r[sC$!6!64==;N;NFGGU(a7U[ XXb50nU[:XaXU'O[U[U5U5 XnGNf=f)Nr7r) enumerater[rKeyErrorrd IndexErrorrrPrbraextendr=setattrrfrr\) r]rBr^ prev_elem prev_actionprev_objrcrCrE _prev_objs r_get_nested_obj_and_forcerrs^IKH!*8!4~4 S= $i$(w #$C H  ="5> J1 %'L i$ $c4((Zc-B-BtsSVxGWJJvC9:JJ{85OPb'C(HT**s3x1} XU!QRC"c).1+#i.#>)C $sAE':BE'A"E'&E'c,[USS9n[X5$)a Get the item from obj based on path. Example: >>> from deepdiff import extract >>> obj = {1: [{'2': 'b'}, 3], 2: [4, 5]} >>> path = "root[1][0]['2']" >>> extract(obj, path) 'b' Note that you can use extract in conjunction with DeepDiff results or even with the search and :ref:`deepsearch_label` modules. For example: >>> from deepdiff import grep >>> obj = {1: [{'2': 'b'}, 3], 2: [4, 5]} >>> result = obj | grep(5) >>> result {'matched_values': ['root[2][1]']} >>> result['matched_values'][0] 'root[2][1]' >>> path = result['matched_values'][0] >>> extract(obj, path) 5 .. note:: Note that even if DeepDiff tried gives you a path to an item in a set, there is no such thing in Python and hence you will get an error trying to extract that item from a set. If you want to be able to get items from sets, use the SetOrdered module to generate the sets. In fact Deepdiff uses SetOrdered as a dependency. >>> from deepdiff import grep, extract >>> obj = {"a", "b"} >>> obj | grep("b") Set item detected in the path.'set' objects do NOT support indexing. But DeepSearch will still report a path. {'matched_values': SetOrdered(['root[0]'])} >>> extract(obj, 'root[0]') Traceback (most recent call last): File "", line 1, in File "deepdiff/deepdiff/path.py", line 126, in extract return _get_nested_obj(obj, elements) File "deepdiff/deepdiff/path.py", line 84, in _get_nested_obj obj = obj[elem] TypeError: 'set' object is not subscriptable >>> from orderly_set import SetOrdered >>> obj = SetOrdered(["a", "b"]) >>> extract(obj, 'root[0]') 'a' NrS)rYr_)r]rRrBs rextractrusl!D9H 3 ))rFc[XS9n[U5nU(a [U5 USLaUVs/sHoDSPM sn$UVs/sH oDSUSS.PM sn$s snfs snf)aC Parse a path to a format that is machine readable **Parameters** path : A string The path string such as "root[1][2]['age']" root_element: string, default='root' What the root is called in the path. include_actions: boolean, default=False If True, we return the action required to retrieve the item at each element of the path. **Examples** >>> from deepdiff import parse_path >>> parse_path("root[1][2]['age']") [1, 2, 'age'] >>> parse_path("root[1][2]['age']", include_actions=True) [{'element': 1, 'action': 'GET'}, {'element': 2, 'action': 'GET'}, {'element': 'age', 'action': 'GET'}] >>> >>> parse_path("root['joe'].age") ['joe', 'age'] >>> parse_path("root['joe'].age", include_actions=True) [{'element': 'joe', 'action': 'GET'}, {'element': 'age', 'action': 'GETATTR'}] rtFrr;)elementrE)rYiternext)rRrSinclude_actionsresultis r parse_pathr}sh<t ?F &\F V %$%f!f%%7= >v!!! -v >>& >s AA!cDSU;nSU;nU(aZU(aSU(dL/nUH+nUS;aURS5 URU5 M- SSRU5-S-nU$U(aSUS3nU$U(aSUS3nU$UcUOURU5nU$)Nr:r9r8r5rK)r=joinformat)param quote_str has_quotehas_double_quote new_paramrXr{s rstringify_elementr9su Ie|%i Dz!  (   T "rwwy))C/ M UG1 M UG1 M$+1A1A%1H Mrz'{}'cU(dUS$US/nSnUSS[[1;aSnU(d'UVs/sH oU[4PM nnUSSUS4US'UHdupg[ U[ 5(aU[:Xa [Xb5nU[:XaURSUS35 MPURSU35 Mf SRU5$![[[4a Nf=fs snf) zX Gets the path as an string. For example [1, 2, 'age'] should become root[1][2]['age'] rFr;TrMrNr4rK) rrrjrk TypeErrorrrfrr=r)rRrSrr{ has_actionsr|rwrEs rstringify_pathrLs A1o FK 71:#w 'K "&'$QC$'71:|A/Q gs # ## ';G S= MMAgYa. ) MMAgY- (   776? j) ,   (sCC2C/.C/z\[\*\*?\]|\.\*\*?(?=[.\[]|$)c>[[RU55$)z) rrpitirrkeypattern target_len pattern_lenpat_elemkr{s rrGlobPathMatcher._match_segmentss?h ;9 --[ 'l 2?{1~H>)r>2A++FFAEWXX$( #3" _,aabz!}, %DI aa%2?*7;q>^#C !GB7;q>^#C &F&;2+;FS  rcX#4nXT;aXE$URnU[U5:XaU[U5:nXtU'U$U[U5:aSXE'gXbSnU[La3URXS-X45=(d URXUS-U5nOLU[LaURXS-US-U5nO)XUS:waSXE'gURXS-US-U5nXtU'U$)zECheck if *target* is a prefix that could lead to a match deeper down.Frr;)rrar?rr>) rrrrrrrr{rs rr'GlobPathMatcher._could_match_descendantsh ;9 -- V #g,&FIM W DI;q> ~ %22662LP55f"q&$O   (11&q&"q&$OF":a=(! 11&q&"q&$OFS  r)rrN) r!r"r#r$r%rrrrrrr&r'rrrrvs)% P CO+ZrrcTU(dgUVs/sHn[U5PM sn$s snf)zCompile a list of glob pattern strings into GlobPathMatcher objects. Returns a list of ``GlobPathMatcher`` or ``None`` if *paths* is empty/None. N)r)pathsps rcompile_glob_pathsrs' (- .1OA  .. .s%r )!reloggingastr functoolsr getLoggerr!loggerrrrr>r?r@r+r0rGDEFAULT_FIRST_ELEMENTrYr_rdr[rrrur}rrcompilerrrrr'rrrs    8 $  66(!%% *  : (< ) :)>HHVH #L7*t#8$?N&'zz + ood/r