+h\ VdZddlZddlmZGddZeZej Zy)zRsupplies the "preloaded" registry to resolve circular module imports at runtime. N)compatc$eZdZdZddZdZdZy)_ModuleRegistryaRegistry of modules to load in a package init file. To avoid potential thread safety issues for imports that are deferred in a function, like https://bugs.python.org/issue38884, these modules are added to the system module cache by importing them after the packages has finished initialization. A global instance is provided under the name :attr:`.preloaded`. Use the function :func:`.preload_module` to register modules to load and :meth:`.import_prefix` to load all the modules that start with the given path. While the modules are loaded in the global module cache, it's advisable to access them using :attr:`.preloaded` to ensure that it was actually registered. Each registered module is added to the instance ``__dict__`` in the form `_`, omitting ``sqlalchemy`` from the package name. Example: ``sqlalchemy.sql.util`` becomes ``preloaded.sql_util``. c0t|_||_yN)setmodule_registryprefix)selfr s M/var/www/html/venv/lib/python3.12/site-packages/sqlalchemy/util/_preloaded.py__init__z_ModuleRegistry.__init__&s"u c>|jj|dS)zAdds the specified modules to the list to load. This method can be used both as a normal function and as a decorator. No change is performed to the decorated object. c|Sr)fns r z0_ModuleRegistry.preload_module..1s"r)r update)r depss r preload_modulez_ModuleRegistry.preload_module*s ##D)rct|jD]}|jr/|j|jdjdd}n|}|r|j |sT||j vsct j|tttj||j |<y)z\Resolve all the modules in the registry that start with the specified path. ._N) r r splitreplace startswith__dict__rimport_globalslocalssysmodules)r pathmodulekeys r import_prefixz_ModuleRegistry.import_prefix3s** 9F{{ll4;;/3;;CEF--d3T]]*vwy&(;%([[%8 c" 9rN)z sqlalchemy.)__name__ __module__ __qualname____doc__rrr(rrr rrs& 9rr)r,r#rr preloadedrrrr r/s2  .9.9b   ))r