G@ddZddlZddlZddlmZmZmZddlZddlZej e Z dZ GddZ e ddZe d d Ze d d Ze d dZdS)zFSpyder global registries for actions, toolbuttons, toolbars and menus.N)AnyOptionalDictcg}tjD]A}|jr|jd}nd}||vr$||jd|jBd|}|S)zr Get file and line where the methods that create actions, toolbuttons, toolbars and menus are called. r:, )inspectstack code_contextappendfilenamelinenojoin)funcframesframer s 7lib/python3.11/site-packages/spyder/utils/registries.py get_callerrs F>>    -a0LLL <   MMU^<General registry for global references (per plugin) in Spyder.r creation_funcobj_typec0i|_||_||_dSN) registry_maprr)selfrrs r__init__zSpyderRegistry.__init__(s  *rNFobjid_plugincontext overwritec||nd}||nd}|j|i}||tj}||vr^ t |j}|s/t jd||d|d|d|d|d |d |n#ttf$rYnwxYwt 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) rr r!r"r#r$plugin_contextscontext_referencesrs rregister_referencez!SpyderRegistry.register_reference-s2"-6$0''j+//;;,00 W02244 $ $ $ #D$677 FME%7%<EE#&EE;BEE&,EEBEEEDG EE =C EEFFF!(+      (C((3((((%(( ) ) )"%3#5 $3&!!!sABB.-B.returncT||nd}||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)rr!r"r#r1r2s r get_referencezSpyderRegistry.get_referencecsDD"-6$0''j+F3,W5!#&&rc||nd}||nd}|j|i}||tj}|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*)rr"r#r1r2s rget_referenceszSpyderRegistry.get_referencessb4"-6$0''j+//;;,00 W02244!!rci|_dSrr6rs rreset_registryzSpyderRegistry.reset_registrysrc(d|jd|jdS)NzSpyderRegistry[r ])rrr;s r__str__zSpyderRegistry.__str__s FFF$2CFFFFr)r)NNF)NN)__name__ __module__ __qualname____doc__strrrrboolr3r7rr9r<r?rrrr%s]HH++c+S++++ 48487<4444c4444#+C=44$,SM44'/tn44444444n/3/3''''''&sm'''}''8;''''''''R6:04 " "Xc] " (  "9=c3h " " " "DGGGGGGGrr create_action SpyderActioncreate_toolbutton QToolButtoncreate_toolbarQToolBar create_menu SpyderMenu)rCr loggingtypingrrrr+r) getLoggerr@r/rrACTION_REGISTRYTOOLBUTTON_REGISTRYTOOLBAR_REGISTRY MENU_REGISTRYrFrrrVsML&&&&&&&&&&  8 $ $"MGMGMGMGMGMGMGMG`!..AA$n%8-HH!>"2J??}l;; r