diff --git a/Doc/whatsnew/3.2.rst b/Doc/whatsnew/3.2.rst index 6a925699435..1a435ee2686 100644 --- a/Doc/whatsnew/3.2.rst +++ b/Doc/whatsnew/3.2.rst @@ -651,23 +651,33 @@ New, Improved, and Deprecated Modules as recommended in public uses of HTTPS. (Added by Antoine Pitrou, :issue:`9003`.) -* Instances of :class:`unittest.TestCase` have two new methods - :meth:`~unittest.TestCase.assertWarns` and :meth:`~unittest.TestCase.assertWarnsRegexp` - to check that a given warning type was triggered by the code under test:: +* The command call, ``python -m unittest`` can now accept file paths instead + of module names for running specific tests (:issue:`10620`). - with self.assertWarns(DeprecationWarning): - legacy_function('XYZ') +* The :mod:`unittest` module has two new methods, + :meth:`~unittest.TestCase.assertWarns` and + :meth:`~unittest.TestCase.assertWarnsRegex` to check that a given warning type + was triggered by the code under test: -* 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); + >>> with self.assertWarns(DeprecationWarning): + ... legacy_function('XYZ') - 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. + In addition, the naming in the module has ungone a number of clean-ups. + For example, :meth:`assertRegex` is the new name for :meth:`assertRegexpMatches` + which was misnamed because the test uses :func:`re.search`, not :func:`re.match`. + + To improve consistency, some of long-standing method aliases are being + deprecated in favor of the preferred names: + + - replace :meth:`assert_` with :meth:`.assertTrue` + - replace :meth:`assertEquals` with :meth:`.assertEqual` + - replace :meth:`assertNotEquals` with :meth:`.assertNotEqual` + - replace :meth:`assertAlmostEquals` with :meth:`.assertAlmostEqual` + - replace :meth:`assertNotAlmostEquals` with :meth:`.assertNotAlmostEqual` + + Likewise, the ``TestCase.fail*`` methods deprecated in Python 3.1 are expected + to be removed in Python 3.3. See also the :ref:`deprecated-aliases` section in + the :mod:`unittest` documentation. (Contributed by Ezio Melotti; :issue:`9424`.)