Unverified Kaydet (Commit) dff46758 authored tarafından Gregory P. Smith's avatar Gregory P. Smith Kaydeden (comit) GitHub

bpo-19950: Clarify unittest TestCase instance use. (GH-6875)

üst 3ab0136a
...@@ -361,8 +361,9 @@ testing code:: ...@@ -361,8 +361,9 @@ testing code::
Note that in order to test something, we use one of the :meth:`assert\*` Note that in order to test something, we use one of the :meth:`assert\*`
methods provided by the :class:`TestCase` base class. If the test fails, an methods provided by the :class:`TestCase` base class. If the test fails, an
exception will be raised, and :mod:`unittest` will identify the test case as a exception will be raised with an explanatory message, and :mod:`unittest`
:dfn:`failure`. Any other exceptions will be treated as :dfn:`errors`. will identify the test case as a :dfn:`failure`. Any other exceptions will be
treated as :dfn:`errors`.
Tests can be numerous, and their set-up can be repetitive. Luckily, we Tests can be numerous, and their set-up can be repetitive. Luckily, we
can factor out set-up code by implementing a method called can factor out set-up code by implementing a method called
...@@ -408,13 +409,18 @@ after the test method has been run:: ...@@ -408,13 +409,18 @@ after the test method has been run::
If :meth:`~TestCase.setUp` succeeded, :meth:`~TestCase.tearDown` will be If :meth:`~TestCase.setUp` succeeded, :meth:`~TestCase.tearDown` will be
run whether the test method succeeded or not. run whether the test method succeeded or not.
Such a working environment for the testing code is called a :dfn:`fixture`. Such a working environment for the testing code is called a
:dfn:`test fixture`. A new TestCase instance is created as a unique
Test case instances are grouped together according to the features they test. test fixture used to execute each individual test method. Thus
:mod:`unittest` provides a mechanism for this: the :dfn:`test suite`, `~TestCase.setUp`, `~TestCase.tearDown`, and `~TestCase.__init__`
represented by :mod:`unittest`'s :class:`TestSuite` class. In most cases, will be called once per test.
calling :func:`unittest.main` will do the right thing and collect all the
module's test cases for you, and then execute them. It is recommended that you use TestCase implementations to group tests together
according to the features they test. :mod:`unittest` provides a mechanism for
this: the :dfn:`test suite`, represented by :mod:`unittest`'s
:class:`TestSuite` class. In most cases, calling :func:`unittest.main` will do
the right thing and collect all the module's test cases for you and execute
them.
However, should you want to customize the building of your test suite, However, should you want to customize the building of your test suite,
you can do it yourself:: you can do it yourself::
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment