SciPy

numpy.testing.rundocs

numpy.testing.rundocs(filename=None, raise_on_error=True)[source]

Run doctests found in the given file.

By default rundocs raises an AssertionError on failure.

Parameters:
filename : str

The path to the file for which the doctests are run.

raise_on_error : bool

Whether to raise an AssertionError when a doctest fails. Default is True.

Notes

The doctests can be run by the user/developer by adding the doctests argument to the test() call. For example, to run all tests (including doctests) for numpy.lib:

>>> np.lib.test(doctests=True)  # doctest: +SKIP

Previous topic

numpy.testing.run_module_suite

Next topic

numpy.testing.suppress_warnings