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.


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.


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)