Change the docs to no longer claim that unittest is preferred over doctest for
regression tests.
This commit is contained in:
parent
3d52e5f07d
commit
27ef61ca18
|
@ -14,11 +14,11 @@ your tests while \module{test.regrtest} drives the testing suite.
|
||||||
|
|
||||||
Each module in the \module{test} package whose name starts with
|
Each module in the \module{test} package whose name starts with
|
||||||
\samp{test_} is a testing suite for a specific module or feature.
|
\samp{test_} is a testing suite for a specific module or feature.
|
||||||
All new tests should be written using the \refmodule{unittest} module;
|
All new tests should be written using the \refmodule{unittest} or
|
||||||
using \refmodule{unittest} is not required but makes the tests more
|
\refmodule{doctest} module. Some older tests are
|
||||||
flexible and maintenance of the tests easier. Some older tests are
|
written using a ``traditional'' testing style that compares output
|
||||||
written to use \refmodule{doctest} and a ``traditional'' testing
|
printed to \code{sys.stdout}; this style of test is considered
|
||||||
style; these styles of tests will not be covered.
|
deprecated.
|
||||||
|
|
||||||
\begin{seealso}
|
\begin{seealso}
|
||||||
\seemodule{unittest}{Writing PyUnit regression tests.}
|
\seemodule{unittest}{Writing PyUnit regression tests.}
|
||||||
|
@ -29,8 +29,8 @@ style; these styles of tests will not be covered.
|
||||||
\subsection{Writing Unit Tests for the \module{test} package%
|
\subsection{Writing Unit Tests for the \module{test} package%
|
||||||
\label{writing-tests}}
|
\label{writing-tests}}
|
||||||
|
|
||||||
It is preferred that tests for the \module{test} package use the
|
It is preferred that tests that use the \refmodule{unittest} module
|
||||||
\refmodule{unittest} module and follow a few guidelines.
|
follow a few guidelines.
|
||||||
One is to name the test module by starting it with \samp{test_} and end it with
|
One is to name the test module by starting it with \samp{test_} and end it with
|
||||||
the name of the module being tested.
|
the name of the module being tested.
|
||||||
The test methods in the test module should start with \samp{test_} and end with
|
The test methods in the test module should start with \samp{test_} and end with
|
||||||
|
|
Loading…
Reference in New Issue