0Vh9dZddlmZddlZddlZddlZddl m Z ddl m ZddlmZddlmZddlmZddlmZddlmZdd lmZ dd lmZdd lmZdd lmZ dd lm!Z"ddlm#Z$ddlm%Z&ddlm'Z(ddlm)Z*ddlm+Z,ddlm-Z.ddlm/Z0ddlm1Z2ddlm3Z4ddlm5Z6ddlm7Z8ddlm9Z:ddlm;Z<ddlm=Z>ddlm?Z@ddlmAZBddlmCZDddlmEZFdd lmGZHdd!lmIZJdd"lmKZLdd#lmMZNdd$lmOZPdd%lmQZRdd&lmSZTdd'lmUZVdd(lmWZXdd)lmYZZdd*l[m\Z\dd+l[m]Z^dd,l[m_Z`dd-l[maZbdd.lcmdZdmeZedd/lfmgZggd0Zher&dd1limjZjmkZkdd2lmlZlmmZmdd3lnmoZoeod4Zpemd5ZqGd6d7eZrerGd8d9erZsdd:d=d;Ztydd:d>d<Zty)?aUtilities for working with ``PyTree``\s. The :mod:`optree.pytree` namespace contains aliases of ``optree.tree_*`` utilities. >>> import optree.pytree as pytree >>> tree = {'b': (2, [3, 4]), 'a': 1, 'c': None, 'd': 5} >>> leaves, treespec = pytree.flatten(tree) >>> leaves, treespec # doctest: +IGNORE_WHITESPACE ( [1, 2, 3, 4, 5], PyTreeSpec({'a': *, 'b': (*, [*, *]), 'c': None, 'd': *}) ) >>> tree == pytree.unflatten(treespec, leaves) True .. versionadded:: 0.14.1 ) annotationsN)all) ModuleType) TYPE_CHECKING) PyTreeEntry)tree_accessors)tree_all)tree_any)tree_broadcast_common)tree_broadcast_map) tree_broadcast_map_with_accessor)tree_broadcast_map_with_path)tree_broadcast_prefix) tree_flatten)tree_flatten_one_level)tree_flatten_with_accessor)tree_flatten_with_path) tree_is_leaf) tree_iter) tree_leaves)tree_map) tree_map_)tree_map_with_accessor)tree_map_with_accessor_)tree_map_with_path)tree_map_with_path_)tree_max)tree_min)tree_partition) tree_paths) tree_reduce)tree_replace_nones)tree_structure)tree_sum)tree_transpose)tree_transpose_map) tree_transpose_map_with_accessor)tree_transpose_map_with_path)tree_unflatten)dict_insertion_ordered)register_pytree_node)register_pytree_node_class)unregister_pytree_node) PyTreeKind PyTreeSpec) __version__)*reexportr/r.rflattenflatten_with_pathflatten_with_accessor unflatteniterleaves structurepaths accessorsis_leafmapmap_ map_with_pathmap_with_path_map_with_accessormap_with_accessor_ replace_nones partition transpose transpose_maptranspose_map_with_pathtranspose_map_with_accessorbroadcast_prefixbroadcast_common broadcast_mapbroadcast_map_with_pathbroadcast_map_with_accessorreducesummaxminranyflatten_one_level register_noderegister_node_classunregister_noder*)CallableIterable)AnyTypeVar) ParamSpec_P_TceZdZUdZded<ddddd d fdZed dZd dZd d Z dd Z xZ S)ReexportedModulez2A module that re-exports APIs from another module.str__doc__N)doc__all____dir__ extra_memberscB|xsd|jd|d|d}t | ||||jDchc] }|dk7s | }}t |}|5|j Dchc]}|j dr|dk7s|}}t |j|}|r6|jD]\} } t|| | |j|||_ ||_ ||_ t||_t||_ycc}wcc}w)NzRe-exports :mod:`z ` as :mod:`z` with namespace :const:`z`.r1_)__name__super__init__rbsetrc startswith intersectionitemssetattrupdate_ReexportedModule__namespace_ReexportedModule__original_ReexportedModule__all_setsorted_ReexportedModule__all_ReexportedModule__dir) selfname namespaceoriginalrarbrcrdnkeyvalue __class__s =/home/dcms/DCMS/lib/python3.12/site-packages/optree/pytree.pyrizReexportedModule.__init__s.  1 12+dVD&&/]" 6  s# ?"*"2"2FQa:oqFGFg, ?"*"2"2"4bQALL> !4??D1D""4(((. D$ %Kwt}}&77I$RSSrctj}d|jvrtjd fd }ntj|j d d fd}j r/j jdd|j d|_|j|jjDcgc]/}|jdk7r|n|j|j 1c} |_ ttd d r |jj|_|Scc}w)z0Re-export a function with the default namespace.rxc|i|SN)argskwargsfuncs r~wrappedz.ReexportedModule.__reexport__..wrappedsT,V,,r)rxc|d|i|S)Nrxr)rxrrrs r~rz.ReexportedModule.__reexport__..wrappeds TAYA&AArz2(default: :const:`''`, i.e., the global namespace)z(default: :const:`z`))default) parametersgetN)r_P.argsr _P.kwargsreturnr\)rrrxr_rrrr\)r signaturer _functoolswrapsrpr`replacevaluesrw __signature__callablerrr)rvrsigrps ` r~rzReexportedModule.__reexport__sV  & cnn ,   d # -$ -  d #"&!1!1 B B B$ B  B$ B||"&,,"6"6H()9)9(r?r@rArBrCrDrErFrGrHrIrJrKrLrMrNrOrPrrQrRrSrTrUr*rrr~rrs  '1 $1'1 $1)4 &4w'():; ,-B C + D!f% + U# + w'3D!$]3 %n5():;)*<=$]3  +  + $]3 "./F"G&23N&O#'(89'(89$]3 "./F"G&23N&O#f%33333():;$]3 *+>?&7!-.D!Err)modulectd)zFRe-export a pytree utility module with the given namespace as default.z1reexport() is not available in type checking mode)NotImplementedError)rxrs r~r1r1s!"UVVrc >ddlm}||urd}nt|tst d|d| t j dxsd}|d }|r!td |jdDstd |||d |d fD]#}|t jvstd|dt|d |t }t|d |t"}t||t jt$t&||d}|t j|<|t j|d <|t j|d <|S#t$rL t jdjjdd}n#ttf$rd}YnwxYwYRwxYw)aRe-export a pytree utility module with the given namespace as default. >>> import optree >>> pytree = optree.pytree.reexport(namespace='my-pkg', module='my_pkg.pytree') >>> pytree.flatten({'a': 1, 'b': 2}) ([1, 2], PyTreeSpec({'a': *, 'b': *})) This function is useful for downstream libraries that want to re-export the pytree utilities with their own namespace:: # foo/__init__.py import optree pytree = optree.pytree.reexport(namespace='foo') # foo/bar.py from foo import pytree @pytree.dataclasses.dataclass class Bar: a: int b: float print(pytree.flatten({'a': 1, 'b': 2, 'c': Bar(3, 4.0)})) # Output: # ([1, 2, 3, 4.0], PyTreeSpec({'a': *, 'b': *, 'c': CustomTreeNode(Bar[()], [*, *])}, namespace='foo')) Args: namespace (str): The namespace to re-export from. module (str, optional): The name of the module to re-export. If not provided, defaults to ``.pytree``. The caller module is determined by inspecting the stack frame. Returns: The re-exported module. r)__GLOBAL_NAMESPACEz$The namespace must be a string, got .__main__rgz.pytreec3<K|]}|jywr) isidentifier).0parts r~ zreexport..[s!T$$"3"3"5!Tszinvalid module name: z .dataclassesz .functoolsrz already exists)rxry)r0rr)rxryrd)optree.registryr isinstancer_ TypeError_sys_getframemodulenamer _getframe f_globalsr ValueError_allsplitmodulesr^rrrgr0)rxrGLOBAL_NAMESPACE caller_module module_namereexported_dataclassesreexported_functoolsmods r~r1r1$sJ K ( (IIs+B9-qQR R > / $ 8 8 ; Iz &g.FT!T&,,sBS!TT4VJ?@ @"vhl$;xz=RS KKdll* 7;/!IJJ K"2hl # "  0hj !  '7 \\(+*51 '  # V0F x|,-.B xz*+ K" //$(NN1$5$?$?$C$CJPZ$[M& 3/$.M/  /s5E F/FFFFFFF)rxr_rrrr)rxr_rrrr)ur` __future__rrrinspectrsysrbuiltinsrrtypesrrtypingr_TYPE_CHECKINGoptree.dataclassesroptree.functoolsoptree.accessorsr optree.opsrr:r r rQr rIr rJr rLrrKrrHrr2rrRrr4rr3rr;rr6rr7rr<rr=rr@rrArr>rr?rrOrrPrrCr r9r!rMr"rBr#r8r$rNr%rDr&rEr'rGr(rFr)r5rr*r+rSr,rTr-rU optree.typingr.r/optree.versionr0rbcollections.abcrVrWrXrYtyping_extensionsrZr[r\r^rr1rrr~rs$# +2($(2&&@:VN@.BJB.(,&(BD:<&&2*,:2&2:VN22AME05+ \2#+ 4B B\{\~-F!1-F^:>W :>Ur