Signal a test failure if *expr* is false; the explanation for the error
will be *msg* if given, otherwise it will be :const:`None`.
- .. deprecated:: 2.7
+ .. deprecated:: 3.1
:meth:`failUnless`.
registers :meth:`addTypeEqualityFunc` the type specific equality function
will be called in order to generate a more useful default error message.
- .. versionchanged:: 2.7
+ .. versionchanged:: 3.1
Added the automatic calling of type specific equality function.
- .. deprecated:: 2.7
+ .. deprecated:: 3.1
:meth:`failUnlessEqual`.
default value for *msg* can be computed to include representations of both
*first* and *second*.
- .. deprecated:: 2.7
+ .. deprecated:: 3.1
:meth:`failIfEqual`.
compare equal, the test will fail with the explanation given by *msg*, or
:const:`None`.
- .. deprecated:: 2.7
+ .. deprecated:: 3.1
:meth:`failUnlessAlmostEqual`.
compare equal, the test will fail with the explanation given by *msg*, or
:const:`None`.
- .. deprecated:: 2.7
+ .. deprecated:: 3.1
:meth:`failIfAlmostEqual`.
>>> self.assertGreaterEqual(3, 4)
AssertionError: "3" unexpectedly not greater than or equal to "4"
- .. versionadded:: 2.7
+ .. versionadded:: 3.1
.. method:: assertMultiLineEqual(self, first, second, msg=None)
If specified *msg* will be used as the error message on failure.
- .. versionadded:: 2.7
+ .. versionadded:: 3.1
.. method:: assertRegexpMatches(text, regexp[, msg=None]):
a regular expression object or a string containing a regular expression
suitable for use by :func:`re.search`.
- .. versionadded:: 2.7
+ .. versionadded:: 3.1
.. method:: assertIn(first, second, msg=None)
If specified *msg* will be used as the error message on failure.
- .. versionadded:: 2.7
+ .. versionadded:: 3.1
.. method:: assertSameElements(expected, actual, msg=None)
If specified *msg* will be used as the error message on failure.
- .. versionadded:: 2.7
+ .. versionadded:: 3.1
.. method:: assertSetEqual(set1, set2, msg=None)
If specified *msg* will be used as the error message on failure.
- .. versionadded:: 2.7
+ .. versionadded:: 3.1
.. method:: assertDictEqual(expected, actual, msg=None)
If specified *msg* will be used as the error message on failure.
- .. versionadded:: 2.7
+ .. versionadded:: 3.1
.. method:: assertDictContainsSubset(expected, actual, msg=None)
If specified *msg* will be used as the error message on failure.
- .. versionadded:: 2.7
+ .. versionadded:: 3.1
.. method:: assertListEqual(list1, list2, msg=None)
If specified *msg* will be used as the error message on failure.
- .. versionadded:: 2.7
+ .. versionadded:: 3.1
.. method:: assertSequenceEqual(seq1, seq2, msg=None, seq_type=None)
This method is used to implement :meth:`assertListEqual` and
:meth:`assertTupleEqual`.
- .. versionadded:: 2.7
+ .. versionadded:: 3.1
.. method:: assertRaises(exception[, callable, ...])
.. versionchanged:: 3.1
Added the ability to use :meth:`assertRaises` as a context manager.
- .. deprecated:: 2.7
+ .. deprecated:: 3.1
:meth:`failUnlessRaises`.
with self.assertRaisesRegexp(ValueError, 'literal'):
int('XYZ')
- .. versionadded:: 2.7
+ .. versionadded:: 3.1
.. method:: assertIsNone(expr[, msg])
This signals a test failure if *expr* is not None.
- .. versionadded:: 2.7
+ .. versionadded:: 3.1
.. method:: assertIsNotNone(expr[, msg])
The inverse of the :meth:`assertIsNone` method.
This signals a test failure if *expr* is None.
- .. versionadded:: 2.7
+ .. versionadded:: 3.1
.. method:: assertFalse(expr[, msg])
This signals a test failure if *expr* is true, with *msg* or :const:`None`
for the error message.
- .. deprecated:: 2.7
+ .. deprecated:: 3.1
:meth:`failIf`.
The class setting can be overridden in individual tests by assigning an
instance attribute to True or False before calling the assert methods.
- .. versionadded:: 2.7
+ .. versionadded:: 3.1
Testing frameworks can use the following methods to collect information on
returns the first line of the test method's docstring, if available,
along with the method name.
- .. versionchanged:: 2.7
+ .. versionchanged:: 3.1
In earlier versions this only returned the first line of the test
method's docstring, if available or the :const:`None`. That led to
is to raise self.failureException with an error message useful
for debugging the by explaining the inequalities in detail.
- .. versionadded:: 2.7
+ .. versionadded:: 3.1
.. class:: FunctionTestCase(testFunc[, setUp[, tearDown[, description]]])
(Contributed by Gregory Smith.)
+* The :mod:`logging` module now implements a simple :class:`NullHandler`
+ class for applications that are not using logging but are calling
+ library code that does. Setting-up a null handler will suppress
+ spurious warnings like "No handlers could be found for logger X.Y.Z"::
+
+ >>> h = logging.NullHandler()
+ >>> logging.getLogger("foo").addHandler(h)
+
+ (Contributed by Vinay Sajip; issue:`4384`).
+
* The :mod:`runpy` module which supports the ``-m`` command line switch
now supports the execution of packages by looking for and executing
a ``__main__`` submodule when a package name is supplied.
def test_gimzo_without_required_library(self):
...
- (Contributed by Benjamin Peterson.)
+ Also, tests for exceptions have been builtout to work with context managers::
+
+ def test_division_by_zero(self):
+ with self.assertRaises(ZeroDivisionError):
+ x / 0
+
+ In addition, several new assertion methods were added including
+ :func:`assertSetEqual`, :func:`assertDictEqual`,
+ :func:`assertDictContainsSubset`, :func:`assertListEqual`,
+ :func:`assertTupleEqual`, :func:`assertSequenceEqual`,
+ :func:`assertRaisesRegexp`, :func:`assertIsNone`,
+ and :func:`assertIsNotNot`.
+
+ (Contributed by Benjamin Peterson and Antoine Pitrou.)
+
+* The :mod:`io` module has three new constants for :meth:`seek`:
+ method :data:`SEEK_SET`, :data:`SEEK_CUR`, and :data:`SEEK_END`.
+
+* The :attr:`sys.version_info` tuple is now a named tuple::
+
+ >>> sys.version_info
+ sys.version_info(major=3, minor=1, micro=0, releaselevel='alpha', serial=2)
+
+ (Contributed by Ross Light; :issue:`4285`.)
* A new module, :mod:`importlib` was added. It provides a complete, portable,
pure Python reference implementation of the *import* statement and its
its performance. The code is expected to be added in-time for the beta
release.
- (Contributed by Bob Ippolito.)
+ (Contributed by Bob Ippolito and converted to Py3.1 by Antoine Pitrou;
+ :issue:`4136`.)
+
+Build and C API Changes
+=======================
+
+Changes to Python's build process and to the C API include:
* Integers are now stored internally either in base 2**15 or in base
2**30, the base being determined at build time. Previously, they
(Contributed by Mark Dickinson; :issue:`4258`.)
+* The :cfunc:`PyLong_AsUnsignedLongLong()` function now handles a negative
+ *pylong* by raising :exc:`OverflowError` instead of :exc:`TypeError`.
+
+ (Contributed by Mark Dickinson and Lisandro Dalcrin; :issue:`5175`.)
+
+* Deprecated :cfunc:`PyNumber_Int`. Use :cfunc:`PyNumber_Long` instead.
+
+ (Contributed by Mark Dickinson; :issue;`4910`.)
projects / python / commitdiff