envisage.plugin_manager module

A simple plugin manager implementation.

class envisage.plugin_manager.PluginManager(plugins=None, **traits)

Bases: HasTraits

A simple plugin manager implementation.

This implementation manages an explicit collection of plugin instances, e.g:

plugin_manager = PluginManager(plugins=[MyPlugin(), YourPlugin()])

Plugins can be added and removed after construction time via the methods ‘add_plugin’ and ‘remove_plugin’.

add_plugin(plugin)

Add a plugin to the manager.

application

The application that the plugin manager is part of.

exclude

An optional list of the Ids of the plugins that are to be excluded by the manager.

Each item in the list is actually an ‘fnmatch’ expression.

get_plugin(plugin_id)

Return the plugin with the specified Id.

include

An optional list of the Ids of the plugins that are to be included by the manager (i.e. only plugins with Ids in this list will be added to the manager).

Each item in the list is actually an ‘fnmatch’ expression.

plugin_added

Fired when a plugin has been added to the manager.

plugin_removed

Fired when a plugin has been removed from the manager.

remove_plugin(plugin)

Remove a plugin from the manager.

start()

Start the plugin manager.

start_plugin(plugin=None, plugin_id=None)

Start the specified plugin.

stop()

Stop the plugin manager.

stop_plugin(plugin=None, plugin_id=None)

Stop the specified plugin.