diff options
| author | Ezio Melotti <ezio.melotti@gmail.com> | 2010-11-22 12:56:58 (GMT) |
|---|---|---|
| committer | Ezio Melotti <ezio.melotti@gmail.com> | 2010-11-22 12:56:58 (GMT) |
| commit | 2baf1a69f4d72e2107b0941a625fd7603f45ae38 (patch) | |
| tree | cbd05dd5996a313b0cb813e2d8d01819b6154244 /Doc | |
| parent | 60fafa276cefc677839927a0647c8bda3703be0b (diff) | |
| download | cpython-2baf1a69f4d72e2107b0941a625fd7603f45ae38.zip cpython-2baf1a69f4d72e2107b0941a625fd7603f45ae38.tar.gz cpython-2baf1a69f4d72e2107b0941a625fd7603f45ae38.tar.bz2 | |
#9424: add a DeprecationWarning for assertEquals, assertNotEquals, assertAlmostEquals, assertNotAlmostEquals, and assert_
Diffstat (limited to 'Doc')
| -rw-r--r-- | Doc/library/unittest.rst | 28 | ||||
| -rw-r--r-- | Doc/whatsnew/3.2.rst | 12 |
2 files changed, 28 insertions, 12 deletions
diff --git a/Doc/library/unittest.rst b/Doc/library/unittest.rst index 640ed4b..91fede0 100644 --- a/Doc/library/unittest.rst +++ b/Doc/library/unittest.rst @@ -1401,6 +1401,8 @@ Test cases :mod:`unittest`-based test framework. +.. _deprecated-aliases: + Deprecated aliases ################## @@ -1408,20 +1410,22 @@ For historical reasons, some of the :class:`TestCase` methods had one or more aliases that are now deprecated. The following table lists the correct names along with their deprecated aliases: - ============================== =============================== - Method Name Deprecated alias(es) - ============================== =============================== - :meth:`.assertEqual` failUnlessEqual, assertEquals - :meth:`.assertNotEqual` failIfEqual - :meth:`.assertTrue` failUnless, assert\_ + ============================== ====================== ====================== + Method Name Deprecated alias Deprecated alias + ============================== ====================== ====================== + :meth:`.assertEqual` failUnlessEqual assertEquals + :meth:`.assertNotEqual` failIfEqual assertNotEquals + :meth:`.assertTrue` failUnless assert\_ :meth:`.assertFalse` failIf :meth:`.assertRaises` failUnlessRaises - :meth:`.assertAlmostEqual` failUnlessAlmostEqual - :meth:`.assertNotAlmostEqual` failIfAlmostEqual - ============================== =============================== - - .. deprecated:: 3.1 - the aliases listed in the second column + :meth:`.assertAlmostEqual` failUnlessAlmostEqual assertAlmostEquals + :meth:`.assertNotAlmostEqual` failIfAlmostEqual assertNotAlmostEquals + ============================== ====================== ====================== + + .. deprecated-removed:: 3.1 3.3 + the fail* aliases listed in the second column. + .. deprecated:: 3.2 + the assert* aliases listed in the third column. diff --git a/Doc/whatsnew/3.2.rst b/Doc/whatsnew/3.2.rst index dd47129..c4b5125 100644 --- a/Doc/whatsnew/3.2.rst +++ b/Doc/whatsnew/3.2.rst @@ -506,6 +506,18 @@ New, Improved, and Deprecated Modules with self.assertWarns(DeprecationWarning): legacy_function('XYZ') +* The following :class:`unittest.TestCase` methods are now deprecated: + * :meth:`assert_` (use :meth:`.assertTrue` instead); + * :meth:`assertEquals` (use :meth:`.assertEqual` instead); + * :meth:`assertNotEquals` (use :meth:`.assertNotEqual` instead); + * :meth:`assertAlmostEquals` (use :meth:`.assertAlmostEqual` instead); + * :meth:`assertNotAlmostEquals` (use :meth:`.assertNotAlmostEqual` instead); + + The ``TestCase.fail*`` methods deprecated in Python 3.1 will be removed in + Python 3.3. See also the :ref:`deprecated-aliases` section in the + :mod:`unittest` documentation. + + (Contributed by Ezio Melotti; :issue:`9424`.) * The previously deprecated :func:`string.maketrans` function has been removed in favor of the static methods, :meth:`bytes.maketrans` and |