sh*SSKrSSKJr SSKJrJr SSKJrJrJ r J r SSK r SSK J r \"SS55r"SS\ 5r"S S 5r"S S 5rg) N)contextmanager) dataclassfield)AnyCallable NamedTupleOptionalc\rSrSr%Sr\"\RRS9r \RR\ S'Sr \ \ \\4\ S'Srg) TracingConfig au This represents a symbolic tracing configuration. Args: tracer (torch.fx.Tracer): An instance of :class:`torch.fx.Tracer` to use for symbolic tracing. The default value is the native :class:`torch.fx.Tracer` constructed with default arguments. However, the user may want to pass a different value such as the ``HFTracer`` for models in the HuggingFace Transformers_ library. .. _Transformers: https://huggingface.co/docs/transformers/index concrete_args (Optional[Dict[str, Any]]): Concrete arguments that should not be treated as ``torch.fx.Proxy`` when tracing the module ``forward()``. Passing ``concrete_args`` allows partially specializing the forward, e.g. to remove control flow or data structures. This ``concrete_args`` here is the same argument used in :meth:`~torch.fx.Tracer.trace`. )default_factorytracerN concrete_args)__name__ __module__ __qualname____firstlineno____doc__rtorchfxTracerr__annotations__rr dictstrr__static_attributes__rw/Users/tiagomarins/Projetos/claudeai/copy_bank/venv/lib/python3.13/site-packages/torch/distributed/fsdp/_trace_utils.pyr r s?$$EHHOODFEHHOOD.2M8DcN+2rr cf\rSrSr%Sr\R \S'\\ \ \R4\S'Sr g)_ParamUsageInfo#a This is used for ``_ExecutionInfo.module_to_param_usage_infos`` to record execution information. The ``dict`` maps modules to a list of these ``_ParamUsageInfo`` instances, where each instance represents a group of parameters used together. Specifically, for each module key in the ``dict``, each instance of this class represents either: (1) the module and some sublist of its ``named_parameters()`` used together in execution (see ``_patched_create_proxy()``), or (2) a submodule and all of ``submodule.named_parameters()`` (see ``_patched_call_module()``). Type (1) corresponds to directly using parameters in ops without calling ``forward()``, and type (2) corresponds to calling ``forward()``. The mapped-to lists in the ``dict`` follow the execution order. module named_paramsrN) rrrrrnnModulerlisttupler Parameterrrrrr r #s,$ IIuS",,./00rr c>\rSrSrSrS\R SS4SjrSrg)_ExecutionInfo:a This represents the execution order information from the forward pass. Attributes: curr_module (nn.Module): Current module being traced. module_forward_order (List[nn.Module]): The modules in (pre-)forward order, i.e. the order in which their ``forward()`` methods are called. Each call to a module's ``forward()`` corresponds to one element in the list. module_to_param_usage_infos (Dict[nn.Module, List[_ParamUsageInfo]]): Maps a module to a list of module execution infos. See :class:`_ParamUsageInfo` for details. param_forward_order (List[nn.Parameter]): The parameters in forward execution order, where only a parameter's first participation is included. visited_params (Set[nn.Parameter]): The parameters visited so far during the trace. This is only used during tracing for fast membership check. Invariant: The parameters in ``param_forward_order`` are exactly those in ``visited_params``. root_modulereturnNc^XlU/UlU/0Ul/Ul[ 5UlgN) curr_modulemodule_forward_ordermodule_to_param_usage_infosparam_forward_ordersetvisited_params)selfr,s r__init___ExecutionInfo.__init__Ps6&16A]! T (8: 14r)r0r1r2r3r5) rrrrrr$r%r7rrrrr*r*:s*7BII7$7rr*c\rSrSrSSjr\S\RRS\ R4Sj5r S\ S \ S \ RS \ S \\S 4S\\\4S\4SjrSS\ S \ S\\\ R&4S\S\RR(R*S \\S 4S\\\4S\\S\\S\\ \RR./\RR04S\RR04SjjrSrg)_ExecOrderTracerZr-NcSUlgr/ exec_info)r6s rr7_ExecOrderTracer.__init__[s 37rrr,c## [U5UlURnURn[R "UR X0R5Ul[UR55n[R "URUURU5UlSv X1lXAlg!X1lXAlf=f7fr/) r*r> call_module create_proxy functoolspartial_patched_call_modulernamed_parameters_patched_create_proxy)r6rr,orig_call_moduleorig_create_proxy fqn_to_params r patch_tracer_ExecOrderTracer.patch_tracer^s' 4!--"//&..  % %'7 K88:; '//  & &  NN     4 !1 "3 "2 "3 sB$C 'B8+ C 8CC rAr>r"forwardargs.kwargscnURRU5 [UR55nURnU(aGXR ;dS5eUR URR[ X755 Un X2l/UR U'U"X4XV5n XlU $)a Overrides ``call_module`` to save execution information to ``exec_info``. Note that ``call_module`` is called during symbolic tracing for each non-root module. Args: call_module (Callable): Original ``call_module`` to override. exec_info (_ExecutionInfo): Used to record execution information. module (nn.Module): Module corresponding to this ``call_module``. forward (Callable): ``forward()`` method of ``module`` to be called for this ``call_module``. args (Tuple[Any, ...]): Positional arguments for ``forward``. kwargs (Dict[str, Any]): Keyword arguments for ``forward``. Returns: Same return value as ``call_module``. zPThe current module should have already been processed by a patched `call_module`)r1appendr&rFr0r2r ) r6rAr>r"rMrNrOr#r0prev_curr_moduleoutputs rrE%_ExecOrderTracer._patched_call_moduless6 &&--f5F3356 ++ "G"GG b G  1 1)2G2G H O O5 ' &8: --f5Vd; 0 rrBrJkindtargetname type_exprproxy_factory_fnc U"XEXgXU 5n URn US;Ga UGb/n UHn[U[RR5(dM.UR R U;dMJX>R R nU RUR R U45 XR;dMURRU5 URRU5 M U (a'URU R[X55 U $US:Xa[U R55n U (a'URU R[X55 U HMunnXR;dMURRU5 URRU5 MO U $)a Overrides ``create_proxy`` to save execution information to ``exec_info``. Note that ``create_proxy`` is called during symbolic tracing for each leaf function/method/module. Args: create_proxy (Callable): Original ``create_proxy`` to override. exec_info (_ExecutionInfo): Used to record execution information. fqn_to_param (Dict[str, nn.Parameter]): ``dict`` version of the root module's ``named_parameters()`` with FQN as key and parameter as value. kind (str): Kind of the target method ('call_function', 'call_method', 'get_attr', 'call_module', 'placeholder', or 'output'). See :class:`torch.fx.Graph` for details. This is passed to ``create_proxy``. target (torch.fx.node.Target): Contains the string name of the function/method/module. This is passed to ``create_proxy``. args (Tuple[Any, ...]): Positional arguments for the function/ method/module. This is passed to ``create_proxy``. kwargs (Dict[str, Any]): Keyword arguments for the function/method/ module. This is passed to ``create_proxy`` name (Optional[str]): An optional string name for the ``Node`` created in ``create_proxy``. This is passed to ``create_proxy``. type_expr (Optional[Any]): An optional type annotation representing the Python type that the output of the node has. This is passed to ``create_proxy``. proxy_factory_fn (Callable[[torch.fx.Node], torch.fx.Proxy]): An alternative proxy constructor used in ``create_proxy``. This is passed to ``create_proxy``. Returns: torch.fx.Proxy: Created ``Node`` wrapped in a ``Proxy`` object. ) call_function call_methodrA)r0 isinstancerrProxynoderVrQr5addr3r2r r&rF)r6rBr>rJrUrVrNrOrWrXrYproxyr0r#argparam_s rrG&_ExecOrderTracer._patched_create_proxys` $9I  ++ 3 3?A C"377HHOO|; ,XX__ =$++SXX__e,DE (@(@@%4488?%99@@G  99+FMM' B ] " < < >?L55kBII#K>)5 8 88,,0071188?) rr=)r-N)NNN)rrrrr7rrrrr$r%rKrr*r'rrrrEr(r_Targetr Noder^rGrrrrr:r:Zs~84588??444(**"*  *  *CHo*S#X* *l##'PTOO"O3 ,- O  O $$OCHoOS#XOsmOC=O#8UXX]]OUXX^^,K#LMO OOrr:)rC contextlibr dataclassesrrtypingrrrr rtorch.nnr$r r r*r:rrrrlsV%(66  33 3.1j1.77@TTr