a a@sdZddlZddlZddlmZmZmZddlZddlZe e Z ddZ GdddZ e dd Ze d d Ze d d Ze ddZdS)zFSpyder global registries for actions, toolbuttons, toolbars and menus.N)AnyOptionalDictcCsVg}tD]:}|jr"|jd}nd}||vr ||jd|jq d|}|S)zr Get file and line where the methods that create actions, toolbuttons, toolbars and menus are called. r:, )inspectstack code_contextappendfilenamelinenojoin)funcframesframer r6lib/python3.9/site-packages/spyder/utils/registries.py get_callers   rc@seZdZdZdeedddZdeeeeeeeedd d Z deeeeeed d d Z deeeee eefdddZ ddZ edddZdS)SpyderRegistryz>General registry for global references (per plugin) in Spyder.r) creation_funcobj_typecCsi|_||_||_dSN) registry_maprr)selfrrrrr__init__(szSpyderRegistry.__init__NF)objid_plugincontext overwritec Cs|dur |nd}|dur|nd}|j|i}||t}||vrzJt|j}|std||d|d|d|d|d |d |Wntt fyYn0t d |d |d |d||||<|||<||j|<dS)a Register a reference `obj` for a given plugin name on a given context. Parameters ---------- obj: Any Object to register as a reference. id_: str String identifier used to store the object reference. plugin: Optional[str] Plugin name used to store the reference. Should belong to :class:`spyder.api.plugins.Plugins`. If None, then the object will be stored under the global `main` key. context: Optional[str] Additional key used to store and identify the object reference. In any Spyder plugin implementation, this context may refer to an identifier of a widget. This context enables plugins to define multiple actions with the same key that live on different widgets. If None, this context will default to the special `__global` identifier. Nmain__globalz!There already exists a reference z with id z under the context z of plugin z. The new reference z. will overwrite the previous reference. Hint: z" should have a different id_. See z Registering z (z) under context z for plugin ) rgetweakrefWeakValueDictionaryrrwarningswarn RuntimeErrorKeyErrorloggerdebug) rrrrrr plugin_contextscontext_referencesrrrrregister_reference-sF z!SpyderRegistry.register_reference)rrrreturncCs:|dur |nd}|dur|nd}|j|}||}||S)a Retrieve a stored object reference under a given id of a specific context of a given plugin name. Parameters ---------- id_: str String identifier used to retrieve the object. plugin: Optional[str] Plugin name used to store the reference. Should belong to :class:`spyder.api.plugins.Plugins`. If None, then the object will be retrieved from the global `main` key. context: Optional[str] Additional key that was used to store the object reference. In any Spyder plugin implementation, this context may refer to an identifier of a widget. This context enables plugins to define multiple actions with the same key that live on different widgets. If None, this context will default to the special `__global` identifier. Returns ------- obj: Any The object that was stored under the given identifier. Raises ------ KeyError If neither of `id_`, `plugin` or `context` were found in the registry. Nr!r"r)rrrrr,r-rrr get_referencecs " zSpyderRegistry.get_reference)rrr/cCsB|dur |nd}|dur|nd}|j|i}||t}|S)a Retrieve all stored object references under the context of a given plugin name. Parameters ---------- plugin: Optional[str] Plugin name used to store the reference. Should belong to :class:`spyder.api.plugins.Plugins`. If None, then the object will be retrieved from the global `main` key. context: Optional[str] Additional key that was used to store the object reference. In any Spyder plugin implementation, this context may refer to an identifier of a widget. This context enables plugins to define multiple actions with the same key that live on different widgets. If None, this context will default to the special `__global` identifier. Returns ------- objs: Dict[str, Any] A dict that contains the actions mapped by their corresponding identifiers. Nr!r")rr#r$r%)rrrr,r-rrrget_referencesszSpyderRegistry.get_referencescCs i|_dSrr0rrrrreset_registryszSpyderRegistry.reset_registry)r/cCsd|jd|jdS)NzSpyderRegistry[r])rrr3rrr__str__szSpyderRegistry.__str__)r)NNF)NN)NN)__name__ __module__ __qualname____doc__strrrrboolr.r1rr2r4r6rrrrr%s. 7 ) "rZ create_actionZ SpyderActionZcreate_toolbuttonZ QToolButtonZcreate_toolbarZQToolBarZ create_menuZ SpyderMenu)r:rZloggingtypingrrrr&r$Z getLoggerr7r*rrZACTION_REGISTRYZTOOLBUTTON_REGISTRYZTOOLBAR_REGISTRYZ MENU_REGISTRYrrrrs