B ؐ<[<@sdZddlZddlZddlZddlZddlmZddlm Z ddl Z ddl m Z ddlmZddlmZy ddlZWnddlZYnXyddlmZWnddlmZYnXd d d d d gZeeZGdddeZGdddeZGdd d eZGdddZGdd d eZGdd d eZyddl Z Gdd d eeZ!Wn&e"k rnGdd d eZ!YnXGdd d e!Z#dS)a 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``. N)chain)warn)Failure)IPluginInterface) sort_list)StringIODefaultPluginManager PluginManagerEntryPointPluginManagerBuiltinPluginManagerRestrictedPluginManagerc@sVeZdZdZeZddZddZddZdd Z d d Z d d Z ddZ dddZ dS) PluginProxya#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. cCslyt|j||_Wn(tk r:td||jjfYnX|||_g|_x|D]}|||qTWdS)Nz%s is not a valid %s method) getattr interfacemethodAttributeError__name__makeCallcallplugins addPlugin)selfrrpr3lib/python3.7/site-packages/nose/plugins/manager.py__init__Ws  zPluginProxy.__init__cOs |j||S)N)r)rargkwrrr__call__bszPluginProxy.__call__csVt||d}|dk rR|dkrBtt|ddkrB|fdd}|j||fdS)z`Add plugin to my list of plugins to call, if it has the attribute I'm bound to. NZloadTestsFromModulercs|S)Nr)modulepathkwargs) orig_methrrnsz'PluginProxy.addPlugin..)rleninspectZ getargspecrappend)rpluginrmethr)r#rres  zPluginProxy.addPlugincsH|dkrjSj}t|ddr,fddSt|ddr>jSjSdS)NZloadTestsFromNames generativeFcstj||S)N)listgenerate)rr)rrrr${sz&PluginProxy.makeCall..Z chainable)_loadTestsFromNamesrrrsimple)rrr)r)rrrqs   zPluginProxy.makeCallcOsZd}ddtt|jdg|D}x2|jD](\}}|||}|dd}||q*W|S)zCall 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. NcSsg|]\}}|r|qSrr).0staticarrr sz%PluginProxy.chain..Z static_args)ziprrrr')rrrresultr0rr)rrrrs  zPluginProxy.chainc osxz|jD]p\}}d}y*|||}|dk rr?rrrrBrErFrGrrJrMrNrOrrrrr@sr@c@sveZdZdZeZdddZddZdd Zd d Z dd d Z ddZ ddZ ddZ ddZddZeeeddZdS)r aBase 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. rNcCs2g|_d|_i|_|r |||dk r.||_dS)Nr)rA _extraplugins_proxiesrJ proxyClass)rrrRrrrrs zPluginManager.__init__cCs<y |j|Stk r6|||j}||j|<YnX|S)N)rQKeyErrorrRrA)rrproxyrrrrGs  zPluginManager.__getattr__cCs t|jS)N)iterr)rrrrrBszPluginManager.__iter__cs<t|dtfdd|jD|jdd<|j|dS)Nnamecs g|]}t|ddkr|qS)rVN)r)r/r)new_namerrr2sz+PluginManager.addPlugin..)robjectrAr')rrIr)rWrrszPluginManager.addPlugincCs(||_xt||D]}||qWdS)zextraplugins 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)rP iterchainr)rrZ extrapluginsrIrrrrJ szPluginManager.addPluginscCsTtd||_td|j}|||dd|jD}||_|td|dS)zConfigure the set of plugins with the given options and config instance. After configuration, disabled plugins are removed from the plugins list. zConfiguring pluginsrMcSsg|]}|jr|qSr)enabled)r/rIrrrr2sz+PluginManager.configure..zPlugins enabled: %sN)logdebugrLr rArrO)rrKrLZcfgrZrrrrMs   zPluginManager.configurecCsx|jD]}||qWdS)N)rPr)rrIrrrrN"s zPluginManager.loadPluginscCst|jddddS)NcSs t|ddS)NZscore)r)xrrrr$'sz$PluginManager.sort..T)reverse)rrA)rrrrrO&szPluginManager.sortcCs|jS)N)rA)rrrr _get_plugins)szPluginManager._get_pluginscCsg|_||dS)N)rArJ)rrrrr _set_plugins,szPluginManager._set_pluginszPAccess the list of plugins managed by this plugin manager)rN)rr)rr=r>r?r rRrrGrBrrJrMrNrOr`rapropertyrrrrrr s   c@s^eZdZdZddZejfddZddZdd Z d d Z d d Z ddZ ddZ ddZdS)ZeroNinePluginz>Proxy for 0.9 plugins, adapts 0.10 calls to 0.9 standard. cCs ||_dS)N)r()rr(rrrr8szZeroNinePlugin.__init__cCs|j||dS)N)r(Z add_options)rparserenvrrrrK;szZeroNinePlugin.optionsc Cst|jdsdSddlm}m}|\}}}t||rRt|jdsDdS|j|jSt||rzt|jdsldS|j|jS|j }|j |j||S)NaddErrorr)SkipTestDeprecatedTestaddSkip addDeprecated) hasattrr(Znose.excrgrh issubclassritestrjcapturedOutputrf) rrmerrrgrhZecZevtbcaptrrrrf>s      zZeroNinePlugin.addErrorcCst|jdr|j|SdS)NloadTestsFromPath)rkr(rr)rfilenamerrrloadTestsFromFilePs z ZeroNinePlugin.loadTestsFromFilecCs0t|jdsdS|j}|j}|j|j|||S)N addFailure)rkr(rntbinforurm)rrmrorqrvrrrruTs  zZeroNinePlugin.addFailurecCs*t|jdsdS|j}|j|j|dS)N addSuccess)rkr(rnrwrm)rrmrqrrrrw\s zZeroNinePlugin.addSuccesscCst|jdsdS|j|jS)N startTest)rkr(rxrm)rrmrrrrxbs zZeroNinePlugin.startTestcCst|jdsdS|j|jS)NstopTest)rkr(ryrm)rrmrrrrygs zZeroNinePlugin.stopTestcCs t|j|S)N)rr()rvalrrrrGlszZeroNinePlugin.__getattr__N)rr=r>r?rosenvironrKrfrtrurwrxryrGrrrrrc5srccs,eZdZdZddeffZfddZZS)r zhPlugin manager that loads plugins from the `nose.plugins` and `nose.plugins.0.10` entry points. )znose.plugins.0.10Nz nose.pluginsc sddlm}i}x|jD]\}}x||D]}|j|kr:q*d||j<td|jj|y |}WnJt k rxYn6t k r}zt d||ft w*Wdd}~XYnX|r||}n|}| |q*WqWtt|dS)zBLoad plugins by iterating the `nose.plugins` entry point. r)iter_entry_pointsTz%s load plugin %szUnable to load plugin %s: %sN) pkg_resourcesr} entry_pointsrVr[r\ __class__rloadr5 ExceptionrRuntimeWarningrsuperr rN) rr}ZloadedZ entry_pointZadaptZepZplugclserI)rrrrNws*      z#EntryPointPluginManager.loadPlugins)rr=r>r?rcrrN __classcell__rr)rrr ps cs eZdZdZfddZZS)r zSPlugin manager that loads plugins from the list in `nose.plugins.builtin`. cs:ddlm}x|jD]}||qWtt|dS)z-Load plugins in nose.plugins.builtin r)builtinN)Z nose.pluginsrrrrr rN)rrrI)rrrrNs  z BuiltinPluginManager.loadPlugins)rr=r>r?rNrrr)rrr sc@s eZdZdS)rN)rr=r>rrrrrsc@s eZdZdS)rN)rr=r>rrrrrsc@s*eZdZdZd ddZddZdd Zd S) r zPlugin 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. rTcCs(t||||_||_g|_d|_dS)N)rrrexcludeexcluded _excludedOpts)rrrrrrrrs  z RestrictedPluginManager.__init__cCsR|jdkrBddlm}|dd|_x|jD]}|j|jidq*W|jd|S)Nr) OptionParserF)Zadd_help_option)rez--)rZoptparserrrKZ get_option)rrVrr(rrrexcludedOptions     z&RestrictedPluginManager.excludedOptioncCsl|jrt|g}xL|jD]B}d}x*|jD] }t||r,d}|j|Pq,W|r||qW||_dS)NTF)rrrNrrrkrr')rZallowr(okrrrrrNs     z#RestrictedPluginManager.loadPluginsN)rrT)rr=r>r?rrrNrrrrr s )$r?r&Zloggingr{r7 itertoolsrrYwarningsrZ nose.configZnoseZ nose.failurerZnose.plugins.baserZnose.pyversionrpickleior__all__Z getLoggerrr[rXr r@r rcr r r~r ImportErrorr rrrr2sB       m&T;%