Tryag File Manager
Home
-
Turbo Force
Current Path :
/
usr
/
share
/
rhsm
/
subscription_manager
/
Upload File :
New :
File
Dir
//usr/share/rhsm/subscription_manager/plugins.pyc
mò x^Sc @ su d k Z e i Z d k Z d k Z d k Z d k Z d k l Z d k l Z l Z d k Z e i d e ƒ Z d k l Z e ƒ Z d k l Z d Z d Z d Z d e f d „ ƒ YZ d e f d „ ƒ YZ d e f d „ ƒ YZ d e f d „ ƒ YZ d e f d „ ƒ YZ d e f d „ ƒ YZ d e f d „ ƒ YZ d e f d „ ƒ YZ d e f d „ ƒ YZ! d e f d „ ƒ YZ" d e f d „ ƒ YZ# d e f d „ ƒ YZ$ d! e f d" „ ƒ YZ% d# e f d$ „ ƒ YZ& d% e f d& „ ƒ YZ' d' e f d( „ ƒ YZ( d) e' f d* „ ƒ YZ) d+ e f d, „ ƒ YZ* d- e f d. „ ƒ YZ+ d/ e+ f d0 „ ƒ YZ, d1 „ Z- d2 „ Z. d S(3 N( s SafeConfigParser( s NoSectionErrors NoOptionErrors rhsm-app.( s initConfig( s SubManPlugins 1.0s /usr/share/rhsm-plugins/s /etc/rhsm/pluginconf.d/t PluginExceptionc B s t Z d Z d „ Z RS( s Base exception for rhsm plugins.c C s> t | d ƒ o* | i o d i | d | i g ƒ } n | S( Nt msgs s Message: %s( t hasattrt selfR t joint repr_msg( R R ( ( t/ /usr/share/rhsm/subscription_manager/plugins.pyt _add_message9 s ( t __name__t __module__t __doc__R ( ( ( R R 7 s t PluginImportExceptionc B s# t Z d Z e d „ Z d „ Z RS( s= Raised when a SubManPlugin derived class can not be imported.c C s | | _ | | _ | | _ d S( N( t module_fileR t module_nameR ( R R R R ( ( R t __init__A s c C s# d | i | i f } | i | ƒ S( Ns* Plugin "%s" can't be imported from file %s( R R R R R ( R R ( ( R t __str__F s ( R R R t NoneR R ( ( ( R R ? s t PluginModuleImportExceptionc B s t Z d Z RS( s. Raise when a plugin module can not be imported( R R R ( ( ( R R L s t, PluginModuleImportApiVersionMissingExceptionc B s t Z d Z d „ Z RS( sF Raised when a plugin module does not include a 'requires_api_version'.c C s# d | i | i f } | i | ƒ S( Nse Plugin module "%s" in %s has no API version. 'requires_api_version' should be set.( R R R R R ( R R ( ( R R R s ( R R R R ( ( ( R R P s t% PluginModuleImportApiVersionExceptionc B s# t Z d Z e d „ Z d „ Z RS( sD Raised when a plugin module's 'requires_api_version' can not be met.c C s1 | | _ | | _ | | _ | | _ | | _ d S( N( R R R t module_vert api_verR ( R R R R R R ( ( R R [ s c C s) d | i | i | i f } | i | ƒ S( Ns8 Plugin "%s" requires API version %s. Supported API is %s( R R R R R R ( R R ( ( R R b s ( R R R R R R ( ( ( R R Y s t PluginConfigExceptionc B s# t Z d Z e d „ Z d „ Z RS( s? Raised when a PluginConfig fails to load or read a config file.c C s | | _ | | _ d S( N( t plugin_nameR R ( R R R ( ( R R j s c C s d | i } | i | ƒ S( Ns) Cannot load configuration for plugin "%s"( R R R R ( R R ( ( R R n s ( R R R R R R ( ( ( R R h s t SlotNameExceptionc B s t Z d Z d „ Z d „ Z RS( sC Raised when PluginManager.run() is called with a unknown slot_name.c C s | | _ d S( N( t slot_nameR ( R R ( ( R R v s c C s d | i S( Ns1 slot name %s does not have a conduit to handle it( R R ( R ( ( R R y s ( R R R R R ( ( ( R R t s t BaseConduitc B sP t Z d Z g Z e d „ Z e d „ Z e d „ Z e d „ Z e d „ Z RS( sþ An API entry point for rhsm plugins. Conduit()'s are used to provide access to the data a SubManPlugin may need. Each 'slot_name' has a BaseConduit() subclass associated with it by PluginManager(). Whenever a slot is reached, PluginManager will find all the SubManPlugin methods that handle the slot, as well as any Conduit() that is mapped to the slot. PluginManager.run(slot_name, kwargs) finds the proper Conduit for slot_name, then creates an instance, passing in the values of kwargs. Then PluginManager.run calls the SubManPlugin hook associated, passing it the Conduit(). Conduits provide access to subscription-manager configuration, as well as a logger object. Conduit() subclasses can provide additional methods. Args: clazz: A SubManPlugin subclass that will use this Conduit() conf: A PluginConf for the class passed as clazz Attributes: slots: A list of slot_name strings this Conduit() will handle log: a logger handler c C s= | o | | _ n | i | _ t i d | i ƒ | _ d S( Ns rhsm-app.( t confR t _conft clazzt loggingt getLoggerR t log( R R R ( ( R R — s c C sV y | i i | | ƒ Wn8 t t f j o& | d j o d Sn t | ƒ Sn Xd S( s¨ get string from plugin config Args: section: config section name option: config option name default: if section or option are not found, return default. None if not specified. Returns: a string. In the case of error, default is returned. If default is not specified, None is returned. N( R R t gett sectiont optiont NoSectionErrort NoOptionErrort defaultR t str( R R" R# R& ( ( R t conf_string s c C sm y | i i | | ƒ WnO t t f j o= | t j o t Sqi | t j o t Sqi t d ƒ ‚ n Xd S( sð get boolean value from plugin config Args: section: config section name option: config option name default: if section or option are not found, return default. Raises: ValueError: value requested is not a boolean Returns: a python boolean. In the case of error, default is returned. If default is not specified and there is an error, a ValueError is raised. s Boolean value expectedN( R R t getbooleanR" R# R$ R% R& t Truet Falset ValueError( R R" R# R& ( ( R t conf_boolµ s c C ss y | i i | | ƒ WnU t t f j oC y t | ƒ } Wn% t t f j o t d ƒ ‚ n X| Sn Xd S( sé get integer value from plugin config Args: section: config section name option: config option name default: if section or option are not found, return default. Raises: ValueError: value requested can not be made into an integer Returns: a python integer. In the case of error, default is returned. If default is not specified, a ValueError is raised. s Integer value expectedN( R R t getintR" R# R$ R% t intR& t valR, t TypeError( R R" R# R& R0 ( ( R t conf_intÎ s c C ss y | i i | | ƒ WnU t t f j oC y t | ƒ } Wn% t t f j o t d ƒ ‚ n X| Sn Xd S( sú get float value from plugin config Args: section: config section name option: config option name default: if section or option are not found, return default. Raises: ValueError: value requested can not be made into a float Returns: a python float. In the case of error, default is returned. If default is not specified, a ValueError is raised. s Float value expectedN( R R t getfloatR" R# R$ R% t floatR& R0 R, R1 ( R R" R# R& R0 ( ( R t conf_floatæ s ( R R R t slotsR R R( R- R2 R5 ( ( ( R R } s t RegistrationConduitc B s t Z d Z d g Z d „ Z RS( s# Conduit for uses with registration.t pre_register_consumerc C s, t t | ƒ i | ƒ | | _ | | _ d S( sy init for RegistrationConduit Args: name: ?? facts: a dictionary of system facts N( t superR7 R R R t namet facts( R R R: R; ( ( R R s ( R R R R6 R ( ( ( R R7 s t PostRegistrationConduitc B s t Z d Z d g Z d „ Z RS( s& Conduit for use with post registrationt post_register_consumerc C s, t t | ƒ i | ƒ | | _ | | _ d S( sÁ init for PostRegistrationConduit Args: consumer: an object representing the registered consumer facts: a dictionary of system facts N( R9 R< R R R t consumerR; ( R R R> R; ( ( R R s ( R R R R6 R ( ( ( R R< s t ProductConduitc B s# t Z d Z d d g Z d „ Z RS( s> Conduit for use with plugins that handle product id functions.t pre_product_id_installt post_product_id_installc C s# t t | ƒ i | ƒ | | _ d S( sn init for ProductConduit Args: product_list: A list of ProductCertificate objects N( R9 R? R R R t product_list( R R RB ( ( R R % s ( R R R R6 R ( ( ( R R? ! s t ProductUpdateConduitc B s# t Z d Z d d g Z d „ Z RS( sE Conduit for use with plugins that handle product id update functions.t pre_product_id_updatet post_product_id_updatec C s# t t | ƒ i | ƒ | | _ d S( st init for ProductUpdateConduit Args: product_list: A list of ProductCertificate objects N( R9 RC R R R RB ( R R RB ( ( R R 3 s ( R R R R6 R ( ( ( R RC / s t FactsConduitc B s t Z d Z d g Z d „ Z RS( s Conduit for collecting facts.t post_facts_collectionc C s# t t | ƒ i | ƒ | | _ d S( s] init for FactsConduit Args: facts: a dictionary of system facts N( R9 RF R R R R; ( R R R; ( ( R R A s ( R R R R6 R ( ( ( R RF = s t SubscriptionConduitc B s t Z d Z d g Z d „ Z RS( s Conduit for subscription infot pre_subscribec C s5 t t | ƒ i | ƒ | | _ | | _ | | _ d S( sj init for SubscriptionConduit Args: consumer_uuid: the UUID of the consumer being subscribed pool_id: the id of the pool the subscription will come from (None if 'auto' is False) quantity: the quantity to consume from the pool (None if 'auto' is False). auto: is this an auto-attach/healing event. N( R9 RH R R R t consumer_uuidt pool_idt quantity( R R RJ RK RL ( ( R R O s ( R R R R6 R ( ( ( R RH K s t PostSubscriptionConduitc B s t Z d g Z d „ Z RS( Nt post_subscribec C s, t t | ƒ i | ƒ | | _ | | _ d S( sµ init for PostSubscriptionConduit Args: consumer_uuid: the UUID of the consumer subscribed entitlement_data: the data returned by the server N( R9 RM R R R RJ t entitlement_data( R R RJ RO ( ( R R a s ( R R R6 R ( ( ( R RM ^ s t AutoAttachConduitc B s t Z d g Z d „ Z RS( Nt pre_auto_attachc C s# t t | ƒ i | ƒ | | _ d S( s… init for AutoAttachConduit Args: consumer_uuid: the UUID of the consumer being auto-subscribed N( R9 RP R R R RJ ( R R RJ ( ( R R p s ( R R R6 R ( ( ( R RP m s t PostAutoAttachConduitc B s t Z d g Z d „ Z RS( Nt post_auto_attachc C s t t | ƒ i | | | ƒ d S( s³ init for PostAutoAttachConduit Args: consumer_uuid: the UUID of the consumer subscribed entitlement_data: the data returned by the server N( R9 RR R R R RJ RO ( R R RJ RO ( ( R R ~ s ( R R R6 R ( ( ( R RR { s t PluginConfigc B s; t Z d Z e Z e d „ Z d „ Z d „ Z d „ Z RS( s Represents configuation for each rhsm plugin. Attributes: plugin_conf_path: where plugin config files are found plugin_key: a string identifier for plugins, For ex, 'facts.FactsPlugin' Used to find the configuration file. c C s„ | | _ | | _ g | _ t ƒ | _ | i o | i ƒ n y | i i | i ƒ Wn' t j o } t | i | ƒ ‚ n Xd S( s init for PluginConfig. Args: plugin_key: string id for class plugin_conf_path: string file path to where plugin config files are found Raises: PluginConfigException: error when finding or loading plugin config N( t plugin_conf_pathR t plugin_keyt conf_filest SafeConfigParsert parsert _get_config_file_patht readt Exceptiont eR ( R RV RU R] ( ( R R ’ s c C s_ t i i | i | i d ƒ } t i | t i ƒ p t | i d ƒ ‚ n | i i | ƒ d S( Ns .confs! Unable to find configuration file( t ost pathR R RU RV t conf_filet accesst R_OKR RW t append( R R` ( ( R RZ « s c C sj y | i i d d ƒ } Wn' t j o } t | i | ƒ ‚ n X| p t i d | i ƒ t Sn t S( s5 returns True if the plugin is enabled in it's config.t maint enableds) Not loading "%s" plugin as it is disabledN( R RY R) Re R\ R] R RV R t debugR+ R* ( R R] Re ( ( R t is_plugin_enabled³ s c C sI d | i } x | i D] } | d | } q W| t | i i ƒ } | S( Ns plugin_key: %s s config file: %s ( R RV t bufRW R` R' RY t data( R Rh R` ( ( R R ¿ s ( R R R R RV R RZ Rg R ( ( ( R RT ˆ s t BasePluginManagerc B s• t Z d Z e e d „ Z d „ Z d „ Z d „ Z d „ Z e d „ Z e d „ Z e d „ Z d „ Z d „ Z e d „ Z d „ Z d „ Z RS( sA Finds, load, and provides acccess to subscription-manager pluginsc C s~ | | _ | | _ | i ƒ | _ h | _ h | _ h | _ g | _ h | _ h | _ | i ƒ | _ | i ƒ | i ƒ d S( sQ init for BasePluginManager(). attributes: conduits: BaseConduit subclasses that can register slots search_path: where to find plugin modules plugin_conf_path: where to find plugin config files _plugins: map of a plugin_key to a SubManPlugin instance _plugin_classes: list of plugin classes found _slot_to_funcs: map of a slotname to a list of plugin methods that handle it _slot_to_conduit: map of a slotname to a Conduit() that is passed to the slot associated N( t search_pathR RU t _get_modulest modulest _modulest _pluginst _plugin_classest conduitst _slot_to_funcst _slot_to_conduitt _get_conduitst _populate_slotst _import_plugins( R Rk RU ( ( R R Í s c C s g S( sf Needs to be implemented in subclass. Returns: A list of Conduit classes N( ( R ( ( R Rt ü s c C s g S( sz Needs to be implemented in subclass. Returns: A list of modules to load plugins classes from N( ( R ( ( R Rl s c C s< | i | i ƒ t i d | i ƒ t i d | i ƒ d S( s¤ Needs to be implemented in subclass. This loads plugin modules, checks them, and loads plugins from them with self.add_plugins_from_module s loaded plugin modules: %ss loaded plugins: %sN( R t add_plugins_from_modulesRm R Rf Ro ( R ( ( R Rv s c C sL xE | i D]: } | i } x( | D] } | | i | <g | i | <q Wq Wd S( N( R Rq t conduit_classR6 t slotRs Rr ( R Ry R6 Rx ( ( R Ru s c C s^ xW | D]O } y | i | d | ƒWq t j o# } t i | ƒ t i | ƒ q Xq Wd S( s Add SubMan plugins from a list of modules Args: modules: a list of python module objects plugin_to_config_map: a dict mapping a plugin_key to a PluginConfig object. If a plugin finds it's config in here, that is used instead of creating a new PluginConfig() (which needs an actual file in plugin_conf_dir) Side effects: whatever add_plugins_from_module does to self t plugin_to_config_mapN( Rm t moduleR t add_plugins_from_moduleRz R R] R t exceptiont error( R Rm Rz R] R{ ( ( R Rw s c s‰ g | i ˆ <‡ d † } t t i ˆ | ƒ ƒ } g } x' t | ƒ D] \ } } | i | ƒ qD Wx! | D] } | i | d | ƒqh Wd S( s8 add SubManPlugin based plugins from a module. Will also look for a PluginConfig() associated with the SubManPlugin classes. Config files should be in self.plugin_conf_path and named in the format "moduleName.plugin_class_name.conf" Args: module: an import python module object, that contains SubManPlugin subclasses. plugin_to_config_map: a dict mapping a plugin_key to a PluginConfig object.If a plugin finds it's config in here, that is used instead of creating a new PluginConfig() Side Effects: self._modules is populated whatever add_plugin_class does Raises: PluginException: multiple plugins with the same name c s0 t i | ƒ o | i ˆ i j o t | t ƒ S( N( t inspectt isclasst cR R{ R t issubclasst SubManPlugin( R ( R{ ( R t is_pluginL s Rz N( R Rn R{ R„ t sortedR t getmemberst plugin_classest found_plugin_classesR: R Rc t plugin_classt add_plugin_classRz ( R R{ Rz R: R‡ R‰ R R„ Rˆ ( ( R{ R R| 3 s c C st | i | d | ƒ} | | _ | i i } | i i ƒ p/ | | i | <t i d | | i f ƒ d Sn | i | ƒ | ƒ } | | i j o | | i | <n t d | i ƒ ‚ | | i | <t } x“ | i i ƒ D]‚ } | d } | i p t | | ƒ oX t t | | ƒ ƒ o' | i | i t | | ƒ ƒ t } qXt i d | | f ƒ qÖ qÖ W| o t | _ n d S( s Add a SubManPlugin and PluginConfig class to PluginManager. Args: plugin_clazz: A SubManPlugin child class, with a .conf PluginConfig() class plugin_to_config_map: a dict mapping a plugin_key to a PluginConfig object.If a plugin finds it's config in here, that is used instead of creating a new PluginConfig() Side effects: self._plugin_classes is populated with all found plugin classes self._modules is populated with plugin classes per plugin module self._plugins is populated with valid and enabled plugin instances Raises: PluginException: multiple plugins with the same name Rz s# %s was disabled via it's config: %sNsF Two or more plugins with the name "%s" exist in the plugin search patht _hooks. %s plugin does not have a callable() method %s( R t _get_plugin_configt plugin_clazzRz t plugin_confR RV Rg Rp R Rf t _track_plugin_class_to_modulest instanceRo R R R+ t class_is_usedRr t keysRy t func_namet all_slotsR t callablet getattrRc R* t found_slots_for_hooks( R R Rz R‘ Ry R“ RŽ R RV ( ( R RŠ e s4 c C sB | i | i j o g | i | i <n | i | i i | ƒ d S( s; Keep a map of plugin classes loaded from each plugin moduleN( R R R Rn Rc ( R R ( ( R R ³ s c K sû | | i j o t | ƒ ‚ n xÔ | i | D]Å } d i | i i | i i g ƒ } t i d | i i | f ƒ | i | } y | | i | } Wn% t j o } t i | ƒ ‚ n Xy | | ƒ Wq. t j o } t i | ƒ ‚ q. Xq. Wd S( s3 For slot_name, run the registered hooks with kwargs. Args: slot_name: a string of the slot_name. Typically of form 'post_someplace_something' kwargs: kwargs dict of arguments to pass to the SubManPlugin hook methods.These are will be passed to the Conduit instance associated with 'slot_name' Returns: Nothing. Raises: SlotNameException: slot_name isn't found (Anything else is plugin and conduit specific) t .s Running %s in %sN( R R Rr R t funcR t im_classR R RV R Rf t im_funcR“ Rs t conduitt kwargst conduit_instanceR\ R] R} ( R R R Rœ R] R™ RV Rž ( ( R t run¹ s$ ! c C sF | o) | i ƒ | j o | | i ƒ Sq0 n t | i ƒ | i ƒ S( s% Get a PluginConfig for plugin_class, creating it if need be. If we have an entry in plugin_to_config_map for plugin_class, return that PluginConfig. Otherwise, we create a PluginConfig() Mote that PluginConfig() will expect to find a config file in self.plugin_conf_path, and will fail if that is not the case. Args: plugin_clazz: A SubManPlugin subclass plugin_to_config_map: A map of plugin_key to PluginConfig objects Returns: A PluginConfig() object N( Rz R t get_plugin_keyRT R RU ( R R Rz ( ( R RŒ í s c C s | i S( s list of pluginsN( R Rp ( R ( ( R t get_plugins s c C s¡ h } xI | i i ƒ D]8 \ } } | | j o g | | <n | | i | ƒ q Wg } xB t | i ƒ ƒ D]. } x% t | | ƒ D] } | i | ƒ q‚ Wqk W| S( sJ list of slots Ordered by conduit name, for presentation. N( t conduit_to_slotsR Rs t itemsRy Rœ Rc t sorted_slotsR… R’ ( R Ry Rœ R¢ R¤ ( ( R t get_slots s ( R R R R R Rt Rl Rv Ru Rw R| RŠ R RŸ RŒ R¡ R¥ ( ( ( R Rj Ê s / 2 N 4 t PluginManagerc B sV t Z d Z e Z e Z e e d „ Z d „ Z d „ Z d „ Z d „ Z d „ Z RS( s• Finds, load, and provides acccess to subscription-manager plugins using subscription-manager default plugin search path and plugin conf path.c C s´ d } d } y( t i d d ƒ } t i d d ƒ } Wn, t j o t i d ƒ d } d } n X| p | p | i } | p | p | i } t t | ƒ i d | d | ƒ d S( sÇ init PluginManager Args: search_path: if not specified, use the configured 'pluginDir' plugin_conf_path: if not specified, use the configured 'pluginConfDir' t rhsmt pluginDirt pluginConfDirs8 no config options found for plugin paths, using defaultsRk RU N( R t cfg_search_patht cfg_conf_patht cfgR! R% R t warningRk R t default_search_patht init_search_pathRU t default_conf_patht init_plugin_conf_pathR9 R¦ R ( R Rk RU R« R± R¯ Rª ( ( R R $ s c C s" t t t t t t t t t t g S( s2 get subscription-manager specific plugin conduits.N( R R? RC R7 R< RF RH RM RP RR ( R ( ( R Rt = s c C s% | i | i ƒ } | i | ƒ } | S( N( R t _find_plugin_module_filesRk t module_filest _load_plugin_module_filest plugin_modules( R Rµ R³ ( ( R Rl F s c C s‚ g } t i i | ƒ p t i d | ƒ g Sn t i i | d ƒ } x* t t i | ƒ ƒ D] } | i | ƒ q] W| i ƒ | S( sp Load all the plugins in the search path. Raise: PluginException: plugin load fails s# Could not find %s for plugin imports *.pyN( R³ R^ R_ t isdirRk R R~ R t maskR… t globR Rc t sort( R Rk R³ R· R ( ( R R² L s c C sZ g } xM | D]E } y | i | i | ƒ ƒ Wq t j o } t i | ƒ q Xq W| S( N( Rm R³ R Rc R t _load_plugin_module_fileR R] R R~ ( R R³ R] Rm R ( ( R R´ ` s c C sû t i i | ƒ \ } } | i d ƒ d } yL t i | | g ƒ \ } } } z t i | | | | ƒ } Wd | i ƒ XWn" t j o t | | ƒ ‚ n Xt | d ƒ p t | | d ƒ ‚ n t t | i ƒ p" t | | d | i d t ƒ‚ n | S( s± Loads SubManPlugin class from a module file. Args: module_file: file path to a python module containing SubManPlugin based classes Raises: PluginImportException: module_file could not be imported PluginImportApiVersionMissingException: module_file has not api version requirement PluginImportApiVersionException: modules api version requirement can not be met s .pyi Nt requires_api_versions+ Plugin doesn't specify required API versionR R ( R^ R_ t splitR t dir_pathR t impt find_modulet fpt pathnamet descriptiont load_modulet loaded_modulet closeR\ R R R t api_version_okt API_VERSIONR» R ( R R RÀ R RÁ R RÄ R½ ( ( R Rº j s" ( R R R t DEFAULT_SEARCH_PATHR® t DEFAULT_CONF_PATHR° R R Rt Rl R² R´ Rº ( ( ( R R¦ s c C s+ | i d ƒ \ } } t | ƒ t | ƒ f S( sA parse an API version string into major and minor version strings.R˜ N( t api_versionR¼ t maj_vert min_verR/ ( RÊ RË RÌ ( ( R t parse_version‹ s c C sV t | ƒ } t | ƒ } | d | d j o t Sn | d | d j o t Sn t S( sA Return true if API version "a" supports API version "b" i i N( RÍ t at bR+ R* ( RÎ RÏ ( ( R RÆ ‘ s (/ t gettextt _R¸ R¾ R R^ t iniparseRX t iniparse.compatR$ R% R R R R t rhsm.configt initConfigR¬ t subscription_manager.base_pluginRƒ RÇ RÈ RÉ R\ R R R R R R R t objectR R7 R< R? RC RF RH RM RP RR RT Rj R¦ RÍ RÆ (' R R R¬ Rj R RF R RP RX RC R RR RÐ R¾ R? RÈ R% R¦ R¸ R Rƒ RÍ R RÑ R RÆ RT RM RÕ RH R R R< R7 R$ R R^ RÇ RÉ ( ( R t ? sL ƒ Bÿ Tn