{ } Raw JSON

bundles / astropy 7.0.1 / astropy / tests / runner / TestRunner / run_tests

function

astropy.tests.runner:TestRunner.run_tests

source: /astropy/tests/runner.py :574

Signature

def   run_tests ( self ** kwargs )

Summary

Run the tests for the package.

Extended Summary

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'. Accepts comma separated string to specify multiple
packages. If nothing is specified all default tests are run.

argsstr, optional

Additional arguments to be passed to ``pytest.main`` in the ``args``
keyword argument.

docs_pathstr, optional

The path to the documentation .rst files.

parallelint 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 the ``pytest-xdist`` plugin.

pastebin('failed', 'all', None), optional

Convenience option for turning on pytest pastebin output. Set to
'failed' to upload info for failed tests, or 'all' to upload info
for all tests.

pdbbool, optional

Turn on PDB post-mortem analysis for failing tests. Same as
specifying ``--pdb`` in ``args``.

pluginslist, optional

Plugins to be passed to ``pytest.main`` in the ``plugins`` keyword
argument.

remote_data{'none', 'astropy', 'any'}, optional

Controls whether to run tests marked with @pytest.mark.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 is ``none``.

repeatint, optional

If set, specifies how many times each test should be run. This is
useful for diagnosing sporadic failures.

skip_docsbool, optional

When `True`, skips running the doctests in the .rst files.

test_pathstr, optional

Specify location to test by path. May be a single file or
directory. Must be specified absolutely or relative to the
calling directory.

verbosebool, optional

Convenience option to turn on verbose output from pytest. Passing
True is the same as specifying ``-v`` in ``args``.

Aliases

  • astropy.tests.runner.TestRunner.run_tests