summaryrefslogtreecommitdiffstats
path: root/Doc/whatsnew/3.3.rst
diff options
context:
space:
mode:
authorR David Murray <rdmurray@bitdance.com>2012-10-02 22:24:56 (GMT)
committerR David Murray <rdmurray@bitdance.com>2012-10-02 22:24:56 (GMT)
commit3430fb803ed10ae99c038eba1a25a0fe42314a9d (patch)
treea772805481912b770b0ec3976b9cfc7aea69c382 /Doc/whatsnew/3.3.rst
parent30a13fb60e87881f665efdaea1950ad4d9ec5b92 (diff)
downloadcpython-3430fb803ed10ae99c038eba1a25a0fe42314a9d.zip
cpython-3430fb803ed10ae99c038eba1a25a0fe42314a9d.tar.gz
cpython-3430fb803ed10ae99c038eba1a25a0fe42314a9d.tar.bz2
More whatsnew updates.
Diffstat (limited to 'Doc/whatsnew/3.3.rst')
-rw-r--r--Doc/whatsnew/3.3.rst71
1 files changed, 54 insertions, 17 deletions
diff --git a/Doc/whatsnew/3.3.rst b/Doc/whatsnew/3.3.rst
index bdf90fa..f5fd3bf 100644
--- a/Doc/whatsnew/3.3.rst
+++ b/Doc/whatsnew/3.3.rst
@@ -1328,7 +1328,24 @@ standard Content Transfer Encodings.
Other API Changes
~~~~~~~~~~~~~~~~~
-Added :class:`email.parser.BytesHeaderParser`.
+New :class:`~email.parser.BytesHeaderParser`, added to the :mod:`~email.parser`
+module to complement :class:`~email.parser.HeaderParser` and complete the Bytes
+API.
+
+New utility functions:
+
+ * :func:`~email.utils.format_datetime`: given a :class:`~datetime.datetime`,
+ produce a string formatted for use in an email header.
+
+ * :func:`~email.utils.parsedate_to_datetime`: given a date string from
+ an email header, convert it into an aware :class:`~datetime.datetime`,
+ or a naive :class:`~datetime.datetime` if the offset is ``-0000``.
+
+ * :func:`~email.utils.localtime`: With no argument, returns the
+ current local time as an aware :class:`~datetime.datetime` using the local
+ :class:`~datetime.timezone`. Given an aware :class:`~datetime.datetime`,
+ converts it into an aware :class:`~datetime.datetime` using the
+ local :class:`~datetime.timezone`.
ftplib
@@ -1453,8 +1470,14 @@ providing a user-supplied binary function.
logging
-------
-:func:`~logging.basicConfig` now supports an optional ``handlers`` argument
-taking an iterable of handlers to be added to the root logger.
+The :func:`~logging.basicConfig` function now supports an optional ``handlers``
+argument taking an iterable of handlers to be added to the root logger.
+
+A class level attribute :attr:`~logging.handlers.SysLogHandler.append_nul` has
+been added to :class:`~logging.handlers.SysLogHandler` to allow control of the
+appending of the ``NUL`` (``\000``) byte to syslog records, since for some
+deamons it is required while for others it is passed through to the log.
+
math
@@ -1466,6 +1489,15 @@ the base-2 logarithm of *x*.
(Written by Mark Dickinson in :issue:`11888`).
+mmap
+----
+
+The :meth:`~mmap.mmap.read` method is now more compatible with other file-like
+objects: if the argument is omitted or specified as ``None``, it returns the
+bytes from the current file position to the end of the mapping. (Contributed
+by Petri Lehtinen in :issue:`12021`.)
+
+
multiprocessing
---------------
@@ -1752,14 +1784,6 @@ signal
instead of a RuntimeError: OSError has an errno attribute.
-smtp
-----
-
-:class:`~smtplib.SMTP` now supports the context manager protocol, allowing an
-``SMTP`` instance to be used in a ``with`` statement. (Contributed
-by Giampaolo Rodolà in :issue:`11289`.)
-
-
smtpd
-----
@@ -1775,11 +1799,13 @@ Orrù and Dan Boswell. :issue:`8739`)
smtplib
-------
+:class:`~smtplib.SMTP` now supports the context manager protocol, allowing an
+``SMTP`` instance to be used in a ``with`` statement. (Contributed
+by Giampaolo Rodolà in :issue:`11289`.)
+
The :class:`~smtplib.SMTP_SSL` constructor and the :meth:`~smtplib.SMTP.starttls`
method now accept an SSLContext parameter to control parameters of the secure
-channel.
-
-(Contributed by Kasun Herath in :issue:`8809`)
+channel. (Contributed by Kasun Herath in :issue:`8809`)
socket
@@ -1942,6 +1968,10 @@ Other new functions:
:func:`~time.clock_settime` functions with ``CLOCK_xxx`` constants.
(Contributed by Victor Stinner in :issue:`10278`)
+To improve cross platform consistency, :func:`~time.sleep` now raises a
+:exc:`ValueError` when passed a negative sleep value. Previously this was an
+error on posix, but produced an infinite sleep on Windows.
+
types
-----
@@ -2283,9 +2313,16 @@ Porting Python code
* The deprecated variable ``time.accept2dyear`` has been removed.
-* The undocumented internal helper class ``SSLFakeFile`` has been
- removed from :mod:`smtplib`, since its functionality has long been
- provided directly by :meth:`socket.socket.makefile`.
+* The undocumented internal helper class ``SSLFakeFile`` has been removed
+ from :mod:`smtplib`, since its functionality has long been provided directly
+ by :meth:`socket.socket.makefile`.
+
+* Passing a negative value to :func:`time.sleep` on Windows now raises an
+ error instead of sleeping forever. It has always raised an error on posix.
+
+* The ``ast.__version__`` constant has been removed. If you need to
+ make decisions affected by the AST version, use :attr:`sys.version_info`
+ to make the decision.
Porting C code