diff options
author | Tim Peters <tim.peters@gmail.com> | 2004-09-26 20:45:04 (GMT) |
---|---|---|
committer | Tim Peters <tim.peters@gmail.com> | 2004-09-26 20:45:04 (GMT) |
commit | 0041121c25b3281233a209f7140166744422f974 (patch) | |
tree | accfbdc0dcb4adc2540efc86343515c59e18402d /Doc/lib | |
parent | aa241e014979612e2c8851bf9b12c16bcc07b161 (diff) | |
download | cpython-0041121c25b3281233a209f7140166744422f974.zip cpython-0041121c25b3281233a209f7140166744422f974.tar.gz cpython-0041121c25b3281233a209f7140166744422f974.tar.bz2 |
Docs for run_docstring_examples().
Diffstat (limited to 'Doc/lib')
-rw-r--r-- | Doc/lib/libdoctest.tex | 30 |
1 files changed, 30 insertions, 0 deletions
diff --git a/Doc/lib/libdoctest.tex b/Doc/lib/libdoctest.tex index f9d6ba0..1b4b59e 100644 --- a/Doc/lib/libdoctest.tex +++ b/Doc/lib/libdoctest.tex @@ -944,6 +944,36 @@ sections \ref{doctest-simple-testmod} and and \var{exclude_empty} were added]{2.4} \end{funcdesc} +There's also a function to run the doctests associated with a single object. +This function is provided for backward compatibility. There are no plans +to deprecate it, but it's rarely useful: + +\begin{funcdesc}{run_docstring_examples}{f, globs\optional{, + verbose}\optional{, name}\optional{, + compileflags}\optional{, optionflags}} + + Test examples associated with object \var{f}; for example, \var{f} may + be a module, function, or class object. + + A shallow copy of dictionary argument \var{globs} is used for the + execution context. + + Optional argument \var{name} is used in failure messages, and defaults + to \code{"NoName"}. + + If optional argument \var{verbose} is true, output is generated even + if there are no failures. By default, output is generated only in case + of an example failure. + + Optional argument \var{compileflags} gives the set of flags that should + be used by the Python compiler when running the examples. By default, or + if \code{None}, flags are deduced corresponding to the set of future + features found in \var{globs}. + + Optional argument \var{optionflags} works as for function + \function{testfile()} above. +\end{funcdesc} + \subsection{Unittest API\label{doctest-unittest-api}} As your collection of doctest'ed modules grows, you'll want a way to run |