Vh( ddlZddlmZddlmZddlmZmZmZm Z ddl m Z m Z m Z ddlZddlmZddlmZddlmZe dd Ze d Zdd ZeZeZGd dZe ddd Ze dej8eej8ZGdde eeeefZefde edeee eefefgee eefeefffdZ!dej8dee"e#effdZ$y)N) OrderedDict)wraps)CallableGenericOptionalProtocol) Concatenate ParamSpecTypeVar)_State)_get_root_modules_TT) covariant_PcF|dttjS)N_)struuiduuid4)strings V/home/dcms/DCMS/lib/python3.12/site-packages/torch/distributed/_composable/contract.pygenerate_state_keyrsXQs4::<() **c eZdZy) RegistryItemN)__name__ __module__ __qualname__rrrrsrr_TStater )boundr_McleZdZdejdej defdZdejde fdZ y) _ContractFnargskwargsreturncyNr)selfr%r&s r__call__z_ContractFn.__call__'rmodulecyr)r)r*r-s rstatez_ContractFn.state)r,rN) rrrrr%r&rr+nnModuler r/rrrr$r$&s-FbggFFrF6BII6'6rr$ state_clsr'ctdttttftfdt tttftt fffd }|S)a% Decorate a function as a composable distributed API, where the first argument of the function must be an :class:`nn.Module` instance or sequence of :class:`nn.Module` instances. The decorator verifies that the decorated function does not modify fully-qualified names (FQNs) for parameters, buffers, or modules. The decorated function can return different module instances than the input modules; the FQN invariant will be enforced following the input order. When a function ``func`` is decorated by ``@contract()``, a ``.state(module: nn.Module)`` method will be installed to the decorated function. Then you can retrieve and modify the state on a module by calling ``func.state(module)``. Example:: >>> # xdoctest: +SKIP >>> import torch.nn as nn >>> >>> class MyModel(nn.Module): >>> def __init__(self) -> None: >>> super().__init__() >>> self.l1 = nn.Linear(10, 10) >>> self.l2 = nn.Linear(10, 10) >>> >>> def forward(self, x): >>> return self.l2(self.l1(x)) >>> >>> @contract() >>> def my_feature(module: nn.Module) -> nn.Module: >>> my_feature.state(module).some_state = "any value" >>> return module >>> >>> model = MyModel() >>> my_feature(model.l1) >>> assert my_feature.state(model.l1).some_state == "any value" >>> my_feature(model.l2) >>> model(torch.randn(2, 10)).sum().backward() funcr'c tdtdtjdtjdtffd }dt j dtffd }||_|S)Nr-r%r&r'c|}t|tjr|g}ntt |}}t }g}g}g} |D]f}t } t } |jjt| } t| tstd| |jjt| } t| tstd| | vsj| vrtdjd|| j|| jj||jt |j|jt |j!| jt |j#i|g|i|}||}t|tjr|g}ntt |}g}g}g}|D]z}|jt |j|jt |j!|jt |j#|t%| }t%|}||k7rtjd|d|ddtt&d tt&d t&fd }t)||D]=\}}|t |j+t |j+d ?t)||D]=\}}|t |j+t |j+d ?t)| |D]=\}}|t |j+t |j+d?|S)Nz-Distributed composable API states corrupted: z/Distributed composable API registry corrupted: zOEach distinct composable distributed API can only be applied to a module once. z3 has already been applied to the following module: zB should return the same number of modules as input modulesInputs: z modules Outputs: z modules orig_fqnsnew_fqns check_keyc||k(ryt|t|}}||z }||z }t|s t|rt|d|d|t|d|d|)NzVComposable distributed API implementations cannot modify FQNs. FQNs only in original: z FQNs only in new: z[Composable distributed API implementations cannot modify the order of FQNs. Original FQNs: z New FQNs: )setlen RuntimeError)r7r8r9 orig_fqn_set new_fqn_set orig_onlynew_onlys r check_fqnz;contract..inner..wrapper..check_fqns(,/ NCMk (;6 &5y>S]&$+22;=--5J8'$+**35%%-J 0rzChecking parameters: zChecking buffers: zChecking modules: ) isinstancer0r1r listrr__dict__ setdefault STATE_KEYdictAssertionError REGISTRY_KEYrappendnamed_parameters named_buffers named_modulesr<rzipkeys)r-r%r& inp_modulemodulesr/ registry_itemall_orig_named_paramsall_orig_named_buffersall_orig_named_modulesdefault_all_statedefault_registry all_stateregistryupdatedupdated_modulesall_new_named_paramsall_new_named_buffersall_new_named_modulesnum_orig_modulesnum_new_modulesrBorig_named_paramsnew_named_paramsorig_named_buffersnew_named_buffersorig_named_modulesnew_named_modulesr4r2s rwrapperz(contract..inner..wrapper_s  J&")),!( ,DL9KE(NM DF !DF "AC "! S.inner..get_states+??--c$i r) rr"rr%r&r0r1r r/)r4rhrkr2s` rinnerzcontract..inner[ss tC C 77C iiC  C  C J bii F  " r)rrr r"rr$r )r2rls` rcontractrm,sa^ 9Q{2r6*B./Q [R("g5 6QQf Lrr-c$t|tdS)z Get an ``OrderedDict`` of composable APIs that have been applied to the ``module``, indexed by the API name. If no API has been applied, then this returns ``None``. N)getattrrJ)r-s r _get_registryrps 6< ..r)__composable_api_state_key)%r collectionsr functoolsrtypingrrrrtyping_extensionsr r r torchtorch.nnr0#torch.distributed._composable_stater torch.distributed.utilsr rrrrGrJrr r1rDr"r$typermrHrrprrrr{s$ #88== 65 TT"t_+  !#    )8t < T299d299o.7(GBGO47 &CG}C  k"b&!2%&' BF#R013CL/"))/c<6G1H(I/r