errbot.plugin_manager module

Logic related to plugin loading and lifecycle

class errbot.plugin_manager.BotPluginManager(storage_plugin, repo_manager, extra, autoinstall_deps, core_plugins, plugins_callback_order)

Bases: yapsy.PluginManager.PluginManager, errbot.storage.StoreMixin

Customized yapsy PluginManager for ErrBot.

BL_PLUGINS = 'bl_plugins'

CONFIGS = 'configs'

__init__(storage_plugin, repo_manager, extra, autoinstall_deps, core_plugins, plugins_callback_order)

Initialize self. See help(type(self)) for accurate signature.

activate_non_started_plugins()

Activates all plugins that are not activated, respecting its dependencies.

Returns:Empty string if no problem occured or a string explaining what went wrong.

activate_plugin(name)

Activate the given plugin.

Parameters:name – the name of the plugin you want to activate. Throws PluginActivationException:  if an error occured while activating the plugin.

activate_plugin_with_version_check(plugin_info: <module 'yapsy.PluginInfo' from '/home/docs/checkouts/readthedocs.org/user_builds/errbot/envs/5.2.0/lib/python3.7/site-packages/yapsy/PluginInfo.py'>, dep_track=None) → errbot.botplugin.BotPlugin

attach_bot(bot)

blacklist_plugin(name)

deactivate_all_plugins()

deactivate_plugin(name)

deactivate_plugin_by_name(name)

get_all_active_plugin_names()

get_all_active_plugin_objects()

get_all_active_plugin_objects_ordered()

get_all_plugin_names()

get_blacklisted_plugin()

get_plugin_by_name(name: str) → <module 'yapsy.PluginInfo' from '/home/docs/checkouts/readthedocs.org/user_builds/errbot/envs/5.2.0/lib/python3.7/site-packages/yapsy/PluginInfo.py'>

get_plugin_configuration(name)

get_plugin_obj_by_name(name: str) → errbot.botplugin.BotPlugin

instanciateElement(element) → errbot.botplugin.BotPlugin

Overrides the instanciation of plugins to inject the bot reference.

is_plugin_blacklisted(name)

reload_plugin_by_name(name)

Completely reload the given plugin, including reloading of the module’s code :throws PluginActivationException: needs to be taken care of by the callers.

remove_plugin(plugin)

Deactivate and remove a plugin completely. :param plugin: the plugin to remove :return:

remove_plugins_from_path(root)

Remove all the plugins that are in the filetree pointed by root.

set_plugin_configuration(name, obj)

shutdown()

unblacklist_plugin(name)

update_dynamic_plugins()

It returns a dictionary of path -> error strings.

update_plugin_places(path_list, extra_plugin_dir, autoinstall_deps=True)

It returns a dictionary of path -> error strings.

exception errbot.plugin_manager.IncompatiblePluginException

Bases: errbot.plugin_manager.PluginActivationException

exception errbot.plugin_manager.PluginActivationException

Bases: Exception

exception errbot.plugin_manager.PluginConfigurationException

Bases: errbot.plugin_manager.PluginActivationException

errbot.plugin_manager.check_dependencies(req_path: str) → Tuple[str, Sequence[str]]

This methods returns a pair of (message, packages missing). Or None, [] if everything is OK.

errbot.plugin_manager.check_enabled_core_plugin(name: str, config: configparser.ConfigParser, core_plugin_list) → bool

Checks if the given plugin is core and if it is, if it is part of the enabled core_plugins_list.

Return type:

bool

Parameters:

• name (str) – The plugin name
• config (ConfigParser) – Its config
• core_plugin_list – the list from CORE_PLUGINS in the config.

Returns:

True if it is OK to load this plugin.

errbot.plugin_manager.check_errbot_plug_section(name: str, config: configparser.ConfigParser) → bool

Checks if we have the correct Errbot version. Returns true if the plugin is loadable

errbot.plugin_manager.check_errbot_version(name: str, min_version: str, max_version: str)

Checks if a plugin version between min_version and max_version is ok for this errbot. Raises IncompatiblePluginException if not.

errbot.plugin_manager.check_python_plug_section(name: str, config: configparser.ConfigParser) → bool

Checks if we have the correct version to run this plugin. Returns true if the plugin is loadable

errbot.plugin_manager.global_restart()

errbot.plugin_manager.install_packages(req_path)

Installs all the packages from the given requirements.txt

Return an exc_info if it fails otherwise None.

errbot.plugin_manager.populate_doc(plugin_info: <module 'yapsy.PluginInfo' from '/home/docs/checkouts/readthedocs.org/user_builds/errbot/envs/5.2.0/lib/python3.7/site-packages/yapsy/PluginInfo.py'>) → None

Previous: errbot.logs module | Next: errbot.plugin_wizard module