^j0-ddlZddlmZddlmZdZGddZGdd eZGd d eZ Gd d eZ dZ y)N) PreOrderIter) ASSERTIONScxeZdZdZiZd fd ZdZdZdZdZ dZ dZ e d Z d Zd Ze d ZxZS)Resolvera 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. cLt|||_||_||_yN)super__init__pathattr ignorecaserelax)selfr rr __class__s I/opt/ringagent/.cad-venv/lib/python3.12/site-packages/anytree/resolver.pyr zResolver.__init__s#   $ c|j|||j\}}| |jry|D]H}|dk(r*|j}||jryt ||}2|dvr7|j ||}J|S)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 rgetz Resolver.getsZll4tzz: e zz#+D11"zz$- . rct|}|jD],}|jt||j|s*|cS|j ryt |||jr )strchildrenr_getattrr rChildResolverError)rrnamenamestrchilds r__getzResolver.__getzs[d)]] Ezz(5$--8'B   :: tT]];;rc|j|||j\}}||jrgS|j||S)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)rrrr s rglobz Resolver.globs@Zll4t||< e  staticmethodr?r-rrQ __classcell__rs@rrr siL \|<P(d*%N ** .  ) )rrceZdZfdZxZS)r6c@t||||_||_y)z)Resolve Error at `node` handling `child`.N)r r rr*)rrr*r:rs rr zResolverError.__init__Fs   rrcrdrer rhris@rr6r6Es rr6ceZdZfdZxZS)rc2d|}t||d|y)z.Root Resolve Error, cannot go above root node.zCannot go above root node N)r r )rr4r:rs rr zRootResolverError.__init__Ns *4(3 tS)rrlris@rrrMs **rrceZdZfdZxZS)r'c |jDcgc]}tt||}}dj||dj |}t ||||ycc}w)z/Child Resolve Error at `node` handling `child`.z'{!r} has no child {}. Children are: {}.z, N)r%reprr&formatjoinr r )rrr*r cnamesr:rs rr zChildResolverError.__init__Us[6:mmDhq(+,DD7>>tUDIIV[L\] uc*EsA"rlris@rr'r'Ts ++rr'c.tt||dSr )r$getattr)rr(s rr&r&\s wtT4( ))r) rUanytree.iterators.preorderiterrconfigrrSr RuntimeErrorr6rr'r&rLrrr{sI 7  x)x)v L* *++*r