Gc @ sx d d k Z d d k Z d d k l Z d d k l Z d d k l Z d e f d YZ d e f d YZ
d S( iN( t OptionConflictError( t warn( t tolistt Pluginc B s} e Z d Z e Z e Z d Z d Z d Z d Z
e i d Z
e i d Z e i d Z d Z d Z d Z RS(
s Base class for nose plugins. It's not *necessary* to subclass this
class to create a plugin; however, all plugins must implement
`options(self, parser, env)` and `configure(self, options, conf)`, and
must have the attributes `enabled`, `name` and `score`. The `name`
attribute may contain hyphens ('-').
Plugins should not be enabled by default.
Subclassing Plugin (and calling the superclass methods in
__init__, configure, and options, if you override them) will give
your plugin some friendly default behavior:
* A --with-$name option will be added to the command line interface
to enable the plugin, and a corresponding environment variable
will be used as the default value. The plugin class's docstring
will be used as the help for this option.
* The plugin will not be enabled unless this option is selected by
the user.
id c C s] | i d j o | i i i | _ n | i d j o d | i i d d | _ n d S( Ns enable_plugin_%st -t _( t namet Nonet __class__t __name__t lowert enableOptt replace( t self( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt __init__! s c C s | i | | d S( s Add command-line options for this plugin.
The base plugin class adds --with-$name by default, used to enable the
plugin.
N( t add_options( R
t parsert env( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt
addOptions' s c C sb y | i | | t | _ Wn> t j
o2 } t d | | f t t | _ t | _ n Xd S( sI Non-camel-case version of func name for backwards compatibility.
s@ Plugin %s has conflicting option string: %s and will be disabledN( t optionst Truet
can_configureR R t RuntimeWarningt Falset enabled( R
R R t e( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyR / s
c
C sz d | i i } | i d d } | i d | i d d d | i d | i | d d
| i i | i | f d S( s New plugin API: override to just set options. Implement
this method instead of addOptions or add_options for normal
options behavior with protection from OptionConflictErrors.
s NOSE_WITH_%sR R s --with-%st actiont
store_truet destt defaultt helps Enable plugin %s: %s [%s]N( R t upperR t
add_optionR t getR R R ( R
R R t env_opt( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyR < s c C sH | i p d S| | _ t | | i o t | | i | _ n d S( s Configure the plugin and system, based on selected options.
The base plugin class sets the plugin to enabled if the enable option
for the plugin (self.enableOpt) is true.
N( R t conft hasattrR t getattrR ( R
R R# ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt configureJ s
c C s% | i i o t i | i i Sd S( s Return help for this plugin. This will be output as the help
section of the --with-$name option that enables the plugin.
s (no help available)( R t __doc__t textwrapt dedent( R
( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyR V s
c C s t d t t | S( Ns9 Plugin.tolist is deprecated. Use nose.util.tolist instead( R t DeprecationWarningR ( R
t val( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyR ` s N( R t
__module__R' R R R R R R t scoreR t ost environR R R R& R R ( ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyR s
t IPluginInterfacec B s e Z d Z d Z e i d Z e Z e e _ d Z
e e
_ d Z e e _ d Z
e e
_ d Z e e _ d Z e e _ d Z e e _ d Z e e _ d
Z e e _ d Z e e _ d Z e e _ d
Z e e _ d Z e e _ d Z e e _ d Z d Z d Z d Z e e _ d Z e e _ e e _ e e f e _ d Z! e e! _ e e! _ e e f e! _ d Z" e e" _ d Z# e e# _ d Z$ e e$ _% e e$ _ d Z& e e& _% d5 d5 d Z( e e( _% d5 d Z) e e) _ e e) _ d Z* e e* _% e e* _ d Z+ e e+ _ d Z, e e, _% d Z- e e- _ e e- _% d Z. e e. _ e e. _% e i d! Z/ e e/ _ d" Z0 d# Z1 e e1 _ d$ Z2 e e2 _ d% Z3 e e3 _ d& Z4 e e4 _ d' Z5 d( Z6 d) Z7 e e7 _ d* Z8 d+ Z9 e e9 _ d, Z: d- Z; e e; _ d. Z< d/ Z= d0 Z> d1 Z? d2 Z@ d3 ZA d4 ZB e eB _ RS(6 s
Nose plugin API
---------------
While it is recommended that plugins subclass
nose.plugins.Plugin, the only requirements for a plugin are
that it implement the methods `options(self, parser, env)` and
`configure(self, options, conf)`, and have the attributes
`enabled`, `name` and `score`.
Plugins may implement any or all of the methods documented
below. Please note that they *must not* subclass `IPluginInterface`;
`IPluginInterface` is a only description of the plugin API.
When plugins are called, the first plugin that implements a method
and returns a non-None value wins, and plugin processing ends. The
exceptions to this are methods marked as `generative` or
`chainable`. `generative` methods combine the output of all
plugins that respond with an iterable into a single flattened
iterable response (a generator, really). `chainable` methods pass
the results of calling plugin A as the input to plugin B, where
the positions in the chain are determined by the plugin sort
order, which is in order by `score` descending.
In general, plugin methods correspond directly to methods of
`nose.selector.Selector`, `nose.loader.TestLoader` and
`nose.result.TextTestResult` are called by those methods when they are
called. In some cases, the plugin hook doesn't neatly match the
method in which it is called; for those, the documentation for the
hook will tell you where in the test process it is called.
Plugin hooks fall into four broad categories: selecting and
loading tests, handling errors raised by tests, preparing objects
used in the testing process, and watching and reporting on test
results.
Selecting and loading tests
===========================
To alter test selection behavior, implement any necessary `want*`
methods as outlined below. Keep in mind, though, that when your
plugin returns True from a `want*` method, you will send the requested
object through the normal test collection process. If the object
represents something from which normal tests can't be collected, you
must also implement a loader method to load the tests.
Examples:
* The builtin doctests plugin implements `wantFile` to enable
loading of doctests from files that are not python modules. It
also implements `loadTestsFromModule` to load doctests from
python modules, and `loadTestsFromFile` to load tests from the
non-module files selected by `wantFile`.
* The builtin attrib plugin implements `wantFunction` and
`wantMethod` so that it can reject tests that don't match the
specified attributes.
Handling errors
===============
To alter error handling behavior -- for instance to catch a
certain class of exception and handle it differently from the
normal error or failure handling -- you should subclass
`ErrorClassPlugin`. See the documentation for `ErrorClassPlugin`_ for
more details.
Examples:
* The builtin skip and deprecated plugins are ErrorClass plugins.
Preparing test objects
======================
To alter, get a handle on, or replace test framework objects such
as the loader, result, runner, and test cases, use the appropriate
prepare methods. The simplest reason to use prepare is if you need
to use an object yourself. For example, the isolate plugin
implements `prepareTestLoader` so that it can use the test loader
later on to load tests. If you return a value from a prepare
method, that value will be used in place of the loader, result,
runner or test case, respectively. When replacing test cases, be
aware that you are replacing the entire test case -- including the
whole `run(result)` method of the `unittest.TestCase` -- so if you
want normal unittest test result reporting, you must implement the
same calls to result as `unittest.TestCase.run`.
Examples:
* The builtin isolate plugin implements `prepareTestLoader` but
does not replace the test loader.
* The builtin profile plugin implements `prepareTest` and does
replace the top-level test case by returning the case wrapped in
the profiler function.
Watching or reporting on tests
==============================
To record information about tests or other modules imported during
the testing process, output additional reports, or entirely change
test report output, implement any of the methods outlined below that
correspond to TextTestResult methods.
Examples:
* The builtin cover plugin implements `begin` and `report` to
capture and report code coverage metrics for all or selected modules
loaded during testing.
* The builtin profile plugin implements `begin`, `prepareTest` and
`report` to record and output profiling information. In this
case, the plugin's `prepareTest` method constructs a function that
runs the test through the hotshot profiler's runcall() method.
c O s t d d S( Ns0 IPluginInterface class is for documentation only( t TypeError( t clst argt kw( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt __new__ s c C s d S( s Called to allow plugin to register command line
options with the parser.
Do *not* return a value from this method unless you want to stop
all other plugins from setting their options.
.. Note:: DEPRECATED -- implement `options` instead.
N( ( R
R R ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyR s c C s d S( s7 Called when a deprecated test is seen. DO NOT return a value
unless you want to stop other plugins from seeing the deprecated
test.
.. Note:: DEPRECATED -- check error class in addError instead
:Parameters:
test : `nose.case.Test`_
the test case
N( ( R
t test( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt
addDeprecated s c C s d S( s Called when a test raises an uncaught exception. DO NOT return a
value unless you want to stop other plugins from seeing that the
test has raised an error.
:Parameters:
test : `nose.case.Test`_
the test case
err : 3-tuple
sys.exc_info() tuple
capt : string
Captured output, if any
.. Note:: DEPRECATED: this parameter will not be passed
N( ( R
R6 t err( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt addError s c C s d S( s5 Called when a test fails. DO NOT return a value unless you
want to stop other plugins from seeing that the test has failed.
:Parameters:
test : `nose.case.Test`_
the test case
err : 3-tuple
sys.exc_info() tuple
capt : string
Captured output, if any.
.. Note:: DEPRECATED: this parameter will not be passed
tb_info : string
Introspected traceback info, if any
.. Note:: DEPRECATED: this parameter will not be passed
N( ( R
R6 R8 ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt
addFailure
s c C s d S( s# Called when a test is skipped. DO NOT return a value unless
you want to stop other plugins from seeing the skipped test.
.. Note:: DEPRECATED -- check error class in addError instead
:Parameters:
test : `nose.case.Test`_
the test case
N( ( R
R6 ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt addSkip s
c C s d S( sf Called when a test passes. DO NOT return a value unless you
want to stop other plugins from seeing the passing test.
:Parameters:
test : `nose.case.Test`_
the test case
capt : string
Captured output, if any.
.. Note:: DEPRECATED: this parameter will not be passed
N( ( R
R6 ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt
addSuccess, s c C s d S( s Called after a context (generally a module) has been
lazy-loaded, imported, setup, had its tests loaded and
executed, and torn down.
N( ( R
( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt afterContext; s c C s d S( s Called after all tests have been loaded from directory at path
and run.
:Parameters:
path : string
the directory that has finished processing
N( ( R
t path( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt afterDirectoryC s c C s d S( s Called after module is imported from filename. afterImport
is called even if the import failed.
:Parameters:
filename : string
The file that was loaded
module : string
The name of the module
N( ( R
t filenamet module( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt afterImportN s
c C s d S( s Called after the test has been run and the result recorded
(after stopTest).
:Parameters:
test : `nose.case.Test`_
the test case
N( ( R
R6 ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt afterTest[ s c C s d S( s Called before a context (generally a module) is
examined. Since the context is not yet loaded, plugins don't
get to know what the context is; so any context operations
should use a stack that is pushed in `beforeContext` and popped
in `afterContext` to ensure they operate symmetrically.
`beforeContext` and `afterContext` are mainly
useful for tracking and restoring global state around possible
changes from within a context, whatever the context may be. If
you need to operate on contexts themselves, see `startContext`
and `stopContext`, which are passed the context in question, but
are called after it has been loaded (imported in the module
case).
N( ( R
( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt
beforeContextf s c C s d S( s Called before tests are loaded from directory at path.
:Parameters:
path : string
the directory that is about to be processed
N( ( R
R> ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt beforeDirectoryx s c C s d S( s Called before module is imported from filename.
:Parameters:
filename : string
The file that will be loaded
module : string
The name of the module found in file
N( ( R
R@ RA ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt beforeImport s c C s d S( s Called before the test is run (before startTest).
:Parameters:
test : `nose.case.Test`_
the test case
N( ( R
R6 ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt
beforeTest s c C s d S( sz Called before any tests are collected or run. Use this to
perform any setup needed before testing begins.
N( ( R
( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt begin s c C s d S( sf Called after the command line has been parsed, with the
parsed options and the config container. Here, implement any
config storage or changes to state or operation that are set
by command line options.
Do *not* return a value from this method unless you want to
stop all other plugins from being configured.
N( ( R
R R# ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyR& s c C s d S( s& Called after all report output, including output from all
plugins, has been sent to the stream. Use this to print final
test results or perform final cleanup. Return None to allow
other plugins to continue printing, any other value to stop
them.
.. Note:: When tests are run under a test runner other than
`nose.core.TextTestRunner`_, for example when tests are run
via ``python setup.py test``, this method may be called
**before** the default report output is sent.
N( ( R
t result( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt finalize s c C s d S( s Return a test description. Called by
`nose.case.Test.shortDescription`.
:Parameters:
test : `nose.case.Test`_
the test case
N( ( R
R6 ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt describeTest s c C s d S( s$ Called in result.addError, before plugin.addError. If you
want to replace or modify the error tuple, return a new error
tuple.
:Parameters:
test : `nose.case.Test`_
the test case
err : 3-tuple
sys.exc_info() tuple
N( ( R
R6 R8 ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt formatError s c C s d S( s Called in result.addFailure, before plugin.addFailure. If you
want to replace or modify the error tuple, return a new error
tuple. Since this method is chainable, you must return the
test as well, so you you'll return something like::
return (test, err)
:Parameters:
test : `nose.case.Test`_
the test case
err : 3-tuple
sys.exc_info() tuple
N( ( R
R6 R8 ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt
formatFailure s c C s d S( s Called on addError. To handle the error yourself and prevent normal
error processing, return a true value.
:Parameters:
test : `nose.case.Test`_
the test case
err : 3-tuple
sys.exc_info() tuple
N( ( R
R6 R8 ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt handleError s
c C s d S( s
Called on addFailure. To handle the failure yourself and
prevent normal failure processing, return a true value.
:Parameters:
test : `nose.case.Test`_
the test case
err : 3-tuple
sys.exc_info() tuple
N( ( R
R6 R8 ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt
handleFailure s
c C s d S( sc Return iterable of tests from a directory. May be a
generator. Each item returned must be a runnable
unittest.TestCase (or subclass) instance or suite instance.
Return None if your plugin cannot collect any tests from
directory.
:Parameters:
path : string
The path to the directory.
N( ( R
R> ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt loadTestsFromDir s c C s d S( sI Return iterable of tests in a module. May be a
generator. Each item returned must be a runnable
unittest.TestCase (or subclass) instance.
Return None if your plugin cannot
collect any tests from module.
:Parameters:
module : python module
The module object
N( ( R
RA ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt loadTestsFromModule s c C s d S( s Return tests in this file or module. Return None if you are not able
to load any tests, or an iterable if you are. May be a
generator.
:Parameters:
name : string
The test name. May be a file or module name plus a test
callable. Use split_test_name to split into parts. Or it might
be some crazy name of your own devising, in which case, do
whatever you want.
module : python module
Module from which the name is to be loaded
importPath :
Path from which file (must be a python module) was found
.. Note:: DEPRECATED: this argument will NOT be passed.
N( ( R
R RA t
importPath( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt loadTestsFromName s c C s d S( s Return a tuple of (tests loaded, remaining names). Return
None if you are not able to load any tests. Multiple plugins
may implement loadTestsFromNames; the remaining name list from
each will be passed to the next as input.
:Parameters:
names : iterable
List of test names.
module : python module
Module from which the names are to be loaded
N( ( R
t namesRA ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt loadTestsFromNames2 s c C s d S( s Return tests in this file. Return None if you are not
interested in loading any tests, or an iterable if you are and
can load some. May be a generator. *If you are interested in
loading tests from the file and encounter no errors, but find
no tests, yield False or return [False].*
.. Note:: This method replaces loadTestsFromPath from the 0.9
API.
:Parameters:
filename : string
The full path to the file or directory.
N( ( R
R@ ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt loadTestsFromFileB s c C s d S( sG
.. Note:: DEPRECATED -- use loadTestsFromFile instead
N( ( R
R> ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt loadTestsFromPathT s c C s d S( s Return tests in this test case class. Return None if you are
not able to load any tests, or an iterable if you are. May be a
generator.
:Parameters:
cls : class
The test case class. Must be subclass of unittest.TestCase.
N( ( R
R2 ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt loadTestsFromTestCase[ s c C s d S( s= Return tests in this test class. Class will *not* be a
unittest.TestCase subclass. Return None if you are not able to
load any tests, an iterable if you are. May be a generator.
:Parameters:
cls : class
The test class. Must NOT be subclass of unittest.TestCase.
N( ( R
R2 ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt loadTestsFromTestClassg s c C s d S( s Given an object and its parent, return or yield one or more
test cases. Each test must be a unittest.TestCase (or subclass)
instance. This is called before default test loading to allow
plugins to load an alternate test case or cases for an
object. May be a generator.
:Parameters:
obj : any object
The object to be made into a test
parent : class, module or other object
The parent of obj (eg, for a method, the class)
N( ( R
t objt parent( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt makeTestt s
c C s d S( s Called to allow plugin to register command line
options with the parser.
Do *not* return a value from this method unless you want to stop
all other plugins from setting their options.
N( ( R
R R ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyR s c C s d S( s Called before the test is run by the test runner. Please
note the article *the* in the previous sentence: prepareTest
is called *only once*, and is passed the test case or test
suite that the test runner will execute. It is *not* called
for each individual test case. If you return a non-None value,
that return value will be run as the test. Use this hook to
wrap or decorate the test with another function. If you need
to modify or wrap individual test cases, use `prepareTestCase`
instead.
:Parameters:
test : `nose.case.Test`_
the test case
N( ( R
R6 ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt prepareTest s c C s d S( s Prepare or wrap an individual test case. Called before
execution of the test. The test passed here is a
nose.case.Test instance; the case to be executed is in the
test attribute of the passed case. To modify the test to be
run, you should return a callable that takes one argument (the
test result object) -- it is recommended that you *do not*
side-effect the nose.case.Test instance you have been passed.
Keep in mind that when you replace the test callable you are
replacing the run() method of the test case -- including the
exception handling and result calls, etc.
:Parameters:
test : `nose.case.Test`_
the test case
N( ( R
R6 ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt prepareTestCase s c C s d S( s Called before tests are loaded. To replace the test loader,
return a test loader. To allow other plugins to process the
test loader, return None. Only one plugin may replace the test
loader. Only valid when using nose.TestProgram.
:Parameters:
loader : `nose.loader.TestLoader` or other loader instance
the test loader
N( ( R
t loader( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt prepareTestLoader s
c C s d S( sz Called before the first test is run. To use a different
test result handler for all tests than the given result,
return a test result handler. NOTE however that this handler
will only be seen by tests, that is, inside of the result
proxy system. The TestRunner and TestProgram -- whether nose's
or other -- will continue to see the original result
handler. For this reason, it is usually better to monkeypatch
the result (for instance, if you want to handle some
exceptions in a unique way). Only one plugin may replace the
result, but many may monkeypatch it. If you want to
monkeypatch and stop other plugins from doing so, monkeypatch
and return the patched result.
:Parameters:
result : `nose.result.TextTestResult` or other result instance
the test result
N( ( R
RI ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt prepareTestResult s c C s d S( sJ Called before tests are run. To replace the test runner,
return a test runner. To allow other plugins to process the
test runner, return None. Only valid when using nose.TestProgram.
:Parameters:
runner : `nose.core.TextTestRunner` or other runner instance
the test runner
N( ( R
t runner( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt prepareTestRunner s c C s d S( s; Called after all error output has been printed. Print your
plugin's report to the provided stream. Return None to allow
other plugins to print reports, any other value to stop them.
:Parameters:
stream : file-like object
stream object; send your output here
N( ( R
t stream( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt report s c C s d S( sc Called before test output begins. To direct test output to a
new stream, return a stream object, which must implement a
`write(msg)` method. If you only want to note the stream, not
capture or redirect it, then return None.
:Parameters:
stream : file-like object
the original output stream
N( ( R
Rd ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt setOutputStream s c C s d S( sp Called before context setup and the running of tests in the
context. Note that tests have already been *loaded* from the
context before this call.
:Parameters:
context : module, class or other object
the context about to be setup. May be a module or class, or any
other object that contains tests.
N( ( R
t context( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt startContext s
c C s d S( s Called before each test is run. DO NOT return a value unless
you want to stop other plugins from seeing the test start.
:Parameters:
test : `nose.case.Test`_
the test case
N( ( R
R6 ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt startTest s c C s d S( s Called after the tests in a context have run and the
context has been torn down.
:Parameters:
context : module, class or other object
the context that has just been torn down.
N( ( R
Rg ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt stopContext s c C s d S( s Called after each test is run. DO NOT return a value unless
you want to stop other plugins from seeing that the test has stopped.
:Parameters:
test : `nose.case.Test`_
the test case
N( ( R
R6 ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt stopTest s c C s d S( s Return a short test name. Called by `nose.case.Test.__str__`.
:Parameters:
test : `nose.case.Test`_
the test case
N( ( R
R6 ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt testName$ s c C s d S( s Return true if you want the main test selector to collect
tests from this class, false if you don't, and None if you don't
care.
:Parameters:
cls : class
The class being examined by the selector
N( ( R
R2 ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt wantClass. s c C s d S( s Return true if you want test collection to descend into this
directory, false if you do not, and None if you don't care.
:Parameters:
dirname : string
Full path to directory being examined by the selector
N( ( R
t dirname( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt
wantDirectory9 s c C s d S( s2 Return true if you want to collect tests from this file,
false if you do not and None if you don't care.
Change from 0.9: The optional package parameter is no longer passed.
:Parameters:
file : string
Full path to file being examined by the selector
N( ( R
t file( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt wantFileC s
c C s d S( s Return true to collect this function as a test, false to
prevent it from being collected, and None if you don't care.
:Parameters:
function : function
The function object being examined by the selector
N( ( R
t function( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt wantFunctionO s c C s d S( s Return true to collect this method as a test, false to
prevent it from being collected, and None if you don't care.
:Parameters:
method : unbound method
The method object being examined by the selector
N( ( R
t method( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt
wantMethodY s c C s d S( s+ Return true if you want to collection to descend into this
module, false to prevent the collector from descending into the
module, and None if you don't care.
:Parameters:
module : python module
The module object being examined by the selector
N( ( R
RA ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt
wantModulec s c C s d S( s
.. Note:: DEPRECATED -- this method will not be called, it has
been folded into wantModule.
N( ( R
RA ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt wantModuleTestsn s N(C R R, R' R5 R. R/ R R R t
deprecatedR7 R9 t changedR: R; R< R= t _newR? RB RC RD RE RF RG RH R& RJ RK RL t chainableR t static_argsRM RN RO RP t
generativeRQ R RS RU RV RW RX RY R\ R R] R^ R` Ra Rc Re Rf Rh Ri Rj Rk Rl Rm Ro Rq Rs Ru Rv Rw ( ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyR0 f s s
( R. R( t optparseR t warningsR t nose.utilR t objectR R0 ( ( ( s5 /usr/lib/python2.6/site-packages/nose/plugins/base.pyt s _