i0-SSKrSSKJr SSKJr Sr"SS5r"SS \5r"S S \5r "S S \5r Sr g)N) PreOrderIter) ASSERTIONSc^\rSrSrSr0rSU4SjjrSrSrSr Sr Sr S r \ S 5rS rS r\ S 5rSrU=r$)Resolver z Resolve :any:`NodeMixin` paths using attribute `pathattr`. Keyword Args: name (str): Name of the node attribute to be used for resolving ignorecase (bool): Enable case insensisitve handling. relax (bool): Do not raise an exception. cF>[TU]5 XlX lX0lgN)super__init__pathattr ignorecaserelax)selfrrr __class__s =/app/mltbenv/lib/python3.13/site-packages/anytree/resolver.pyr Resolver.__init__s  $ cURXUR5upUcUR(agUHSnUS:Xa1URnUcUR(a g[ U5eUnM:US;aMBUR X5nMU U$)a' Return instance at `path`. An example module tree: >>> from anytree import Node >>> top = Node("top", parent=None) >>> sub0 = Node("sub0", parent=top) >>> sub0sub0 = Node("sub0sub0", parent=sub0) >>> sub0sub1 = Node("sub0sub1", parent=sub0) >>> sub1 = Node("sub1", parent=top) A resolver using the `name` attribute: >>> resolver = Resolver('name') >>> relaxedresolver = Resolver('name', relax=True) # never generate exceptions Relative paths: >>> resolver.get(top, "sub0/sub0sub0") Node('/top/sub0/sub0sub0') >>> resolver.get(sub1, "..") Node('/top') >>> resolver.get(sub1, "../sub0/sub0sub1") Node('/top/sub0/sub0sub1') >>> resolver.get(sub1, ".") Node('/top/sub1') >>> resolver.get(sub1, "") Node('/top/sub1') >>> resolver.get(top, "sub2") Traceback (most recent call last): ... anytree.resolver.ChildResolverError: Node('/top') has no child sub2. Children are: 'sub0', 'sub1'. >>> print(relaxedresolver.get(top, "sub2")) None Absolute paths: >>> resolver.get(sub0sub0, "/top") Node('/top') >>> resolver.get(sub0sub0, "/top/sub0") Node('/top/sub0') >>> resolver.get(sub0sub0, "/") Traceback (most recent call last): ... anytree.resolver.ResolverError: root node missing. root is '/top'. >>> print(relaxedresolver.get(sub0sub0, "/")) None >>> resolver.get(sub0sub0, "/bar") Traceback (most recent call last): ... anytree.resolver.ResolverError: unknown root node '/bar'. root is '/top'. >>> print(relaxedresolver.get(sub0sub0, "/bar")) None Going above the root node raises a :any:`RootResolverError`: >>> resolver.get(top, "..") Traceback (most recent call last): ... anytree.resolver.RootResolverError: Cannot go above root node Node('/top') .. note:: Please not that :any:`get()` returned `None` in exactly that case above, which was a bug until version 1.8.1. Case insensitive matching: >>> resolver.get(top, '/TOP') Traceback (most recent call last): ... anytree.resolver.ResolverError: unknown root node '/TOP'. root is '/top'. >>> ignorecaseresolver = Resolver('name', ignorecase=True) >>> ignorecaseresolver.get(top, '/TOp') Node('/top') N...)_Resolver__start_Resolver__cmprparentRootResolverError_Resolver__get)rnodepathpartspartrs rget Resolver.getsZll4tzz:  zz#+D11"zz$- rc[U5nURH1nUR[X@R5U5(dM/Us $ UR (ag[ XUR5er )strchildrenr_getattrrrChildResolverError)rr namenamestrchilds r__getResolver.__getzsUd)]]Ezz(5--8'BB # :: T]];;rcURXUR5upUcUR(a/$URX5$)a Return instances at `path` supporting wildcards. Behaves identical to :any:`get`, but accepts wildcards and returns a list of found nodes. * `*` matches any characters, except '/'. * `?` matches a single character, except '/'. An example module tree: >>> from anytree import Node >>> top = Node("top", parent=None) >>> sub0 = Node("sub0", parent=top) >>> sub0sub0 = Node("sub0", parent=sub0) >>> sub0sub1 = Node("sub1", parent=sub0) >>> sub1 = Node("sub1", parent=top) >>> sub1sub0 = Node("sub0", parent=sub1) A resolver using the `name` attribute: >>> resolver = Resolver('name') >>> relaxedresolver = Resolver('name', relax=True) # never generate exceptions Relative paths: >>> resolver.glob(top, "sub0/sub?") [Node('/top/sub0/sub0'), Node('/top/sub0/sub1')] >>> resolver.glob(sub1, ".././*") [Node('/top/sub0'), Node('/top/sub1')] >>> resolver.glob(top, "*/*") [Node('/top/sub0/sub0'), Node('/top/sub0/sub1'), Node('/top/sub1/sub0')] >>> resolver.glob(top, "*/sub0") [Node('/top/sub0/sub0'), Node('/top/sub1/sub0')] >>> resolver.glob(top, "sub1/sub1") Traceback (most recent call last): ... anytree.resolver.ChildResolverError: Node('/top/sub1') has no child sub1. Children are: 'sub0'. >>> relaxedresolver.glob(top, "sub1/sub1") [] Non-matching wildcards are no error: >>> resolver.glob(top, "bar*") [] >>> resolver.glob(top, "sub2") Traceback (most recent call last): ... anytree.resolver.ChildResolverError: Node('/top') has no child sub2. Children are: 'sub0', 'sub1'. >>> relaxedresolver.glob(top, "sub2") [] Absolute paths: >>> resolver.glob(sub0sub0, "/top/*") [Node('/top/sub0'), Node('/top/sub1')] >>> resolver.glob(sub0sub0, "/") Traceback (most recent call last): ... anytree.resolver.ResolverError: root node missing. root is '/top'. >>> relaxedresolver.glob(sub0sub0, "/") [] >>> resolver.glob(sub0sub0, "/bar") Traceback (most recent call last): ... anytree.resolver.ResolverError: unknown root node '/bar'. root is '/top'. Going above the root node raises a :any:`RootResolverError`: >>> resolver.glob(top, "..") Traceback (most recent call last): ... anytree.resolver.RootResolverError: Cannot go above root node Node('/top') >>> relaxedresolver.glob(top, "..") [] )r_Resolver__matchr_Resolver__glob)rr r!r"s rglob Resolver.globs:Zll4t||<  URnUcUR(a/$[U5eUR XT5$US;aUR X5$US:XaG/n[ U5H4nUR Xt5HnX;dM UR U5 M M6 U$URXU5nU(dA[RU5(d'UR(d[XUR5eU$![a Mf=f)Nrrrrz**) rrrrr2rappendr*_Resolver__findr is_wildcardr) rr r"r+ remainderrmatchessubnodematchs r__globResolver.__globs' :# ##6MQx!"I  4<[[F~::I'--;;v1 1 9 ;;t/ / 4<G'-!%W!@ /#NN51"A.N++d)4x33D99$**$T? ?*sD)2D)) D76D7cN/nURH^n[XPR5nURXb5(a/U(aX@R XS5- nMKUR U5 M^M` U$![ a'n[RU5(dUeSnAMSnAff=fr ) r(r)rr1r2rCr;rrE)rr patrFrGr-r+excs r__findResolver.__finds]]EE==1D <<** ;;u#@@u- +#! ++C00I1 s0A3A33 B$=BB$c$SU;=(d SU;$)zReturn `True` is a wildcard.?*)r!s rrEResolver.is_wildcard sd{)cTk)rcX R4n[RUnURU5SL$![a [R U5n[ [R5[ :a[RR5 SnUR(aU[R-n[R"XVS9=[RU'nNf=f)Nr)flags) rr _match_cacheKeyError_Resolver__translatelen _MAXCACHEclearre IGNORECASEcompilerI)rr+rMkre_patresrWs r__matchResolver.__match%s // " M**1-F||D!-- M&&s+C8(()Y6%%++-E&02 30L LH ! !! $v Ms5B+C#"C#cnUR(a!UR5UR5:H$X:H$r )rupper)rr+rMs r__cmpResolver.__cmp3s( ??::<399;. .{rcSnUH6nUS:XaUS- nMUS:XaUS- nMU[R"U5- nM8 SU-S-$)NrrSz.*rRrz(?ms)z\Z)r^escape)rMrbchars r __translateResolver.__translate8sUDs{$# "))D/) & 5((r)rrr)r+FF)__name__ __module__ __qualname____firstlineno____doc__rXr r$rr3rr2rD staticmethodrEr1rrZ__static_attributes__ __classcell__rs@rrr siL \|<P(d*%N ** .  ) )rrc(^\rSrSrU4SjrSrU=r$)r;iEc<>[TU]U5 XlX lg)z)Resolve Error at `node` handling `child`.N)r r r r-)rr r-r?rs rr ResolverError.__init__Fs   r)r-r rorprqrrr rurvrws@rr;r;Es rr;c(^\rSrSrU4SjrSrU=r$)riMc4>SU<3n[TU]USU5 g)z.Root Resolve Error, cannot go above root node.zCannot go above root node N)r r )rr9r?rs rr RootResolverError.__init__Ns *4(3 tS)rrTr{rws@rrrMs **rrc(^\rSrSrU4SjrSrU=r$)r*iTc >URVs/sHn[[XC55PM nnSRXSR U55n[ TU]XU5 gs snf)z/Child Resolve Error at `node` handling `child`.z'{!r} has no child {}. Children are: {}.z, N)r(reprr)formatjoinr r )rr r-rcnamesr?rs rr ChildResolverError.__init__UsV6:mmDmhq+,mD7>>tDIIV[L\] c*EsA"rTr{rws@rr*r*Ts ++rr*c,[[XS55$r )r'getattr)r r+s rr)r)\s wt4( ))r) r^anytree.iterators.preorderiterrconfigrr\r RuntimeErrorr;rr*r)rTrrrsI 7  x)x)v L* *++*r