�9�c@s�dZd
dl
Z
d
dlZd
dlZd
dlZd
dlmZ
d
dlm	Z	
d
dl
Zd
dlm
Z

d
dlmZ
d
dlmZ
yd
dlZWn


d
dlZn
Xyd
dlmZ
Wn


d
dlmZ
n
Xd	d
ddd
gZeje�Zdef
d��YZdef
d��YZd
ef
d��YZddd��YZdef
d��YZdef
d��YZ y)d
dl!Z!d	ee fd��YZ"Wn'e#k
r�


d	e f
d��YZ"n
Xd
e"f
d��YZ$dS(s
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:

:class:`PluginManager`
    This manager doesn't implement loadPlugins, so it can only work
    with a static list of plugins.

:class:`BuiltinPluginManager`
    This manager loads plugins referenced in ``nose.plugins.builtin``.

:class:`EntryPointPluginManager`
    This manager uses setuptools entrypoints to load plugins.

:class:`ExtraPluginsPluginManager`
    This manager loads extra plugins specified with the keyword
    `addplugins`.

:class:`DefaultPluginMananger`
    This is the manager class that will be used by default. If
    setuptools is installed, it is a subclass of
    :class:`EntryPointPluginManager` and :class:`BuiltinPluginManager`;
    otherwise, an alias to :class:`BuiltinPluginManager`.

:class:`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 :class:`TextTestRunner`. It
    is a subclass of :class:`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 :class:`nose.config.Config` instance that you pass to
:class:`TestProgram` (or :func:`main` or :func:`run`).

To implement your plugin loading scheme, implement ``loadPlugins()``,
and in that method, call ``addPlugin()`` with an instance of 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(
tchain(
twarn(
tFailure(
tIPluginInterface(
t	sort_list(
tStringIOtDefaultPluginManagert
PluginManagertEntryPointPluginManagertBuiltinPluginManagertRestrictedPluginManagertPluginProxycBs_eZ
dZeZd
�Zd�Zd�Zd�Zd�Z	d�Z
d�Zd	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.
    cCs�yt|j
|
�|_Wn-tk
rH


td
|
|j
jf��n
X|j|
�|_g|_x|D]}|j||
�
qkWdS(Ns%s is not a valid %s method(	tgetattrt	interfacetmethodtAttributeErrort__name__tmakeCalltcalltpluginst	addPlugin(tselfRRt
p((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyt__init__Ws







	


c
Os|j|
|�S(
N(
R(Rtargtkw((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyt__call__bs
cs~t|
|d�}|dk	rz|d
krattj|�d�dkra|��f
d�}n|jj|
|f�
ndS(s`Add plugin to my list of plugins to call, if it has the attribute
        I'm bound to.
        tloadTestsFromModuleiics
�|�S(
N((tmoduletpathtkwargs(
t	orig_meth(s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyt<lambda>nsN(RtNonetlentinspectt
getargspecRtappend(RtpluginRtmeth((
Rs8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyRes





cs_|
d
kr�jS�j
}t|dt�r;�f
d�St|dt�rT�jS�jSdS(NtloadTestsFromNamest
generativecst�j
||
��S(
N(tlisttgenerate(RR(
R(s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyR {st	chainable(t_loadTestsFromNamesRRtFalseRtsimple(RRR'((
Rs8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyRqs
	



c
Os�d}gt
t|jd
g�|
�D]\}}|r%|^q%}x:|jD]/\}}||
|�}|}
|
j|�
qMW|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.
        tstatic_argsN(R!tzipRRRR%(RRRtresulttstatict
aRR'((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyR�s
(





c
os�x�|jD]�\}}d
}y8||
|�}|d
k	rSx|D]}|V
qAWnWq
ttfk
rp


�q



tj�}t|�V
q
q
Xq
Wd
S(sFCall all plugins, yielding each item in each non-None result.
        N(RR!tKeyboardInterruptt
SystemExittsystexc_infoR(RRRRR'R2t
rtexc((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyR+�s












c
Os=x6|jD]+\}}||
|�}|d
k	r
|Sq
Wd
S(s?Call all plugins, returning the first non-None result.
        N(RR!(RRRRR'R2((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyR/�s


cCsmg}xZ|jD]O\}}||
d
|�
}|dk	r|\}}
|r_|j|�
q_qqW||
fS(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.
        RN(RR!textend(RtnamesRtsuiteRR'R2t
suite_part((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyR-�s






N(Rt
__module__t__doc__RR
RRRRRR+R/R!R-(((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyRNs

							t	NoPluginsc
BsneZ
dZeZd
�Zd�Zd�Zd�Zd�Z	d�Z
d�Zd�Zd	�Z
d
�ZRS(s(Null Plugin manager that has no plugins.c

Csd
|_|_
dS(N((t_pluginsR(
R((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyR�s
c


Csd
S(N(((
R((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyt__iter__�s
c

OsdS(
N((Rtargstkwds((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyt
_doNothing�s
c

Osd
S(N(((RRDRE((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyt_emptyIterator�s
cCs6t|j
|
�}t|d
t�r+|jS|jSdS(NR)(RR
R.RGRF(RRR((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyt__getattr__�s


c
Cs
t��dS(
N(
tNotImplementedError(Rtplug((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyR�s
c
Cs
t��dS(
N(
RI(RR((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyt
addPlugins�s
c
CsdS(
N((Rtoptionstconfig((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyt	configure�s
c


CsdS(
N((
R((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pytloadPlugins�s
c


CsdS(
N((
R((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pytsort�s
(RR?R@RR
RRCRFRGRHRRKRNRORP(((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyRA�s


									cBs�eZ
dZeZdd
d
�Zd�Zd�Zd�Z	ddd�Z
d�Zd�Zd�Z
d	�Zd
�Zeeed
d�ZRS(s�Base class for plugin managers. PluginManager is intended to be
    used only with a static list of plugins. The loadPlugins() implementation
    only reloads plugins from _extraplugins to prevent those from being
    overridden by a subclass.

    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.
    cCsMg|_d
|_
i|_|
r1|j|
�
n|dk	rI||_ndS(N((RBt
_extrapluginst_proxiesRKR!t
proxyClass(RRRS((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyR�s
	
	
	



cCsIy|j|
SWn3t
k
rD


|j|
|j�}||j|
<n
X|S(
N(RRtKeyErrorRSRB(RRtproxy((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyRH�s






c

Cs
t|j
�S(
N(titerR(
R((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyRC
s
cCsat|
d
t
��}g|jD]$}t|d
d�|kr|^q|j(|jj|
�
dS(Ntname(RtobjectRBR!R%(RRJtnew_nameR((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyR
s

(
cCs4||_x$t
|
|�D]}|j|�
qWd
S(s�extraplugins are maintained in a separate list and
        re-added by loadPlugins() to prevent their being overwritten
        by plugins added by a subclass of PluginManager
        N(RQt	iterchainR(RRtextrapluginsRJ((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyRK
s	

cCs�tj
d
�
||_td|j�}||
|�
g|jD]}|jr?|^q?}||_|j�
tj
d|�
dS(s�Configure the set of plugins with the given options
        and config instance. After configuration, disabled plugins
        are removed from the plugins list.
        sConfiguring pluginsRNsPlugins enabled: %sN(tlogtdebugRMRRBtenabledRRP(RRLRMtcfgRJR^((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyRN
s

	



%
	


c
Cs%x|jD]}
|j
|
�
q
WdS(
N(RQR(RRJ((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyRO"
s

c

Cst|j
d
�dt�
S(Nc

Sst|d
d�S(Ntscorei
(
R(
t
x((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyR '
streverse(RRBtTrue(
R((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyRP&
s
c


Cs|jS(
N(
RB(
R((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyt_get_plugins)
s
cCsg|_|j
|
�
dS(
N(RBRK(RR((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyt_set_plugins,
s
	
sPAccess the list of plugins managed by
                       this plugin manager(N(((RR?R@RRSR!RRHRCRRKRNRORPRdRetpropertyR(((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyR�s
										tZeroNinePlugincBseeZ
dZd
�Zejd�Zd�Zd�Zd�Z	d�Z
d�Zd�Zd	�Z
RS(
s>Proxy for 0.9 plugins, adapts 0.10 calls to 0.9 standard.
    cCs
|
|_dS(
N(
R&(RR&((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyR8
s
cCs|jj
|
|�
dS(
N(R&tadd_options(Rtparsertenv((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyRL;
s
c	Cs�t|j
d
�sdSddlm}m}
|\}}}t||�rst|j
d�s`dS|j
j|
j�St||�r�t|j
d�s�dS|j
j|
j�S|
j	}|j
j
|
j||�S(NtaddErrori�(tSkipTesttDeprecatedTesttaddSkipt
addDeprecated(thasattrR&tnose.excRlRmt
issubclassRnttestRotcapturedOutputRk(	RRsterrRlRmtectevttbtcapt((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyRk>
s










	
cCs&t|j
d
�r"|j
j|
�SdS(NtloadTestsFromPath(RpR&Rz(Rtfilename((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pytloadTestsFromFileP
s

cCsDt|j
d
�sdS|
j}|
j}|j
j|
j|||�S(Nt
addFailure(RpR&RtttbinfoR}Rs(RRsRuRyR~((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyR}T
s


	
	
cCs9t|j
d
�sdS|
j}|j
j|
j|�
dS(Nt
addSuccess(RpR&RtRRs(RRsRy((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyR\
s


	
cCs)t|j
d
�sdS|j
j|
j�S(Nt	startTest(RpR&R�Rs(RRs((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyR�b
s


cCs)t|j
d
�sdS|j
j|
j�S(NtstopTest(RpR&R�Rs(RRs((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyR�g
s


cCst|j
|
�S(
N(RR&(Rtval((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyRHl
s
(RR?R@RtostenvironRLRkR|R}RR�R�RH(((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyRg5
s
							cBs)eZ
dZddeffZd�ZRS(shPlugin manager that loads plugins from the `nose.plugins` and
    `nose.plugins.0.10` entry points.
    snose.plugins.0.10snose.pluginsc
	Cs
d
dlm
}

i}x�jD]�\}}x�|
|�D]�}|j|krTq9nt||j<tjd|jj|�
y|j	�}Wn@t
k
r�


�n-tk
r�
}
td||ft
�
q9n
X|r�|��}n	|�}|j|�
q9Wq Wtt|�j�
dS(sBLoad plugins by iterating the `nose.plugins` entry point.
        i�(
titer_entry_pointss%s load plugin %ssUnable to load plugin %s: %sN(t
pkg_resourcesR�tentry_pointsRWRcR\R]t	__class__RtloadR5t	ExceptionR
tRuntimeWarningRtsuperRRO(	RR�tloadedtentry_pointtadaptteptplugclst
eRJ((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyROw
s*

















	

N(snose.plugins.0.10N(RR?R@R!RgR�RO(((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyRp
s

c
BseZ
dZd
�ZRS(sSPlugin manager that loads plugins from the list in
    `nose.plugins.builtin`.
    c
CsKd
dlm
}

x!|
jD]}|j|��
qWtt|�j�
dS(s-Load plugins in nose.plugins.builtin
        i�(
tbuiltinN(tnose.pluginsR�RRR�R	RO(RR�RJ((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyRO�s


(RR?R@RO(((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyR	�s
c
BseZ
RS((RR?(((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyR�s
c
BseZ
RS((RR?(((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyR�s
cBs2eZ
dZdded
�Zd�Zd�ZRS(s�Plugin manager that restricts the plugin list to those not
    excluded by a list of exclude methods. Any plugin that implements
    an excluded method will be removed from the manager's plugin list
    after plugins are loaded.
    cCs8tj
||
�
||_||_g|_d|_dS(
N(RRR�texcludetexcludedR!t
_excludedOpts(RRR�R�((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyR�s


	
	
	
cCsr|jdkr^d
dlm}
|dt�
|_x*|jD]}|j|jdi�

q;Wn|jjd|
�S(Ni�(
tOptionParsertadd_help_optionRjs--(R�R!toptparseR�R.R�RLt
get_option(RRWR�R&((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pytexcludedOption�s





c
Cs�|jrt
j|�
ng}
xj|jD]_}t}x:|jD]/}t||�r?t}|jj	|�
Pq?q?W|r)|
j	|�
q)q)W|
|_dS(
N(
R�RRORRcR�RpR.R�R%(RtallowR&tokR((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyRO�s
	











(((RR?R@RcRR�RO(((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyR
�s
	((%R@R#tloggingR�R7t	itertoolsRRZtwarningsR
tnose.configtnosetnose.failureRtnose.plugins.baseRtnose.pyversionRtcPickletpicklet	cStringIORt__all__t	getLoggerRR\RXRRARRgRR	R�RtImportErrorR
(((s8/sys/lib/python2.7/site-packages/nose/plugins/manager.pyt<module>2sB
















	
m&T;%