From 30a13fb60e87881f665efdaea1950ad4d9ec5b92 Mon Sep 17 00:00:00 2001 From: Nick Coghlan Date: Tue, 2 Oct 2012 21:29:59 +0530 Subject: Reword the next version placeholder now that the changelog is part of the published What's New docs --- Misc/NEWS | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/Misc/NEWS b/Misc/NEWS index 8dae861..1f9e644 100644 --- a/Misc/NEWS +++ b/Misc/NEWS @@ -5,7 +5,9 @@ Python News What's New in Python 3.3.1? =========================== -*Release date: XX-XXX-2012* +*Not yet released, see sections below for changes released in 3.3.0* + +.. *Release date: XX-XXX-2012* Core and Builtins ----------------- -- cgit v0.12 From 3430fb803ed10ae99c038eba1a25a0fe42314a9d Mon Sep 17 00:00:00 2001 From: R David Murray Date: Tue, 2 Oct 2012 18:24:56 -0400 Subject: More whatsnew updates. --- Doc/whatsnew/3.3.rst | 71 +++++++++++++++++++++++++++++++++++++++------------- Misc/NEWS | 2 +- 2 files changed, 55 insertions(+), 18 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 diff --git a/Misc/NEWS b/Misc/NEWS index 1f9e644..e5ac247 100644 --- a/Misc/NEWS +++ b/Misc/NEWS @@ -3147,7 +3147,7 @@ Library - Issue #12352: Fix a deadlock in multiprocessing.Heap when a block is freed by the garbage collector while the Heap lock is held. -- Issue #12462: time.sleep() now calls immediatly the (Python) signal handler +- Issue #12462: time.sleep() now immediately calls the (Python) signal handler if it is interrupted by a signal, instead of having to wait until the next instruction. -- cgit v0.12