/usr/lib/python2.6/site-packages/stevedore
Edit: /usr/lib/python2.6/site-packages/stevedore/extension.pyc (11657B)
Ñò
yDVc @ s] d Z d d k Z d d k Z e i e ƒ Z d e f d „ ƒ YZ d e f d „ ƒ YZ d S( s ExtensionManager
iÿÿÿÿNt Extensionc B s& e Z d Z d „ Z e d „ ƒ Z RS( s• Book-keeping object for tracking extensions.
The arguments passed to the constructor are saved as attributes of
the instance using the same names, and can be accessed by the
callables passed to :meth:`map` or when iterating over an
:class:`ExtensionManager` directly.
:param name: The entry point name.
:type name: str
:param entry_point: The EntryPoint instance returned by
:mod:`pkg_resources`.
:type entry_point: EntryPoint
:param plugin: The value returned by entry_point.load()
:param obj: The object returned by ``plugin(*args, **kwds)`` if the
manager invoked the extension on load.
c C s( | | _ | | _ | | _ | | _ d S( N( t namet entry_pointt plugint obj( t selfR R R R ( ( s6 /tmp/pip-build-lt8jXN/stevedore/stevedore/extension.pyt __init__ s c C s d | i i | i i d f S( sÆ The module and attribute referenced by this extension's entry_point.
:return: A string representation of the target of the entry point in
'dotted.module:object' format.
s %s:%si ( R t module_namet attrs( R ( ( s6 /tmp/pip-build-lt8jXN/stevedore/stevedore/extension.pyt entry_point_target% s ( t __name__t
__module__t __doc__R t propertyR ( ( ( s6 /tmp/pip-build-lt8jXN/stevedore/stevedore/extension.pyR s t ExtensionManagerc B sË e Z d Z e d h e d e d „ Z e d e d e d „ ƒ Z e d d „ Z d „ Z h Z
d „ Z d „ Z d „ Z
d „ Z d
„ Z e d „ ƒ Z d „ Z d
„ Z d „ Z d „ Z d „ Z RS( sW Base class for all of the other managers.
:param namespace: The namespace for the entry points.
:type namespace: str
:param invoke_on_load: Boolean controlling whether to invoke the
object returned by the entry point after the driver is loaded.
:type invoke_on_load: bool
:param invoke_args: Positional arguments to pass when invoking
the object returned by the entry point. Only used if invoke_on_load
is True.
:type invoke_args: tuple
:param invoke_kwds: Named arguments to pass when invoking
the object returned by the entry point. Only used if invoke_on_load
is True.
:type invoke_kwds: dict
:param propagate_map_exceptions: Boolean controlling whether exceptions
are propagated up through the map call or whether they are logged and
then ignored
:type propagate_map_exceptions: bool
:param on_load_failure_callback: Callback function that will be called when
a entrypoint can not be loaded. The arguments that will be provided
when this is called (when an entrypoint fails to load) are
(manager, entrypoint, exception)
:type on_load_failure_callback: function
:param verify_requirements: Use setuptools to enforce the
dependencies of the plugin(s) being loaded. Defaults to False.
:type verify_requirements: bool
c C sB | i | d | d | ƒ| i | | | | ƒ } | i | ƒ d S( Nt propagate_map_exceptionst on_load_failure_callback( t _init_attributest
_load_pluginst
_init_plugins( R t namespacet invoke_on_loadt invoke_argst invoke_kwdsR R t verify_requirementst
extensions( ( s6 /tmp/pip-build-lt8jXN/stevedore/stevedore/extension.pyR N s t TESTINGc C s9 | i | ƒ } | i | d | d | ƒ| i | ƒ | S( s Construct a test ExtensionManager
Test instances are passed a list of extensions to work from rather
than loading them from entry points.
:param extensions: Pre-configured Extension instances to use
:type extensions: list of :class:`~stevedore.extension.Extension`
:param namespace: The namespace for the manager; used only for
identification since the extensions are passed in.
:type namespace: str
:param propagate_map_exceptions: When calling map, controls whether
exceptions are propagated up through the map call or whether they
are logged and then ignored
:type propagate_map_exceptions: bool
:param on_load_failure_callback: Callback function that will
be called when a entrypoint can not be loaded. The
arguments that will be provided when this is called (when
an entrypoint fails to load) are (manager, entrypoint,
exception)
:type on_load_failure_callback: function
:param verify_requirements: Use setuptools to enforce the
dependencies of the plugin(s) being loaded. Defaults to False.
:type verify_requirements: bool
:return: The manager instance, initialized for testing
R R ( t __new__R R ( t clsR R R R R t o( ( s6 /tmp/pip-build-lt8jXN/stevedore/stevedore/extension.pyt make_test_instance_ s
c C s | | _ | | _ | | _ d S( N( R R t _on_load_failure_callback( R R R R ( ( s6 /tmp/pip-build-lt8jXN/stevedore/stevedore/extension.pyR † s c C s | | _ d | _ d S( N( R t Nonet _extensions_by_name( R R ( ( s6 /tmp/pip-build-lt8jXN/stevedore/stevedore/extension.pyR Œ s c C sA | | i j o& t t i | ƒ ƒ } | | i |
R? ( ( s6 /tmp/pip-build-lt8jXN/stevedore/stevedore/extension.pyt _call_extension_methodã s c O s | i | i | | | Ž S( sÊ Iterate over the extensions invoking a method by name.
This is equivalent of using :meth:`map` with func set to
`lambda x: x.obj.method_name()`
while being more convenient.
Exceptions raised from within the called method are propagated up
and processing stopped if self.propagate_map_exceptions is True,
otherwise they are logged and ignored.
.. versionadded:: 0.12
:param method_name: The extension method name
to call for each extension.
:param args: Variable arguments to pass to method
:param kwds: Keyword arguments to pass to method
:returns: List of values returned from methods
( RA RE ( R RD R> R? ( ( s6 /tmp/pip-build-lt8jXN/stevedore/stevedore/extension.pyt
map_methodç s c C sj y | | | | | Ž ƒ WnI t j
o= } | i o ‚ qf t i d | i | ƒ t i | ƒ n Xd S( Ns error calling %r: %s( R. R R( R/ R R0 ( R t response_callbackR= R9 R> R? R3 ( ( s6 /tmp/pip-build-lt8jXN/stevedore/stevedore/extension.pyR< ý s
c C s
t | i ƒ S( s¬ Produce iterator for the manager.
Iterating over an ExtensionManager produces the :class:`Extension`
instances in the order they would be invoked.
( t iterR ( R ( ( s6 /tmp/pip-build-lt8jXN/stevedore/stevedore/extension.pyt __iter__ s c C sO | i d j o4 h } x | i D] } | | | i Return true if name is in list of enabled extensions.
c 3 s" x | ] } | i ˆ j Vq Wd S( N( R ( t .0RC ( R ( s6 /tmp/pip-build-lt8jXN/stevedore/stevedore/extension.pys s ( t anyR ( R R ( ( R s6 /tmp/pip-build-lt8jXN/stevedore/stevedore/extension.pyt __contains__ s ( N( R
R R t FalseR R t classmethodR R R R" R' R R* R: RA t staticmethodRE RF R< RI RK RN ( ( ( s6 /tmp/pip-build-lt8jXN/stevedore/stevedore/extension.pyR 0 s6 #
( R R$ t loggingt getLoggerR
R( t objectR R ( ( ( s6 /tmp/pip-build-lt8jXN/stevedore/stevedore/extension.pyt s
$