test¶
-
cygrid.test(**kwargs) [edit on github]¶ Run the tests for the package.
This method builds arguments for and then calls
pytest.main.- Parameters
- packagestr, 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.mainin theargskeyword argument.- docs_pathstr, optional
The path to the documentation .rst files.
- open_filesbool, optional
Fail when any tests leave files open. Off by default, because this adds extra run time to the test suite. Requires the
psutilpackage.- 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 thepytest-xdistplugin.- 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.
- pdbbool, optional
Turn on PDB post-mortem analysis for failing tests. Same as specifying
--pdbinargs.- pep8bool, optional
Turn on PEP8 checking via the pytest-pep8 plugin and disable normal tests. Same as specifying
--pep8 -k pep8inargs.- pluginslist, optional
Plugins to be passed to
pytest.mainin thepluginskeyword 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 isnone.- repeat
int, optional If set, specifies how many times each test should be run. This is useful for diagnosing sporadic failures.
- skip_docs
bool, 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 py.test. Passing True is the same as specifying
-vinargs.