TestRunner¶
-
class
astropy.tests.runner.
TestRunner
(base_path)[source] [edit on github]¶ Bases:
astropy.tests.runner.TestRunnerBase
A test runner for astropy tests
Attributes Summary
keywords
Methods Summary
args
(**kwargs)args : str, optional Additional arguments to be passed to pytest.main
in theargs
keyword argument.coverage
(**kwargs)docs_path
(**kwargs)docs_path : str, optional The path to the documentation .rst files. open_files
(**kwargs)open_files : bool, optional Fail when any tests leave files open. package
(**kwargs)package : str, optional The name of a specific package to test, e.g. parallel
(**kwargs)parallel : int or ‘auto’, optional When provided, run the tests in parallel on the specified number of CPUs. pastebin
(**kwargs)pastebin : (‘failed’, ‘all’, None), optional Convenience option for turning on py.test pastebin output. pdb
(**kwargs)pdb : bool, optional Turn on PDB post-mortem analysis for failing tests. pep8
(**kwargs)pep8 : bool, optional Turn on PEP8 checking via the pytest-pep8 plugin and disable normal tests. plugins
(**kwargs)plugins : list, optional Plugins to be passed to pytest.main
in theplugins
keyword argument.remote_data
(**kwargs)remote_data : {‘none’, ‘astropy’, ‘any’}, optional Controls whether to run tests marked with @remote_data. repeat
(**kwargs)repeat : int
, optional If set, specifies how many times each test should be run.run_tests
(**kwargs)Run the tests for the package. skip_docs
(**kwargs)skip_docs : bool
, optional WhenTrue
, skips running the doctests in the .rst files.test_path
(**kwargs)test_path : str, optional Specify location to test by path. verbose
(**kwargs)verbose : bool, optional Convenience option to turn on verbose output from py.test. Attributes Documentation
-
keywords
= {'args': None, 'coverage': None, 'docs_path': None, 'open_files': None, 'package': None, 'parallel': 0, 'pastebin': None, 'pdb': None, 'pep8': None, 'plugins': None, 'remote_data': u'none', 'repeat': None, 'skip_docs': None, 'test_path': None, 'verbose': None}¶
Methods Documentation
-
args
(**kwargs)[source] [edit on github]¶ - args : str, optional
- Additional arguments to be passed to
pytest.main
in theargs
keyword argument.
-
coverage
(**kwargs)[source] [edit on github]¶
-
docs_path
(**kwargs)[source] [edit on github]¶ - docs_path : str, optional
- The path to the documentation .rst files.
-
open_files
(**kwargs)[source] [edit on github]¶ - open_files : bool, optional
- Fail when any tests leave files open. Off by default, because
this adds extra run time to the test suite. Requires the
psutil
package.
-
package
(**kwargs)[source] [edit on github]¶ - package : str, optional
- The name of a specific package to test, e.g. ‘io.fits’ or ‘utils’. If nothing is specified all default Astropy tests are run.
-
parallel
(**kwargs)[source] [edit on github]¶ - parallel : int or ‘auto’, optional
- When provided, run the tests in parallel on the specified
number of CPUs. If parallel is
'auto'
, it will use the all the cores on the machine. Requires thepytest-xdist
plugin.
-
pastebin
(**kwargs)[source] [edit on github]¶ - pastebin : (‘failed’, ‘all’, None), optional
- Convenience option for turning on py.test pastebin output. Set to ‘failed’ to upload info for failed tests, or ‘all’ to upload info for all tests.
-
pdb
(**kwargs)[source] [edit on github]¶ - pdb : bool, optional
- Turn on PDB post-mortem analysis for failing tests. Same as
specifying
--pdb
inargs
.
-
pep8
(**kwargs)[source] [edit on github]¶ - pep8 : bool, optional
- Turn on PEP8 checking via the pytest-pep8 plugin and disable normal
tests. Same as specifying
--pep8 -k pep8
inargs
.
-
plugins
(**kwargs)[source] [edit on github]¶ - plugins : list, optional
- Plugins to be passed to
pytest.main
in theplugins
keyword argument.
-
remote_data
(**kwargs)[source] [edit on github]¶ - remote_data : {‘none’, ‘astropy’, ‘any’}, optional
- Controls whether to run tests marked with @remote_data. This can be
set to run no tests with remote data (
none
), only ones that use data from http://data.astropy.org (astropy
), or all tests that use remote data (any
). The default isnone
.
-
repeat
(**kwargs)[source] [edit on github]¶ - repeat :
int
, optional - If set, specifies how many times each test should be run. This is useful for diagnosing sporadic failures.
- repeat :
-
run_tests
(**kwargs)[source] [edit on github]¶ Run the tests for the package.
This method builds arguments for and then calls
pytest.main
.Parameters: package : str, optional
The name of a specific package to test, e.g. ‘io.fits’ or ‘utils’. If nothing is specified all default Astropy tests are run.
args : str, optional
Additional arguments to be passed to
pytest.main
in theargs
keyword argument.docs_path : str, optional
The path to the documentation .rst files.
open_files : bool, optional
Fail when any tests leave files open. Off by default, because this adds extra run time to the test suite. Requires the
psutil
package.parallel : int or ‘auto’, optional
When provided, run the tests in parallel on the specified number of CPUs. If parallel is
'auto'
, it will use the all the cores on the machine. Requires thepytest-xdist
plugin.pastebin : (‘failed’, ‘all’, None), optional
Convenience option for turning on py.test pastebin output. Set to ‘failed’ to upload info for failed tests, or ‘all’ to upload info for all tests.
pdb : bool, optional
Turn on PDB post-mortem analysis for failing tests. Same as specifying
--pdb
inargs
.pep8 : bool, optional
Turn on PEP8 checking via the pytest-pep8 plugin and disable normal tests. Same as specifying
--pep8 -k pep8
inargs
.plugins : list, optional
Plugins to be passed to
pytest.main
in theplugins
keyword argument.remote_data : {‘none’, ‘astropy’, ‘any’}, optional
Controls whether to run tests marked with @remote_data. This can be set to run no tests with remote data (
none
), only ones that use data from http://data.astropy.org (astropy
), or all tests that use remote data (any
). The default isnone
.repeat :
int
, optionalIf set, specifies how many times each test should be run. This is useful for diagnosing sporadic failures.
skip_docs :
bool
, optionalWhen
True
, skips running the doctests in the .rst files.test_path : str, optional
Specify location to test by path. May be a single file or directory. Must be specified absolutely or relative to the calling directory.
verbose : bool, optional
Convenience option to turn on verbose output from py.test. Passing True is the same as specifying
-v
inargs
.
-
skip_docs
(**kwargs)[source] [edit on github]¶ - skip_docs :
bool
, optional - When
True
, skips running the doctests in the .rst files.
- skip_docs :
-
test_path
(**kwargs)[source] [edit on github]¶ - test_path : str, optional
- Specify location to test by path. May be a single file or directory. Must be specified absolutely or relative to the calling directory.
-
verbose
(**kwargs)[source] [edit on github]¶ - verbose : bool, optional
- Convenience option to turn on verbose output from py.test. Passing
True is the same as specifying
-v
inargs
.
-