Je1dZddlZddlmZmZmZddlZddlmZm Z ddl m Z ddl m Z ddlmZddlmZej$eZeeeeeeefZGd d ZGd d eZy) z Spyder API helper mixins. N)AnyUnionOptional)QActionQWidget)Shortcut)CONF)ConfigurationKey) NoDefaultc eZdZdZdZedfdedeeefde e fdZ dde e fdZ ddedede e d e fd Z ddede e fd Z ddede e fd Z dd e de e de e de fdZ dded e dede e def dZedZy)SpyderConfigurationAccessorzQ Mixin used to access options stored in the Spyder configuration system. Noptiondefaultsectioncj| |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. KA SpyderConfigurationAccessor must define a `CONF_SECTION` class attribute!) CONF_SECTIONAttributeErrorr get)selfrrrs :/usr/lib/python3/dist-packages/spyder/api/config/mixins.pyget_confz$SpyderConfigurationAccessor.get_conf)sA8(/$##G ? #  xx11cf| |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. r)rrr options)rrs rget_conf_optionsz,SpyderConfigurationAccessor.get_conf_optionsNs=((/$##G ? # ||G$$rvaluerecursive_notificationcp| |jn|}| tdtj||||y)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_confjsF2(/$##G ? #     #9  rcj| |jn|}| tdtj||y)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_confs>(/$##G ? #  7F+rch| |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. r)rrr get_defaultr$s rget_conf_defaultz,SpyderConfigurationAccessor.get_conf_defaultsA(/$##G ? # 00rnamecontext plugin_namereturncP| |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],0371!11"*3-1.7;)-==&.sm=!#=25=<&*  !  ),  6=  c]  .6  D''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|_|j|j|j D]\}| |jn|}|j |}|D]6}tj|d|d|tj|||8^y)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__s     $ MM**.0  )+%'*2w$   ""$44 BG+2?d''G#<rrm __classcell__)rQs@rrCrCs: B.+O"6 .>'*rrC)r<loggingtypingrrrrGqtpy.QtWidgetsrrspyder.config.guirspyder.config.managerr spyder.config.typesr spyder.config.userr getLoggerr9rMr?intr>tuplelistdictr=r rCrArrr{sr '','&0(   8 $ 4c5$4 5 ^'^'B`"=`r