o i. @sUdZddlZddlmZddlmZmZmZmZm Z m Z gdZ ee Z eeeeeffed<ee Zeeeeeffed<e dd d Zd ed efd dZd e deeefd e deeeffddZGdd d Z   d(deded eede eeedfdef ddZ d)ded eded efddZded eefddZded eefddZ d*d edede eeedffdd Zd!ed"ed efd#d$Zded%efd&d'ZdS)+zn Universal registry to support registration and loading of child classes and plugins of neuralmagic utilities N) defaultdict)AnyDictListOptionalTypeVarUnion) RegistryMixinregisterget_from_registryregistered_namesregistered_aliasesstandardize_lookup_name_ALIAS_REGISTRY _REGISTRYr )boundnamereturncCs|ddddS)aD Standardize the given name for lookup in the registry. This will replace all underscores and spaces with hyphens and convert the name to lowercase. example: ``` standardize_lookup_name("Foo_bar baz") == "foo-bar-baz" ``` :param name: name to standardize :return: standardized name _- )replacelowerrrX/home/ubuntu/.local/lib/python3.10/site-packages/compressed_tensors/registry/registry.pyr(srcCs,|durdSt|trt|Sdd|DS)NcSsg|]}t|qSr)r).0nrrr Asz*standardize_alias_name..) isinstancestrrrrrrstandardize_alias_name9s  r"c @seZdZUdZdZeed<e ddee de e e e dffddZ e dd e de de e e e dffd d Zed eede d efddZed eede d efddZed e e fddZed e e fddZdS)r a Universal registry to support registration and loading of child classes and plugins of neuralmagic utilities. Classes that require a registry or plugins may add the `RegistryMixin` and use `register` and `load` as the main entrypoints for adding new implementations and loading requested values from its registry. If a class should only have its child classes in its registry, the class should set the static attribute `registry_requires_subclass` to True example ```python class Dataset(RegistryMixin): pass # register with default name @Dataset.register() class ImageNetDataset(Dataset): pass # load as "ImageNetDataset" imagenet = Dataset.load("ImageNetDataset") # register with custom name @Dataset.register(name="cifar-dataset") class Cifar(Dataset): pass Note: the name will be standardized for lookup in the registry. For example, if a class is registered as "cifar_dataset" or "cifar dataset", it will be stored as "cifar-dataset". The user will be able to load the class with any of the three name variants. # register with multiple aliases @Dataset.register(alias=["cifar-10-dataset", "cifar_100_dataset"]) class Cifar(Dataset): pass # load as "cifar-dataset" cifar = Dataset.load_from_registry("cifar-dataset") # load from custom file that implements a dataset mnist = Dataset.load_from_registry("/path/to/mnnist_dataset.py:MnistDataset") ``` Fregistry_requires_subclassNraliascsdtffdd }|S)a Decorator for registering a value (ie class or function) wrapped by this decorator to the base class (class that .register is called from) :param name: name or list of names to register the wrapped value as, defaults to value.__name__ :param alias: alias or list of aliases to register the wrapped value as, defaults to None :return: register decorator valuecsj|d|S)N)rr$)register_value)r%r$clsrrr decoratorsz)RegistryMixin.register..decorator)r)r(rr$r)rr'rr yszRegistryMixin.registerr%cCst|||||jddS)aR Registers the given value to the class `.register_value` is called from :param value: value to register :param name: name to register the wrapped value as, defaults to value.__name__ :param alias: alias or list of aliases to register the wrapped value as, defaults to None ) parent_classr%rr$require_subclassN)r r#)r(r%rr$rrrr&s  zRegistryMixin.register_valuer(rcKs|j|d}|di|S)an :param name: name of registered class to load :param constructor_kwargs: arguments to pass to the constructor retrieved from the registry :return: loaded object registered to this class under the given name, constructed with the given kwargs. Raises error if the name is not found in the registry rNr)get_value_from_registry)r(rconstructor_kwargs constructorrrrload_from_registrys z RegistryMixin.load_from_registrycCst|||jdS)z :param name: name to retrieve from the registry :return: value from retrieved the registry for the given name, raises error if not found )r*rr+)r r#)r(rrrrr,s z%RegistryMixin.get_value_from_registrycCt|S)zE :return: list of all names registered to this class )r r(rrrr zRegistryMixin.registered_namescCr0)zG :return: list of all aliases registered to this class )r r1rrrr r2z RegistryMixin.registered_aliases)NNN)__name__ __module__ __qualname____doc__r#bool__annotations__ classmethodrr!rrr rr&typeTr/r,r r rrrrr Ds6  2    Fr*r%r$r+c Cs|dur|j}t|}t|}t|||d|rt|||t|vr?t||}||ur=td|d|d|d|dS|t||<dS)a :param parent_class: class to register the name under :param value: the value to register :param name: name to register the wrapped value as, defaults to value.__name__ :param alias: alias or list of aliases to register the wrapped value as, defaults to None :param require_subclass: require that value is a subclass of the class this method is called from N)rr$r*zAttempting to register name  as however has already been registered as )r4rr"register_alias_validate_subclassr RuntimeError)r*r%rr$r+registered_valuerrrr s&   r cCst|}d|vr|d\}}t||}n-t|||}t||}|durBtd|d|d|dt|d|dt| |rIt |||S)aZ :param parent_class: class that the name is registered under :param name: name to retrieve from the registry of the class :param require_subclass: require that value is a subclass of the class this method is called from :return: value from retrieved the registry for the given name, raises error if not found :NzUnable to find z registered under type z. Registered values for z: z Registered aliases for ) rsplit!_import_and_get_value_from_modulergetrKeyErrorr r rA)r*rr+ module_path value_nameretrieved_valuerrrr s*   r cCstt|S)zt :param parent_class: class to look up the registry of :return: all names registered to the given class )listrkeys)r*rrrr sr cCs,tt|}tt|tt|}|S)zv :param parent_class: class to look up the registry of :return: all aliases registered to the given class )rLrrMsetr )r*registered_aliases_plus_namesr rrrr s r c Cs|durt|tr |n|g}ng}||vr td|d|d|||D] }|t|vrAtd|d|d|dt||t||<q'dS)aX Updates the mapping from the alias(es) to the given name. If the alias is None, the name is used as the alias. ``` :param name: name that the alias refers to :param parent_class: class that the name is registered under :param alias: single alias or list of aliases that refer to the name, defaults to None NzAttempting to register alias z., that is identical to the standardized name: .r=r>r?)r rLrHappendr)rr*r$ alias_namerrrr@,s*   r@rIrJcCsTtjd||}tj|}|j|t||d}|s(td|d||S)Nplugin_module_for_zUnable to find attribute z in module ) importlibutilspec_from_file_locationmodule_from_specloader exec_modulegetattrrB)rIrJspecmoduler%rrrrFOs    rF child_classcCs$t||std|d|ddS)Nzclass z6 is not a subclass of the class it is registered for: rP) issubclass ValueError)r*r]rrrrAds rA)NNF)Fr3)r7rT collectionsrtypingrrrrrr__all__dictrr;r!r9rr<rr"r r8r r r r r@rFrArrrrsh        ) %  #