class core.plugin.instance.PluginInstanceManager(manager, plugins=None, proxy_class=None)

Bases: object

clear()

function(group, name)

has_instance(group, name)

implementations(interface, **kwds)

Return all instances implementing this interface

instance(group, name, class_args=None, class_kwds=None)

Use this function if you always want the same instance: If plugin has never been called, create a new instance else return first created one.

instances(group, name=None, class_args=None, class_kwds=None)

Return all existing instances corresponding to this plugin

new(group, name, class_args=None, class_kwds=None)

Create a new instance and register it. You can get all created instances with instances method.

register(group, name, instance)

Add a weakref to instance in dict group -> name -> [list of instances]

set_manager(manager)

unregister(group, name, instance)

Unregistered instances won't be list by "instances" method

debug

core.plugin.instance.enhanced_error(error, **kwds)

Add plugin information to given exception. By default, if a plugin fails, for example because a dependency cannot be imported, user get error message "ImportError: No module named mydep". This message is useless because we don't know which plugin has failed.

Once enhanced, error message become: "MyLab (mypackage.lab.mylab): ImportError: No module named mydep"

kwds:

• plugin: plugin instance
• plugin_class: plugin class