a j:@s<dZddlZddlZddlZddlZddlmZddlm Z ddl m Z ddl m Z ddlmZgdZeeZeed sd d e_Gd d d eZGdddeZGdddeZGdddZddZGdddeZGdddeZzGdddeeZWn$ey&GdddeZYn0GdddeZ 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)DefaultPluginManager PluginManagerEntryPointPluginManagerBuiltinPluginManagerRestrictedPluginManager getargspeccCst|ddS)N)inspectgetfullargspec)funcr:E:\soccer\ml_env\Lib\site-packages\nose/plugins/manager.py5rc@sVeZdZdZeZddZddZddZdd Z d d Z d d Z ddZ dddZ dS) PluginProxyaProxy 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.cCsfzt|j||_Wn&ty8td||jjfYn0|||_g|_|D]}|||qPdS)Nz%s is not a valid %s method) getattr interfacemethodAttributeError__name__makeCallcallplugins addPlugin)selfrrprrr__init__@s   zPluginProxy.__init__cOs|j|i|SN)r)rargkwrrr__call__KszPluginProxy.__call__csVt||d}|durR|dkrBtt|ddkrB|fdd}|j||fdS)NZloadTestsFromModulercs|Sr"r)modulepathkwargsZ orig_methrrrVrz'PluginProxy.addPlugin..)rlenrr rappend)rpluginrmethrr*rrNs  zPluginProxy.addPlugincsH|dkrjSj}t|ddr,fddSt|ddr>jSjSdS)NZloadTestsFromNames generativeFcstj|i|Sr")listgenerate)r#r$rrrr`rz&PluginProxy.makeCall..Z chainable)_loadTestsFromNamesrrrsimple)rrr.rr2rrYs   zPluginProxy.makeCallcOsZd}ddtt|jdg|D}|jD],\}}||i|}|dd}||q(|S)zCall plugins in a chain, where the result of each plugin call is sent to next plugin as input. The final output result is returned.NcSsg|]\}}|r|qSrr).0staticarrr ls z%PluginProxy.chain..Z static_args)ziprrrr,)rr#r$resultr6r r.rrrrfs  zPluginProxy.chainc os||jD]p\}}d}z$||i|}|dur4|EdHWqttfyNYqtytt}t|VYqYq0qdS)z=Call all plugins, yielding each item in each non-None result.N)rKeyboardInterrupt SystemExit Exceptionsysexc_infor)rr#r$r r.r:excrrrr1us  zPluginProxy.generatecOs2|jD]&\}}||i|}|dur|SqdS)z6Call all plugins, returning the first non-None result.N)r)rr#r$r r.r:rrrr4s  zPluginProxy.simpleNcCsFg}|jD]2\}}|||d}|dur |\}}|r ||q ||fS)aChainable 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.)r'N)rextend)rnamesr'Zsuiter r.r:Z suite_partrrrr3s  zPluginProxy._loadTestsFromNames)N)r __module__ __qualname____doc__rrr!r%rrrr1r4r3rrrrr8s   rc@sdeZdZdZeZddZddZddZdd Z d d Z d d Z ddZ ddZ ddZddZdS) NoPluginsz(Null Plugin manager that has no plugins.cCsd|_|_dSNr)_pluginsrr2rrrr!szNoPlugins.__init__cCsdSrGrr2rrr__iter__szNoPlugins.__iter__cOsdSr"rrargskwdsrrr _doNothingszNoPlugins._doNothingcOsdSrGrrJrrr_emptyIteratorszNoPlugins._emptyIteratorcCs(t|j|}t|ddr|jS|jSdS)Nr/F)rrrNrM)rrrrrr __getattr__s  zNoPlugins.__getattr__cCs tdSr"NotImplementedErrorrplugrrrrszNoPlugins.addPlugincCs tdSr"rPrrrrr addPluginsszNoPlugins.addPluginscCsdSr"r)roptionsconfigrrr configureszNoPlugins.configurecCsdSr"rr2rrr loadPluginsszNoPlugins.loadPluginscCsdSr"rr2rrrsortszNoPlugins.sortN)rrCrDrErrr!rIrMrNrOrrUrXrYrZrrrrrFsrFc@sveZdZdZeZdddZddZdd Zd d Z dd d Z ddZ ddZ ddZ ddZddZeeeddZdS)raBase 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 plugins *may not* be changed after the first plugin call.rNcCs2g|_d|_i|_|r |||dur.||_dSrG)rH _extraplugins_proxiesrU proxyClass)rrr]rrrr!s zPluginManager.__init__cCs<z |j|WSty6|||j}||j|<Yn0|Sr")r\KeyErrorr]rH)rrproxyrrrrOs   zPluginManager.__getattr__cCs t|jSr")iterrr2rrrrIszPluginManager.__iter__cs<t|dtfdd|jD|jdd<|j|dS)Nnamecs g|]}t|ddkr|qS)raNr)r5r new_namerrr8sz+PluginManager.addPlugin..)robjectrHr,rRrrcrrszPluginManager.addPlugincCs$||_t||D]}||qdS)zextraplugins are maintained in a separate list and re-added by loadPlugins() to prevent their being overwritten by plugins added by a subclass of PluginManagerN)r[ iterchainr)rrZ extrapluginsrSrrrrUszPluginManager.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 pluginsrXcSsg|]}|jr|qSr)enabled)r5rSrrrr8rz+PluginManager.configure..zPlugins enabled: %sN)logdebugrWrrHrrZ)rrVrWcfgrgrrrrXs   zPluginManager.configurecCs|jD]}||qdSr")r[rrRrrrrYs zPluginManager.loadPluginscCst|jddddS)NcSs t|ddS)NZscorerb)xrrrrrz$PluginManager.sort..T)reverse)rrHr2rrrrZs zPluginManager.sortcCs|jSr")rHr2rrr _get_pluginsszPluginManager._get_pluginscCsg|_||dSr")rHrUrTrrr _set_pluginsszPluginManager._set_pluginszPAccess the list of plugins managed by this plugin manager)rN)rr)rrCrDrErr]r!rOrIrrUrXrYrZrnropropertyrrrrrrs   rc@sZeZdZddZejfddZddZddZd d Z d d Z d dZ ddZ ddZ dS)ZeroNinePlugincCs ||_dSr")r-)rr-rrrr!szZeroNinePlugin.__init__cCs|j||dSr")r- add_options)rparserenvrrrrVszZeroNinePlugin.optionsc Cst|jdsdSddlm}m}|\}}}t||rRt|jdsDdS|j|jSt||rzt|jdsldS|j|jS|j }|j |j||S)NaddErrorr)SkipTestDeprecatedTestaddSkip addDeprecated) hasattrr-Znose.excrvrw issubclassrxtestrycapturedOutputru) rr|errrvrwecZevtbcaptrrrrus      zZeroNinePlugin.addErrorcCst|jdr|j|SdS)NloadTestsFromPath)rzr-r)rfilenamerrrloadTestsFromFile(s  z ZeroNinePlugin.loadTestsFromFilecCs0t|jdsdS|j}|j}|j|j|||S)N addFailure)rzr-r}tbinforr|)rr|r~rrrrrr-s  zZeroNinePlugin.addFailurecCs*t|jdsdS|j}|j|j|dS)N addSuccess)rzr-r}rr|)rr|rrrrr4s zZeroNinePlugin.addSuccesscCst|jdsdS|j|jS)N startTest)rzr-rr|rr|rrrr:s zZeroNinePlugin.startTestcCst|jdsdS|j|jS)NstopTest)rzr-rr|rrrrr?s zZeroNinePlugin.stopTestcCs t|j|Sr")rr-)rvalrrrrODszZeroNinePlugin.__getattr__N)rrCrDr!osenvironrVrurrrrrrOrrrrrqsrqc Cszddlm}WnRttfybzddlm}WnttfyPgYYS0||YSYn0|}t|dr|j|dS| |gSdS)Nr) entry_points)iter_entry_pointsselect)group) importlib.metadatar ImportErrorr= pkg_resourcesrOSErrorrzrget) group_namerrgroupsrrrrHs  rcs,eZdZdZddeffZfddZZS)r zCPlugin manager that loads plugins from `nose.plugins` entry points.)znose.plugins.0.10Nz nose.pluginsc si}|jD]\}}t|D]}|j|vr*qd||j<td|jj|z |}WnTtyfYnBt y}z*t d||ft WYd}~qWYd}~n d}~00|r||}n|}| |qq t t|dS)z9Load plugins by iterating the `nose.plugins` entry point.Tz%s load plugin %szUnable to load plugin %s: %sN)rrrarhri __class__rloadr;r=rRuntimeWarningrsuperr rY)rZloaded entry_pointZadaptepZplugclserSrrrrYbs*      " z#EntryPointPluginManager.loadPlugins)rrCrDrErqrrY __classcell__rrrrr ]s r cs eZdZdZfddZZS)r zCManager that loads plugins from the list in `nose.plugins.builtin`.cs6ddlm}|jD]}||qtt|dS)Nr)builtin)Z nose.pluginsrrrrr rY)rrrSrrrrY}s  z BuiltinPluginManager.loadPlugins)rrCrDrErYrrrrrr {sr c@s eZdZdSrNrrCrDrrrrrsrc@s eZdZdSrrrrrrrsc@s&eZdZd ddZddZddZd S) r rTcCs(t||||_||_g|_d|_dSr")rr!rexcludeexcluded _excludedOpts)rrrrrrrr!s  z RestrictedPluginManager.__init__cCsN|jdur>ddlm}|dd|_|jD]}|j|jidq(|jd|S)Nr) OptionParserF)add_help_option)rtz--)roptparserrrV get_option)rrarr-rrrexcludedOptions     z&RestrictedPluginManager.excludedOptioncCsf|jrt|g}|jD]@}d}|jD]"}t||r(d}|j|qLq(|r||q||_dS)NTF)rrrYrrrzrr,)rZallowr-okrrrrrYs      z#RestrictedPluginManager.loadPluginsN)rrT)rrCrDr!rrYrrrrr s r )!rErloggingrr> itertoolsrrfwarningsrZ nose.failurerZnose.plugins.baserZnose.pyversionr__all__ getLoggerrrhrzr rerrFrrqrr r rrr rrrrs2&        c'O7