G@d1dZddlZddlmZmZmZddlZddlmZm Z ddl m Z ddl m Z ddlmZddlmZejeZeeeeeeefZGd d ZGd d eZdS) z Spyder API helper mixins. N)AnyUnionOptional)QActionQWidget)Shortcut)CONF)ConfigurationKey) NoDefaultc HeZdZdZdZedfdedeeefde e fdZ dde e fdZ dded ede e d e fd Z ddede e fd Z ddede e fd Z dde de e de e de fdZ ddede dede e def dZedZdS)SpyderConfigurationAccessorzQ Mixin used to access options stored in the Spyder configuration system. Noptiondefaultsectioncf||jn|}|tdtj|||S)a Get an option from the Spyder configuration system. Parameters ---------- option: ConfigurationKey Name/Tuple path of the option to get its value from. default: Union[NoDefault, BasicTypes] Fallback value to return if the option is not found on the configuration system. section: str Section in the configuration system, e.g. `shortcuts`. If None, then the value of `CONF_SECTION` is used. Returns ------- value: BasicTypes Value of the option in the configuration section. Raises ------ configparser.NoOptionError If the section does not exist in the configuration. NKA SpyderConfigurationAccessor must define a `CONF_SECTION` class attribute!) CONF_SECTIONAttributeErrorr get)selfrrrs 8lib/python3.11/site-packages/spyder/api/config/mixins.pyget_confz$SpyderConfigurationAccessor.get_conf)sG8(/$##G ? #  x111cb||jn|}|tdtj|S)a Get all options from the given section. Parameters ---------- section: Optional[str] Section in the configuration system, e.g. `shortcuts`. If None, then the value of `CONF_SECTION` is used. Returns ------- values: BasicTypes Values of the option in the configuration section. Raises ------ configparser.NoOptionError If the section does not exist in the configuration. Nr)rrr options)rrs rget_conf_optionsz,SpyderConfigurationAccessor.get_conf_optionsNsC((/$##G ? # |G$$$rTvaluerecursive_notificationcn||jn|}|tdtj||||dS)a Set an option in the Spyder configuration system. Parameters ---------- option: ConfigurationKey Name/Tuple path of the option to set its value. value: BasicTypes Value to set on the configuration system. section: Optional[str] Section in the configuration system, e.g. `shortcuts`. If None, then the value of `CONF_SECTION` is used. recursive_notification: bool If True, all objects that observe all changes on the configuration section and objects that observe partial tuple paths are notified. For example if the option `opt` of section `sec` changes, then the observers for section `sec` are notified. Likewise, if the option `(a, b, c)` changes, then observers for `(a, b, c)`, `(a, b)` and a are notified as well. Nr)r)rrr set)rrrrrs rset_confz$SpyderConfigurationAccessor.set_confjsb2(/$##G ? #     #9       rch||jn|}|tdtj||dS)an Remove an option in the Spyder configuration system. Parameters ---------- option: ConfigurationKey Name/Tuple path of the option to remove its value. section: Optional[str] Section in the configuration system, e.g. `shortcuts`. If None, then the value of `CONF_SECTION` is used. Nr)rrr remove_optionrrrs r remove_confz'SpyderConfigurationAccessor.remove_confsL(/$##G ? #  7F+++++rcd||jn|}|tdtj||S)ay Get an option default value in the Spyder configuration system. Parameters ---------- option: ConfigurationKey Name/Tuple path of the option to remove its value. section: Optional[str] Section in the configuration system, e.g. `shortcuts`. If None, then the value of `CONF_SECTION` is used. Nr)rrr get_defaultr$s rget_conf_defaultz,SpyderConfigurationAccessor.get_conf_defaultsF(/$##G ? # 000rnamecontext plugin_namereturncD||jn|}tj|||S)aR Get a shortcut sequence stored under the given name and context. Parameters ---------- name: str Key identifier under which the shortcut is stored. context: Optional[str] Name of the shortcut context. plugin: Optional[str] Name of the plugin where the shortcut is defined. Returns ------- shortcut: str Key sequence of the shortcut. Raises ------ configparser.NoOptionError If the section does not exist in the configuration. )rr get_shortcut)rr)r*r+s rr.z(SpyderConfigurationAccessor.get_shortcuts*2(/$##G $ <<+/04 $ $ )$ "$ #3-$ *. $ $ $ $ P.2,,,,%c],,,,03711!11"*3-1111.7;)-===&.sm=!#=25====<&*   !  ),  6=  c]  .6     D''X'''rr cHeZdZdZfdZdZdZdZdede de fd Z xZ S) SpyderConfigurationObservera Concrete implementation of the protocol :class:`spyder.config.types.ConfigurationObserver`. This mixin enables a class to receive configuration updates seamlessly, by registering methods using the :function:`spyder.api.config.decorators.on_conf_change` decorator, which receives a configuration section and option to observe. When a change occurs on any of the registered configuration options, the corresponding registered method is called with the new value. c t|jtjd|di|_t i|_|| |jD]W}||jn|}|j|}|D]:}t |d|d|tj |||;XdS)NzRA SpyderConfigurationObserver must define a `CONF_SECTION` class attribute! Hint: z) or its parent should define the section.z is observing z in section )super__init__rwarningswarn_configuration_listenersr _multi_option_listeners_gather_observers_merge_none_observersloggerdebugr observe_configuration)rrobserved_optionsr __class__s rrFz$SpyderConfigurationObserver.__init__s4    $ M*.    )+%'*2ww$     ""$$$4 B BG+2?d''G#rrm __classcell__)rQs@rrCrCs  BBBBB.+++OOO"666 .>'*rrC)r<loggingtypingrrrrGqtpy.QtWidgetsrrspyder.config.guirspyder.config.managerr spyder.config.typesr spyder.config.userr getLoggerr9rMr?intr>tuplelistdictr=r rCrArrr{s@ '''''''''',+++++++'&&&&&&&&&&&000000((((((  8 $ $ 4c5$4 5 ^'^'^'^'^'^'^'^'B`````"=`````r