Ñò
ý÷òGc
@ s^ d Z d d k Z d d k Z d d k Z d d k l Z d d k l Z d d k l Z d d d d d
g Z
e i e ƒ Z
d e f d „ ƒ YZ d
e f d „ ƒ YZ d e f d „ ƒ YZ d d d „ ƒ YZ d e f d „ ƒ YZ d e f d „ ƒ YZ y) d d k Z d e e f d „ ƒ YZ Wn e j
o
e Z n Xd
e f d „ ƒ YZ d S( sZ
Plugin Manager
--------------
A plugin manager class is used to load plugins, manage the list of
loaded plugins, and proxy calls to those plugins.
The plugin managers provided with nose are:
``PluginManager``
This manager doesn't implement loadPlugins, so it can only work
with a static list of plugins.
``BuiltinPluginManager``
This manager loads plugins referenced in ``nose.plugins.builtin``.
``EntryPointPluginManager``
This manager uses setuptools entrypoints to load plugins.
``DefaultPluginMananger``
This is the manager class that will be used by default. If
setuptools is installed, it is a subclass of
``EntryPointPluginManager`` and ``BuiltinPluginManager``; otherwise, an
alias to ``BuiltinPluginManager``.
``RestrictedPluginManager``
This manager is for use in test runs where some plugin calls are
not available, such as runs started with `python setup.py test`,
where the test runner is the default unittest ``TextTestRunner``. It
is a subclass of ``DefaultPluginManager``.
Writing a plugin manager
========================
If you want to load plugins via some other means, you can write a
plugin manager and pass an instance of your plugin manager class when
instantiating the `nose.config.Config`_ instance that you pass to
``TestProgram`` (or ``main`` or ``run``).
To implement your plugin loading scheme, implement ``loadPlugins()``,
and in that method, call ``addPlugin()`` with an instance each plugin
you wish to make available. Make sure to call
``super(self).loadPlugins()`` as well if have subclassed a manager
other than ``PluginManager``.
iÿÿÿÿN( t warn( t Failure( t IPluginInterfacet DefaultPluginManagert
PluginManagert EntryPointPluginManagert BuiltinPluginManagert RestrictedPluginManagert PluginProxyc B s_ e Z d Z e Z d „ Z d „ Z d „ Z d „ Z d „ Z d „ Z
d „ Z d d „ Z
RS(
s# Proxy for plugin calls. Essentially a closure bound to the
given call and plugin list.
The plugin proxy also must be bound to a particular plugin
interface specification, so that it knows what calls are available
and any special handling that is required for each call.
c C s‹ y t | i | ƒ | _ Wn/ t j
o# t d | | i i f ƒ ‚ n X| i | ƒ | _ g | _ x | D] } | i | | ƒ qm Wd S( Ns %s is not a valid %s method( t getattrt interfacet methodt AttributeErrort __name__t makeCallt callt pluginst addPlugin( t selfR R t p( ( s8 /usr/lib/python2.6/site-packages/nose/plugins/manager.pyt __init__E s c O s | i | | Ž S( N( R ( R t argt kw( ( s8 /usr/lib/python2.6/site-packages/nose/plugins/manager.pyt __call__P s c C s= t | | d ƒ } | d j o | i i | | f ƒ n d S( s` Add plugin to my list of plugins to call, if it has the attribute
I'm bound to.
N( R t NoneR t append( R t pluginR t meth( ( s8 /usr/lib/python2.6/site-packages/nose/plugins/manager.pyR S s
c se | d j o ˆ i Sˆ i } t | d t ƒ o ‡ f d † St | d t ƒ o ˆ i Sˆ i Sd S( Nt loadTestsFromNamest
generativec s t ˆ i | | Ž ƒ S( ( t listt generate( R R ( R ( s8 /usr/lib/python2.6/site-packages/nose/plugins/manager.pyt e s t chainable( t _loadTestsFromNamesR R t Falset chaint simple( R R R ( ( R s8 /usr/lib/python2.6/site-packages/nose/plugins/manager.pyR [ s
c O s‘ d } g } t t | i d g ƒ | ƒ D] \ } } | o | | q) q) ~ } x: | i D]/ \ } } | | | Ž } | } | i | ƒ qZ W| S( s˜ Call plugins in a chain, where the result of each plugin call is
sent to the next plugin as input. The final output result is returned.
t static_argsN( R t zipR R R R ( R R R t resultt _[1]t statict aR R ( ( s8 /usr/lib/python2.6/site-packages/nose/plugins/manager.pyR$ l s (
c o s x– | i D]‹ \ } } d } y: | | | Ž } | d j o x | D] } | VqB Wn Wq
t t f j
o
‚ q
t i ƒ } t | Œ Vq
q
Xq
Wd S( sF Call all plugins, yielding each item in each non-None result.
N( R R t KeyboardInterruptt
SystemExitt syst exc_infoR ( R R R R R R( t rt exc( ( s8 /usr/lib/python2.6/site-packages/nose/plugins/manager.pyR | s
c O s? x8 | i D]- \ } } | | | Ž } | d j o | Sq
Wd S( s? Call all plugins, returning the first non-None result.
N( R R ( R R R R R R( ( ( s8 /usr/lib/python2.6/site-packages/nose/plugins/manager.pyR% s
c C sq g } x^ | i D]S \ } } | | d | ƒ} | d j o( | \ } } | o | i | ƒ qc q q W| | f S( s
Chainable but not quite normal. Plugins return a tuple of
(tests, names) after processing the names. The tests are added
to a suite that is accumulated throughout the full call, while
names are input for the next plugin in the chain.
t moduleN( R R t extend( R t namesR2 t suiteR R R( t
suite_part( ( s8 /usr/lib/python2.6/site-packages/nose/plugins/manager.pyR" • s
N( R
t
__module__t __doc__R R
R R R R R$ R R% R R" ( ( ( s8 /usr/lib/python2.6/site-packages/nose/plugins/manager.pyR < s t NoPluginsc B sq e Z d Z e Z d „ Z d „ Z d „ Z d „ Z d „ Z d „ Z
d „ Z d „ Z d „ Z
d d
„ Z RS( s( Null Plugin manager that has no plugins.c C s
d | _ d S( N( ( R ( R ( ( s8 /usr/lib/python2.6/site-packages/nose/plugins/manager.pyR ¨ s c C s d S( N( ( ( R ( ( s8 /usr/lib/python2.6/site-packages/nose/plugins/manager.pyt __iter__« s c O s d S( N( ( R t argst kwds( ( s8 /usr/lib/python2.6/site-packages/nose/plugins/manager.pyt
_doNothing® s c O s d S( N( ( ( R R; R< ( ( s8 /usr/lib/python2.6/site-packages/nose/plugins/manager.pyt _emptyIterator± s c C s8 t | i | ƒ } t | d t ƒ o | i S| i Sd S( NR ( R R
R# R> R= ( R R R ( ( s8 /usr/lib/python2.6/site-packages/nose/plugins/manager.pyt __getattr__´ s c C s
t ƒ ‚ d S( N( t NotImplementedError( R t plug( ( s8 /usr/lib/python2.6/site-packages/nose/plugins/manager.pyR » s c C s
t ƒ ‚ d S( N( R@ ( R R ( ( s8 /usr/lib/python2.6/site-packages/nose/plugins/manager.pyt
addPlugins¾ s c C s d S( N( ( R t optionst config( ( s8 /usr/lib/python2.6/site-packages/nose/plugins/manager.pyt configureÁ s c C s d S( N( ( R ( ( s8 /usr/lib/python2.6/site-packages/nose/plugins/manager.pyt loadPluginsÄ s c C s d S( N( ( R t cmpf( ( s8 /usr/lib/python2.6/site-packages/nose/plugins/manager.pyt sortÇ s N( R
R7 R8 R R
R R: R= R> R? R RB RE RF R RH ( ( ( s8 /usr/lib/python2.6/site-packages/nose/plugins/manager.pyR9 ¥ s c B sŒ e Z d Z e Z d d
d „ Z d „ Z d „ Z d „ Z d „ Z
d „ Z d „ Z d
d „ Z
d „ Z d
„ Z e e e d
d ƒ Z RS( s_ Base class for plugin managers. Does not implement loadPlugins, so it
may only be used with a static list of plugins.
The basic functionality of a plugin manager is to proxy all unknown
attributes through a ``PluginProxy`` to a list of plugins.
Note that the list of plugins *may not* be changed after the first plugin
call.
c C sH g | _ h | _ | o | i | ƒ n | d j o
| | _ n d S( N( t _pluginst _proxiesRB R t
proxyClass( R R RK ( ( s8 /usr/lib/python2.6/site-packages/nose/plugins/manager.pyR × s
c C sK y | i | SWn5 t j
o) | i | | i ƒ } | | i | Proxy for 0.9 plugins, adapts 0.10 calls to 0.9 standard.
c C s
| | _ d S( N( R ( R R ( ( s8 /usr/lib/python2.6/site-packages/nose/plugins/manager.pyR s c C s | i i | | ƒ d S( N( R t add_options( R t parsert env( ( s8 /usr/lib/python2.6/site-packages/nose/plugins/manager.pyRC s c C s× t | i d ƒ p d Sd d k l } l } | \ } } } t | | ƒ o, t | i d ƒ p d S| i i | i ƒ St | | ƒ o, t | i d ƒ p d S| i i | i ƒ S| i } | i i
| i | | ƒ S( Nt addErroriÿÿÿÿ( t SkipTestt DeprecatedTestt addSkipt
addDeprecated( t hasattrR t nose.excR^ R_ t
issubclassR` t testRa t capturedOutputR] ( R Re t errR^ R_ t ect evt tbt capt( ( s8 /usr/lib/python2.6/site-packages/nose/plugins/manager.pyR] s c C s( t | i d ƒ o | i i | ƒ Sd S( Nt loadTestsFromPath( Rb R Rl ( R t filename( ( s8 /usr/lib/python2.6/site-packages/nose/plugins/manager.pyt loadTestsFromFile/ s c C sF t | i d ƒ p d S| i } | i } | i i | i | | | ƒ S( Nt
addFailure( Rb R Rf t tbinfoRo Re ( R Re Rg Rk Rp ( ( s8 /usr/lib/python2.6/site-packages/nose/plugins/manager.pyRo 3 s
c C s; t | i d ƒ p d S| i } | i i | i | ƒ d S( Nt
addSuccess( Rb R Rf Rq Re ( R Re Rk ( ( s8 /usr/lib/python2.6/site-packages/nose/plugins/manager.pyRq ; s c C s+ t | i d ƒ p d S| i i | i ƒ S( Nt startTest( Rb R Rr Re ( R Re ( ( s8 /usr/lib/python2.6/site-packages/nose/plugins/manager.pyRr A s c C s+ t | i d ƒ p d S| i i | i ƒ S( Nt stopTest( Rb R Rs Re ( R Re ( ( s8 /usr/lib/python2.6/site-packages/nose/plugins/manager.pyRs F s c C s t | i | ƒ S( N( R R ( R t val( ( s8 /usr/lib/python2.6/site-packages/nose/plugins/manager.pyR? K s ( R
R7 R8 R t ost environRC R] Rn Ro Rq Rr Rs R? ( ( ( s8 /usr/lib/python2.6/site-packages/nose/plugins/manager.pyRY s c B s) e Z d Z d d e f f Z d „ Z RS( sh Plugin manager that loads plugins from the `nose.plugins` and
`nose.plugins.0.10` entry points.
s nose.plugins.0.10s nose.pluginsc C s" t t | ƒ i ƒ d d k l } h } xò | i D]ç \ } } xØ | | ƒ D]Ê } | i | j o qL n t | | i . s* i&I;&