[Python-checkins] cpython (merge 3.3 -> 3.3): merge heads
benjamin.peterson
python-checkins at python.org
Tue Oct 9 17:16:51 CEST 2012
http://hg.python.org/cpython/rev/4d5cb87230f4
changeset: 79628:4d5cb87230f4
branch: 3.3
parent: 79626:332b93ce7bf9
parent: 79623:ff925e135e60
user: Benjamin Peterson <benjamin at python.org>
date: Tue Oct 09 11:16:26 2012 -0400
summary:
merge heads
files:
Doc/Makefile | 2 +-
Doc/c-api/unicode.rst | 2 -
Doc/glossary.rst | 2 +-
Doc/howto/ipaddress.rst | 27 +-
Doc/howto/urllib2.rst | 29 +-
Doc/library/collections.rst | 22 +-
Doc/library/concurrency.rst | 1 +
Doc/library/concurrent.rst | 6 +
Doc/library/configparser.rst | 14 +-
Doc/library/doctest.rst | 28 +-
Doc/library/dummy_threading.rst | 2 +-
Doc/library/ftplib.rst | 18 +-
Doc/library/functions.rst | 3 +-
Doc/library/gc.rst | 6 +-
Doc/library/html.rst | 7 +
Doc/library/http.rst | 11 +
Doc/library/internet.rst | 3 +
Doc/library/ipaddress.rst | 21 +-
Doc/library/markup.rst | 9 +-
Doc/library/multiprocessing.rst | 6 +-
Doc/library/os.rst | 19 +-
Doc/library/socketserver.rst | 18 +-
Doc/library/sqlite3.rst | 448 +-
Doc/library/subprocess.rst | 71 +-
Doc/library/tempfile.rst | 3 +
Doc/library/threading.rst | 313 +-
Doc/library/time.rst | 2 +-
Doc/library/timeit.rst | 269 +-
Doc/library/urllib.rst | 9 +
Doc/library/xml.etree.elementtree.rst | 22 +-
Doc/library/xml.rst | 29 +
Doc/library/xmlrpc.rst | 12 +
Doc/library/zipfile.rst | 24 +-
Doc/make.bat | 2 +-
Doc/reference/datamodel.rst | 2 +-
Doc/reference/expressions.rst | 14 +-
Doc/reference/lexical_analysis.rst | 4 +-
Doc/tools/sphinxext/indexsidebar.html | 2 +-
Doc/tools/sphinxext/layout.html | 59 +-
Doc/tools/sphinxext/pyspecific.py | 42 +
Doc/tools/sphinxext/susp-ignored.csv | 12 +
Doc/using/windows.rst | 2 +
Doc/whatsnew/3.3.rst | 1545 +-
Doc/whatsnew/changelog.rst | 6 +
Doc/whatsnew/index.rst | 8 +
Include/unicodeobject.h | 3 +-
Lib/bz2.py | 105 +-
Lib/codecs.py | 2 +-
Lib/ctypes/__init__.py | 2 +-
Lib/ctypes/test/test_win32.py | 22 +
Lib/idlelib/config-extensions.def | 2 +
Lib/ipaddress.py | 7 +-
Lib/logging/handlers.py | 10 +-
Lib/platform.py | 12 +-
Lib/pstats.py | 6 +-
Lib/socketserver.py | 2 +-
Lib/subprocess.py | 9 +-
Lib/test/subprocessdata/sigchild_ignore.py | 11 +-
Lib/test/test_capi.py | 11 +
Lib/test/test_httpservers.py | 1 +
Lib/test/test_subprocess.py | 156 +-
Lib/test/test_threaded_import.py | 4 +-
Lib/test/test_xml_etree.py | 44 +-
Lib/xml/etree/ElementTree.py | 4 +-
Misc/ACKS | 6 +-
Misc/HISTORY | 5397 +++++++++
Misc/NEWS | 5965 +---------
Modules/_codecsmodule.c | 4 +-
Modules/_datetimemodule.c | 7 +-
Modules/_decimal/libmpdec/typearith.h | 32 +-
Modules/_decimal/libmpdec/umodarith.h | 156 +-
Modules/_decimal/tests/bench.py | 9 +-
Modules/_elementtree.c | 279 +-
Modules/_randommodule.c | 3 +-
Modules/_testcapimodule.c | 2 +-
Modules/arraymodule.c | 12 +-
Modules/audioop.c | 4 +-
Modules/zipimport.c | 43 +-
Objects/longobject.c | 24 +-
Objects/rangeobject.c | 5 +-
Objects/sliceobject.c | 3 +-
Objects/tupleobject.c | 12 +-
Objects/unicodeobject.c | 44 +-
Parser/asdl_c.py | 2 +-
setup.py | 1 +
85 files changed, 8328 insertions(+), 7251 deletions(-)
diff --git a/Doc/Makefile b/Doc/Makefile
--- a/Doc/Makefile
+++ b/Doc/Makefile
@@ -53,7 +53,7 @@
fi
@if [ ! -d tools/pygments ]; then \
echo "Checking out Pygments..."; \
- svn checkout $(SVNROOT)/external/Pygments-1.3.1/pygments tools/pygments; \
+ svn checkout $(SVNROOT)/external/Pygments-1.5dev-20120930/pygments tools/pygments; \
fi
update: clean checkout
diff --git a/Doc/c-api/unicode.rst b/Doc/c-api/unicode.rst
--- a/Doc/c-api/unicode.rst
+++ b/Doc/c-api/unicode.rst
@@ -1083,8 +1083,6 @@
After completion, *\*byteorder* is set to the current byte order at the end
of input data.
- In a narrow build codepoints outside the BMP will be decoded as surrogate pairs.
-
If *byteorder* is *NULL*, the codec starts in native order mode.
Return *NULL* if an exception was raised by the codec.
diff --git a/Doc/glossary.rst b/Doc/glossary.rst
--- a/Doc/glossary.rst
+++ b/Doc/glossary.rst
@@ -660,7 +660,7 @@
sequence
An :term:`iterable` which supports efficient element access using integer
indices via the :meth:`__getitem__` special method and defines a
- :meth:`len` method that returns the length of the sequence.
+ :meth:`__len__` method that returns the length of the sequence.
Some built-in sequence types are :class:`list`, :class:`str`,
:class:`tuple`, and :class:`bytes`. Note that :class:`dict` also
supports :meth:`__getitem__` and :meth:`__len__`, but is considered a
diff --git a/Doc/howto/ipaddress.rst b/Doc/howto/ipaddress.rst
--- a/Doc/howto/ipaddress.rst
+++ b/Doc/howto/ipaddress.rst
@@ -1,7 +1,7 @@
.. _ipaddress-howto:
***************************************
-An Introduction to the ipaddress module
+An introduction to the ipaddress module
***************************************
:author: Peter Moody
@@ -47,7 +47,12 @@
when working with IP addressing. The simplest way to create addresses is
to use the :func:`ipaddress.ip_address` factory function, which automatically
determines whether to create an IPv4 or IPv6 address based on the passed in
-value::
+value:
+
+.. testsetup::
+ >>> import ipaddress
+
+::
>>> ipaddress.ip_address('192.0.2.1')
IPv4Address('192.0.2.1')
@@ -142,7 +147,7 @@
>>> ipaddress.ip_interface('192.0.2.1/24')
IPv4Interface('192.0.2.1/24')
- >>> ipaddress.ip_network('2001:db8::1/96')
+ >>> ipaddress.ip_interface('2001:db8::1/96')
IPv6Interface('2001:db8::1/96')
Integer inputs are accepted (as with networks), and use of a particular IP
@@ -177,22 +182,22 @@
Finding out how many individual addresses are in a network::
>>> net4 = ipaddress.ip_network('192.0.2.0/24')
- >>> net4.numhosts
+ >>> net4.num_addresses
256
>>> net6 = ipaddress.ip_network('2001:db8::0/96')
- >>> net6.numhosts
+ >>> net6.num_addresses
4294967296
Iterating through the "usable" addresses on a network::
>>> net4 = ipaddress.ip_network('192.0.2.0/24')
>>> for x in net4.hosts():
- print(x)
+ ... print(x) # doctest: +ELLIPSIS
192.0.2.1
192.0.2.2
192.0.2.3
192.0.2.4
- <snip>
+ ...
192.0.2.252
192.0.2.253
192.0.2.254
@@ -216,9 +221,9 @@
Exploding or compressing the address::
>>> addr6.exploded
- '2001:0db8:0000:0000:0000:0000:0000:0000'
+ '2001:0db8:0000:0000:0000:0000:0000:0001'
>>> addr6.compressed
- '2001:db8::'
+ '2001:db8::1'
>>> net6.exploded
'2001:0db8:0000:0000:0000:0000:0000:0000/96'
>>> net6.compressed
@@ -241,9 +246,9 @@
>>> net4[-1]
IPv4Address('192.0.2.255')
>>> net6[1]
- IPv6Address('2001::1')
+ IPv6Address('2001:db8::1')
>>> net6[-1]
- IPv6Address('2001::ffff:ffff')
+ IPv6Address('2001:db8::ffff:ffff')
It also means that network objects lend themselves to using the list
diff --git a/Doc/howto/urllib2.rst b/Doc/howto/urllib2.rst
--- a/Doc/howto/urllib2.rst
+++ b/Doc/howto/urllib2.rst
@@ -144,7 +144,7 @@
>>> data['location'] = 'Northampton'
>>> data['language'] = 'Python'
>>> url_values = urllib.parse.urlencode(data)
- >>> print(url_values)
+ >>> print(url_values) # The order may differ from below. #doctest: +SKIP
name=Somebody+Here&language=Python&location=Northampton
>>> url = 'http://www.example.com/example.cgi'
>>> full_url = url + '?' + url_values
@@ -214,9 +214,9 @@
>>> req = urllib.request.Request('http://www.pretend_server.org')
>>> try: urllib.request.urlopen(req)
- >>> except urllib.error.URLError as e:
- >>> print(e.reason)
- >>>
+ ... except urllib.error.URLError as e:
+ ... print(e.reason) #doctest: +SKIP
+ ...
(4, 'getaddrinfo failed')
@@ -322,18 +322,17 @@
>>> req = urllib.request.Request('http://www.python.org/fish.html')
>>> try:
- >>> urllib.request.urlopen(req)
- >>> except urllib.error.HTTPError as e:
- >>> print(e.code)
- >>> print(e.read())
- >>>
+ ... urllib.request.urlopen(req)
+ ... except urllib.error.HTTPError as e:
+ ... print(e.code)
+ ... print(e.read()) #doctest: +ELLIPSIS, +NORMALIZE_WHITESPACE
+ ...
404
- <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
- "http://www.w3.org/TR/html4/loose.dtd">
- <?xml-stylesheet href="./css/ht2html.css"
- type="text/css"?>
- <html><head><title>Error 404: File Not Found</title>
- ...... etc...
+ b'<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">\n\n\n<html
+ ...
+ <title>Page Not Found</title>\n
+ ...
Wrapping it Up
--------------
diff --git a/Doc/library/collections.rst b/Doc/library/collections.rst
--- a/Doc/library/collections.rst
+++ b/Doc/library/collections.rst
@@ -159,7 +159,7 @@
d['x'] # Get first key in the chain of contexts
d['x'] = 1 # Set value in current context
- del['x'] # Delete from current context
+ del d['x'] # Delete from current context
list(d) # All nested values
k in d # Check all nested values
len(d) # Number of nested values
@@ -347,24 +347,24 @@
this section documents the minimum range and type restrictions.
* The :class:`Counter` class itself is a dictionary subclass with no
- restrictions on its keys and values. The values are intended to be numbers
- representing counts, but you *could* store anything in the value field.
+ restrictions on its keys and values. The values are intended to be numbers
+ representing counts, but you *could* store anything in the value field.
* The :meth:`most_common` method requires only that the values be orderable.
* For in-place operations such as ``c[key] += 1``, the value type need only
- support addition and subtraction. So fractions, floats, and decimals would
- work and negative values are supported. The same is also true for
- :meth:`update` and :meth:`subtract` which allow negative and zero values
- for both inputs and outputs.
+ support addition and subtraction. So fractions, floats, and decimals would
+ work and negative values are supported. The same is also true for
+ :meth:`update` and :meth:`subtract` which allow negative and zero values
+ for both inputs and outputs.
* The multiset methods are designed only for use cases with positive values.
- The inputs may be negative or zero, but only outputs with positive values
- are created. There are no type restrictions, but the value type needs to
- support addition, subtraction, and comparison.
+ The inputs may be negative or zero, but only outputs with positive values
+ are created. There are no type restrictions, but the value type needs to
+ support addition, subtraction, and comparison.
* The :meth:`elements` method requires integer counts. It ignores zero and
- negative counts.
+ negative counts.
.. seealso::
diff --git a/Doc/library/concurrency.rst b/Doc/library/concurrency.rst
--- a/Doc/library/concurrency.rst
+++ b/Doc/library/concurrency.rst
@@ -15,6 +15,7 @@
threading.rst
multiprocessing.rst
+ concurrent.rst
concurrent.futures.rst
subprocess.rst
sched.rst
diff --git a/Doc/library/concurrent.rst b/Doc/library/concurrent.rst
new file mode 100644
--- /dev/null
+++ b/Doc/library/concurrent.rst
@@ -0,0 +1,6 @@
+The :mod:`concurrent` package
+=============================
+
+Currently, there is only one module in this package:
+
+* :mod:`concurrent.futures` -- Launching parallel tasks
diff --git a/Doc/library/configparser.rst b/Doc/library/configparser.rst
--- a/Doc/library/configparser.rst
+++ b/Doc/library/configparser.rst
@@ -770,9 +770,9 @@
# values using the mapping protocol or ConfigParser's set() does not allow
# such assignments to take place.
config.add_section('Section1')
- config.set('Section1', 'int', '15')
- config.set('Section1', 'bool', 'true')
- config.set('Section1', 'float', '3.1415')
+ config.set('Section1', 'an_int', '15')
+ config.set('Section1', 'a_bool', 'true')
+ config.set('Section1', 'a_float', '3.1415')
config.set('Section1', 'baz', 'fun')
config.set('Section1', 'bar', 'Python')
config.set('Section1', 'foo', '%(bar)s is %(baz)s!')
@@ -790,13 +790,13 @@
# getfloat() raises an exception if the value is not a float
# getint() and getboolean() also do this for their respective types
- float = config.getfloat('Section1', 'float')
- int = config.getint('Section1', 'int')
- print(float + int)
+ a_float = config.getfloat('Section1', 'a_float')
+ an_int = config.getint('Section1', 'an_int')
+ print(a_float + an_int)
# Notice that the next output does not interpolate '%(bar)s' or '%(baz)s'.
# This is because we are using a RawConfigParser().
- if config.getboolean('Section1', 'bool'):
+ if config.getboolean('Section1', 'a_bool'):
print(config.get('Section1', 'foo'))
To get interpolation, use :class:`ConfigParser`::
diff --git a/Doc/library/doctest.rst b/Doc/library/doctest.rst
--- a/Doc/library/doctest.rst
+++ b/Doc/library/doctest.rst
@@ -650,7 +650,16 @@
An example's doctest directives modify doctest's behavior for that single
example. Use ``+`` to enable the named behavior, or ``-`` to disable it.
-For example, this test passes::
+.. note::
+ Due to an `unfortunate limitation`_ of our current documentation
+ publishing process, syntax highlighting has been disabled in the examples
+ below in order to ensure the doctest directives are correctly displayed.
+
+ .. _unfortunate limitation: http://bugs.python.org/issue12947
+
+For example, this test passes:
+
+.. code-block:: text
>>> print(list(range(20))) #doctest: +NORMALIZE_WHITESPACE
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9,
@@ -659,18 +668,25 @@
Without the directive it would fail, both because the actual output doesn't have
two blanks before the single-digit list elements, and because the actual output
is on a single line. This test also passes, and also requires a directive to do
-so::
+so:
+
+.. code-block:: text
>>> print(list(range(20))) # doctest: +ELLIPSIS
[0, 1, ..., 18, 19]
-Multiple directives can be used on a single physical line, separated by commas::
+Multiple directives can be used on a single physical line, separated by
+commas:
+
+.. code-block:: text
>>> print(list(range(20))) # doctest: +ELLIPSIS, +NORMALIZE_WHITESPACE
[0, 1, ..., 18, 19]
If multiple directive comments are used for a single example, then they are
-combined::
+combined:
+
+.. code-block:: text
>>> print(list(range(20))) # doctest: +ELLIPSIS
... # doctest: +NORMALIZE_WHITESPACE
@@ -678,7 +694,9 @@
As the previous example shows, you can add ``...`` lines to your example
containing only directives. This can be useful when an example is too long for
-a directive to comfortably fit on the same line::
+a directive to comfortably fit on the same line:
+
+.. code-block:: text
>>> print(list(range(5)) + list(range(10, 20)) + list(range(30, 40)))
... # doctest: +ELLIPSIS
diff --git a/Doc/library/dummy_threading.rst b/Doc/library/dummy_threading.rst
--- a/Doc/library/dummy_threading.rst
+++ b/Doc/library/dummy_threading.rst
@@ -17,7 +17,7 @@
try:
import threading
except ImportError:
- import dummy_threading
+ import dummy_threading as threading
Be careful to not use this module where deadlock might occur from a thread being
created that blocks waiting for another thread to be created. This often occurs
diff --git a/Doc/library/ftplib.rst b/Doc/library/ftplib.rst
--- a/Doc/library/ftplib.rst
+++ b/Doc/library/ftplib.rst
@@ -270,12 +270,12 @@
.. method:: FTP.storbinary(cmd, file, blocksize=8192, callback=None, rest=None)
Store a file in binary transfer mode. *cmd* should be an appropriate
- ``STOR`` command: ``"STOR filename"``. *file* is an open :term:`file object`
- which is read until EOF using its :meth:`read` method in blocks of size
- *blocksize* to provide the data to be stored. The *blocksize* argument
- defaults to 8192. *callback* is an optional single parameter callable that
- is called on each block of data after it is sent. *rest* means the same thing
- as in the :meth:`transfercmd` method.
+ ``STOR`` command: ``"STOR filename"``. *file* is a :term:`file object`
+ (opened in binary mode) which is read until EOF using its :meth:`read`
+ method in blocks of size *blocksize* to provide the data to be stored.
+ The *blocksize* argument defaults to 8192. *callback* is an optional single
+ parameter callable that is called on each block of data after it is sent.
+ *rest* means the same thing as in the :meth:`transfercmd` method.
.. versionchanged:: 3.2
*rest* parameter added.
@@ -285,9 +285,9 @@
Store a file in ASCII transfer mode. *cmd* should be an appropriate
``STOR`` command (see :meth:`storbinary`). Lines are read until EOF from the
- open :term:`file object` *file* using its :meth:`readline` method to provide
- the data to be stored. *callback* is an optional single parameter callable
- that is called on each line after it is sent.
+ :term:`file object` *file* (opened in binary mode) using its :meth:`readline`
+ method to provide the data to be stored. *callback* is an optional single
+ parameter callable that is called on each line after it is sent.
.. method:: FTP.transfercmd(cmd, rest=None)
diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
--- a/Doc/library/functions.rst
+++ b/Doc/library/functions.rst
@@ -1203,7 +1203,8 @@
.. _func-str:
-.. function:: str([object[, encoding[, errors]]])
+.. function:: str(object='')
+ str(object[, encoding[, errors]])
Return a string version of an object, using one of the following modes:
diff --git a/Doc/library/gc.rst b/Doc/library/gc.rst
--- a/Doc/library/gc.rst
+++ b/Doc/library/gc.rst
@@ -189,13 +189,13 @@
after collection. The callbacks will be called with two arguments,
*phase* and *info*.
- *phase* can one of two values:
+ *phase* can be one of two values:
"start": The garbage collection is about to start.
"stop": The garbage collection has finished.
- *info* provides more information for the callback. The following
+ *info* is a dict providing more information for the callback. The following
keys are currently defined:
"generation": The oldest generation being collected.
@@ -203,7 +203,7 @@
"collected": When *phase* is "stop", the number of objects
successfully collected.
- "uncollectable": when *phase* is "stop", the number of objects
+ "uncollectable": When *phase* is "stop", the number of objects
that could not be collected and were put in :data:`garbage`.
Applications can add their own callbacks to this list. The primary
diff --git a/Doc/library/html.rst b/Doc/library/html.rst
--- a/Doc/library/html.rst
+++ b/Doc/library/html.rst
@@ -19,3 +19,10 @@
attribute value delimited by quotes, as in ``<a href="...">``.
.. versionadded:: 3.2
+
+--------------
+
+Submodules in the ``html`` package are:
+
+* :mod:`html.parser` -- HTML/XHTML parser with lenient parsing mode
+* :mod:`html.entities` -- HTML entity definitions
diff --git a/Doc/library/http.rst b/Doc/library/http.rst
new file mode 100644
--- /dev/null
+++ b/Doc/library/http.rst
@@ -0,0 +1,11 @@
+:mod:`http` --- HTTP modules
+============================
+
+``http`` is a package that collects several modules for working with the
+HyperText Transfer Protocol:
+
+* :mod:`http.client` is a low-level HTTP protocol client; for high-level URL
+ opening use :mod:`urllib.request`
+* :mod:`http.server` contains basic HTTP server classes based on :mod:`socketserver`
+* :mod:`http.cookies` has utilities for implementing state management with cookies
+* :mod:`http.cookiejar` provides persistence of cookies
diff --git a/Doc/library/internet.rst b/Doc/library/internet.rst
--- a/Doc/library/internet.rst
+++ b/Doc/library/internet.rst
@@ -23,10 +23,12 @@
cgi.rst
cgitb.rst
wsgiref.rst
+ urllib.rst
urllib.request.rst
urllib.parse.rst
urllib.error.rst
urllib.robotparser.rst
+ http.rst
http.client.rst
ftplib.rst
poplib.rst
@@ -40,6 +42,7 @@
http.server.rst
http.cookies.rst
http.cookiejar.rst
+ xmlrpc.rst
xmlrpc.client.rst
xmlrpc.server.rst
ipaddress.rst
diff --git a/Doc/library/ipaddress.rst b/Doc/library/ipaddress.rst
--- a/Doc/library/ipaddress.rst
+++ b/Doc/library/ipaddress.rst
@@ -42,8 +42,15 @@
Return an :class:`IPv4Address` or :class:`IPv6Address` object depending on
the IP address passed as argument. Either IPv4 or IPv6 addresses may be
supplied; integers less than 2**32 will be considered to be IPv4 by default.
- A :exc:`ValueError` is raised if *address* does not represent a valid IPv4 or
- IPv6 address.
+ A :exc:`ValueError` is raised if *address* does not represent a valid IPv4
+ or IPv6 address.
+
+.. testsetup::
+ >>> import ipaddress
+ >>> from ipaddress import (ip_network, IPv4Address, IPv4Interface,
+ ... IPv4Network)
+
+::
>>> ipaddress.ip_address('192.168.0.1')
IPv4Address('192.168.0.1')
@@ -111,7 +118,7 @@
>>> ipaddress.IPv4Address('192.168.0.1')
IPv4Address('192.168.0.1')
- >>> ipaddress.IPv4Address(3221225985)
+ >>> ipaddress.IPv4Address(3232235521)
IPv4Address('192.168.0.1')
>>> ipaddress.IPv4Address(b'\xC0\xA8\x00\x01')
IPv4Address('192.168.0.1')
@@ -437,7 +444,7 @@
hosts are all the IP addresses that belong to the network, except the
network address itself and the network broadcast address.
- >>> list(ip_network('192.0.2.0/29').hosts())
+ >>> list(ip_network('192.0.2.0/29').hosts()) #doctest: +NORMALIZE_WHITESPACE
[IPv4Address('192.0.2.1'), IPv4Address('192.0.2.2'),
IPv4Address('192.0.2.3'), IPv4Address('192.0.2.4'),
IPv4Address('192.0.2.5'), IPv4Address('192.0.2.6')]
@@ -456,7 +463,7 @@
>>> n1 = ip_network('192.0.2.0/28')
>>> n2 = ip_network('192.0.2.1/32')
- >>> list(n1.address_exclude(n2))
+ >>> list(n1.address_exclude(n2)) #doctest: +NORMALIZE_WHITESPACE
[IPv4Network('192.0.2.8/29'), IPv4Network('192.0.2.4/30'),
IPv4Network('192.0.2.2/31'), IPv4Network('192.0.2.0/32')]
@@ -471,10 +478,10 @@
>>> list(ip_network('192.0.2.0/24').subnets())
[IPv4Network('192.0.2.0/25'), IPv4Network('192.0.2.128/25')]
- >>> list(ip_network('192.0.2.0/24').subnets(prefixlen_diff=2))
+ >>> list(ip_network('192.0.2.0/24').subnets(prefixlen_diff=2)) #doctest: +NORMALIZE_WHITESPACE
[IPv4Network('192.0.2.0/26'), IPv4Network('192.0.2.64/26'),
IPv4Network('192.0.2.128/26'), IPv4Network('192.0.2.192/26')]
- >>> list(ip_network('192.0.2.0/24').subnets(new_prefix=26))
+ >>> list(ip_network('192.0.2.0/24').subnets(new_prefix=26)) #doctest: +NORMALIZE_WHITESPACE
[IPv4Network('192.0.2.0/26'), IPv4Network('192.0.2.64/26'),
IPv4Network('192.0.2.128/26'), IPv4Network('192.0.2.192/26')]
>>> list(ip_network('192.0.2.0/24').subnets(new_prefix=23))
diff --git a/Doc/library/markup.rst b/Doc/library/markup.rst
--- a/Doc/library/markup.rst
+++ b/Doc/library/markup.rst
@@ -9,20 +9,13 @@
Language (SGML) and the Hypertext Markup Language (HTML), and several interfaces
for working with the Extensible Markup Language (XML).
-It is important to note that modules in the :mod:`xml` package require that
-there be at least one SAX-compliant XML parser available. The Expat parser is
-included with Python, so the :mod:`xml.parsers.expat` module will always be
-available.
-
-The documentation for the :mod:`xml.dom` and :mod:`xml.sax` packages are the
-definition of the Python bindings for the DOM and SAX interfaces.
-
.. toctree::
html.rst
html.parser.rst
html.entities.rst
+ xml.rst
xml.etree.elementtree.rst
xml.dom.rst
xml.dom.minidom.rst
diff --git a/Doc/library/multiprocessing.rst b/Doc/library/multiprocessing.rst
--- a/Doc/library/multiprocessing.rst
+++ b/Doc/library/multiprocessing.rst
@@ -29,7 +29,7 @@
Functionality within this package requires that the ``__main__`` module be
importable by the children. This is covered in :ref:`multiprocessing-programming`
however it is worth pointing out here. This means that some examples, such
- as the :class:`multiprocessing.Pool` examples will not work in the
+ as the :class:`multiprocessing.pool.Pool` examples will not work in the
interactive interpreter. For example::
>>> from multiprocessing import Pool
@@ -916,7 +916,7 @@
.. class:: Condition([lock])
- A condition variable: a clone of :class:`threading.Condition`.
+ A condition variable: an alias for :class:`threading.Condition`.
If *lock* is specified then it should be a :class:`Lock` or :class:`RLock`
object from :mod:`multiprocessing`.
@@ -1638,7 +1638,7 @@
One can create a pool of processes which will carry out tasks submitted to it
with the :class:`Pool` class.
-.. class:: multiprocessing.Pool([processes[, initializer[, initargs[, maxtasksperchild]]]])
+.. class:: Pool([processes[, initializer[, initargs[, maxtasksperchild]]]])
A process pool object which controls a pool of worker processes to which jobs
can be submitted. It supports asynchronous results with timeouts and
diff --git a/Doc/library/os.rst b/Doc/library/os.rst
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -1555,18 +1555,21 @@
single: UNC paths; and os.makedirs()
Recursive directory creation function. Like :func:`mkdir`, but makes all
- intermediate-level directories needed to contain the leaf directory. If
- the target directory with the same mode as specified already exists,
- raises an :exc:`OSError` exception if *exist_ok* is False, otherwise no
- exception is raised. If the directory cannot be created in other cases,
- raises an :exc:`OSError` exception. The default *mode* is ``0o777`` (octal).
- On some systems, *mode* is ignored. Where it is used, the current umask
- value is first masked out.
+ intermediate-level directories needed to contain the leaf directory.
+
+ The default *mode* is ``0o777`` (octal). On some systems, *mode* is
+ ignored. Where it is used, the current umask value is first masked out.
+
+ If *exists_ok* is ``False`` (the default), an :exc:`OSError` is raised if
+ the target directory already exists. If *exists_ok* is ``True`` an
+ :exc:`OSError` is still raised if the umask-masked *mode* is different from
+ the existing mode, on systems where the mode is used. :exc:`OSError` will
+ also be raised if the directory creation fails.
.. note::
:func:`makedirs` will become confused if the path elements to create
- include :data:`pardir`.
+ include :data:`pardir` (eg. ".." on UNIX systems).
This function handles UNC paths correctly.
diff --git a/Doc/library/socketserver.rst b/Doc/library/socketserver.rst
--- a/Doc/library/socketserver.rst
+++ b/Doc/library/socketserver.rst
@@ -153,20 +153,22 @@
.. method:: BaseServer.serve_forever(poll_interval=0.5)
- Handle requests until an explicit :meth:`shutdown` request.
- Poll for shutdown every *poll_interval* seconds. Ignores :attr:`self.timeout`. It also calls
- :meth:`service_actions` which may be used by a subclass or Mixin to provide
- various cleanup actions. For e.g. ForkingMixin class uses
- :meth:`service_actions` to cleanup the zombie child processes.
+ Handle requests until an explicit :meth:`shutdown` request. Poll for
+ shutdown every *poll_interval* seconds. Ignores :attr:`self.timeout`. It
+ also calls :meth:`service_actions`, which may be used by a subclass or mixin
+ to provide actions specific to a given service. For example, the
+ :class:`ForkingMixIn` class uses :meth:`service_actions` to clean up zombie
+ child processes.
.. versionchanged:: 3.3
- Added service_actions call to the serve_forever method.
+ Added ``service_actions`` call to the ``serve_forever`` method.
.. method:: BaseServer.service_actions()
- This is called by the serve_forever loop. This method is can be overridden
- by Mixin's to add cleanup or service specific actions.
+ This is called in the :meth:`serve_forever` loop. This method is can be
+ overridden by subclasses or mixin classes to perform actions specific to
+ a given service, such as cleanup actions.
.. versionadded:: 3.3
diff --git a/Doc/library/sqlite3.rst b/Doc/library/sqlite3.rst
--- a/Doc/library/sqlite3.rst
+++ b/Doc/library/sqlite3.rst
@@ -222,250 +222,254 @@
A SQLite database connection has the following attributes and methods:
-.. attribute:: Connection.isolation_level
+ .. attribute:: isolation_level
- Get or set the current isolation level. :const:`None` for autocommit mode or
- one of "DEFERRED", "IMMEDIATE" or "EXCLUSIVE". See section
- :ref:`sqlite3-controlling-transactions` for a more detailed explanation.
+ Get or set the current isolation level. :const:`None` for autocommit mode or
+ one of "DEFERRED", "IMMEDIATE" or "EXCLUSIVE". See section
+ :ref:`sqlite3-controlling-transactions` for a more detailed explanation.
-.. attribute:: Connection.in_transaction
+ .. attribute:: in_transaction
- :const:`True` if a transaction is active (there are uncommitted changes),
- :const:`False` otherwise. Read-only attribute.
+ :const:`True` if a transaction is active (there are uncommitted changes),
+ :const:`False` otherwise. Read-only attribute.
- .. versionadded:: 3.2
+ .. versionadded:: 3.2
-.. method:: Connection.cursor([cursorClass])
+ .. method:: cursor([cursorClass])
- The cursor method accepts a single optional parameter *cursorClass*. If
- supplied, this must be a custom cursor class that extends
- :class:`sqlite3.Cursor`.
+ The cursor method accepts a single optional parameter *cursorClass*. If
+ supplied, this must be a custom cursor class that extends
+ :class:`sqlite3.Cursor`.
-.. method:: Connection.commit()
+ .. method:: commit()
- This method commits the current transaction. If you don't call this method,
- anything you did since the last call to ``commit()`` is not visible from
- other database connections. If you wonder why you don't see the data you've
- written to the database, please check you didn't forget to call this method.
+ This method commits the current transaction. If you don't call this method,
+ anything you did since the last call to ``commit()`` is not visible from
+ other database connections. If you wonder why you don't see the data you've
+ written to the database, please check you didn't forget to call this method.
-.. method:: Connection.rollback()
+ .. method:: rollback()
- This method rolls back any changes to the database since the last call to
- :meth:`commit`.
+ This method rolls back any changes to the database since the last call to
+ :meth:`commit`.
-.. method:: Connection.close()
+ .. method:: close()
- This closes the database connection. Note that this does not automatically
- call :meth:`commit`. If you just close your database connection without
- calling :meth:`commit` first, your changes will be lost!
+ This closes the database connection. Note that this does not automatically
+ call :meth:`commit`. If you just close your database connection without
+ calling :meth:`commit` first, your changes will be lost!
-.. method:: Connection.execute(sql, [parameters])
+ .. method:: execute(sql, [parameters])
- This is a nonstandard shortcut that creates an intermediate cursor object by
- calling the cursor method, then calls the cursor's :meth:`execute
- <Cursor.execute>` method with the parameters given.
+ This is a nonstandard shortcut that creates an intermediate cursor object by
+ calling the cursor method, then calls the cursor's :meth:`execute
+ <Cursor.execute>` method with the parameters given.
-.. method:: Connection.executemany(sql, [parameters])
+ .. method:: executemany(sql, [parameters])
- This is a nonstandard shortcut that creates an intermediate cursor object by
- calling the cursor method, then calls the cursor's :meth:`executemany
- <Cursor.executemany>` method with the parameters given.
+ This is a nonstandard shortcut that creates an intermediate cursor object by
+ calling the cursor method, then calls the cursor's :meth:`executemany
+ <Cursor.executemany>` method with the parameters given.
-.. method:: Connection.executescript(sql_script)
+ .. method:: executescript(sql_script)
- This is a nonstandard shortcut that creates an intermediate cursor object by
- calling the cursor method, then calls the cursor's :meth:`executescript
- <Cursor.executescript>` method with the parameters given.
+ This is a nonstandard shortcut that creates an intermediate cursor object by
+ calling the cursor method, then calls the cursor's :meth:`executescript
+ <Cursor.executescript>` method with the parameters given.
-.. method:: Connection.create_function(name, num_params, func)
+ .. method:: create_function(name, num_params, func)
- Creates a user-defined function that you can later use from within SQL
- statements under the function name *name*. *num_params* is the number of
- parameters the function accepts, and *func* is a Python callable that is called
- as the SQL function.
+ Creates a user-defined function that you can later use from within SQL
+ statements under the function name *name*. *num_params* is the number of
+ parameters the function accepts, and *func* is a Python callable that is called
+ as the SQL function.
- The function can return any of the types supported by SQLite: bytes, str, int,
- float and None.
+ The function can return any of the types supported by SQLite: bytes, str, int,
+ float and None.
- Example:
+ Example:
- .. literalinclude:: ../includes/sqlite3/md5func.py
+ .. literalinclude:: ../includes/sqlite3/md5func.py
-.. method:: Connection.create_aggregate(name, num_params, aggregate_class)
+ .. method:: create_aggregate(name, num_params, aggregate_class)
- Creates a user-defined aggregate function.
+ Creates a user-defined aggregate function.
- The aggregate class must implement a ``step`` method, which accepts the number
- of parameters *num_params*, and a ``finalize`` method which will return the
- final result of the aggregate.
+ The aggregate class must implement a ``step`` method, which accepts the number
+ of parameters *num_params*, and a ``finalize`` method which will return the
+ final result of the aggregate.
- The ``finalize`` method can return any of the types supported by SQLite:
- bytes, str, int, float and None.
+ The ``finalize`` method can return any of the types supported by SQLite:
+ bytes, str, int, float and None.
- Example:
+ Example:
- .. literalinclude:: ../includes/sqlite3/mysumaggr.py
+ .. literalinclude:: ../includes/sqlite3/mysumaggr.py
-.. method:: Connection.create_collation(name, callable)
+ .. method:: create_collation(name, callable)
- Creates a collation with the specified *name* and *callable*. The callable will
- be passed two string arguments. It should return -1 if the first is ordered
- lower than the second, 0 if they are ordered equal and 1 if the first is ordered
- higher than the second. Note that this controls sorting (ORDER BY in SQL) so
- your comparisons don't affect other SQL operations.
+ Creates a collation with the specified *name* and *callable*. The callable will
+ be passed two string arguments. It should return -1 if the first is ordered
+ lower than the second, 0 if they are ordered equal and 1 if the first is ordered
+ higher than the second. Note that this controls sorting (ORDER BY in SQL) so
+ your comparisons don't affect other SQL operations.
- Note that the callable will get its parameters as Python bytestrings, which will
- normally be encoded in UTF-8.
+ Note that the callable will get its parameters as Python bytestrings, which will
+ normally be encoded in UTF-8.
- The following example shows a custom collation that sorts "the wrong way":
+ The following example shows a custom collation that sorts "the wrong way":
- .. literalinclude:: ../includes/sqlite3/collation_reverse.py
+ .. literalinclude:: ../includes/sqlite3/collation_reverse.py
- To remove a collation, call ``create_collation`` with None as callable::
+ To remove a collation, call ``create_collation`` with None as callable::
- con.create_collation("reverse", None)
+ con.create_collation("reverse", None)
-.. method:: Connection.interrupt()
+ .. method:: interrupt()
- You can call this method from a different thread to abort any queries that might
- be executing on the connection. The query will then abort and the caller will
- get an exception.
+ You can call this method from a different thread to abort any queries that might
+ be executing on the connection. The query will then abort and the caller will
+ get an exception.
-.. method:: Connection.set_authorizer(authorizer_callback)
+ .. method:: set_authorizer(authorizer_callback)
- This routine registers a callback. The callback is invoked for each attempt to
- access a column of a table in the database. The callback should return
- :const:`SQLITE_OK` if access is allowed, :const:`SQLITE_DENY` if the entire SQL
- statement should be aborted with an error and :const:`SQLITE_IGNORE` if the
- column should be treated as a NULL value. These constants are available in the
- :mod:`sqlite3` module.
+ This routine registers a callback. The callback is invoked for each attempt to
+ access a column of a table in the database. The callback should return
+ :const:`SQLITE_OK` if access is allowed, :const:`SQLITE_DENY` if the entire SQL
+ statement should be aborted with an error and :const:`SQLITE_IGNORE` if the
+ column should be treated as a NULL value. These constants are available in the
+ :mod:`sqlite3` module.
- The first argument to the callback signifies what kind of operation is to be
- authorized. The second and third argument will be arguments or :const:`None`
- depending on the first argument. The 4th argument is the name of the database
- ("main", "temp", etc.) if applicable. The 5th argument is the name of the
- inner-most trigger or view that is responsible for the access attempt or
- :const:`None` if this access attempt is directly from input SQL code.
+ The first argument to the callback signifies what kind of operation is to be
+ authorized. The second and third argument will be arguments or :const:`None`
+ depending on the first argument. The 4th argument is the name of the database
+ ("main", "temp", etc.) if applicable. The 5th argument is the name of the
+ inner-most trigger or view that is responsible for the access attempt or
+ :const:`None` if this access attempt is directly from input SQL code.
- Please consult the SQLite documentation about the possible values for the first
- argument and the meaning of the second and third argument depending on the first
- one. All necessary constants are available in the :mod:`sqlite3` module.
+ Please consult the SQLite documentation about the possible values for the first
+ argument and the meaning of the second and third argument depending on the first
+ one. All necessary constants are available in the :mod:`sqlite3` module.
-.. method:: Connection.set_progress_handler(handler, n)
+ .. method:: set_progress_handler(handler, n)
- This routine registers a callback. The callback is invoked for every *n*
- instructions of the SQLite virtual machine. This is useful if you want to
- get called from SQLite during long-running operations, for example to update
- a GUI.
+ This routine registers a callback. The callback is invoked for every *n*
+ instructions of the SQLite virtual machine. This is useful if you want to
+ get called from SQLite during long-running operations, for example to update
+ a GUI.
- If you want to clear any previously installed progress handler, call the
- method with :const:`None` for *handler*.
+ If you want to clear any previously installed progress handler, call the
+ method with :const:`None` for *handler*.
-.. method:: Connection.set_trace_callback(trace_callback)
+ .. method:: set_trace_callback(trace_callback)
- Registers *trace_callback* to be called for each SQL statement that is
- actually executed by the SQLite backend.
+ Registers *trace_callback* to be called for each SQL statement that is
+ actually executed by the SQLite backend.
- The only argument passed to the callback is the statement (as string) that
- is being executed. The return value of the callback is ignored. Note that
- the backend does not only run statements passed to the :meth:`Cursor.execute`
- methods. Other sources include the transaction management of the Python
- module and the execution of triggers defined in the current database.
+ The only argument passed to the callback is the statement (as string) that
+ is being executed. The return value of the callback is ignored. Note that
+ the backend does not only run statements passed to the :meth:`Cursor.execute`
+ methods. Other sources include the transaction management of the Python
+ module and the execution of triggers defined in the current database.
- Passing :const:`None` as *trace_callback* will disable the trace callback.
+ Passing :const:`None` as *trace_callback* will disable the trace callback.
- .. versionadded:: 3.3
+ .. versionadded:: 3.3
-.. method:: Connection.enable_load_extension(enabled)
+ .. method:: enable_load_extension(enabled)
- This routine allows/disallows the SQLite engine to load SQLite extensions
- from shared libraries. SQLite extensions can define new functions,
- aggregates or whole new virtual table implementations. One well-known
- extension is the fulltext-search extension distributed with SQLite.
+ This routine allows/disallows the SQLite engine to load SQLite extensions
+ from shared libraries. SQLite extensions can define new functions,
+ aggregates or whole new virtual table implementations. One well-known
+ extension is the fulltext-search extension distributed with SQLite.
- Loadable extensions are disabled by default. See [#f1]_.
+ Loadable extensions are disabled by default. See [#f1]_.
- .. versionadded:: 3.2
+ .. versionadded:: 3.2
- .. literalinclude:: ../includes/sqlite3/load_extension.py
+ .. literalinclude:: ../includes/sqlite3/load_extension.py
-.. method:: Connection.load_extension(path)
+ .. method:: load_extension(path)
- This routine loads a SQLite extension from a shared library. You have to
- enable extension loading with :meth:`enable_load_extension` before you can
- use this routine.
+ This routine loads a SQLite extension from a shared library. You have to
+ enable extension loading with :meth:`enable_load_extension` before you can
+ use this routine.
- Loadable extensions are disabled by default. See [#f1]_.
+ Loadable extensions are disabled by default. See [#f1]_.
- .. versionadded:: 3.2
+ .. versionadded:: 3.2
-.. attribute:: Connection.row_factory
+ .. attribute:: row_factory
- You can change this attribute to a callable that accepts the cursor and the
- original row as a tuple and will return the real result row. This way, you can
- implement more advanced ways of returning results, such as returning an object
- that can also access columns by name.
+ You can change this attribute to a callable that accepts the cursor and the
+ original row as a tuple and will return the real result row. This way, you can
+ implement more advanced ways of returning results, such as returning an object
+ that can also access columns by name.
- Example:
+ Example:
- .. literalinclude:: ../includes/sqlite3/row_factory.py
+ .. literalinclude:: ../includes/sqlite3/row_factory.py
- If returning a tuple doesn't suffice and you want name-based access to
- columns, you should consider setting :attr:`row_factory` to the
- highly-optimized :class:`sqlite3.Row` type. :class:`Row` provides both
- index-based and case-insensitive name-based access to columns with almost no
- memory overhead. It will probably be better than your own custom
- dictionary-based approach or even a db_row based solution.
+ If returning a tuple doesn't suffice and you want name-based access to
+ columns, you should consider setting :attr:`row_factory` to the
+ highly-optimized :class:`sqlite3.Row` type. :class:`Row` provides both
+ index-based and case-insensitive name-based access to columns with almost no
+ memory overhead. It will probably be better than your own custom
+ dictionary-based approach or even a db_row based solution.
- .. XXX what's a db_row-based solution?
+ .. XXX what's a db_row-based solution?
-.. attribute:: Connection.text_factory
+ .. attribute:: text_factory
- Using this attribute you can control what objects are returned for the ``TEXT``
- data type. By default, this attribute is set to :class:`str` and the
- :mod:`sqlite3` module will return Unicode objects for ``TEXT``. If you want to
- return bytestrings instead, you can set it to :class:`bytes`.
+ Using this attribute you can control what objects are returned for the ``TEXT``
+ data type. By default, this attribute is set to :class:`str` and the
+ :mod:`sqlite3` module will return Unicode objects for ``TEXT``. If you want to
+ return bytestrings instead, you can set it to :class:`bytes`.
- You can also set it to any other callable that accepts a single bytestring
- parameter and returns the resulting object.
+ For efficiency reasons, there's also a way to return :class:`str` objects
+ only for non-ASCII data, and :class:`bytes` otherwise. To activate it, set
+ this attribute to :const:`sqlite3.OptimizedUnicode`.
- See the following example code for illustration:
+ You can also set it to any other callable that accepts a single bytestring
+ parameter and returns the resulting object.
- .. literalinclude:: ../includes/sqlite3/text_factory.py
+ See the following example code for illustration:
+ .. literalinclude:: ../includes/sqlite3/text_factory.py
-.. attribute:: Connection.total_changes
- Returns the total number of database rows that have been modified, inserted, or
- deleted since the database connection was opened.
+ .. attribute:: total_changes
+ Returns the total number of database rows that have been modified, inserted, or
+ deleted since the database connection was opened.
-.. attribute:: Connection.iterdump
- Returns an iterator to dump the database in an SQL text format. Useful when
- saving an in-memory database for later restoration. This function provides
- the same capabilities as the :kbd:`.dump` command in the :program:`sqlite3`
- shell.
+ .. attribute:: iterdump
- Example::
+ Returns an iterator to dump the database in an SQL text format. Useful when
+ saving an in-memory database for later restoration. This function provides
+ the same capabilities as the :kbd:`.dump` command in the :program:`sqlite3`
+ shell.
- # Convert file existing_db.db to SQL dump file dump.sql
- import sqlite3, os
+ Example::
- con = sqlite3.connect('existing_db.db')
- with open('dump.sql', 'w') as f:
- for line in con.iterdump():
- f.write('%s\n' % line)
+ # Convert file existing_db.db to SQL dump file dump.sql
+ import sqlite3, os
+
+ con = sqlite3.connect('existing_db.db')
+ with open('dump.sql', 'w') as f:
+ for line in con.iterdump():
+ f.write('%s\n' % line)
.. _sqlite3-cursor-objects:
@@ -477,110 +481,110 @@
A :class:`Cursor` instance has the following attributes and methods.
-.. method:: Cursor.execute(sql, [parameters])
+ .. method:: execute(sql, [parameters])
- Executes an SQL statement. The SQL statement may be parametrized (i. e.
- placeholders instead of SQL literals). The :mod:`sqlite3` module supports two
- kinds of placeholders: question marks (qmark style) and named placeholders
- (named style).
+ Executes an SQL statement. The SQL statement may be parametrized (i. e.
+ placeholders instead of SQL literals). The :mod:`sqlite3` module supports two
+ kinds of placeholders: question marks (qmark style) and named placeholders
+ (named style).
- Here's an example of both styles:
+ Here's an example of both styles:
- .. literalinclude:: ../includes/sqlite3/execute_1.py
+ .. literalinclude:: ../includes/sqlite3/execute_1.py
- :meth:`execute` will only execute a single SQL statement. If you try to execute
- more than one statement with it, it will raise a Warning. Use
- :meth:`executescript` if you want to execute multiple SQL statements with one
- call.
+ :meth:`execute` will only execute a single SQL statement. If you try to execute
+ more than one statement with it, it will raise a Warning. Use
+ :meth:`executescript` if you want to execute multiple SQL statements with one
+ call.
-.. method:: Cursor.executemany(sql, seq_of_parameters)
+ .. method:: executemany(sql, seq_of_parameters)
- Executes an SQL command against all parameter sequences or mappings found in
- the sequence *sql*. The :mod:`sqlite3` module also allows using an
- :term:`iterator` yielding parameters instead of a sequence.
+ Executes an SQL command against all parameter sequences or mappings found in
+ the sequence *sql*. The :mod:`sqlite3` module also allows using an
+ :term:`iterator` yielding parameters instead of a sequence.
- .. literalinclude:: ../includes/sqlite3/executemany_1.py
+ .. literalinclude:: ../includes/sqlite3/executemany_1.py
- Here's a shorter example using a :term:`generator`:
+ Here's a shorter example using a :term:`generator`:
- .. literalinclude:: ../includes/sqlite3/executemany_2.py
+ .. literalinclude:: ../includes/sqlite3/executemany_2.py
-.. method:: Cursor.executescript(sql_script)
+ .. method:: executescript(sql_script)
- This is a nonstandard convenience method for executing multiple SQL statements
- at once. It issues a ``COMMIT`` statement first, then executes the SQL script it
- gets as a parameter.
+ This is a nonstandard convenience method for executing multiple SQL statements
+ at once. It issues a ``COMMIT`` statement first, then executes the SQL script it
+ gets as a parameter.
- *sql_script* can be an instance of :class:`str` or :class:`bytes`.
+ *sql_script* can be an instance of :class:`str` or :class:`bytes`.
- Example:
+ Example:
- .. literalinclude:: ../includes/sqlite3/executescript.py
+ .. literalinclude:: ../includes/sqlite3/executescript.py
-.. method:: Cursor.fetchone()
+ .. method:: fetchone()
- Fetches the next row of a query result set, returning a single sequence,
- or :const:`None` when no more data is available.
+ Fetches the next row of a query result set, returning a single sequence,
+ or :const:`None` when no more data is available.
-.. method:: Cursor.fetchmany(size=cursor.arraysize)
+ .. method:: fetchmany(size=cursor.arraysize)
- Fetches the next set of rows of a query result, returning a list. An empty
- list is returned when no more rows are available.
+ Fetches the next set of rows of a query result, returning a list. An empty
+ list is returned when no more rows are available.
- The number of rows to fetch per call is specified by the *size* parameter.
- If it is not given, the cursor's arraysize determines the number of rows
- to be fetched. The method should try to fetch as many rows as indicated by
- the size parameter. If this is not possible due to the specified number of
- rows not being available, fewer rows may be returned.
+ The number of rows to fetch per call is specified by the *size* parameter.
+ If it is not given, the cursor's arraysize determines the number of rows
+ to be fetched. The method should try to fetch as many rows as indicated by
+ the size parameter. If this is not possible due to the specified number of
+ rows not being available, fewer rows may be returned.
- Note there are performance considerations involved with the *size* parameter.
- For optimal performance, it is usually best to use the arraysize attribute.
- If the *size* parameter is used, then it is best for it to retain the same
- value from one :meth:`fetchmany` call to the next.
+ Note there are performance considerations involved with the *size* parameter.
+ For optimal performance, it is usually best to use the arraysize attribute.
+ If the *size* parameter is used, then it is best for it to retain the same
+ value from one :meth:`fetchmany` call to the next.
-.. method:: Cursor.fetchall()
+ .. method:: fetchall()
- Fetches all (remaining) rows of a query result, returning a list. Note that
- the cursor's arraysize attribute can affect the performance of this operation.
- An empty list is returned when no rows are available.
+ Fetches all (remaining) rows of a query result, returning a list. Note that
+ the cursor's arraysize attribute can affect the performance of this operation.
+ An empty list is returned when no rows are available.
-.. attribute:: Cursor.rowcount
+ .. attribute:: rowcount
- Although the :class:`Cursor` class of the :mod:`sqlite3` module implements this
- attribute, the database engine's own support for the determination of "rows
- affected"/"rows selected" is quirky.
+ Although the :class:`Cursor` class of the :mod:`sqlite3` module implements this
+ attribute, the database engine's own support for the determination of "rows
+ affected"/"rows selected" is quirky.
- For :meth:`executemany` statements, the number of modifications are summed up
- into :attr:`rowcount`.
+ For :meth:`executemany` statements, the number of modifications are summed up
+ into :attr:`rowcount`.
- As required by the Python DB API Spec, the :attr:`rowcount` attribute "is -1 in
- case no ``executeXX()`` has been performed on the cursor or the rowcount of the
- last operation is not determinable by the interface". This includes ``SELECT``
- statements because we cannot determine the number of rows a query produced
- until all rows were fetched.
+ As required by the Python DB API Spec, the :attr:`rowcount` attribute "is -1 in
+ case no ``executeXX()`` has been performed on the cursor or the rowcount of the
+ last operation is not determinable by the interface". This includes ``SELECT``
+ statements because we cannot determine the number of rows a query produced
+ until all rows were fetched.
- With SQLite versions before 3.6.5, :attr:`rowcount` is set to 0 if
- you make a ``DELETE FROM table`` without any condition.
+ With SQLite versions before 3.6.5, :attr:`rowcount` is set to 0 if
+ you make a ``DELETE FROM table`` without any condition.
-.. attribute:: Cursor.lastrowid
+ .. attribute:: lastrowid
- This read-only attribute provides the rowid of the last modified row. It is
- only set if you issued a ``INSERT`` statement using the :meth:`execute`
- method. For operations other than ``INSERT`` or when :meth:`executemany` is
- called, :attr:`lastrowid` is set to :const:`None`.
+ This read-only attribute provides the rowid of the last modified row. It is
+ only set if you issued a ``INSERT`` statement using the :meth:`execute`
+ method. For operations other than ``INSERT`` or when :meth:`executemany` is
+ called, :attr:`lastrowid` is set to :const:`None`.
-.. attribute:: Cursor.description
+ .. attribute:: description
- This read-only attribute provides the column names of the last query. To
- remain compatible with the Python DB API, it returns a 7-tuple for each
- column where the last six items of each tuple are :const:`None`.
+ This read-only attribute provides the column names of the last query. To
+ remain compatible with the Python DB API, it returns a 7-tuple for each
+ column where the last six items of each tuple are :const:`None`.
- It is set for ``SELECT`` statements without any matching rows as well.
+ It is set for ``SELECT`` statements without any matching rows as well.
.. _sqlite3-row-objects:
diff --git a/Doc/library/subprocess.rst b/Doc/library/subprocess.rst
--- a/Doc/library/subprocess.rst
+++ b/Doc/library/subprocess.rst
@@ -358,20 +358,15 @@
Arguments are:
- *args* should be a string, or a sequence of program arguments. The program
- to execute is normally the first item in the args sequence or the string if
- a string is given, but can be explicitly set by using the *executable*
- argument. When *executable* is given, the first item in the args sequence
- is still treated by most programs as the command name, which can then be
- different from the actual executable name. On Unix, it becomes the display
- name for the executing program in utilities such as :program:`ps`.
+ *args* should be a sequence of program arguments or else a single string.
+ By default, the program to execute is the first item in *args* if *args* is
+ a sequence and the string itself if *args* is a string. However, see the
+ *shell* and *executable* arguments for differences from this behavior.
- On Unix, with *shell=False* (default): In this case, the Popen class uses
- :meth:`os.execvp` like behavior to execute the child program.
- *args* should normally be a
- sequence. If a string is specified for *args*, it will be used as the name
- or path of the program to execute; this will only work if the program is
- being given no arguments.
+ On Unix, the :class:`Popen` class uses :meth:`os.execvp`-like behavior to
+ execute the child program. If *args* is a string, the string is
+ interpreted as the name or path of the program to execute; this only works
+ if the program is being given no arguments.
.. note::
@@ -392,13 +387,23 @@
used in the shell (such as filenames containing spaces or the *echo* command
shown above) are single list elements.
- On Unix, with *shell=True*: If args is a string, it specifies the command
- string to execute through the shell. This means that the string must be
+ On Windows, the :class:`Popen` class uses ``CreateProcess()`` to
+ execute the child program, which operates on strings. If *args* is a
+ sequence, it will be converted to a string in a manner described in
+ :ref:`converting-argument-sequence`.
+
+ The *shell* argument (which defaults to *False*) specifies whether to use
+ the shell as the program to execute. It is recommended to pass *args* as a
+ sequence if *shell* is *False* and as a string if *shell* is *True*.
+
+ On Unix with ``shell=True``, the shell defaults to :file:`/bin/sh`. If
+ *args* is a string, the string specifies the command
+ to execute through the shell. This means that the string must be
formatted exactly as it would be when typed at the shell prompt. This
includes, for example, quoting or backslash escaping filenames with spaces in
them. If *args* is a sequence, the first item specifies the command string, and
any additional items will be treated as additional arguments to the shell
- itself. That is to say, *Popen* does the equivalent of::
+ itself. That is to say, :class:`Popen` does the equivalent of::
Popen(['/bin/sh', '-c', args[0], args[1], ...])
@@ -408,10 +413,11 @@
input. See the warning under :ref:`frequently-used-arguments`
for details.
- On Windows: the :class:`Popen` class uses CreateProcess() to execute the
- child program, which operates on strings. If *args* is a sequence, it will
- be converted to a string in a manner described in
- :ref:`converting-argument-sequence`.
+ On Windows with ``shell=True``, the :envvar:`COMSPEC` environment variable
+ specifies the default shell. The only time you need to specify
+ ``shell=True`` on Windows is when the command you wish to execute is built
+ into the shell (e.g. :command:`dir` or :command:`copy`). You do not need
+ ``shell=True`` to run a batch file or console-based executable.
*bufsize*, if given, has the same meaning as the corresponding argument to the
built-in open() function: :const:`0` means unbuffered, :const:`1` means line
@@ -425,15 +431,14 @@
enable buffering by setting *bufsize* to either -1 or a large enough
positive value (such as 4096).
- The *executable* argument specifies the program to execute. It is very seldom
- needed: Usually, the program to execute is defined by the *args* argument. If
- ``shell=True``, the *executable* argument specifies which shell to use. On Unix,
- the default shell is :file:`/bin/sh`. On Windows, the default shell is
- specified by the :envvar:`COMSPEC` environment variable. The only reason you
- would need to specify ``shell=True`` on Windows is where the command you
- wish to execute is actually built in to the shell, eg ``dir``, ``copy``.
- You don't need ``shell=True`` to run a batch file, nor to run a console-based
- executable.
+ The *executable* argument specifies a replacement program to execute. It
+ is very seldom needed. When ``shell=False``, *executable* replaces the
+ program to execute specified by *args*. However, the *args* program is
+ still treated by most programs as the command name, which can then be
+ different from the program actually executed. On Unix, the *args* name
+ becomes the display name for the executable in utilities such as
+ :program:`ps`. If ``shell=True``, on Unix the *executable* argument
+ specifies a replacement shell for the default :file:`/bin/sh`.
*stdin*, *stdout* and *stderr* specify the executed program's standard input,
standard output and standard error file handles, respectively. Valid values
@@ -484,10 +489,10 @@
.. versionadded:: 3.2
The *pass_fds* parameter was added.
- If *cwd* is not ``None``, the child's current directory will be changed to *cwd*
- before it is executed. Note that this directory is not considered when
- searching the executable, so you can't specify the program's path relative to
- *cwd*.
+ If *cwd* is not ``None``, the function changes the working directory to
+ *cwd* before executing the child. In particular, the function looks for
+ *executable* (or for the first item in *args*) relative to *cwd* if the
+ executable path is a relative path.
If *restore_signals* is True (the default) all signals that Python has set to
SIG_IGN are restored to SIG_DFL in the child process before the exec.
diff --git a/Doc/library/tempfile.rst b/Doc/library/tempfile.rst
--- a/Doc/library/tempfile.rst
+++ b/Doc/library/tempfile.rst
@@ -86,6 +86,9 @@
whether :func:`rollover` has been called. This file-like object can be
used in a :keyword:`with` statement, just like a normal file.
+ .. versionchanged:: 3.3
+ the truncate method now accepts a ``size`` argument.
+
.. function:: TemporaryDirectory(suffix='', prefix='tmp', dir=None)
diff --git a/Doc/library/threading.rst b/Doc/library/threading.rst
--- a/Doc/library/threading.rst
+++ b/Doc/library/threading.rst
@@ -21,7 +21,7 @@
supported by this module.
-This module defines the following functions and objects:
+This module defines the following functions:
.. function:: active_count()
@@ -30,16 +30,6 @@
count is equal to the length of the list returned by :func:`.enumerate`.
-.. function:: Condition()
- :noindex:
-
- A factory function that returns a new condition variable object. A condition
- variable allows one or more threads to wait until they are notified by another
- thread.
-
- See :ref:`condition-objects`.
-
-
.. function:: current_thread()
Return the current :class:`Thread` object, corresponding to the caller's thread
@@ -67,88 +57,6 @@
and threads that have not yet been started.
-.. function:: Event()
- :noindex:
-
- A factory function that returns a new event object. An event manages a flag
- that can be set to true with the :meth:`~Event.set` method and reset to false
- with the :meth:`clear` method. The :meth:`wait` method blocks until the flag
- is true.
-
- See :ref:`event-objects`.
-
-
-.. class:: local
-
- A class that represents thread-local data. Thread-local data are data whose
- values are thread specific. To manage thread-local data, just create an
- instance of :class:`local` (or a subclass) and store attributes on it::
-
- mydata = threading.local()
- mydata.x = 1
-
- The instance's values will be different for separate threads.
-
- For more details and extensive examples, see the documentation string of the
- :mod:`_threading_local` module.
-
-
-.. function:: Lock()
-
- A factory function that returns a new primitive lock object. Once a thread has
- acquired it, subsequent attempts to acquire it block, until it is released; any
- thread may release it.
-
- See :ref:`lock-objects`.
-
-
-.. function:: RLock()
-
- A factory function that returns a new reentrant lock object. A reentrant lock
- must be released by the thread that acquired it. Once a thread has acquired a
- reentrant lock, the same thread may acquire it again without blocking; the
- thread must release it once for each time it has acquired it.
-
- See :ref:`rlock-objects`.
-
-
-.. function:: Semaphore(value=1)
- :noindex:
-
- A factory function that returns a new semaphore object. A semaphore manages a
- counter representing the number of :meth:`release` calls minus the number of
- :meth:`acquire` calls, plus an initial value. The :meth:`acquire` method blocks
- if necessary until it can return without making the counter negative. If not
- given, *value* defaults to 1.
-
- See :ref:`semaphore-objects`.
-
-
-.. function:: BoundedSemaphore(value=1)
-
- A factory function that returns a new bounded semaphore object. A bounded
- semaphore checks to make sure its current value doesn't exceed its initial
- value. If it does, :exc:`ValueError` is raised. In most situations semaphores
- are used to guard resources with limited capacity. If the semaphore is released
- too many times it's a sign of a bug. If not given, *value* defaults to 1.
-
-
-.. class:: Thread
-
- A class that represents a thread of control. This class can be safely
- subclassed in a limited fashion.
-
- See :ref:`thread-objects`.
-
-
-.. class:: Timer
- :noindex:
-
- A thread that executes a function after a specified interval has passed.
-
- See :ref:`timer-objects`.
-
-
.. function:: settrace(func)
.. index:: single: trace function
@@ -197,7 +105,8 @@
.. versionadded:: 3.2
-Detailed interfaces for the objects are documented below.
+This module defines a number of classes, which are detailed in the sections
+below.
The design of this module is loosely based on Java's threading model. However,
where Java makes locks and condition variables basic behavior of every object,
@@ -210,17 +119,38 @@
All of the methods described below are executed atomically.
+Thread-Local Data
+-----------------
+
+Thread-local data is data whose values are thread specific. To manage
+thread-local data, just create an instance of :class:`local` (or a
+subclass) and store attributes on it::
+
+ mydata = threading.local()
+ mydata.x = 1
+
+The instance's values will be different for separate threads.
+
+
+.. class:: local()
+
+ A class that represents thread-local data.
+
+ For more details and extensive examples, see the documentation string of the
+ :mod:`_threading_local` module.
+
+
.. _thread-objects:
Thread Objects
--------------
-This class represents an activity that is run in a separate thread of control.
-There are two ways to specify the activity: by passing a callable object to the
-constructor, or by overriding the :meth:`~Thread.run` method in a subclass.
-No other methods (except for the constructor) should be overridden in a
-subclass. In other words, *only* override the :meth:`~Thread.__init__`
-and :meth:`~Thread.run` methods of this class.
+The :class:`Thread` class represents an activity that is run in a separate
+thread of control. There are two ways to specify the activity: by passing a
+callable object to the constructor, or by overriding the :meth:`~Thread.run`
+method in a subclass. No other methods (except for the constructor) should be
+overridden in a subclass. In other words, *only* override the
+:meth:`~Thread.__init__` and :meth:`~Thread.run` methods of this class.
Once a thread object is created, its activity must be started by calling the
thread's :meth:`~Thread.start` method. This invokes the :meth:`~Thread.run`
@@ -419,45 +349,55 @@
All methods are executed atomically.
-.. method:: Lock.acquire(blocking=True, timeout=-1)
+.. class:: Lock()
- Acquire a lock, blocking or non-blocking.
+ The class implementing primitive lock objects. Once a thread has acquired a
+ lock, subsequent attempts to acquire it block, until it is released; any
+ thread may release it.
- When invoked with the *blocking* argument set to ``True`` (the default),
- block until the lock is unlocked, then set it to locked and return ``True``.
+ .. versionchanged:: 3.3
+ Changed from a factory function to a class.
- When invoked with the *blocking* argument set to ``False``, do not block.
- If a call with *blocking* set to ``True`` would block, return ``False``
- immediately; otherwise, set the lock to locked and return ``True``.
- When invoked with the floating-point *timeout* argument set to a positive
- value, block for at most the number of seconds specified by *timeout*
- and as long as the lock cannot be acquired. A negative *timeout* argument
- specifies an unbounded wait. It is forbidden to specify a *timeout*
- when *blocking* is false.
+ .. method:: acquire(blocking=True, timeout=-1)
- The return value is ``True`` if the lock is acquired successfully,
- ``False`` if not (for example if the *timeout* expired).
+ Acquire a lock, blocking or non-blocking.
- .. versionchanged:: 3.2
- The *timeout* parameter is new.
+ When invoked with the *blocking* argument set to ``True`` (the default),
+ block until the lock is unlocked, then set it to locked and return ``True``.
- .. versionchanged:: 3.2
- Lock acquires can now be interrupted by signals on POSIX.
+ When invoked with the *blocking* argument set to ``False``, do not block.
+ If a call with *blocking* set to ``True`` would block, return ``False``
+ immediately; otherwise, set the lock to locked and return ``True``.
+ When invoked with the floating-point *timeout* argument set to a positive
+ value, block for at most the number of seconds specified by *timeout*
+ and as long as the lock cannot be acquired. A negative *timeout* argument
+ specifies an unbounded wait. It is forbidden to specify a *timeout*
+ when *blocking* is false.
-.. method:: Lock.release()
+ The return value is ``True`` if the lock is acquired successfully,
+ ``False`` if not (for example if the *timeout* expired).
- Release a lock. This can be called from any thread, not only the thread
- which has acquired the lock.
+ .. versionchanged:: 3.2
+ The *timeout* parameter is new.
- When the lock is locked, reset it to unlocked, and return. If any other threads
- are blocked waiting for the lock to become unlocked, allow exactly one of them
- to proceed.
+ .. versionchanged:: 3.2
+ Lock acquires can now be interrupted by signals on POSIX.
- When invoked on an unlocked lock, a :exc:`RuntimeError` is raised.
- There is no return value.
+ .. method:: release()
+
+ Release a lock. This can be called from any thread, not only the thread
+ which has acquired the lock.
+
+ When the lock is locked, reset it to unlocked, and return. If any other threads
+ are blocked waiting for the lock to become unlocked, allow exactly one of them
+ to proceed.
+
+ When invoked on an unlocked lock, a :exc:`RuntimeError` is raised.
+
+ There is no return value.
.. _rlock-objects:
@@ -481,47 +421,59 @@
Reentrant locks also support the :ref:`context manager protocol <with-locks>`.
-.. method:: RLock.acquire(blocking=True, timeout=-1)
+.. class:: RLock()
- Acquire a lock, blocking or non-blocking.
+ This class implements reentrant lock objects. A reentrant lock must be
+ released by the thread that acquired it. Once a thread has acquired a
+ reentrant lock, the same thread may acquire it again without blocking; the
+ thread must release it once for each time it has acquired it.
- When invoked without arguments: if this thread already owns the lock, increment
- the recursion level by one, and return immediately. Otherwise, if another
- thread owns the lock, block until the lock is unlocked. Once the lock is
- unlocked (not owned by any thread), then grab ownership, set the recursion level
- to one, and return. If more than one thread is blocked waiting until the lock
- is unlocked, only one at a time will be able to grab ownership of the lock.
- There is no return value in this case.
+ Note that ``RLock`` is actually a factory function which returns an instance
+ of the most efficient version of the concrete RLock class that is supported
+ by the platform.
- When invoked with the *blocking* argument set to true, do the same thing as when
- called without arguments, and return true.
- When invoked with the *blocking* argument set to false, do not block. If a call
- without an argument would block, return false immediately; otherwise, do the
- same thing as when called without arguments, and return true.
+ .. method:: acquire(blocking=True, timeout=-1)
- When invoked with the floating-point *timeout* argument set to a positive
- value, block for at most the number of seconds specified by *timeout*
- and as long as the lock cannot be acquired. Return true if the lock has
- been acquired, false if the timeout has elapsed.
+ Acquire a lock, blocking or non-blocking.
- .. versionchanged:: 3.2
- The *timeout* parameter is new.
+ When invoked without arguments: if this thread already owns the lock, increment
+ the recursion level by one, and return immediately. Otherwise, if another
+ thread owns the lock, block until the lock is unlocked. Once the lock is
+ unlocked (not owned by any thread), then grab ownership, set the recursion level
+ to one, and return. If more than one thread is blocked waiting until the lock
+ is unlocked, only one at a time will be able to grab ownership of the lock.
+ There is no return value in this case.
+ When invoked with the *blocking* argument set to true, do the same thing as when
+ called without arguments, and return true.
-.. method:: RLock.release()
+ When invoked with the *blocking* argument set to false, do not block. If a call
+ without an argument would block, return false immediately; otherwise, do the
+ same thing as when called without arguments, and return true.
- Release a lock, decrementing the recursion level. If after the decrement it is
- zero, reset the lock to unlocked (not owned by any thread), and if any other
- threads are blocked waiting for the lock to become unlocked, allow exactly one
- of them to proceed. If after the decrement the recursion level is still
- nonzero, the lock remains locked and owned by the calling thread.
+ When invoked with the floating-point *timeout* argument set to a positive
+ value, block for at most the number of seconds specified by *timeout*
+ and as long as the lock cannot be acquired. Return true if the lock has
+ been acquired, false if the timeout has elapsed.
- Only call this method when the calling thread owns the lock. A
- :exc:`RuntimeError` is raised if this method is called when the lock is
- unlocked.
+ .. versionchanged:: 3.2
+ The *timeout* parameter is new.
- There is no return value.
+
+ .. method:: release()
+
+ Release a lock, decrementing the recursion level. If after the decrement it is
+ zero, reset the lock to unlocked (not owned by any thread), and if any other
+ threads are blocked waiting for the lock to become unlocked, allow exactly one
+ of them to proceed. If after the decrement the recursion level is still
+ nonzero, the lock remains locked and owned by the calling thread.
+
+ Only call this method when the calling thread owns the lock. A
+ :exc:`RuntimeError` is raised if this method is called when the lock is
+ unlocked.
+
+ There is no return value.
.. _condition-objects:
@@ -556,10 +508,6 @@
the thread that called :meth:`~Condition.notify` or :meth:`~Condition.notify_all`
finally relinquishes ownership of the lock.
-
-Usage
-^^^^^
-
The typical programming style using condition variables uses the lock to
synchronize access to some shared state; threads that are interested in a
particular change of state call :meth:`~Condition.wait` repeatedly until they
@@ -598,15 +546,18 @@
item to the buffer only needs to wake up one consumer thread.
-Interface
-^^^^^^^^^
+.. class:: Condition(lock=None)
-.. class:: Condition(lock=None)
+ This class implements condition variable objects. A condition variable
+ allows one or more threads to wait until they are notified by another thread.
If the *lock* argument is given and not ``None``, it must be a :class:`Lock`
or :class:`RLock` object, and it is used as the underlying lock. Otherwise,
a new :class:`RLock` object is created and used as the underlying lock.
+ .. versionchanged:: 3.3
+ changed from a factory function to a class.
+
.. method:: acquire(*args)
Acquire the underlying lock. This method calls the corresponding method on
@@ -716,10 +667,19 @@
.. class:: Semaphore(value=1)
+ This class implements semaphore objects. A semaphore manages a counter
+ representing the number of :meth:`release` calls minus the number of
+ :meth:`acquire` calls, plus an initial value. The :meth:`acquire` method
+ blocks if necessary until it can return without making the counter negative.
+ If not given, *value* defaults to 1.
+
The optional argument gives the initial *value* for the internal counter; it
defaults to ``1``. If the *value* given is less than 0, :exc:`ValueError` is
raised.
+ .. versionchanged:: 3.3
+ changed from a factory function to a class.
+
.. method:: acquire(blocking=True, timeout=None)
Acquire a semaphore.
@@ -752,6 +712,18 @@
than zero again, wake up that thread.
+.. class:: BoundedSemaphore(value=1)
+
+ Class implementing bounded semaphore objects. A bounded semaphore checks to
+ make sure its current value doesn't exceed its initial value. If it does,
+ :exc:`ValueError` is raised. In most situations semaphores are used to guard
+ resources with limited capacity. If the semaphore is released too many times
+ it's a sign of a bug. If not given, *value* defaults to 1.
+
+ .. versionchanged:: 3.3
+ changed from a factory function to a class.
+
+
.. _semaphore-examples:
:class:`Semaphore` Example
@@ -763,7 +735,7 @@
main thread would initialize the semaphore::
maxconnections = 5
- ...
+ # ...
pool_sema = BoundedSemaphore(value=maxconnections)
Once spawned, worker threads call the semaphore's acquire and release methods
@@ -772,7 +744,7 @@
with pool_sema:
conn = connectdb()
try:
- ... use connection ...
+ # ... use connection ...
finally:
conn.close()
@@ -795,7 +767,13 @@
.. class:: Event()
- The internal flag is initially false.
+ Class implementing event objects. An event manages a flag that can be set to
+ true with the :meth:`~Event.set` method and reset to false with the
+ :meth:`clear` method. The :meth:`wait` method blocks until the flag is true.
+ The flag is initially false.
+
+ .. versionchanged:: 3.3
+ changed from a factory function to a class.
.. method:: is_set()
@@ -860,6 +838,9 @@
Create a timer that will run *function* with arguments *args* and keyword
arguments *kwargs*, after *interval* seconds have passed.
+ .. versionchanged:: 3.3
+ changed from a factory function to a class.
+
.. method:: cancel()
Stop the timer, and cancel the execution of the timer's action. This will
diff --git a/Doc/library/time.rst b/Doc/library/time.rst
--- a/Doc/library/time.rst
+++ b/Doc/library/time.rst
@@ -557,7 +557,7 @@
:exc:`TypeError` is raised.
.. versionchanged:: 3.3
- :attr:`tm_gmtoff` and :attr:`tm_zone` attributes are avaliable on platforms
+ :attr:`tm_gmtoff` and :attr:`tm_zone` attributes are available on platforms
with C library supporting the corresponding fields in ``struct tm``.
.. function:: time()
diff --git a/Doc/library/timeit.rst b/Doc/library/timeit.rst
--- a/Doc/library/timeit.rst
+++ b/Doc/library/timeit.rst
@@ -14,113 +14,154 @@
--------------
This module provides a simple way to time small bits of Python code. It has both
-command line as well as callable interfaces. It avoids a number of common traps
-for measuring execution times. See also Tim Peters' introduction to the
-"Algorithms" chapter in the Python Cookbook, published by O'Reilly.
+a :ref:`command-line-interface` as well as a :ref:`callable <python-interface>`
+one. It avoids a number of common traps for measuring execution times.
+See also Tim Peters' introduction to the "Algorithms" chapter in the *Python
+Cookbook*, published by O'Reilly.
-The module defines the following public class:
+
+Basic Examples
+--------------
+
+The following example shows how the :ref:`command-line-interface`
+can be used to compare three different expressions:
+
+.. code-block:: sh
+
+ $ python -m timeit '"-".join(str(n) for n in range(100))'
+ 10000 loops, best of 3: 40.3 usec per loop
+ $ python -m timeit '"-".join([str(n) for n in range(100)])'
+ 10000 loops, best of 3: 33.4 usec per loop
+ $ python -m timeit '"-".join(map(str, range(100)))'
+ 10000 loops, best of 3: 25.2 usec per loop
+
+This can be achieved from the :ref:`python-interface` with::
+
+ >>> import timeit
+ >>> timeit.timeit('"-".join(str(n) for n in range(100))', number=10000)
+ 0.8187260627746582
+ >>> timeit.timeit('"-".join([str(n) for n in range(100)])', number=10000)
+ 0.7288308143615723
+ >>> timeit.timeit('"-".join(map(str, range(100)))', number=10000)
+ 0.5858950614929199
+
+Note however that :mod:`timeit` will automatically determine the number of
+repetitions only when the command-line interface is used. In the
+:ref:`timeit-examples` section you can find more advanced examples.
+
+
+.. _python-interface:
+
+Python Interface
+----------------
+
+The module defines three convenience functions and a public class:
+
+
+.. function:: timeit(stmt='pass', setup='pass', timer=<default timer>, number=1000000)
+
+ Create a :class:`Timer` instance with the given statement, *setup* code and
+ *timer* function and run its :meth:`.timeit` method with *number* executions.
+
+
+.. function:: repeat(stmt='pass', setup='pass', timer=<default timer>, repeat=3, number=1000000)
+
+ Create a :class:`Timer` instance with the given statement, *setup* code and
+ *timer* function and run its :meth:`.repeat` method with the given *repeat*
+ count and *number* executions.
+
+
+.. function:: default_timer()
+
+ The default timer, which is always :func:`time.perf_counter`.
+
+ .. versionchanged:: 3.3
+ :func:`time.perf_counter` is now the default timer.
.. class:: Timer(stmt='pass', setup='pass', timer=<timer function>)
Class for timing execution speed of small code snippets.
- The constructor takes a statement to be timed, an additional statement used for
- setup, and a timer function. Both statements default to ``'pass'``; the timer
- function is platform-dependent (see the module doc string). *stmt* and *setup*
- may also contain multiple statements separated by ``;`` or newlines, as long as
- they don't contain multi-line string literals.
+ The constructor takes a statement to be timed, an additional statement used
+ for setup, and a timer function. Both statements default to ``'pass'``;
+ the timer function is platform-dependent (see the module doc string).
+ *stmt* and *setup* may also contain multiple statements separated by ``;``
+ or newlines, as long as they don't contain multi-line string literals.
- To measure the execution time of the first statement, use the :meth:`Timer.timeit`
- method. The :meth:`repeat` method is a convenience to call :meth:`.timeit`
+ To measure the execution time of the first statement, use the :meth:`.timeit`
+ method. The :meth:`.repeat` method is a convenience to call :meth:`.timeit`
multiple times and return a list of results.
The *stmt* and *setup* parameters can also take objects that are callable
- without arguments. This will embed calls to them in a timer function that
+ without arguments. This will embed calls to them in a timer function that
will then be executed by :meth:`.timeit`. Note that the timing overhead is a
little larger in this case because of the extra function calls.
-.. method:: Timer.print_exc(file=None)
+ .. method:: Timer.timeit(number=1000000)
- Helper to print a traceback from the timed code.
+ Time *number* executions of the main statement. This executes the setup
+ statement once, and then returns the time it takes to execute the main
+ statement a number of times, measured in seconds as a float.
+ The argument is the number of times through the loop, defaulting to one
+ million. The main statement, the setup statement and the timer function
+ to be used are passed to the constructor.
- Typical use::
+ .. note::
- t = Timer(...) # outside the try/except
- try:
- t.timeit(...) # or t.repeat(...)
- except:
- t.print_exc()
+ By default, :meth:`.timeit` temporarily turns off :term:`garbage
+ collection` during the timing. The advantage of this approach is that
+ it makes independent timings more comparable. This disadvantage is
+ that GC may be an important component of the performance of the
+ function being measured. If so, GC can be re-enabled as the first
+ statement in the *setup* string. For example::
- The advantage over the standard traceback is that source lines in the compiled
- template will be displayed. The optional *file* argument directs where the
- traceback is sent; it defaults to ``sys.stderr``.
+ timeit.Timer('for i in range(10): oct(i)', 'gc.enable()').timeit()
-.. method:: Timer.repeat(repeat=3, number=1000000)
+ .. method:: Timer.repeat(repeat=3, number=1000000)
- Call :meth:`.timeit` a few times.
+ Call :meth:`.timeit` a few times.
- This is a convenience function that calls the :meth:`.timeit` repeatedly,
- returning a list of results. The first argument specifies how many times to
- call :meth:`.timeit`. The second argument specifies the *number* argument for
- :meth:`.timeit`.
+ This is a convenience function that calls the :meth:`.timeit` repeatedly,
+ returning a list of results. The first argument specifies how many times
+ to call :meth:`.timeit`. The second argument specifies the *number*
+ argument for :meth:`.timeit`.
- .. note::
+ .. note::
- It's tempting to calculate mean and standard deviation from the result vector
- and report these. However, this is not very useful. In a typical case, the
- lowest value gives a lower bound for how fast your machine can run the given
- code snippet; higher values in the result vector are typically not caused by
- variability in Python's speed, but by other processes interfering with your
- timing accuracy. So the :func:`min` of the result is probably the only number
- you should be interested in. After that, you should look at the entire vector
- and apply common sense rather than statistics.
+ It's tempting to calculate mean and standard deviation from the result
+ vector and report these. However, this is not very useful.
+ In a typical case, the lowest value gives a lower bound for how fast
+ your machine can run the given code snippet; higher values in the
+ result vector are typically not caused by variability in Python's
+ speed, but by other processes interfering with your timing accuracy.
+ So the :func:`min` of the result is probably the only number you
+ should be interested in. After that, you should look at the entire
+ vector and apply common sense rather than statistics.
-.. method:: Timer.timeit(number=1000000)
+ .. method:: Timer.print_exc(file=None)
- Time *number* executions of the main statement. This executes the setup
- statement once, and then returns the time it takes to execute the main statement
- a number of times, measured in seconds as a float. The argument is the number
- of times through the loop, defaulting to one million. The main statement, the
- setup statement and the timer function to be used are passed to the constructor.
+ Helper to print a traceback from the timed code.
- .. note::
+ Typical use::
- By default, :meth:`.timeit` temporarily turns off :term:`garbage collection`
- during the timing. The advantage of this approach is that it makes
- independent timings more comparable. This disadvantage is that GC may be
- an important component of the performance of the function being measured.
- If so, GC can be re-enabled as the first statement in the *setup* string.
- For example::
+ t = Timer(...) # outside the try/except
+ try:
+ t.timeit(...) # or t.repeat(...)
+ except:
+ t.print_exc()
- timeit.Timer('for i in range(10): oct(i)', 'gc.enable()').timeit()
+ The advantage over the standard traceback is that source lines in the
+ compiled template will be displayed. The optional *file* argument directs
+ where the traceback is sent; it defaults to :data:`sys.stderr`.
-The module also defines three convenience functions:
+.. _command-line-interface:
-
-.. function:: default_timer()
-
- The default timer, which is always :func:`time.perf_counter`.
-
-
-.. function:: repeat(stmt='pass', setup='pass', timer=<default timer>, repeat=3, number=1000000)
-
- Create a :class:`Timer` instance with the given statement, setup code and timer
- function and run its :meth:`repeat` method with the given repeat count and
- *number* executions.
-
-
-.. function:: timeit(stmt='pass', setup='pass', timer=<default timer>, number=1000000)
-
- Create a :class:`Timer` instance with the given statement, setup code and timer
- function and run its :meth:`.timeit` method with *number* executions.
-
-
-Command Line Interface
+Command-Line Interface
----------------------
When called as a program from the command line, the following form is used::
@@ -184,25 +225,53 @@
There is a certain baseline overhead associated with executing a pass statement.
The code here doesn't try to hide it, but you should be aware of it. The
- baseline overhead can be measured by invoking the program without arguments.
+ baseline overhead can be measured by invoking the program without arguments,
+ and it might differ between Python versions.
-The baseline overhead differs between Python versions! Also, to fairly compare
-older Python versions to Python 2.3, you may want to use Python's :option:`-O`
-option for the older versions to avoid timing ``SET_LINENO`` instructions.
+.. _timeit-examples:
Examples
--------
-Here are two example sessions (one using the command line, one using the module
-interface) that compare the cost of using :func:`hasattr` vs.
-:keyword:`try`/:keyword:`except` to test for missing and present object
-attributes. ::
+It is possible to provide a setup statement that is executed only once at the beginning:
+
+.. code-block:: sh
+
+ $ python -m timeit -s 'text = "sample string"; char = "g"' 'char in text'
+ 10000000 loops, best of 3: 0.0877 usec per loop
+ $ python -m timeit -s 'text = "sample string"; char = "g"' 'text.find(char)'
+ 1000000 loops, best of 3: 0.342 usec per loop
+
+::
+
+ >>> import timeit
+ >>> timeit.timeit('char in text', setup='text = "sample string"; char = "g"')
+ 0.41440500499993504
+ >>> timeit.timeit('text.find(char)', setup='text = "sample string"; char = "g"')
+ 1.7246671520006203
+
+The same can be done using the :class:`Timer` class and its methods::
+
+ >>> import timeit
+ >>> t = timeit.Timer('char in text', setup='text = "sample string"; char = "g"')
+ >>> t.timeit()
+ 0.3955516149999312
+ >>> t.repeat()
+ [0.40193588800002544, 0.3960157959998014, 0.39594301399984033]
+
+
+The following examples show how to time expressions that contain multiple lines.
+Here we compare the cost of using :func:`hasattr` vs. :keyword:`try`/:keyword:`except`
+to test for missing and present object attributes:
+
+.. code-block:: sh
$ python -m timeit 'try:' ' str.__bool__' 'except AttributeError:' ' pass'
100000 loops, best of 3: 15.7 usec per loop
$ python -m timeit 'if hasattr(str, "__bool__"): pass'
100000 loops, best of 3: 4.26 usec per loop
+
$ python -m timeit 'try:' ' int.__bool__' 'except AttributeError:' ' pass'
1000000 loops, best of 3: 1.43 usec per loop
$ python -m timeit 'if hasattr(int, "__bool__"): pass'
@@ -211,36 +280,32 @@
::
>>> import timeit
+ >>> # attribute is missing
>>> s = """\
... try:
... str.__bool__
... except AttributeError:
... pass
... """
- >>> t = timeit.Timer(stmt=s)
- >>> print("%.2f usec/pass" % (1000000 * t.timeit(number=100000)/100000))
- 17.09 usec/pass
- >>> s = """\
- ... if hasattr(str, '__bool__'): pass
- ... """
- >>> t = timeit.Timer(stmt=s)
- >>> print("%.2f usec/pass" % (1000000 * t.timeit(number=100000)/100000))
- 4.85 usec/pass
+ >>> timeit.timeit(stmt=s, number=100000)
+ 0.9138244460009446
+ >>> s = "if hasattr(str, '__bool__'): pass"
+ >>> timeit.timeit(stmt=s, number=100000)
+ 0.5829014980008651
+ >>>
+ >>> # attribute is present
>>> s = """\
... try:
... int.__bool__
... except AttributeError:
... pass
... """
- >>> t = timeit.Timer(stmt=s)
- >>> print("%.2f usec/pass" % (1000000 * t.timeit(number=100000)/100000))
- 1.97 usec/pass
- >>> s = """\
- ... if hasattr(int, '__bool__'): pass
- ... """
- >>> t = timeit.Timer(stmt=s)
- >>> print("%.2f usec/pass" % (1000000 * t.timeit(number=100000)/100000))
- 3.15 usec/pass
+ >>> timeit.timeit(stmt=s, number=100000)
+ 0.04215312199994514
+ >>> s = "if hasattr(int, '__bool__'): pass"
+ >>> timeit.timeit(stmt=s, number=100000)
+ 0.08588060699912603
+
To give the :mod:`timeit` module access to functions you define, you can pass a
*setup* parameter which contains an import statement::
@@ -250,7 +315,5 @@
L = [i for i in range(100)]
if __name__ == '__main__':
- from timeit import Timer
- t = Timer("test()", "from __main__ import test")
- print(t.timeit())
-
+ import timeit
+ print(timeit.timeit("test()", setup="from __main__ import test"))
diff --git a/Doc/library/urllib.rst b/Doc/library/urllib.rst
new file mode 100644
--- /dev/null
+++ b/Doc/library/urllib.rst
@@ -0,0 +1,9 @@
+:mod:`urllib` --- URL handling modules
+======================================
+
+``urllib`` is a package that collects several modules for working with URLs:
+
+* :mod:`urllib.request` for opening and reading URLs
+* :mod:`urllib.error` containing the exceptions raised by :mod:`urllib.request`
+* :mod:`urllib.parse` for parsing URLs
+* :mod:`urllib.robotparser` for parsing ``robots.txt`` files
diff --git a/Doc/library/xml.etree.elementtree.rst b/Doc/library/xml.etree.elementtree.rst
--- a/Doc/library/xml.etree.elementtree.rst
+++ b/Doc/library/xml.etree.elementtree.rst
@@ -291,7 +291,9 @@
| | current element. For example, ``.//egg`` selects |
| | all ``egg`` elements in the entire tree. |
+-----------------------+------------------------------------------------------+
-| ``..`` | Selects the parent element. |
+| ``..`` | Selects the parent element. Returns ``None`` if the |
+| | path attempts to reach the ancestors of the start |
+| | element (the element ``find`` was called on). |
+-----------------------+------------------------------------------------------+
| ``[@attrib]`` | Selects all elements that have the given attribute. |
+-----------------------+------------------------------------------------------+
@@ -431,9 +433,9 @@
Generates a string representation of an XML element, including all
subelements. *element* is an :class:`Element` instance. *encoding* [1]_ is
the output encoding (default is US-ASCII). Use ``encoding="unicode"`` to
- generate a Unicode string. *method* is either ``"xml"``,
- ``"html"`` or ``"text"`` (default is ``"xml"``). Returns an (optionally)
- encoded string containing the XML data.
+ generate a Unicode string (otherwise, a bytestring is generated). *method*
+ is either ``"xml"``, ``"html"`` or ``"text"`` (default is ``"xml"``).
+ Returns an (optionally) encoded string containing the XML data.
.. function:: tostringlist(element, encoding="us-ascii", method="xml")
@@ -441,11 +443,11 @@
Generates a string representation of an XML element, including all
subelements. *element* is an :class:`Element` instance. *encoding* [1]_ is
the output encoding (default is US-ASCII). Use ``encoding="unicode"`` to
- generate a Unicode string. *method* is either ``"xml"``,
- ``"html"`` or ``"text"`` (default is ``"xml"``). Returns a list of
- (optionally) encoded strings containing the XML data. It does not guarantee
- any specific sequence, except that ``"".join(tostringlist(element)) ==
- tostring(element)``.
+ generate a Unicode string (otherwise, a bytestring is generated). *method*
+ is either ``"xml"``, ``"html"`` or ``"text"`` (default is ``"xml"``).
+ Returns a list of (optionally) encoded strings containing the XML data.
+ It does not guarantee any specific sequence, except that
+ ``"".join(tostringlist(element)) == tostring(element)``.
.. versionadded:: 3.2
@@ -521,7 +523,7 @@
.. method:: clear()
Resets an element. This function removes all subelements, clears all
- attributes, and sets the text and tail attributes to None.
+ attributes, and sets the text and tail attributes to ``None``.
.. method:: get(key, default=None)
diff --git a/Doc/library/xml.rst b/Doc/library/xml.rst
new file mode 100644
--- /dev/null
+++ b/Doc/library/xml.rst
@@ -0,0 +1,29 @@
+.. _xml:
+
+XML Processing Modules
+======================
+
+Python's interfaces for processing XML are grouped in the ``xml`` package.
+
+It is important to note that modules in the :mod:`xml` package require that
+there be at least one SAX-compliant XML parser available. The Expat parser is
+included with Python, so the :mod:`xml.parsers.expat` module will always be
+available.
+
+The documentation for the :mod:`xml.dom` and :mod:`xml.sax` packages are the
+definition of the Python bindings for the DOM and SAX interfaces.
+
+The XML handling submodules are:
+
+* :mod:`xml.etree.ElementTree`: the ElementTree API, a simple and lightweight
+
+..
+
+* :mod:`xml.dom`: the DOM API definition
+* :mod:`xml.dom.minidom`: a lightweight DOM implementation
+* :mod:`xml.dom.pulldom`: support for building partial DOM trees
+
+..
+
+* :mod:`xml.sax`: SAX2 base classes and convenience functions
+* :mod:`xml.parsers.expat`: the Expat parser binding
diff --git a/Doc/library/xmlrpc.rst b/Doc/library/xmlrpc.rst
new file mode 100644
--- /dev/null
+++ b/Doc/library/xmlrpc.rst
@@ -0,0 +1,12 @@
+:mod:`xmlrpc` --- XMLRPC server and client modules
+==================================================
+
+XML-RPC is a Remote Procedure Call method that uses XML passed via HTTP as a
+transport. With it, a client can call methods with parameters on a remote
+server (the server is named by a URI) and get back structured data.
+
+``xmlrpc`` is a package that collects server and client modules implementing
+XML-RPC. The modules are:
+
+* :mod:`xmlrpc.client`
+* :mod:`xmlrpc.server`
diff --git a/Doc/library/zipfile.rst b/Doc/library/zipfile.rst
--- a/Doc/library/zipfile.rst
+++ b/Doc/library/zipfile.rst
@@ -61,7 +61,7 @@
.. class:: ZipInfo(filename='NoName', date_time=(1980,1,1,0,0,0))
Class used to represent information about a member of an archive. Instances
- of this class are returned by the :meth:`getinfo` and :meth:`infolist`
+ of this class are returned by the :meth:`.getinfo` and :meth:`.infolist`
methods of :class:`ZipFile` objects. Most users of the :mod:`zipfile` module
will not need to create these, but only use those created by this
module. *filename* should be the full name of the archive member, and
@@ -87,20 +87,20 @@
.. data:: ZIP_DEFLATED
The numeric constant for the usual ZIP compression method. This requires the
- zlib module.
+ :mod:`zlib` module.
.. data:: ZIP_BZIP2
The numeric constant for the BZIP2 compression method. This requires the
- bz2 module.
+ :mod:`bz2` module.
.. versionadded:: 3.3
.. data:: ZIP_LZMA
The numeric constant for the LZMA compression method. This requires the
- lzma module.
+ :mod:`lzma` module.
.. versionadded:: 3.3
@@ -155,7 +155,7 @@
these extensions.
If the file is created with mode ``'a'`` or ``'w'`` and then
- :meth:`close`\ d without adding any files to the archive, the appropriate
+ :meth:`closed <close>` without adding any files to the archive, the appropriate
ZIP structures for an empty archive will be written to the file.
ZipFile is also a context manager and therefore supports the
@@ -169,7 +169,7 @@
Added the ability to use :class:`ZipFile` as a context manager.
.. versionchanged:: 3.3
- Added support for :mod:`bzip2` and :mod:`lzma` compression.
+ Added support for :mod:`bzip2 <bz2>` and :mod:`lzma` compression.
.. method:: ZipFile.close()
@@ -207,7 +207,7 @@
*mode* parameter, if included, must be one of the following: ``'r'`` (the
default), ``'U'``, or ``'rU'``. Choosing ``'U'`` or ``'rU'`` will enable
:term:`universal newlines` support in the read-only object. *pwd* is the
- password used for encrypted files. Calling :meth:`open` on a closed
+ password used for encrypted files. Calling :meth:`.open` on a closed
ZipFile will raise a :exc:`RuntimeError`.
.. note::
@@ -229,7 +229,7 @@
.. note::
- The :meth:`open`, :meth:`read` and :meth:`extract` methods can take a filename
+ The :meth:`.open`, :meth:`read` and :meth:`extract` methods can take a filename
or a :class:`ZipInfo` object. You will appreciate this when trying to read a
ZIP file that contains members with duplicate names.
@@ -335,7 +335,7 @@
:class:`ZipInfo` constructor sets this member to :const:`ZIP_STORED`.
.. versionchanged:: 3.2
- The *compression_type* argument.
+ The *compress_type* argument.
The following data attributes are also available:
@@ -351,7 +351,7 @@
The comment text associated with the ZIP file. If assigning a comment to a
:class:`ZipFile` instance created with mode 'a' or 'w', this should be a
string no longer than 65535 bytes. Comments longer than this will be
- truncated in the written archive when :meth:`ZipFile.close` is called.
+ truncated in the written archive when :meth:`close` is called.
.. _pyzipfile-objects:
@@ -407,8 +407,8 @@
ZipInfo Objects
---------------
-Instances of the :class:`ZipInfo` class are returned by the :meth:`getinfo` and
-:meth:`infolist` methods of :class:`ZipFile` objects. Each object stores
+Instances of the :class:`ZipInfo` class are returned by the :meth:`.getinfo` and
+:meth:`.infolist` methods of :class:`ZipFile` objects. Each object stores
information about a single member of the ZIP archive.
Instances have the following attributes:
diff --git a/Doc/make.bat b/Doc/make.bat
--- a/Doc/make.bat
+++ b/Doc/make.bat
@@ -37,7 +37,7 @@
svn co %SVNROOT%/external/Sphinx-1.0.7/sphinx tools/sphinx
svn co %SVNROOT%/external/docutils-0.6/docutils tools/docutils
svn co %SVNROOT%/external/Jinja-2.3.1/jinja2 tools/jinja2
-svn co %SVNROOT%/external/Pygments-1.3.1/pygments tools/pygments
+svn co %SVNROOT%/external/Pygments-1.5dev-20120930/pygments tools/pygments
goto end
:update
diff --git a/Doc/reference/datamodel.rst b/Doc/reference/datamodel.rst
--- a/Doc/reference/datamodel.rst
+++ b/Doc/reference/datamodel.rst
@@ -312,7 +312,7 @@
A bytes object is an immutable array. The items are 8-bit bytes,
represented by integers in the range 0 <= x < 256. Bytes literals
- (like ``b'abc'`` and the built-in function :func:`bytes` can be used to
+ (like ``b'abc'``) and the built-in function :func:`bytes` can be used to
construct bytes objects. Also, bytes objects can be decoded to strings
via the :meth:`decode` method.
diff --git a/Doc/reference/expressions.rst b/Doc/reference/expressions.rst
--- a/Doc/reference/expressions.rst
+++ b/Doc/reference/expressions.rst
@@ -1094,16 +1094,10 @@
another one is made arbitrarily but consistently within one execution of a
program.
-Comparison of objects of the differing types depends on whether either
-of the types provide explicit support for the comparison. Most numeric types
-can be compared with one another, but comparisons of :class:`float` and
-:class:`Decimal` are not supported to avoid the inevitable confusion arising
-from representation issues such as ``float('1.1')`` being inexactly represented
-and therefore not exactly equal to ``Decimal('1.1')`` which is. When
-cross-type comparison is not supported, the comparison method returns
-``NotImplemented``. This can create the illusion of non-transitivity between
-supported cross-type comparisons and unsupported comparisons. For example,
-``Decimal(2) == 2`` and ``2 == float(2)`` but ``Decimal(2) != float(2)``.
+Comparison of objects of the differing types depends on whether either of the
+types provide explicit support for the comparison. Most numeric types can be
+compared with one another. When cross-type comparison is not supported, the
+comparison method returns ``NotImplemented``.
.. _membership-test-details:
diff --git a/Doc/reference/lexical_analysis.rst b/Doc/reference/lexical_analysis.rst
--- a/Doc/reference/lexical_analysis.rst
+++ b/Doc/reference/lexical_analysis.rst
@@ -538,9 +538,7 @@
this escape sequence. Exactly four hex digits are required.
(6)
- Any Unicode character can be encoded this way, but characters outside the Basic
- Multilingual Plane (BMP) will be encoded using a surrogate pair if Python is
- compiled to use 16-bit code units (the default). Exactly eight hex digits
+ Any Unicode character can be encoded this way. Exactly eight hex digits
are required.
diff --git a/Doc/tools/sphinxext/indexsidebar.html b/Doc/tools/sphinxext/indexsidebar.html
--- a/Doc/tools/sphinxext/indexsidebar.html
+++ b/Doc/tools/sphinxext/indexsidebar.html
@@ -3,7 +3,7 @@
<h3>Docs for other versions</h3>
<ul>
<li><a href="http://docs.python.org/2.7/">Python 2.7 (stable)</a></li>
- <li><a href="http://docs.python.org/3.2/">Python 3.2 (stable)</a></li>
+ <li><a href="http://docs.python.org/3.4/">Python 3.4 (in development)</a></li>
<li><a href="http://www.python.org/doc/versions/">Old versions</a></li>
</ul>
diff --git a/Doc/tools/sphinxext/layout.html b/Doc/tools/sphinxext/layout.html
--- a/Doc/tools/sphinxext/layout.html
+++ b/Doc/tools/sphinxext/layout.html
@@ -8,13 +8,70 @@
{% block extrahead %}
<link rel="shortcut icon" type="image/png" href="{{ pathto('_static/py.png', 1) }}" />
{% if not embedded %}<script type="text/javascript" src="{{ pathto('_static/copybutton.js', 1) }}"></script>{% endif %}
+ {% if pagename == 'whatsnew/changelog' %}
+ <script type="text/javascript">
+ $(document).ready(function() {
+ // add the search form and bind the events
+ $('h1').after([
+ '<p>Filter entries by content:',
+ '<input type="text" value="" id="searchbox" style="width: 50%">',
+ '<input type="submit" id="searchbox-submit" value="Filter"></p>'
+ ].join('\n'));
+
+ function dofilter() {
+ try {
+ var query = new RegExp($('#searchbox').val(), 'i');
+ }
+ catch (e) {
+ return; // not a valid regex (yet)
+ }
+ // find headers for the versions (What's new in Python X.Y.Z?)
+ $('#changelog h2').each(function(index1, h2) {
+ var h2_parent = $(h2).parent();
+ var sections_found = 0;
+ // find headers for the sections (Core, Library, etc.)
+ h2_parent.find('h3').each(function(index2, h3) {
+ var h3_parent = $(h3).parent();
+ var entries_found = 0;
+ // find all the entries
+ h3_parent.find('li').each(function(index3, li) {
+ var li = $(li);
+ // check if the query matches the entry
+ if (query.test(li.text())) {
+ li.show();
+ entries_found++;
+ }
+ else {
+ li.hide();
+ }
+ });
+ // if there are entries, show the section, otherwise hide it
+ if (entries_found > 0) {
+ h3_parent.show();
+ sections_found++;
+ }
+ else {
+ h3_parent.hide();
+ }
+ });
+ if (sections_found > 0)
+ h2_parent.show();
+ else
+ h2_parent.hide();
+ });
+ }
+ $('#searchbox').keyup(dofilter);
+ $('#searchbox-submit').click(dofilter);
+ });
+ </script>
+ {% endif %}
{{ super() }}
{% endblock %}
{% block footer %}
<div class="footer">
© <a href="{{ pathto('copyright') }}">Copyright</a> {{ copyright|e }}.
<br />
- The Python Software Foundation is a non-profit corporation.
+ The Python Software Foundation is a non-profit corporation.
<a href="http://www.python.org/psf/donations/">Please donate.</a>
<br />
Last updated on {{ last_updated|e }}.
diff --git a/Doc/tools/sphinxext/pyspecific.py b/Doc/tools/sphinxext/pyspecific.py
--- a/Doc/tools/sphinxext/pyspecific.py
+++ b/Doc/tools/sphinxext/pyspecific.py
@@ -145,6 +145,47 @@
return ret
+# Support for including Misc/NEWS
+
+import re
+import codecs
+
+issue_re = re.compile('([Ii])ssue #([0-9]+)')
+whatsnew_re = re.compile(r"(?im)^what's new in (.*?)\??$")
+
+class MiscNews(Directive):
+ has_content = False
+ required_arguments = 1
+ optional_arguments = 0
+ final_argument_whitespace = False
+ option_spec = {}
+
+ def run(self):
+ fname = self.arguments[0]
+ source = self.state_machine.input_lines.source(
+ self.lineno - self.state_machine.input_offset - 1)
+ source_dir = path.dirname(path.abspath(source))
+ fpath = path.join(source_dir, fname)
+ self.state.document.settings.record_dependencies.add(fpath)
+ try:
+ fp = codecs.open(fpath, encoding='utf-8')
+ try:
+ content = fp.read()
+ finally:
+ fp.close()
+ except Exception:
+ text = 'The NEWS file is not available.'
+ node = nodes.strong(text, text)
+ return [node]
+ content = issue_re.sub(r'`\1ssue #\2 <http://bugs.python.org/\2>`__',
+ content)
+ content = whatsnew_re.sub(r'\1', content)
+ # remove first 3 lines as they are the main heading
+ lines = ['.. default-role:: obj', ''] + content.splitlines()[3:]
+ self.state_machine.insert_input(lines, fname)
+ return []
+
+
# Support for building "topic help" for pydoc
pydoc_topic_labels = [
@@ -276,3 +317,4 @@
app.add_description_unit('2to3fixer', '2to3fixer', '%s (2to3 fixer)')
app.add_directive_to_domain('py', 'decorator', PyDecoratorFunction)
app.add_directive_to_domain('py', 'decoratormethod', PyDecoratorMethod)
+ app.add_directive('miscnews', MiscNews)
diff --git a/Doc/tools/sphinxext/susp-ignored.csv b/Doc/tools/sphinxext/susp-ignored.csv
--- a/Doc/tools/sphinxext/susp-ignored.csv
+++ b/Doc/tools/sphinxext/susp-ignored.csv
@@ -357,3 +357,15 @@
whatsnew/3.2,,:location,zope9-location = ${zope9:location}
whatsnew/3.2,,:prefix,... zope-conf = ${custom:prefix}/etc/zope.conf
whatsnew/3.2,,:prefix,zope-conf = ${custom:prefix}/etc/zope.conf
+whatsnew/news,,:platform,:platform:
+whatsnew/news,,:password,: Unquote before b64encoding user:password during Basic
+whatsnew/news,,:close,Connection:close header.
+whatsnew/news,,:PythonCmd,"With Tk < 8.5 _tkinter.c:PythonCmd() raised UnicodeDecodeError, caused"
+whatsnew/news,,:close,: Connection:close header is sent by requests using URLOpener
+whatsnew/news,,::,": Fix FTP tests for IPv6, bind to ""::1"" instead of ""localhost""."
+whatsnew/news,,:test,: test_subprocess:test_leaking_fds_on_error no longer gives a
+whatsnew/news,,:test,: Fix test_posix:test_getgroups failure under Solaris. Patch
+whatsnew/news,,:Olimit,Drop -OPT:Olimit compiler option.
+whatsnew/news,,:MAXYEAR,timedelta from date or datetime falls outside of the MINYEAR:MAXYEAR range.
+whatsnew/news,,:bz2,with mode 'r' or 'r:bz2' and a fileobj argument that contained no data or
+whatsnew/news,,:db2,: Add configure option --with-dbmliborder=db1:db2:... to specify
diff --git a/Doc/using/windows.rst b/Doc/using/windows.rst
--- a/Doc/using/windows.rst
+++ b/Doc/using/windows.rst
@@ -132,6 +132,8 @@
Setting Environment variables, Louis J. Farrugia
+.. _windows-path-mod:
+
Finding the Python executable
-----------------------------
diff --git a/Doc/whatsnew/3.3.rst b/Doc/whatsnew/3.3.rst
--- a/Doc/whatsnew/3.3.rst
+++ b/Doc/whatsnew/3.3.rst
@@ -2,7 +2,6 @@
What's New In Python 3.3
****************************
-:Author: Raymond Hettinger
:Release: |release|
:Date: |today|
@@ -47,7 +46,12 @@
when researching a change.
This article explains the new features in Python 3.3, compared to 3.2.
-Python 3.3 was released on September 29, 2012.
+Python 3.3 was released on September 29, 2012. For full details,
+see the :source:`Misc/NEWS` file.
+
+.. seealso::
+
+ :pep:`398` - Python 3.3 Release Schedule
Summary -- Release highlights
@@ -80,6 +84,12 @@
* More compact :ref:`unicode strings <pep-393>`.
* More compact :ref:`attribute dictionaries <pep-412>`.
+Significantly Improved Library Modules:
+
+* C Accelerator for the :ref:`decimal <new-decimal>` module.
+* Better unicode handling in the :ref:`email <new-email>` module
+ (:term:`provisional <provisional package>`).
+
Security improvements:
* Hash randomization is switched on by default.
@@ -92,9 +102,6 @@
PEP 405: Virtual Environments
=============================
-:pep:`405` - Python Virtual Environments
- PEP written by Carl Meyer, implemented by Carl Meyer and Vinay Sajip.
-
Virtual environments help create separate Python setups while sharing a
system-wide base install, for ease of maintenance. Virtual environments
have their own set of private site packages (i.e. locally-installed
@@ -105,10 +112,17 @@
This PEP adds the :mod:`venv` module for programmatic access, and the
:ref:`pyvenv <scripts-pyvenv>` script for command-line access and
-administration. The Python interpreter becomes aware of a ``pvenv.cfg``
+administration. The Python interpreter checks for a ``pvenv.cfg``,
file whose existence signals the base of a virtual environment's directory
tree.
+(Implemented by Carl Meyer and Vinay Sajip.)
+
+.. seealso::
+
+ :pep:`405` - Python Virtual Environments
+ PEP written by Carl Meyer
+
PEP 420: Namespace Packages
===========================
@@ -118,14 +132,19 @@
various third party approaches to namespace packages, as described in
:pep:`420`)
+.. seealso::
+
+ :pep:`420` - Namespace packages
+ PEP written by Eric V. Smith; implementation by Eric V. Smith
+ and Barry Warsaw
+
.. _pep-3118-update:
PEP 3118: New memoryview implementation and buffer protocol documentation
=========================================================================
-:issue:`10181` - memoryview bug fixes and features.
- Written by Stefan Krah.
+The implementation of :pep:`3118` has been significantly improved.
The new memoryview implementation comprehensively fixes all ownership and
lifetime issues of dynamically allocated fields in the Py_buffer struct
@@ -182,6 +201,13 @@
* For further changes see `Build and C API Changes`_ and `Porting C code`_ .
+(Contributed by Stefan Krah in :issue:`10181`)
+
+.. seealso::
+
+ :pep:`3118` - Revising the Buffer Protocol
+
+
.. _pep-393:
PEP 393: Flexible String Representation
@@ -256,15 +282,55 @@
bit better than Python 2.7, on a Django benchmark (see the PEP for
details).
+.. seealso::
+
+ :pep:`393` - Flexible String Representation
+ PEP written by Martin von Löwis; implementation by Torsten Becker
+ and Martin von Löwis.
+
+
+.. _pep-397:
+
+PEP 397: Python Launcher for Windows
+====================================
+
+The Python 3.3 Windows installer now includes a ``py`` launcher application
+that can be used to launch Python applications in a version independent
+fashion.
+
+This launcher is invoked implicitly when double-clicking ``*.py`` files.
+If only a single Python version is installed on the system, that version
+will be used to run the file. If multiple versions are installed, the most
+recent version is used by default, but this can be overridden by including
+a Unix-style "shebang line" in the Python script.
+
+The launcher can also be used explicitly from the command line as the ``py``
+application. Running ``py`` follows the same version selection rules as
+implicitly launching scripts, but a more specific version can be selected
+by passing appropriate arguments (such as ``-3`` to request Python 3 when
+Python 2 is also installed, or ``-2.6`` to specifclly request an earlier
+Python version when a more recent version is installed).
+
+In addition to the launcher, the Windows installer now includes an
+option to add the newly installed Python to the system PATH (contributed
+by Brian Curtin in :issue:`3561`).
+
+.. seealso::
+
+ :pep:`397` - Python Launcher for Windows
+ PEP written by Mark Hammond and Martin v. Löwis; implementation by
+ Vinay Sajip.
+
+ Launcher documentation: :ref:`launcher`
+
+ Installer PATH modification: :ref:`windows-path-mod`
+
.. _pep-3151:
PEP 3151: Reworking the OS and IO exception hierarchy
=====================================================
-:pep:`3151` - Reworking the OS and IO exception hierarchy
- PEP written and implemented by Antoine Pitrou.
-
The hierarchy of exceptions raised by operating system errors is now both
simplified and finer-grained.
@@ -326,15 +392,17 @@
except PermissionError:
print("You are not allowed to read document.txt")
+.. seealso::
+
+ :pep:`3151` - Reworking the OS and IO Exception Hierarchy
+ PEP written and implemented by Antoine Pitrou
+
.. _pep-380:
PEP 380: Syntax for Delegating to a Subgenerator
================================================
-:pep:`380` - Syntax for Delegating to a Subgenerator
- PEP written by Greg Ewing.
-
PEP 380 adds the ``yield from`` expression, allowing a generator to delegate
part of its operations to another generator. This allows a section of code
containing 'yield' to be factored out and placed in another generator.
@@ -390,17 +458,17 @@
multiple subgenerators as easily as a single large function can be split into
multiple subfunctions.
-(Implementation by Greg Ewing, integrated into 3.3 by Renaud Blanch, Ryan
-Kelly and Nick Coghlan, documentation by Zbigniew Jędrzejewski-Szmek and
-Nick Coghlan)
+.. seealso::
+
+ :pep:`380` - Syntax for Delegating to a Subgenerator
+ PEP written by Greg Ewing; implementation by Greg Ewing, integrated into
+ 3.3 by Renaud Blanch, Ryan Kelly and Nick Coghlan, documentation by
+ Zbigniew Jędrzejewski-Szmek and Nick Coghlan)
PEP 409: Suppressing exception context
======================================
-:pep:`409` - Suppressing exception context
- PEP written by Ethan Furman, implemented by Ethan Furman and Nick Coghlan.
-
PEP 409 introduces new syntax that allows the display of the chained
exception context to be disabled. This allows cleaner error messages in
applications that convert between exception types::
@@ -455,13 +523,16 @@
...
KeyError('x',)
+.. seealso::
+
+ :pep:`409` - Suppressing exception context
+ PEP written by Ethan Furman; implemented by Ethan Furman and Nick
+ Coghlan.
+
PEP 414: Explicit Unicode literals
======================================
-:pep:`414` - Explicit Unicode literals
- PEP written by Armin Ronacher.
-
To ease the transition from Python 2 for Unicode aware Python applications
that make heavy use of Unicode literals, Python 3.3 once again supports the
"``u``" prefix for string literals. This prefix has no semantic significance
@@ -470,13 +541,15 @@
the more significant semantic changes (such as the stricter default
separation of binary and text data).
+.. seealso::
+
+ :pep:`414` - Explicit Unicode literals
+ PEP written by Armin Ronacher.
+
PEP 3155: Qualified name for classes and functions
==================================================
-:pep:`3155` - Qualified name for classes and functions
- PEP written and implemented by Antoine Pitrou.
-
Functions and class objects have a new ``__qualname__`` attribute representing
the "path" from the module top-level to their definition. For global functions
and classes, this is the same as ``__name__``. For other functions and classes,
@@ -529,28 +602,31 @@
>>> str(C.D.meth)
'<function C.D.meth at 0x7f46b9fe31e0>'
+.. seealso::
+
+ :pep:`3155` - Qualified name for classes and functions
+ PEP written and implemented by Antoine Pitrou.
+
.. _pep-412:
PEP 412: Key-Sharing Dictionary
===============================
-:pep:`412` - Key-Sharing Dictionary
- PEP written and implemented by Mark Shannon.
-
Dictionaries used for the storage of objects' attributes are now able to
share part of their internal storage between each other (namely, the part
which stores the keys and their respective hashes). This reduces the memory
consumption of programs creating many instances of non-builtin types.
+.. seealso::
+
+ :pep:`412` - Key-Sharing Dictionary
+ PEP written and implemented by Mark Shannon.
+
PEP 362: Function Signature Object
==================================
-:pep:`362`: - Function Signature Object
- PEP written by Brett Cannon, Yury Selivanov, Larry Hastings, Jiwon Seo.
- Implemented by Yury Selivanov.
-
A new function :func:`inspect.signature` makes introspection of python
callables easy and straightforward. A broad range of callables is supported:
python functions, decorated or not, classes, and :func:`functools.partial`
@@ -560,13 +636,16 @@
which considerably simplifies writing decorators and any code that validates
or amends calling signatures or arguments.
+.. seealso::
+
+ :pep:`362`: - Function Signature Object
+ PEP written by Brett Cannon, Yury Selivanov, Larry Hastings, Jiwon Seo;
+ implemented by Yury Selivanov.
+
PEP 421: Adding sys.implementation
==================================
-:pep:`421` - Adding sys.implementation
- PEP written and implemented by Eric Snow.
-
A new attribute on the :mod:`sys` module exposes details specific to the
implementation of the currently running interpreter. The initial set of
attributes on :attr:`sys.implementation` are ``name``, ``version``,
@@ -595,6 +674,11 @@
are writable. This means that you can add, remove, and modify the namespace
through normal attribute access.
+.. seealso::
+
+ :pep:`421` - Adding sys.implementation
+ PEP written and implemented by Eric Snow.
+
.. _importlib:
@@ -605,8 +689,6 @@
:issue:`14605` - Make import machinery explicit
:issue:`14646` - Require loaders set __loader__ and __package__
-(Written by Brett Cannon)
-
The :func:`__import__` function is now powered by :func:`importlib.__import__`.
This work leads to the completion of "phase 2" of :pep:`302`. There are
multiple benefits to this change. First, it has allowed for more of the
@@ -616,11 +698,10 @@
import semantics. And finally it eases the maintenance of import, allowing for
future growth to occur.
-For the common user, this change should result in no visible change in
-semantics. Any possible changes required in one's code to handle this change
-should read the `Porting Python code`_ section of this document to see what
-needs to be changed, but it will only affect those that currently manipulate
-import or try calling it programmatically.
+For the common user, there should be no visible change in semantics. For
+those whose code currently manipulates import or calls import
+programmatically, the code changes that might possibly be required are covered
+in the `Porting Python code`_ section of this document.
New APIs
--------
@@ -659,8 +740,9 @@
Visible Changes
---------------
-[For potential required changes to code, see the `Porting Python code`_
-section]
+
+For potential required changes to code, see the `Porting Python code`_
+section.
Beyond the expanse of what :mod:`importlib` now exposes, there are other
visible changes to import. The biggest is that :attr:`sys.meta_path` and
@@ -688,12 +770,425 @@
consideration when updating code for Python 3.3, and thus should be read about
in the `Porting Python code`_ section of this document.
-
-New Email Package Features
-==========================
+(Implementation by Brett Cannon)
+
+
+Other Language Changes
+======================
+
+Some smaller changes made to the core Python language are:
+
+* Added support for Unicode name aliases and named sequences.
+ Both :func:`unicodedata.lookup()` and ``'\N{...}'`` now resolve name aliases,
+ and :func:`unicodedata.lookup()` resolves named sequences too.
+
+ (Contributed by Ezio Melotti in :issue:`12753`)
+
+* Unicode database updated to UCD version 6.1.0
+
+* Equality comparisons on :func:`range` objects now return a result reflecting
+ the equality of the underlying sequences generated by those range objects.
+ (:issue:`13201`)
+
+* The ``count()``, ``find()``, ``rfind()``, ``index()`` and ``rindex()``
+ methods of :class:`bytes` and :class:`bytearray` objects now accept an
+ integer between 0 and 255 as their first argument.
+
+ (Contributed by Petri Lehtinen in :issue:`12170`)
+
+* New methods have been added to :class:`list` and :class:`bytearray`:
+ ``copy()`` and ``clear()`` (:issue:`10516`). Consequently,
+ :class:`~collections.abc.MutableSequence` now also defines a
+ :meth:`~collections.abc.MutableSequence.clear` method (:issue:`11388`).
+
+* Raw bytes literals can now be written ``rb"..."`` as well as ``br"..."``.
+
+ (Contributed by Antoine Pitrou in :issue:`13748`.)
+
+* :meth:`dict.setdefault` now does only one lookup for the given key, making
+ it atomic when used with built-in types.
+
+ (Contributed by Filip Gruszczyński in :issue:`13521`.)
+
+* The error messages produced when a function call does not match the function
+ signature have been significantly improved.
+
+ (Contributed by Benjamin Peterson.)
+
+
+A Finer-Grained Import Lock
+===========================
+
+Previous versions of CPython have always relied on a global import lock.
+This led to unexpected annoyances, such as deadlocks when importing a module
+would trigger code execution in a different thread as a side-effect.
+Clumsy workarounds were sometimes employed, such as the
+:c:func:`PyImport_ImportModuleNoBlock` C API function.
+
+In Python 3.3, importing a module takes a per-module lock. This correctly
+serializes importation of a given module from multiple threads (preventing
+the exposure of incompletely initialized modules), while eliminating the
+aforementioned annoyances.
+
+(Contributed by Antoine Pitrou in :issue:`9260`.)
+
+
+Builtin functions and types
+===========================
+
+* :func:`open` gets a new *opener* parameter: the underlying file descriptor
+ for the file object is then obtained by calling *opener* with (*file*,
+ *flags*). It can be used to use custom flags like :data:`os.O_CLOEXEC` for
+ example. The ``'x'`` mode was added: open for exclusive creation, failing if
+ the file already exists.
+* :func:`print`: added the *flush* keyword argument. If the *flush* keyword
+ argument is true, the stream is forcibly flushed.
+* :func:`hash`: hash randomization is enabled by default, see
+ :meth:`object.__hash__` and :envvar:`PYTHONHASHSEED`.
+* The :class:`str` type gets a new :meth:`~str.casefold` method: return a
+ casefolded copy of the string, casefolded strings may be used for caseless
+ matching. For example, ``'ß'.casefold()`` returns ``'ss'``.
+* The sequence documentation has been substantially rewritten to better
+ explain the binary/text sequence distinction and to provide specific
+ documentation sections for the individual builtin sequence types
+ (:issue:`4966`)
+
+
+New Modules
+===========
+
+faulthandler
+------------
+
+This new debug module :mod:`faulthandler` contains functions to dump Python tracebacks explicitly,
+on a fault (a crash like a segmentation fault), after a timeout, or on a user
+signal. Call :func:`faulthandler.enable` to install fault handlers for the
+:const:`SIGSEGV`, :const:`SIGFPE`, :const:`SIGABRT`, :const:`SIGBUS`, and
+:const:`SIGILL` signals. You can also enable them at startup by setting the
+:envvar:`PYTHONFAULTHANDLER` environment variable or by using :option:`-X`
+``faulthandler`` command line option.
+
+Example of a segmentation fault on Linux: ::
+
+ $ python -q -X faulthandler
+ >>> import ctypes
+ >>> ctypes.string_at(0)
+ Fatal Python error: Segmentation fault
+
+ Current thread 0x00007fb899f39700:
+ File "/home/python/cpython/Lib/ctypes/__init__.py", line 486 in string_at
+ File "<stdin>", line 1 in <module>
+ Segmentation fault
+
+
+ipaddress
+---------
+
+The new :mod:`ipaddress` module provides tools for creating and manipulating
+objects representing IPv4 and IPv6 addresses, networks and interfaces (i.e.
+an IP address associated with a specific IP subnet).
+
+(Contributed by Google and Peter Moody in :pep:`3144`)
+
+lzma
+----
+
+The newly-added :mod:`lzma` module provides data compression and decompression
+using the LZMA algorithm, including support for the ``.xz`` and ``.lzma``
+file formats.
+
+(Contributed by Nadeem Vawda and Per Øyvind Karlsen in :issue:`6715`)
+
+
+Improved Modules
+================
+
+abc
+---
+
+Improved support for abstract base classes containing descriptors composed with
+abstract methods. The recommended approach to declaring abstract descriptors is
+now to provide :attr:`__isabstractmethod__` as a dynamically updated
+property. The built-in descriptors have been updated accordingly.
+
+ * :class:`abc.abstractproperty` has been deprecated, use :class:`property`
+ with :func:`abc.abstractmethod` instead.
+ * :class:`abc.abstractclassmethod` has been deprecated, use
+ :class:`classmethod` with :func:`abc.abstractmethod` instead.
+ * :class:`abc.abstractstaticmethod` has been deprecated, use
+ :class:`staticmethod` with :func:`abc.abstractmethod` instead.
+
+(Contributed by Darren Dale in :issue:`11610`)
+
+:meth:`abc.ABCMeta.register` now returns the registered subclass, which means
+it can now be used as a class decorator (:issue:`10868`).
+
+
+array
+-----
+
+The :mod:`array` module supports the :c:type:`long long` type using ``q`` and
+``Q`` type codes.
+
+(Contributed by Oren Tirosh and Hirokazu Yamamoto in :issue:`1172711`)
+
+
+base64
+------
+
+ASCII-only Unicode strings are now accepted by the decoding functions of the
+:mod:`base64` modern interface. For example, ``base64.b64decode('YWJj')``
+returns ``b'abc'``. (Contributed by Catalin Iacob in :issue:`13641`.)
+
+
+binascii
+--------
+
+In addition to the binary objects they normally accept, the ``a2b_`` functions
+now all also accept ASCII-only strings as input. (Contributed by Antoine
+Pitrou in :issue:`13637`.)
+
+
+bz2
+---
+
+The :mod:`bz2` module has been rewritten from scratch. In the process, several
+new features have been added:
+
+* New :func:`bz2.open` function: open a bzip2-compressed file in binary or
+ text mode.
+
+* :class:`bz2.BZ2File` can now read from and write to arbitrary file-like
+ objects, by means of its constructor's *fileobj* argument.
+
+ (Contributed by Nadeem Vawda in :issue:`5863`)
+
+* :class:`bz2.BZ2File` and :func:`bz2.decompress` can now decompress
+ multi-stream inputs (such as those produced by the :program:`pbzip2` tool).
+ :class:`bz2.BZ2File` can now also be used to create this type of file, using
+ the ``'a'`` (append) mode.
+
+ (Contributed by Nir Aides in :issue:`1625`)
+
+* :class:`bz2.BZ2File` now implements all of the :class:`io.BufferedIOBase` API,
+ except for the :meth:`detach` and :meth:`truncate` methods.
+
+
+codecs
+------
+
+The :mod:`~encodings.mbcs` codec has been rewritten to handle correctly
+``replace`` and ``ignore`` error handlers on all Windows versions. The
+:mod:`~encodings.mbcs` codec now supports all error handlers, instead of only
+``replace`` to encode and ``ignore`` to decode.
+
+A new Windows-only codec has been added: ``cp65001`` (:issue:`13216`). It is the
+Windows code page 65001 (Windows UTF-8, ``CP_UTF8``). For example, it is used
+by ``sys.stdout`` if the console output code page is set to cp65001 (e.g., using
+``chcp 65001`` command).
+
+Multibyte CJK decoders now resynchronize faster. They only ignore the first
+byte of an invalid byte sequence. For example, ``b'\xff\n'.decode('gb2312',
+'replace')`` now returns a ``\n`` after the replacement character.
+
+(:issue:`12016`)
+
+Incremental CJK codec encoders are no longer reset at each call to their
+encode() methods. For example::
+
+ $ ./python -q
+ >>> import codecs
+ >>> encoder = codecs.getincrementalencoder('hz')('strict')
+ >>> b''.join(encoder.encode(x) for x in '\u52ff\u65bd\u65bc\u4eba\u3002 Bye.')
+ b'~{NpJ)l6HK!#~} Bye.'
+
+This example gives ``b'~{Np~}~{J)~}~{l6~}~{HK~}~{!#~} Bye.'`` with older Python
+versions.
+
+(:issue:`12100`)
+
+The ``unicode_internal`` codec has been deprecated.
+
+
+collections
+-----------
+
+Addition of a new :class:`~collections.ChainMap` class to allow treating a
+number of mappings as a single unit. (Written by Raymond Hettinger for
+:issue:`11089`, made public in :issue:`11297`)
+
+The abstract base classes have been moved in a new :mod:`collections.abc`
+module, to better differentiate between the abstract and the concrete
+collections classes. Aliases for ABCs are still present in the
+:mod:`collections` module to preserve existing imports. (:issue:`11085`)
+
+.. XXX addition of __slots__ to ABCs not recorded here: internal detail
+
+The :class:`~collections.Counter` class now supports the unary ``+`` and ``-``
+operators, as well as the in-place operators ``+=``, ``-=``, ``|=``, and
+``&=``. (Contributed by Raymond Hettinger in :issue:`13121`.)
+
+
+contextlib
+----------
+
+:class:`~contextlib.ExitStack` now provides a solid foundation for
+programmatic manipulation of context managers and similar cleanup
+functionality. Unlike the previous ``contextlib.nested`` API (which was
+deprecated and removed), the new API is designed to work correctly
+regardless of whether context managers acquire their resources in
+their ``__init__`` method (for example, file objects) or in their
+``__enter__`` method (for example, synchronisation objects from the
+:mod:`threading` module).
+
+(:issue:`13585`)
+
+
+crypt
+-----
+
+Addition of salt and modular crypt format (hashing method) and the :func:`~crypt.mksalt`
+function to the :mod:`crypt` module.
+
+(:issue:`10924`)
+
+curses
+------
+
+ * If the :mod:`curses` module is linked to the ncursesw library, use Unicode
+ functions when Unicode strings or characters are passed (e.g.
+ :c:func:`waddwstr`), and bytes functions otherwise (e.g. :c:func:`waddstr`).
+ * Use the locale encoding instead of ``utf-8`` to encode Unicode strings.
+ * :class:`curses.window` has a new :attr:`curses.window.encoding` attribute.
+ * The :class:`curses.window` class has a new :meth:`~curses.window.get_wch`
+ method to get a wide character
+ * The :mod:`curses` module has a new :meth:`~curses.unget_wch` function to
+ push a wide character so the next :meth:`~curses.window.get_wch` will return
+ it
+
+(Contributed by Iñigo Serna in :issue:`6755`)
+
+datetime
+--------
+
+ * Equality comparisons between naive and aware :class:`~datetime.datetime`
+ instances now return :const:`False` instead of raising :exc:`TypeError`
+ (:issue:`15006`).
+ * New :meth:`datetime.datetime.timestamp` method: Return POSIX timestamp
+ corresponding to the :class:`~datetime.datetime` instance.
+ * The :meth:`datetime.datetime.strftime` method supports formatting years
+ older than 1000.
+ * The :meth:`datetime.datetime.astimezone` method can now be
+ called without arguments to convert datetime instance to the system
+ timezone.
+
+
+.. _new-decimal:
+
+decimal
+-------
+
+:issue:`7652` - integrate fast native decimal arithmetic.
+ C-module and libmpdec written by Stefan Krah.
+
+The new C version of the decimal module integrates the high speed libmpdec
+library for arbitrary precision correctly-rounded decimal floating point
+arithmetic. libmpdec conforms to IBM's General Decimal Arithmetic Specification.
+
+Performance gains range from 10x for database applications to 100x for
+numerically intensive applications. These numbers are expected gains
+for standard precisions used in decimal floating point arithmetic. Since
+the precision is user configurable, the exact figures may vary. For example,
+in integer bignum arithmetic the differences can be significantly higher.
+
+The following table is meant as an illustration. Benchmarks are available
+at http://www.bytereef.org/mpdecimal/quickstart.html.
+
+ +---------+-------------+--------------+-------------+
+ | | decimal.py | _decimal | speedup |
+ +=========+=============+==============+=============+
+ | pi | 42.02s | 0.345s | 120x |
+ +---------+-------------+--------------+-------------+
+ | telco | 172.19s | 5.68s | 30x |
+ +---------+-------------+--------------+-------------+
+ | psycopg | 3.57s | 0.29s | 12x |
+ +---------+-------------+--------------+-------------+
+
+Features
+~~~~~~~~
+
+* The :exc:`~decimal.FloatOperation` signal optionally enables stricter
+ semantics for mixing floats and Decimals.
+
+* If Python is compiled without threads, the C version automatically
+ disables the expensive thread local context machinery. In this case,
+ the variable :data:`~decimal.HAVE_THREADS` is set to False.
+
+API changes
+~~~~~~~~~~~
+
+* The C module has the following context limits, depending on the machine
+ architecture:
+
+ +-------------------+---------------------+------------------------------+
+ | | 32-bit | 64-bit |
+ +===================+=====================+==============================+
+ | :const:`MAX_PREC` | :const:`425000000` | :const:`999999999999999999` |
+ +-------------------+---------------------+------------------------------+
+ | :const:`MAX_EMAX` | :const:`425000000` | :const:`999999999999999999` |
+ +-------------------+---------------------+------------------------------+
+ | :const:`MIN_EMIN` | :const:`-425000000` | :const:`-999999999999999999` |
+ +-------------------+---------------------+------------------------------+
+
+* In the context templates (:class:`~decimal.DefaultContext`,
+ :class:`~decimal.BasicContext` and :class:`~decimal.ExtendedContext`)
+ the magnitude of :attr:`~decimal.Context.Emax` and
+ :attr:`~decimal.Context.Emin` has changed to :const:`999999`.
+
+* The :class:`~decimal.Decimal` constructor in decimal.py does not observe
+ the context limits and converts values with arbitrary exponents or precision
+ exactly. Since the C version has internal limits, the following scheme is
+ used: If possible, values are converted exactly, otherwise
+ :exc:`~decimal.InvalidOperation` is raised and the result is NaN. In the
+ latter case it is always possible to use :meth:`~decimal.Context.create_decimal`
+ in order to obtain a rounded or inexact value.
+
+
+* The power function in decimal.py is always correctly-rounded. In the
+ C version, it is defined in terms of the correctly-rounded
+ :meth:`~decimal.Decimal.exp` and :meth:`~decimal.Decimal.ln` functions,
+ but the final result is only "almost always correctly rounded".
+
+
+* In the C version, the context dictionary containing the signals is a
+ :class:`~collections.abc.MutableMapping`. For speed reasons,
+ :attr:`~decimal.Context.flags` and :attr:`~decimal.Context.traps` always
+ refer to the same :class:`~collections.abc.MutableMapping` that the context
+ was initialized with. If a new signal dictionary is assigned,
+ :attr:`~decimal.Context.flags` and :attr:`~decimal.Context.traps`
+ are updated with the new values, but they do not reference the RHS
+ dictionary.
+
+
+* Pickling a :class:`~decimal.Context` produces a different output in order
+ to have a common interchange format for the Python and C versions.
+
+
+* The order of arguments in the :class:`~decimal.Context` constructor has been
+ changed to match the order displayed by :func:`repr`.
+
+
+* The ``watchexp`` parameter in the :meth:`~decimal.Decimal.quantize` method
+ is deprecated.
+
+
+.. _new-email:
+
+email
+-----
Policy Framework
-----------------
+~~~~~~~~~~~~~~~~
The email package now has a :mod:`~email.policy` framework. A
:class:`~email.policy.Policy` is an object with several methods and properties
@@ -748,7 +1243,7 @@
Provisional Policy with New Header API
---------------------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
While the policy framework is worthwhile all by itself, the main motivation for
introducing it is to allow the creation of new policies that implement new
@@ -839,410 +1334,56 @@
package transparently encodes and decodes the unicode to and from the RFC
standard Content Transfer Encodings.
-
-Other Language Changes
-======================
-
-Some smaller changes made to the core Python language are:
-
-* Added support for Unicode name aliases and named sequences.
- Both :func:`unicodedata.lookup()` and ``'\N{...}'`` now resolve name aliases,
- and :func:`unicodedata.lookup()` resolves named sequences too.
-
- (Contributed by Ezio Melotti in :issue:`12753`)
-
-* Unicode database updated to UCD version 6.1.0
-
-* Equality comparisons on :func:`range` objects now return a result reflecting
- the equality of the underlying sequences generated by those range objects.
-
- (:issue:`13201`)
-
-* The ``count()``, ``find()``, ``rfind()``, ``index()`` and ``rindex()``
- methods of :class:`bytes` and :class:`bytearray` objects now accept an
- integer between 0 and 255 as their first argument.
-
- (Contributed by Petri Lehtinen in :issue:`12170`)
-
-* New methods have been added to :class:`list` and :class:`bytearray`:
- ``copy()`` and ``clear()``.
-
- (:issue:`10516`)
-
-* Raw bytes literals can now be written ``rb"..."`` as well as ``br"..."``.
- (Contributed by Antoine Pitrou in :issue:`13748`.)
-
-* :meth:`dict.setdefault` now does only one lookup for the given key, making
- it atomic when used with built-in types.
- (Contributed by Filip Gruszczyński in :issue:`13521`.)
-
-
-.. XXX mention new error messages for passing wrong number of arguments to functions
-
-
-A Finer-Grained Import Lock
-===========================
-
-Previous versions of CPython have always relied on a global import lock.
-This led to unexpected annoyances, such as deadlocks when importing a module
-would trigger code execution in a different thread as a side-effect.
-Clumsy workarounds were sometimes employed, such as the
-:c:func:`PyImport_ImportModuleNoBlock` C API function.
-
-In Python 3.3, importing a module takes a per-module lock. This correctly
-serializes importation of a given module from multiple threads (preventing
-the exposure of incompletely initialized modules), while eliminating the
-aforementioned annoyances.
-
-(contributed by Antoine Pitrou in :issue:`9260`.)
-
-
-Builtin functions and types
-===========================
-
-* :func:`open` gets a new *opener* parameter: the underlying file descriptor
- for the file object is then obtained by calling *opener* with (*file*,
- *flags*). It can be used to use custom flags like :data:`os.O_CLOEXEC` for
- example. The ``'x'`` mode was added: open for exclusive creation, failing if
- the file already exists.
-* :func:`print`: added the *flush* keyword argument. If the *flush* keyword
- argument is true, the stream is forcibly flushed.
-* :func:`hash`: hash randomization is enabled by default, see
- :meth:`object.__hash__` and :envvar:`PYTHONHASHSEED`.
-* The :class:`str` type gets a new :meth:`~str.casefold` method: return a
- casefolded copy of the string, casefolded strings may be used for caseless
- matching. For example, ``'ß'.casefold()`` returns ``'ss'``.
-* The sequence documentation has been substantially rewritten to better
- explain the binary/text sequence distinction and to provide specific
- documentation sections for the individual builtin sequence types
- (:issue:`4966`)
-
-New Modules
-===========
-
-faulthandler
-------------
-
-This new debug module :mod:`faulthandler` contains functions to dump Python tracebacks explicitly,
-on a fault (a crash like a segmentation fault), after a timeout, or on a user
-signal. Call :func:`faulthandler.enable` to install fault handlers for the
-:const:`SIGSEGV`, :const:`SIGFPE`, :const:`SIGABRT`, :const:`SIGBUS`, and
-:const:`SIGILL` signals. You can also enable them at startup by setting the
-:envvar:`PYTHONFAULTHANDLER` environment variable or by using :option:`-X`
-``faulthandler`` command line option.
-
-Example of a segmentation fault on Linux: ::
-
- $ python -q -X faulthandler
- >>> import ctypes
- >>> ctypes.string_at(0)
- Fatal Python error: Segmentation fault
-
- Current thread 0x00007fb899f39700:
- File "/home/python/cpython/Lib/ctypes/__init__.py", line 486 in string_at
- File "<stdin>", line 1 in <module>
- Segmentation fault
-
-
-ipaddress
----------
-
-The new :mod:`ipaddress` module provides tools for creating and manipulating
-objects representing IPv4 and IPv6 addresses, networks and interfaces (i.e.
-an IP address associated with a specific IP subnet).
-
-(Contributed by Google and Peter Moody in :pep:`3144`)
-
-lzma
-----
-
-The newly-added :mod:`lzma` module provides data compression and decompression
-using the LZMA algorithm, including support for the ``.xz`` and ``.lzma``
-file formats.
-
-(Contributed by Nadeem Vawda and Per Øyvind Karlsen in :issue:`6715`)
-
-
-Improved Modules
-================
-
-abc
----
-
-Improved support for abstract base classes containing descriptors composed with
-abstract methods. The recommended approach to declaring abstract descriptors is
-now to provide :attr:`__isabstractmethod__` as a dynamically updated
-property. The built-in descriptors have been updated accordingly.
-
- * :class:`abc.abstractproperty` has been deprecated, use :class:`property`
- with :func:`abc.abstractmethod` instead.
- * :class:`abc.abstractclassmethod` has been deprecated, use
- :class:`classmethod` with :func:`abc.abstractmethod` instead.
- * :class:`abc.abstractstaticmethod` has been deprecated, use
- :class:`staticmethod` with :func:`abc.abstractmethod` instead.
-
-(Contributed by Darren Dale in :issue:`11610`)
-
-array
------
-
-The :mod:`array` module supports the :c:type:`long long` type using ``q`` and
-``Q`` type codes.
-
-(Contributed by Oren Tirosh and Hirokazu Yamamoto in :issue:`1172711`)
-
-
-base64, binascii
-----------------
-
-ASCII-only Unicode strings are now accepted by the decoding functions of the
-modern interface. For example, ``base64.b64decode('YWJj')`` returns ``b'abc'``.
-
-
-bz2
----
-
-The :mod:`bz2` module has been rewritten from scratch. In the process, several
-new features have been added:
-
-* New :func:`bz2.open` function: open a bzip2-compressed file in binary or
- text mode.
-
-* :class:`bz2.BZ2File` can now read from and write to arbitrary file-like
- objects, by means of its constructor's *fileobj* argument.
-
- (Contributed by Nadeem Vawda in :issue:`5863`)
-
-* :class:`bz2.BZ2File` and :func:`bz2.decompress` can now decompress
- multi-stream inputs (such as those produced by the :program:`pbzip2` tool).
- :class:`bz2.BZ2File` can now also be used to create this type of file, using
- the ``'a'`` (append) mode.
-
- (Contributed by Nir Aides in :issue:`1625`)
-
-* :class:`bz2.BZ2File` now implements all of the :class:`io.BufferedIOBase` API,
- except for the :meth:`detach` and :meth:`truncate` methods.
-
-
-codecs
-------
-
-The :mod:`~encodings.mbcs` codec has been rewritten to handle correctly
-``replace`` and ``ignore`` error handlers on all Windows versions. The
-:mod:`~encodings.mbcs` codec now supports all error handlers, instead of only
-``replace`` to encode and ``ignore`` to decode.
-
-A new Windows-only codec has been added: ``cp65001`` (:issue:`13216`). It is the
-Windows code page 65001 (Windows UTF-8, ``CP_UTF8``). For example, it is used
-by ``sys.stdout`` if the console output code page is set to cp65001 (e.g., using
-``chcp 65001`` command).
-
-Multibyte CJK decoders now resynchronize faster. They only ignore the first
-byte of an invalid byte sequence. For example, ``b'\xff\n'.decode('gb2312',
-'replace')`` now returns a ``\n`` after the replacement character.
-
-(:issue:`12016`)
-
-Incremental CJK codec encoders are no longer reset at each call to their
-encode() methods. For example::
-
- $ ./python -q
- >>> import codecs
- >>> encoder = codecs.getincrementalencoder('hz')('strict')
- >>> b''.join(encoder.encode(x) for x in '\u52ff\u65bd\u65bc\u4eba\u3002 Bye.')
- b'~{NpJ)l6HK!#~} Bye.'
-
-This example gives ``b'~{Np~}~{J)~}~{l6~}~{HK~}~{!#~} Bye.'`` with older Python
-versions.
-
-(:issue:`12100`)
-
-The ``unicode_internal`` codec has been deprecated.
-
-
-collections
------------
-
-Addition of a new :class:`~collections.ChainMap` class to allow treating a
-number of mappings as a single unit.
-
-(Written by Raymond Hettinger for :issue:`11089`, made public in
-:issue:`11297`)
-
-The abstract base classes have been moved in a new :mod:`collections.abc`
-module, to better differentiate between the abstract and the concrete
-collections classes. Aliases for ABCs are still present in the
-:mod:`collections` module to preserve existing imports.
-
-(:issue:`11085`)
-
-.. XXX addition of __slots__ to ABCs not recorded here: internal detail
-
-
-contextlib
-----------
-
-:class:`~contextlib.ExitStack` now provides a solid foundation for
-programmatic manipulation of context managers and similar cleanup
-functionality. Unlike the previous ``contextlib.nested`` API (which was
-deprecated and removed), the new API is designed to work correctly
-regardless of whether context managers acquire their resources in
-their ``__init__`` method (for example, file objects) or in their
-``__enter__`` method (for example, synchronisation objects from the
-:mod:`threading` module).
-
-(:issue:`13585`)
-
-
-crypt
------
-
-Addition of salt and modular crypt format (hashing method) and the :func:`~crypt.mksalt`
-function to the :mod:`crypt` module.
-
-(:issue:`10924`)
-
-curses
-------
-
- * If the :mod:`curses` module is linked to the ncursesw library, use Unicode
- functions when Unicode strings or characters are passed (e.g.
- :c:func:`waddwstr`), and bytes functions otherwise (e.g. :c:func:`waddstr`).
- * Use the locale encoding instead of ``utf-8`` to encode Unicode strings.
- * :class:`curses.window` has a new :attr:`curses.window.encoding` attribute.
- * The :class:`curses.window` class has a new :meth:`~curses.window.get_wch`
- method to get a wide character
- * The :mod:`curses` module has a new :meth:`~curses.unget_wch` function to
- push a wide character so the next :meth:`~curses.window.get_wch` will return
- it
-
-(Contributed by Iñigo Serna in :issue:`6755`)
-
-datetime
---------
-
- * Equality comparisons between naive and aware :class:`~datetime.datetime`
- instances now return :const:`False` instead of raising :exc:`TypeError`.
- * New :meth:`datetime.datetime.timestamp` method: Return POSIX timestamp
- corresponding to the :class:`~datetime.datetime` instance.
- * The :meth:`datetime.datetime.strftime` method supports formatting years
- older than 1000.
- * The :meth:`datetime.datetime.astimezone` method can now be
- called without arguments to convert datetime instance to the system
- timezone.
-
-decimal
--------
-
-:issue:`7652` - integrate fast native decimal arithmetic.
- C-module and libmpdec written by Stefan Krah.
-
-The new C version of the decimal module integrates the high speed libmpdec
-library for arbitrary precision correctly-rounded decimal floating point
-arithmetic. libmpdec conforms to IBM's General Decimal Arithmetic Specification.
-
-Performance gains range from 10x for database applications to 100x for
-numerically intensive applications. These numbers are expected gains
-for standard precisions used in decimal floating point arithmetic. Since
-the precision is user configurable, the exact figures may vary. For example,
-in integer bignum arithmetic the differences can be significantly higher.
-
-The following table is meant as an illustration. Benchmarks are available
-at http://www.bytereef.org/mpdecimal/quickstart.html.
-
- +---------+-------------+--------------+-------------+
- | | decimal.py | _decimal | speedup |
- +=========+=============+==============+=============+
- | pi | 42.02s | 0.345s | 120x |
- +---------+-------------+--------------+-------------+
- | telco | 172.19s | 5.68s | 30x |
- +---------+-------------+--------------+-------------+
- | psycopg | 3.57s | 0.29s | 12x |
- +---------+-------------+--------------+-------------+
-
-Features
-~~~~~~~~
-
-* The :exc:`~decimal.FloatOperation` signal optionally enables stricter
- semantics for mixing floats and Decimals.
-
-* If Python is compiled without threads, the C version automatically
- disables the expensive thread local context machinery. In this case,
- the variable :data:`~decimal.HAVE_THREADS` is set to False.
-
-API changes
-~~~~~~~~~~~
-
-* The C module has the following context limits, depending on the machine
- architecture:
-
- +-------------------+---------------------+------------------------------+
- | | 32-bit | 64-bit |
- +===================+=====================+==============================+
- | :const:`MAX_PREC` | :const:`425000000` | :const:`999999999999999999` |
- +-------------------+---------------------+------------------------------+
- | :const:`MAX_EMAX` | :const:`425000000` | :const:`999999999999999999` |
- +-------------------+---------------------+------------------------------+
- | :const:`MIN_EMIN` | :const:`-425000000` | :const:`-999999999999999999` |
- +-------------------+---------------------+------------------------------+
-
-* In the context templates (:class:`~decimal.DefaultContext`,
- :class:`~decimal.BasicContext` and :class:`~decimal.ExtendedContext`)
- the magnitude of :attr:`~decimal.Context.Emax` and
- :attr:`~decimal.Context.Emin` has changed to :const:`999999`.
-
-* The :class:`~decimal.Decimal` constructor in decimal.py does not observe
- the context limits and converts values with arbitrary exponents or precision
- exactly. Since the C version has internal limits, the following scheme is
- used: If possible, values are converted exactly, otherwise
- :exc:`~decimal.InvalidOperation` is raised and the result is NaN. In the
- latter case it is always possible to use :meth:`~decimal.Context.create_decimal`
- in order to obtain a rounded or inexact value.
-
-
-* The power function in decimal.py is always correctly-rounded. In the
- C version, it is defined in terms of the correctly-rounded
- :meth:`~decimal.Decimal.exp` and :meth:`~decimal.Decimal.ln` functions,
- but the final result is only "almost always correctly rounded".
-
-
-* In the C version, the context dictionary containing the signals is a
- :class:`~collections.abc.MutableMapping`. For speed reasons,
- :attr:`~decimal.Context.flags` and :attr:`~decimal.Context.traps` always
- refer to the same :class:`~collections.abc.MutableMapping` that the context
- was initialized with. If a new signal dictionary is assigned,
- :attr:`~decimal.Context.flags` and :attr:`~decimal.Context.traps`
- are updated with the new values, but they do not reference the RHS
- dictionary.
-
-
-* Pickling a :class:`~decimal.Context` produces a different output in order
- to have a common interchange format for the Python and C versions.
-
-
-* The order of arguments in the :class:`~decimal.Context` constructor has been
- changed to match the order displayed by :func:`repr`.
-
-
-* The ``watchexp`` parameter in the :meth:`~decimal.Decimal.quantize` method
- is deprecated.
+Other API Changes
+~~~~~~~~~~~~~~~~~
+
+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
------
+* :class:`ftplib.FTP` now accepts a ``source_address`` keyword argument to
+ specify the ``(host, port)`` to use as the source address in the bind call
+ when creating the outgoing socket. (Contributed by Giampaolo Rodolà
+ in :issue:`8594`.)
+
* The :class:`~ftplib.FTP_TLS` class now provides a new
:func:`~ftplib.FTP_TLS.ccc` function to revert control channel back to
- plaintext. This can be useful to take advantage of firewalls that know how to
- handle NAT with non-secure FTP without opening fixed ports.
-
- (Contributed by Giampaolo Rodolà in :issue:`12139`)
+ plaintext. This can be useful to take advantage of firewalls that know how
+ to handle NAT with non-secure FTP without opening fixed ports. (Contributed
+ by Giampaolo Rodolà in :issue:`12139`)
* Added :meth:`ftplib.FTP.mlsd` method which provides a parsable directory
listing format and deprecates :meth:`ftplib.FTP.nlst` and
- :meth:`ftplib.FTP.dir`.
-
- (Contributed by Giampaolo Rodolà in :issue:`11072`)
+ :meth:`ftplib.FTP.dir`. (Contributed by Giampaolo Rodolà in :issue:`11072`)
+
+
+functools
+---------
+
+The :func:`functools.lru_cache` decorator now accepts a ``typed`` keyword
+argument (that defaults to ``False`` to ensure that it caches values of
+different types that compare equal in separate cache slots. (Contributed
+by Raymond Hettinger in :issue:`13227`.)
+
gc
--
@@ -1254,37 +1395,49 @@
hmac
----
-A new :func:`~hmac.compare_digest` function has been added to prevent
-side channel attacks on digests through timing analysis.
-
-(Contributed by Nick Coghlan and Christian Heimes in issue:`15061`)
-
-
-html.entities
--------------
-
-A new :data:`~html.entities.html5` dictionary that maps HTML5 named character
-references to the equivalent Unicode character(s) (e.g. ``html5['gt;'] == '>'``)
-has been added to the :mod:`html.entities` module. The dictionary is now also
-used by :class:`~html.parser.HTMLParser`.
-
-(Contributed by Ezio Melotti in :issue:`11113` and :issue:`15156`)
-
-
-html.parser
------------
-
-:class:`~html.parser.HTMLParser` is now able to parse broken markup without
+A new :func:`~hmac.compare_digest` function has been added to prevent side
+channel attacks on digests through timing analysis. (Contributed by Nick
+Coghlan and Christian Heimes in :issue:`15061`)
+
+
+http
+----
+
+:class:`http.server.BaseHTTPRequestHandler` now buffers the headers and writes
+them all at once when :meth:`~http.server.BaseHTTPRequestHandler.end_headers` is
+called. A new method :meth:`~http.server.BaseHTTPRequestHandler.flush_headers`
+can be used to directly manage when the accumlated headers are sent.
+(Contributed by Andrew Schaaf in :issue:`3709`.)
+
+:class:`http.server` now produces valid ``HTML 4.01 strict`` output.
+(Contributed by Ezio Melotti in :issue:`13295`.)
+
+:class:`http.client.HTTPResponse` now has a
+:meth:`~http.client.HTTPResponse.readinto` method, which means it can be used
+as a :class:`io.RawIOBase` class. (Contributed by John Kuhn in
+:issue:`13464`.)
+
+
+html
+----
+
+:class:`html.parser.HTMLParser` is now able to parse broken markup without
raising errors, therefore the *strict* argument of the constructor and the
:exc:`~html.parser.HTMLParseError` exception are now deprecated.
The ability to parse broken markup is the result of a number of bug fixes that
are also available on the latest bug fix releases of Python 2.7/3.2.
-
(Contributed by Ezio Melotti in :issue:`15114`, and :issue:`14538`,
:issue:`13993`, :issue:`13960`, :issue:`13358`, :issue:`1745761`,
:issue:`755670`, :issue:`13357`, :issue:`12629`, :issue:`1200313`,
:issue:`670664`, :issue:`13273`, :issue:`12888`, :issue:`7311`)
+A new :data:`~html.entities.html5` dictionary that maps HTML5 named character
+references to the equivalent Unicode character(s) (e.g. ``html5['gt;'] ==
+'>'``) has been added to the :mod:`html.entities` module. The dictionary is
+now also used by :class:`~html.parser.HTMLParser`. (Contributed by Ezio
+Melotti in :issue:`11113` and :issue:`15156`)
+
+
imaplib
-------
@@ -1327,13 +1480,42 @@
underlying binary buffer.
+itertools
+---------
+
+:func:`~itertools.accumulate` now takes an optional ``func`` argument for
+providing a user-supplied binary function.
+
+
+logging
+-------
+
+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
----
-The :mod:`math` module has a new function:
-
- * :func:`~math.log2`: return the base-2 logarithm of *x*
- (Written by Mark Dickinson in :issue:`11888`).
+The :mod:`math` module has a new function, :func:`~math.log2`, which returns
+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
@@ -1347,6 +1529,22 @@
multiprocessing connections.
(Contributed by Richard Oudkerk in :issue:`4892`.)
+:class:`multiprocessing.Process` now accepts a ``daemon`` keyword argument
+to override the default behavior of inheriting the ``daemon`` flag from
+the parent process (:issue:`6064`).
+
+New attribute attribute :data:`multiprocessing.Process.sentinel` allows a
+program to wait on multiple :class:`~multiprocessing.Process` objects at one
+time using the appropriate OS primitives (for example, :mod:`select` on
+posix systems).
+
+New methods :meth:`multiprocessing.pool.Pool.starmap` and
+:meth:`~multiprocessing.pool.Pool.starmap_async` provide
+:func:`itertools.starmap` equivalents to the existing
+:meth:`multiprocessing.pool.Pool.map` and
+:meth:`~multiprocessing.pool.Pool.map_async` functions. (Contributed by Hynek
+Schlawack in :issue:`12708`.)
+
nntplib
-------
@@ -1400,12 +1598,20 @@
:func:`~os.link`, :func:`~os.lstat`, :func:`~os.mkdir`, :func:`~os.mkfifo`,
:func:`~os.mknod`, :func:`~os.open`, :func:`~os.readlink`, :func:`~os.remove`,
:func:`~os.rename`, :func:`~os.replace`, :func:`~os.rmdir`, :func:`~os.stat`,
- :func:`~os.symlink`, :func:`~os.unlink`, :func:`~os.utime`.
+ :func:`~os.symlink`, :func:`~os.unlink`, :func:`~os.utime`. Platform
+ support for using these parameters can be checked via the sets
+ :data:`os.supports_dir_fd` and :data:`os.supports_follows_symlinks`.
- The following functions now support a file descriptor for their path argument:
:func:`~os.chdir`, :func:`~os.chmod`, :func:`~os.chown`,
:func:`~os.execve`, :func:`~os.listdir`, :func:`~os.pathconf`, :func:`~os.path.exists`,
- :func:`~os.stat`, :func:`~os.statvfs`, :func:`~os.utime`.
+ :func:`~os.stat`, :func:`~os.statvfs`, :func:`~os.utime`. Platform support
+ for this can be checked via the :data:`os.supports_fd` set.
+
+* :func:`~os.access` accepts an ``effective_ids`` keyword argument to turn on
+ using the effective uid/gid rather than the real uid/gid in the access check.
+ Platform support for this can be checked via the
+ :data:`~os.supports_effective_ids` set.
* The :mod:`os` module has two new functions: :func:`~os.getpriority` and
:func:`~os.setpriority`. They can be used to get or set process
@@ -1454,7 +1660,7 @@
for a file.
* :func:`~os.sync`: Force write of everything to disk.
-* Add some extra posix functions to the os module:
+* Additional new posix functions:
* :func:`~os.lockf`: Apply, test or remove a POSIX lock on an open file descriptor.
* :func:`~os.pread`: Read from a file descriptor at an offset, the file
@@ -1473,13 +1679,29 @@
* :func:`~os.times` and :func:`~os.uname`: Return type changed from a tuple to
a tuple-like object with named attributes.
+* Some platforms now support additional constants for the :func:`~os.lseek`
+ function, such as ``os.SEEK_HOLE`` and ``os.SEEK_DATA``.
+
+* New constants :data:`~os.RTLD_LAZY`, :data:`~os.RTLD_NOW`,
+ :data:`~os.RTLD_GLOBAL`, :data:`~os.RTLD_LOCAL`, :data:`~os.RTLD_NODELETE`,
+ :data:`~os.RTLD_NOLOAD`, and :data:`~os.RTLD_DEEPBIND` are available on
+ platforms that support them. These are for use with the
+ :func:`sys.setdlopenflags` function, and supersede the similar constants
+ defined in :mod:`ctypes` and :mod:`DLFCN`. (Contributed by Victor Stinner
+ in :issue:`13226`.)
+
+* :func:`os.symlink` now accepts (and ignores) the ``target_is_directory``
+ keyword argument on non-Windows platforms, to ease cross-platform support.
+
pdb
---
-* Tab-completion is now available not only for command names, but also their
- arguments. For example, for the ``break`` command, function and file names
- are completed. (Contributed by Georg Brandl in :issue:`14210`)
+Tab-completion is now available not only for command names, but also their
+arguments. For example, for the ``break`` command, function and file names
+are completed.
+
+(Contributed by Georg Brandl in :issue:`14210`)
pickle
@@ -1488,6 +1710,7 @@
:class:`pickle.Pickler` objects now have an optional
:attr:`~pickle.Pickler.dispatch_table` attribute allowing to set per-pickler
reduction functions.
+
(Contributed by Richard Oudkerk in :issue:`14166`.)
@@ -1534,40 +1757,53 @@
:issue:`13245`)
+select
+------
+
+Solaris and derivatives platforms have a new class :class:`select.devpoll`
+for high performance asynchronous sockets via :file:`/dev/poll`.
+(Contributed by Jesús Cea Avión in :issue:`6397`.)
+
+
shlex
-----
-* The previously undocumented helper function ``quote`` from the
- :mod:`pipes` modules has been moved to the :mod:`shlex` module and
- documented. :func:`~shlex.quote` properly escapes all characters in a string
- that might be otherwise given special meaning by the shell.
+The previously undocumented helper function ``quote`` from the
+:mod:`pipes` modules has been moved to the :mod:`shlex` module and
+documented. :func:`~shlex.quote` properly escapes all characters in a string
+that might be otherwise given special meaning by the shell.
shutil
------
-* The :mod:`shutil` module has these new fuctions:
+* New functions:
* :func:`~shutil.disk_usage`: provides total, used and free disk space
statistics. (Contributed by Giampaolo Rodolà in :issue:`12442`)
* :func:`~shutil.chown`: allows one to change user and/or group of the given
path also specifying the user/group names and not only their numeric
ids. (Contributed by Sandro Tosi in :issue:`12191`)
+ * :func:`shutil.get_terminal_size`: returns the size of the terminal window
+ to which the interpreter is attached. (Contributed by Zbigniew
+ Jędrzejewski-Szmek in :issue:`13609`.)
* :func:`~shutil.copy2` and :func:`~shutil.copystat` now preserve file
timestamps with nanosecond precision on platforms that support it.
They also preserve file "extended attributes" on Linux. (Contributed
by Larry Hastings in :issue:`14127` and :issue:`15238`.)
-* The new :func:`shutil.get_terminal_size` function returns the size of the
- terminal window the interpreter is attached to.
- (Contributed by Zbigniew Jędrzejewski-Szmek in :issue:`13609`.)
-
* Several functions now take an optional ``symlinks`` argument: when that
parameter is true, symlinks aren't dereferenced and the operation instead
acts on the symlink itself (or creates one, if relevant).
(Contributed by Hynek Schlawack in :issue:`12715`.)
+* When copying files to a different file system, :func:`~shutil.move` now
+ handles symlinks the way the posix ``mv`` command does, recreating the
+ symlink rather than copying the target file contents. (Contributed by
+ Jonathan Niehof in :issue:`9993`.) :func:`~shutil.move` now also returns
+ the ``dst`` argument as its result.
+
* :func:`~shutil.rmtree` is now resistant to symlink attacks on platforms
which support the new ``dir_fd`` parameter in :func:`os.open` and
:func:`os.unlink`. (Contributed by Martin von Löwis and Hynek Schlawack
@@ -1600,23 +1836,31 @@
smtpd
-----
-* The :mod:`smtpd` module now supports :rfc:`5321` (extended SMTP) and :rfc:`1870`
- (size extension). Per the standard, these extensions are enabled if and only
- if the client initiates the session with an ``EHLO`` command.
-
- (Initial ``ELHO`` support by Alberto Trevino. Size extension by Juhana
- Jauhiainen. Substantial additional work on the patch contributed by Michele
- Orrù and Dan Boswell. :issue:`8739`)
+The :mod:`smtpd` module now supports :rfc:`5321` (extended SMTP) and :rfc:`1870`
+(size extension). Per the standard, these extensions are enabled if and only
+if the client initiates the session with an ``EHLO`` command.
+
+(Initial ``ELHO`` support by Alberto Trevino. Size extension by Juhana
+Jauhiainen. Substantial additional work on the patch contributed by Michele
+Orrù and Dan Boswell. :issue:`8739`)
smtplib
-------
-* 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`)
+The :class:`~smtplib.SMTP`, :class:`~smtplib.SMTP_SSL`, and
+:class:`~smtplib.LMTP` classes now accept a ``source_address`` keyword argument
+to specify the ``(host, port)`` to use as the source address in the bind call
+when creating the outgoing socket. (Contributed by Paulo Scardine in
+:issue:`11281`.)
+
+: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`)
socket
@@ -1642,6 +1886,32 @@
(http://en.wikipedia.org/wiki/Reliable_Datagram_Sockets and
http://oss.oracle.com/projects/rds/).
+* The :class:`~socket.socket` class now supports the ``PF_SYSTEM`` protocol
+ family on OS X. (Contributed by Michael Goderbauer in :issue:`13777`.)
+
+* New function :func:`~socket.sethostname` allows the hostname to be set
+ on unix systems if the calling process has sufficient privileges.
+ (Contributed by Ross Lagerwall in :issue:`10866`.)
+
+
+socketserver
+------------
+
+:class:`~socketserver.BaseServer` now has an overridable method
+:meth:`~socketserver.BaseServer.service_actions` that is called by the
+:meth:`~socketserver.BaseServer.serve_forever` method in the service loop.
+:class:`~socketserver.ForkingMixIn` now uses this to clean up zombie
+child proceses. (Contributed by Justin Warkentin in :issue:`11109`.)
+
+
+sqlite3
+-------
+
+New :class:`sqlite3.Connection` method
+:meth:`~sqlite3.Connection.set_trace_callback` can be used to capture a trace of
+all sql commands processed by sqlite. (Contributed by Torsten Landschoff
+in :issue:`11688`.)
+
ssl
---
@@ -1656,66 +1926,121 @@
* The :mod:`ssl` module now exposes a finer-grained exception hierarchy
in order to make it easier to inspect the various kinds of errors.
-
(Contributed by Antoine Pitrou in :issue:`11183`)
* :meth:`~ssl.SSLContext.load_cert_chain` now accepts a *password* argument
to be used if the private key is encrypted.
-
(Contributed by Adam Simpkins in :issue:`12803`)
* Diffie-Hellman key exchange, both regular and Elliptic Curve-based, is
now supported through the :meth:`~ssl.SSLContext.load_dh_params` and
:meth:`~ssl.SSLContext.set_ecdh_curve` methods.
-
(Contributed by Antoine Pitrou in :issue:`13626` and :issue:`13627`)
* SSL sockets have a new :meth:`~ssl.SSLSocket.get_channel_binding` method
allowing the implementation of certain authentication mechanisms such as
- SCRAM-SHA-1-PLUS.
-
- (Contributed by Jacek Konieczny in :issue:`12551`)
+ SCRAM-SHA-1-PLUS. (Contributed by Jacek Konieczny in :issue:`12551`)
* You can query the SSL compression algorithm used by an SSL socket, thanks
- to its new :meth:`~ssl.SSLSocket.compression` method.
-
+ to its new :meth:`~ssl.SSLSocket.compression` method. The new attribute
+ :attr:`~ssl.OP_NO_COMPRESSION` can be used to disable compression.
(Contributed by Antoine Pitrou in :issue:`13634`)
* Support has been added for the Next Procotol Negotiation extension using
the :meth:`ssl.SSLContext.set_npn_protocols` method.
-
(Contributed by Colin Marc in :issue:`14204`)
* SSL errors can now be introspected more easily thanks to
:attr:`~ssl.SSLError.library` and :attr:`~ssl.SSLError.reason` attributes.
-
(Contributed by Antoine Pitrou in :issue:`14837`)
+* The :func:`~ssl.get_server_certificate` function now supports IPv6.
+ (Contributed by Charles-François Natali in :issue:`11811`.)
+
+* New attribute :attr:`~ssl.OP_CIPHER_SERVER_PREFERENCE` allows setting
+ SSLv3 server sockets to use the server's cipher ordering preference rather
+ than the client's (:issue:`13635`).
+
+
stat
----
-- The undocumented tarfile.filemode function has been moved to
- :func:`stat.filemode`. It can be used to convert a file's mode to a string of
- the form '-rwxrwxrwx'.
-
- (Contributed by Giampaolo Rodolà in :issue:`14807`)
+The undocumented tarfile.filemode function has been moved to
+:func:`stat.filemode`. It can be used to convert a file's mode to a string of
+the form '-rwxrwxrwx'.
+
+(Contributed by Giampaolo Rodolà in :issue:`14807`)
+
+
+struct
+------
+
+The :mod:`struct` module now supports ``ssize_t`` and ``size_t`` via the
+new codes ``n`` and ``N``, respectively. (Contributed by Antoine Pitrou
+in :issue:`3163`.)
+
+
+subprocess
+----------
+
+Command strings can now be bytes objects on posix platforms. (Contributed by
+Victor Stinner in :issue:`8513`.)
+
+A new constant :data:`~subprocess.DEVNULL` allows suppressing output in a
+platform-independent fashion. (Contributed by Ross Lagerwall in
+:issue:`5870`.)
+
sys
---
-* The :mod:`sys` module has a new :data:`~sys.thread_info` :term:`struct
- sequence` holding informations about the thread implementation.
-
- (:issue:`11223`)
+The :mod:`sys` module has a new :data:`~sys.thread_info` :term:`struct
+sequence` holding informations about the thread implementation
+(:issue:`11223`).
+
+
+tarfile
+-------
+
+:mod:`tarfile` now supports ``lzma`` encoding via the :mod:`lzma` module.
+(Contributed by Lars Gustäbel in :issue:`5689`.)
+
+
+tempfile
+--------
+
+:class:`tempfile.SpooledTemporaryFile`\'s
+:meth:`~tempfile.SpooledTemporaryFile.trucate` method now accepts
+a ``size`` parameter. (Contributed by Ryan Kelly in :issue:`9957`.)
+
textwrap
--------
-* The :mod:`textwrap` module has a new :func:`~textwrap.indent` that makes
- it straightforward to add a common prefix to selected lines in a block
- of text.
-
- (:issue:`13857`)
+The :mod:`textwrap` module has a new :func:`~textwrap.indent` that makes
+it straightforward to add a common prefix to selected lines in a block
+of text (:issue:`13857`).
+
+
+threading
+---------
+
+:class:`threading.Condition`, :class:`threading.Semaphore`,
+:class:`threading.BoundedSemaphore`, :class:`threading.Event`, and
+:class:`threading.Timer`, all of which used to be factory functions returning a
+class instance, are now classes and may be subclassed. (Contributed by Éric
+Araujo in :issue:`10968`).
+
+The :class:`threading.Thread` constructor now accepts a ``daemon`` keyword
+argument to override the default behavior of inheriting the ``deamon`` flag
+value from the parent thread (:issue:`6064`).
+
+The formerly private function ``_thread.get_ident`` is now available as the
+public function :func:`threading.get_ident`. This eliminates several cases of
+direct access to the ``_thread`` module in the stdlib. Third party code that
+used ``_thread.get_ident`` should likewise be changed to use the new public
+interface.
+
time
----
@@ -1736,6 +2061,10 @@
: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
-----
@@ -1753,9 +2082,11 @@
:meth:`.assertRaises`, :meth:`.assertRaisesRegex`, :meth:`.assertWarns`, and
:meth:`.assertWarnsRegex` now accept a keyword argument *msg* when used as
-context managers.
-
-(Contributed by Ezio Melotti and Winston Ewert in :issue:`10775`)
+context managers. (Contributed by Ezio Melotti and Winston Ewert in
+:issue:`10775`)
+
+:meth:`unittest.TestCase.run` now returns the :class:`~unittest.TestResult`
+object.
urllib
@@ -1773,13 +2104,13 @@
webbrowser
----------
-The :mod:`webbrowser` module supports more browsers: Google Chrome (named
+The :mod:`webbrowser` module supports more "browsers": Google Chrome (named
:program:`chrome`, :program:`chromium`, :program:`chrome-browser` or
-:program:`chromium-browser` depending on the version and operating system) as
-well as the the generic launchers :program:`xdg-open` from the FreeDesktop.org
-project and :program:`gvfs-open` which is the default URI handler for GNOME 3.
-
-(:issue:`13620` and :issue:`14493`)
+:program:`chromium-browser` depending on the version and operating system),
+and the generic launchers :program:`xdg-open`, from the FreeDesktop.org
+project, and :program:`gvfs-open`, which is the default URI handler for GNOME
+3. (The former contributed by Arnaud Calmettes in :issue:`13620`, the latter
+by Matthias Klose in :issue:`14493`)
xml.etree.ElementTree
@@ -1794,6 +2125,18 @@
and a more detailed reference.
+zlib
+----
+
+New attribute :attr:`zlib.Decompress.eof` makes it possible to distinguish
+between a properly-formed compressed stream and an incomplete or truncated one.
+(Contributed by Nadeem Vawda in :issue:`12646`.)
+
+New attribute :attr:`zlib.ZLIB_RUNTIME_VERSION` reports the version string of
+the underlying ``zlib`` library that is loaded at runtime. (Contributed by
+Torsten Landschoff in :issue:`12306`.)
+
+
Optimizations
=============
@@ -1862,6 +2205,8 @@
Windows 2000 and Windows platforms which set ``COMSPEC`` to ``command.com``
are no longer supported due to maintenance burden.
+OSF support, which was deprecated in 3.2, has been completely removed.
+
Deprecated Python modules, functions and methods
------------------------------------------------
@@ -1872,7 +2217,7 @@
* :meth:`ftplib.FTP.nlst` and :meth:`ftplib.FTP.dir`: use
:meth:`ftplib.FTP.mlsd`
* :func:`platform.popen`: use the :mod:`subprocess` module. Check especially
- the :ref:`subprocess-replacements` section.
+ the :ref:`subprocess-replacements` section (:issue:`11377`).
* :issue:`13374`: The Windows bytes API has been deprecated in the :mod:`os`
module. Use Unicode filenames, instead of bytes filenames, to not depend on
the ANSI code page anymore and to support any filename.
@@ -1911,58 +2256,58 @@
Unicode functions and methods using :c:type:`Py_UNICODE` and
:c:type:`Py_UNICODE*` types:
- * :c:macro:`PyUnicode_FromUnicode`: use :c:func:`PyUnicode_FromWideChar` or
- :c:func:`PyUnicode_FromKindAndData`
- * :c:macro:`PyUnicode_AS_UNICODE`, :c:func:`PyUnicode_AsUnicode`,
- :c:func:`PyUnicode_AsUnicodeAndSize`: use :c:func:`PyUnicode_AsWideCharString`
- * :c:macro:`PyUnicode_AS_DATA`: use :c:macro:`PyUnicode_DATA` with
- :c:macro:`PyUnicode_READ` and :c:macro:`PyUnicode_WRITE`
- * :c:macro:`PyUnicode_GET_SIZE`, :c:func:`PyUnicode_GetSize`: use
- :c:macro:`PyUnicode_GET_LENGTH` or :c:func:`PyUnicode_GetLength`
- * :c:macro:`PyUnicode_GET_DATA_SIZE`: use
- ``PyUnicode_GET_LENGTH(str) * PyUnicode_KIND(str)`` (only work on ready
- strings)
- * :c:func:`PyUnicode_AsUnicodeCopy`: use :c:func:`PyUnicode_AsUCS4Copy` or
- :c:func:`PyUnicode_AsWideCharString`
- * :c:func:`PyUnicode_GetMax`
+* :c:macro:`PyUnicode_FromUnicode`: use :c:func:`PyUnicode_FromWideChar` or
+ :c:func:`PyUnicode_FromKindAndData`
+* :c:macro:`PyUnicode_AS_UNICODE`, :c:func:`PyUnicode_AsUnicode`,
+ :c:func:`PyUnicode_AsUnicodeAndSize`: use :c:func:`PyUnicode_AsWideCharString`
+* :c:macro:`PyUnicode_AS_DATA`: use :c:macro:`PyUnicode_DATA` with
+ :c:macro:`PyUnicode_READ` and :c:macro:`PyUnicode_WRITE`
+* :c:macro:`PyUnicode_GET_SIZE`, :c:func:`PyUnicode_GetSize`: use
+ :c:macro:`PyUnicode_GET_LENGTH` or :c:func:`PyUnicode_GetLength`
+* :c:macro:`PyUnicode_GET_DATA_SIZE`: use
+ ``PyUnicode_GET_LENGTH(str) * PyUnicode_KIND(str)`` (only work on ready
+ strings)
+* :c:func:`PyUnicode_AsUnicodeCopy`: use :c:func:`PyUnicode_AsUCS4Copy` or
+ :c:func:`PyUnicode_AsWideCharString`
+* :c:func:`PyUnicode_GetMax`
Functions and macros manipulating Py_UNICODE* strings:
- * :c:macro:`Py_UNICODE_strlen`: use :c:func:`PyUnicode_GetLength` or
- :c:macro:`PyUnicode_GET_LENGTH`
- * :c:macro:`Py_UNICODE_strcat`: use :c:func:`PyUnicode_CopyCharacters` or
- :c:func:`PyUnicode_FromFormat`
- * :c:macro:`Py_UNICODE_strcpy`, :c:macro:`Py_UNICODE_strncpy`,
- :c:macro:`Py_UNICODE_COPY`: use :c:func:`PyUnicode_CopyCharacters` or
- :c:func:`PyUnicode_Substring`
- * :c:macro:`Py_UNICODE_strcmp`: use :c:func:`PyUnicode_Compare`
- * :c:macro:`Py_UNICODE_strncmp`: use :c:func:`PyUnicode_Tailmatch`
- * :c:macro:`Py_UNICODE_strchr`, :c:macro:`Py_UNICODE_strrchr`: use
- :c:func:`PyUnicode_FindChar`
- * :c:macro:`Py_UNICODE_FILL`: use :c:func:`PyUnicode_Fill`
- * :c:macro:`Py_UNICODE_MATCH`
+* :c:macro:`Py_UNICODE_strlen`: use :c:func:`PyUnicode_GetLength` or
+ :c:macro:`PyUnicode_GET_LENGTH`
+* :c:macro:`Py_UNICODE_strcat`: use :c:func:`PyUnicode_CopyCharacters` or
+ :c:func:`PyUnicode_FromFormat`
+* :c:macro:`Py_UNICODE_strcpy`, :c:macro:`Py_UNICODE_strncpy`,
+ :c:macro:`Py_UNICODE_COPY`: use :c:func:`PyUnicode_CopyCharacters` or
+ :c:func:`PyUnicode_Substring`
+* :c:macro:`Py_UNICODE_strcmp`: use :c:func:`PyUnicode_Compare`
+* :c:macro:`Py_UNICODE_strncmp`: use :c:func:`PyUnicode_Tailmatch`
+* :c:macro:`Py_UNICODE_strchr`, :c:macro:`Py_UNICODE_strrchr`: use
+ :c:func:`PyUnicode_FindChar`
+* :c:macro:`Py_UNICODE_FILL`: use :c:func:`PyUnicode_Fill`
+* :c:macro:`Py_UNICODE_MATCH`
Encoders:
- * :c:func:`PyUnicode_Encode`: use :c:func:`PyUnicode_AsEncodedObject`
- * :c:func:`PyUnicode_EncodeUTF7`
- * :c:func:`PyUnicode_EncodeUTF8`: use :c:func:`PyUnicode_AsUTF8` or
- :c:func:`PyUnicode_AsUTF8String`
- * :c:func:`PyUnicode_EncodeUTF32`
- * :c:func:`PyUnicode_EncodeUTF16`
- * :c:func:`PyUnicode_EncodeUnicodeEscape:` use
- :c:func:`PyUnicode_AsUnicodeEscapeString`
- * :c:func:`PyUnicode_EncodeRawUnicodeEscape:` use
- :c:func:`PyUnicode_AsRawUnicodeEscapeString`
- * :c:func:`PyUnicode_EncodeLatin1`: use :c:func:`PyUnicode_AsLatin1String`
- * :c:func:`PyUnicode_EncodeASCII`: use :c:func:`PyUnicode_AsASCIIString`
- * :c:func:`PyUnicode_EncodeCharmap`
- * :c:func:`PyUnicode_TranslateCharmap`
- * :c:func:`PyUnicode_EncodeMBCS`: use :c:func:`PyUnicode_AsMBCSString` or
- :c:func:`PyUnicode_EncodeCodePage` (with ``CP_ACP`` code_page)
- * :c:func:`PyUnicode_EncodeDecimal`,
- :c:func:`PyUnicode_TransformDecimalToASCII`
+* :c:func:`PyUnicode_Encode`: use :c:func:`PyUnicode_AsEncodedObject`
+* :c:func:`PyUnicode_EncodeUTF7`
+* :c:func:`PyUnicode_EncodeUTF8`: use :c:func:`PyUnicode_AsUTF8` or
+ :c:func:`PyUnicode_AsUTF8String`
+* :c:func:`PyUnicode_EncodeUTF32`
+* :c:func:`PyUnicode_EncodeUTF16`
+* :c:func:`PyUnicode_EncodeUnicodeEscape:` use
+ :c:func:`PyUnicode_AsUnicodeEscapeString`
+* :c:func:`PyUnicode_EncodeRawUnicodeEscape:` use
+ :c:func:`PyUnicode_AsRawUnicodeEscapeString`
+* :c:func:`PyUnicode_EncodeLatin1`: use :c:func:`PyUnicode_AsLatin1String`
+* :c:func:`PyUnicode_EncodeASCII`: use :c:func:`PyUnicode_AsASCIIString`
+* :c:func:`PyUnicode_EncodeCharmap`
+* :c:func:`PyUnicode_TranslateCharmap`
+* :c:func:`PyUnicode_EncodeMBCS`: use :c:func:`PyUnicode_AsMBCSString` or
+ :c:func:`PyUnicode_EncodeCodePage` (with ``CP_ACP`` code_page)
+* :c:func:`PyUnicode_EncodeDecimal`,
+ :c:func:`PyUnicode_TransformDecimalToASCII`
Deprecated features
@@ -2045,6 +2390,54 @@
special case the standard import hooks so they are still supported even
though they do not provide the non-standard ``iter_modules()`` method.
+* A longstanding RFC-compliance bug (:issue:`1079`) in the parsing done by
+ :func:`email.header.decode_header` has been fixed. Code that uses the
+ standard idiom to convert encoded headers into unicode
+ (``str(make_header(decode_header(h))``) will see no change, but code that
+ looks at the individual tuples returned by decode_header will see that
+ whitespace that precedes or follows ``ASCII`` sections is now included in the
+ ``ASCII`` section. Code that builds headers using ``make_header`` should
+ also continue to work without change, since ``make_header`` continues to add
+ whitespace between ``ASCII`` and non-``ASCII`` sections if it is not already
+ present in the input strings.
+
+* :func:`email.utils.formataddr` now does the correct content transfer
+ encoding when passed non-``ASCII`` display names. Any code that depended on
+ the previous buggy behavior that preserved the non-``ASCII`` unicode in the
+ formatted output string will need to be changed (:issue:`1690608`).
+
+* :meth:`poplib.POP3.quit` may now raise protocol errors like all other
+ ``poplib`` methods. Code that assumes ``quit`` does not raise
+ :exc:`poplib.error_proto` errors may need to be changed if errors on ``quit``
+ are encountered by a particular application (:issue:`11291`).
+
+* The ``strict`` argument to :class:`email.parser.Parser`, deprecated since
+ Python 2.4, has finally been removed.
+
+* The deprecated method ``unittest.TestCase.assertSameElements`` has been
+ removed.
+
+* The deprecated variable ``time.accept2dyear`` has been removed.
+
+* The deprecated ``Context._clamp`` attribute has been removed from the
+ :mod:`decimal` module. It was previously replaced by the public attribute
+ :attr:`~decimal.Context.clamp`. (See :issue:`8540`.)
+
+* 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.
+
+* Code that used to work around the fact that the :mod:`threading` module used
+ factory functions by subclassing the private classes will need to change to
+ subclass the now-public classes.
+
Porting C code
--------------
diff --git a/Doc/whatsnew/changelog.rst b/Doc/whatsnew/changelog.rst
new file mode 100644
--- /dev/null
+++ b/Doc/whatsnew/changelog.rst
@@ -0,0 +1,6 @@
++++++++++
+Changelog
++++++++++
+
+.. miscnews:: ../../Misc/NEWS
+
diff --git a/Doc/whatsnew/index.rst b/Doc/whatsnew/index.rst
--- a/Doc/whatsnew/index.rst
+++ b/Doc/whatsnew/index.rst
@@ -23,3 +23,11 @@
2.2.rst
2.1.rst
2.0.rst
+
+The "Changelog" is a HTML version of the file :source:`Misc/NEWS` which
+contains *all* nontrivial changes to Python for the current version.
+
+.. toctree::
+ :maxdepth: 2
+
+ changelog.rst
diff --git a/Include/unicodeobject.h b/Include/unicodeobject.h
--- a/Include/unicodeobject.h
+++ b/Include/unicodeobject.h
@@ -1022,8 +1022,7 @@
/* Create a Unicode Object from the given Unicode code point ordinal.
- The ordinal must be in range(0x10000) on narrow Python builds
- (UCS2), and range(0x110000) on wide builds (UCS4). A ValueError is
+ The ordinal must be in range(0x110000). A ValueError is
raised in case it is not.
*/
diff --git a/Lib/bz2.py b/Lib/bz2.py
--- a/Lib/bz2.py
+++ b/Lib/bz2.py
@@ -79,7 +79,8 @@
mode = "rb"
mode_code = _MODE_READ
self._decompressor = BZ2Decompressor()
- self._buffer = None
+ self._buffer = b""
+ self._buffer_offset = 0
elif mode in ("w", "wb"):
mode = "wb"
mode_code = _MODE_WRITE
@@ -124,7 +125,8 @@
self._fp = None
self._closefp = False
self._mode = _MODE_CLOSED
- self._buffer = None
+ self._buffer = b""
+ self._buffer_offset = 0
@property
def closed(self):
@@ -157,15 +159,18 @@
raise ValueError("I/O operation on closed file")
def _check_can_read(self):
- if not self.readable():
+ if self._mode not in (_MODE_READ, _MODE_READ_EOF):
+ self._check_not_closed()
raise io.UnsupportedOperation("File not open for reading")
def _check_can_write(self):
- if not self.writable():
+ if self._mode != _MODE_WRITE:
+ self._check_not_closed()
raise io.UnsupportedOperation("File not open for writing")
def _check_can_seek(self):
- if not self.readable():
+ if self._mode not in (_MODE_READ, _MODE_READ_EOF):
+ self._check_not_closed()
raise io.UnsupportedOperation("Seeking is only supported "
"on files open for reading")
if not self._fp.seekable():
@@ -174,16 +179,13 @@
# Fill the readahead buffer if it is empty. Returns False on EOF.
def _fill_buffer(self):
+ if self._mode == _MODE_READ_EOF:
+ return False
# Depending on the input data, our call to the decompressor may not
# return any data. In this case, try again after reading another block.
- while True:
- if self._buffer:
- return True
-
- if self._decompressor.unused_data:
- rawblock = self._decompressor.unused_data
- else:
- rawblock = self._fp.read(_BUFFER_SIZE)
+ while self._buffer_offset == len(self._buffer):
+ rawblock = (self._decompressor.unused_data or
+ self._fp.read(_BUFFER_SIZE))
if not rawblock:
if self._decompressor.eof:
@@ -199,30 +201,48 @@
self._decompressor = BZ2Decompressor()
self._buffer = self._decompressor.decompress(rawblock)
+ self._buffer_offset = 0
+ return True
# Read data until EOF.
# If return_data is false, consume the data without returning it.
def _read_all(self, return_data=True):
+ # The loop assumes that _buffer_offset is 0. Ensure that this is true.
+ self._buffer = self._buffer[self._buffer_offset:]
+ self._buffer_offset = 0
+
blocks = []
while self._fill_buffer():
if return_data:
blocks.append(self._buffer)
self._pos += len(self._buffer)
- self._buffer = None
+ self._buffer = b""
if return_data:
return b"".join(blocks)
# Read a block of up to n bytes.
# If return_data is false, consume the data without returning it.
def _read_block(self, n, return_data=True):
+ # If we have enough data buffered, return immediately.
+ end = self._buffer_offset + n
+ if end <= len(self._buffer):
+ data = self._buffer[self._buffer_offset : end]
+ self._buffer_offset = end
+ self._pos += len(data)
+ return data if return_data else None
+
+ # The loop assumes that _buffer_offset is 0. Ensure that this is true.
+ self._buffer = self._buffer[self._buffer_offset:]
+ self._buffer_offset = 0
+
blocks = []
while n > 0 and self._fill_buffer():
if n < len(self._buffer):
data = self._buffer[:n]
- self._buffer = self._buffer[n:]
+ self._buffer_offset = n
else:
data = self._buffer
- self._buffer = None
+ self._buffer = b""
if return_data:
blocks.append(data)
self._pos += len(data)
@@ -238,9 +258,9 @@
"""
with self._lock:
self._check_can_read()
- if self._mode == _MODE_READ_EOF or not self._fill_buffer():
+ if not self._fill_buffer():
return b""
- return self._buffer
+ return self._buffer[self._buffer_offset:]
def read(self, size=-1):
"""Read up to size uncompressed bytes from the file.
@@ -250,7 +270,7 @@
"""
with self._lock:
self._check_can_read()
- if self._mode == _MODE_READ_EOF or size == 0:
+ if size == 0:
return b""
elif size < 0:
return self._read_all()
@@ -268,15 +288,19 @@
# In this case we make multiple reads, to avoid returning b"".
with self._lock:
self._check_can_read()
- if (size == 0 or self._mode == _MODE_READ_EOF or
- not self._fill_buffer()):
+ if (size == 0 or
+ # Only call _fill_buffer() if the buffer is actually empty.
+ # This gives a significant speedup if *size* is small.
+ (self._buffer_offset == len(self._buffer) and not self._fill_buffer())):
return b""
- if 0 < size < len(self._buffer):
- data = self._buffer[:size]
- self._buffer = self._buffer[size:]
+ if size > 0:
+ data = self._buffer[self._buffer_offset :
+ self._buffer_offset + size]
+ self._buffer_offset += len(data)
else:
- data = self._buffer
- self._buffer = None
+ data = self._buffer[self._buffer_offset:]
+ self._buffer = b""
+ self._buffer_offset = 0
self._pos += len(data)
return data
@@ -295,10 +319,20 @@
non-negative, no more than size bytes will be read (in which
case the line may be incomplete). Returns b'' if already at EOF.
"""
- if not hasattr(size, "__index__"):
- raise TypeError("Integer argument expected")
- size = size.__index__()
+ if not isinstance(size, int):
+ if not hasattr(size, "__index__"):
+ raise TypeError("Integer argument expected")
+ size = size.__index__()
with self._lock:
+ self._check_can_read()
+ # Shortcut for the common case - the whole line is in the buffer.
+ if size < 0:
+ end = self._buffer.find(b"\n", self._buffer_offset) + 1
+ if end > 0:
+ line = self._buffer[self._buffer_offset : end]
+ self._buffer_offset = end
+ self._pos += len(line)
+ return line
return io.BufferedIOBase.readline(self, size)
def readlines(self, size=-1):
@@ -308,9 +342,10 @@
further lines will be read once the total size of the lines read
so far equals or exceeds size.
"""
- if not hasattr(size, "__index__"):
- raise TypeError("Integer argument expected")
- size = size.__index__()
+ if not isinstance(size, int):
+ if not hasattr(size, "__index__"):
+ raise TypeError("Integer argument expected")
+ size = size.__index__()
with self._lock:
return io.BufferedIOBase.readlines(self, size)
@@ -345,7 +380,8 @@
self._mode = _MODE_READ
self._pos = 0
self._decompressor = BZ2Decompressor()
- self._buffer = None
+ self._buffer = b""
+ self._buffer_offset = 0
def seek(self, offset, whence=0):
"""Change the file position.
@@ -385,8 +421,7 @@
offset -= self._pos
# Read and discard data until we reach the desired position.
- if self._mode != _MODE_READ_EOF:
- self._read_block(offset, return_data=False)
+ self._read_block(offset, return_data=False)
return self._pos
diff --git a/Lib/codecs.py b/Lib/codecs.py
--- a/Lib/codecs.py
+++ b/Lib/codecs.py
@@ -461,7 +461,7 @@
# read until we get the required number of characters (if available)
while True:
- # can the request can be satisfied from the character buffer?
+ # can the request be satisfied from the character buffer?
if chars < 0:
if size < 0:
if self.charbuffer:
diff --git a/Lib/ctypes/__init__.py b/Lib/ctypes/__init__.py
--- a/Lib/ctypes/__init__.py
+++ b/Lib/ctypes/__init__.py
@@ -456,7 +456,7 @@
code = GetLastError()
if descr is None:
descr = FormatError(code).strip()
- return WindowsError(code, descr)
+ return WindowsError(None, descr, None, code)
if sizeof(c_uint) == sizeof(c_void_p):
c_size_t = c_uint
diff --git a/Lib/ctypes/test/test_win32.py b/Lib/ctypes/test/test_win32.py
--- a/Lib/ctypes/test/test_win32.py
+++ b/Lib/ctypes/test/test_win32.py
@@ -67,6 +67,28 @@
self.assertEqual(ex.text, "text")
self.assertEqual(ex.details, ("details",))
+ class TestWinError(unittest.TestCase):
+ def test_winerror(self):
+ # see Issue 16169
+ import errno
+ ERROR_INVALID_PARAMETER = 87
+ msg = FormatError(ERROR_INVALID_PARAMETER).strip()
+ args = (errno.EINVAL, msg, None, ERROR_INVALID_PARAMETER)
+
+ e = WinError(ERROR_INVALID_PARAMETER)
+ self.assertEqual(e.args, args)
+ self.assertEqual(e.errno, errno.EINVAL)
+ self.assertEqual(e.winerror, ERROR_INVALID_PARAMETER)
+
+ windll.kernel32.SetLastError(ERROR_INVALID_PARAMETER)
+ try:
+ raise WinError()
+ except OSError as exc:
+ e = exc
+ self.assertEqual(e.args, args)
+ self.assertEqual(e.errno, errno.EINVAL)
+ self.assertEqual(e.winerror, ERROR_INVALID_PARAMETER)
+
class Structures(unittest.TestCase):
def test_struct_by_value(self):
diff --git a/Lib/idlelib/config-extensions.def b/Lib/idlelib/config-extensions.def
--- a/Lib/idlelib/config-extensions.def
+++ b/Lib/idlelib/config-extensions.def
@@ -46,6 +46,8 @@
[ScriptBinding]
enable=1
+enable_shell=0
+enable_editor=1
[ScriptBinding_cfgBindings]
run-module=<Key-F5>
check-module=<Alt-Key-x>
diff --git a/Lib/ipaddress.py b/Lib/ipaddress.py
--- a/Lib/ipaddress.py
+++ b/Lib/ipaddress.py
@@ -206,10 +206,11 @@
"""Summarize a network range given the first and last IP addresses.
Example:
- >>> summarize_address_range(IPv4Address('192.0.2.0'),
- IPv4Address('192.0.2.130'))
+ >>> list(summarize_address_range(IPv4Address('192.0.2.0'),
+ ... IPv4Address('192.0.2.130')))
+ ... #doctest: +NORMALIZE_WHITESPACE
[IPv4Network('192.0.2.0/25'), IPv4Network('192.0.2.128/31'),
- IPv4Network('192.0.2.130/32')]
+ IPv4Network('192.0.2.130/32')]
Args:
first: the first IPv4Address or IPv6Address in the range.
diff --git a/Lib/logging/handlers.py b/Lib/logging/handlers.py
--- a/Lib/logging/handlers.py
+++ b/Lib/logging/handlers.py
@@ -794,18 +794,12 @@
self.formatter = None
def _connect_unixsocket(self, address):
- self.socket = socket.socket(socket.AF_UNIX, socket.SOCK_DGRAM)
- # syslog may require either DGRAM or STREAM sockets
+ self.socket = socket.socket(socket.AF_UNIX, self.socktype)
try:
self.socket.connect(address)
except socket.error:
self.socket.close()
- self.socket = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
- try:
- self.socket.connect(address)
- except socket.error:
- self.socket.close()
- raise
+ raise
def encodePriority(self, facility, priority):
"""
diff --git a/Lib/platform.py b/Lib/platform.py
--- a/Lib/platform.py
+++ b/Lib/platform.py
@@ -112,7 +112,7 @@
__version__ = '1.0.7'
import collections
-import sys, os, re
+import sys, os, re, subprocess
### Globals & Constants
@@ -922,13 +922,15 @@
if sys.platform in ('dos','win32','win16','os2'):
# XXX Others too ?
return default
- target = _follow_symlinks(target).replace('"', '\\"')
+ target = _follow_symlinks(target)
try:
- f = os.popen('file -b "%s" 2> %s' % (target, DEV_NULL))
+ proc = subprocess.Popen(['file', target],
+ stdout=subprocess.PIPE, stderr=subprocess.STDOUT)
+
except (AttributeError,os.error):
return default
- output = f.read().strip()
- rc = f.close()
+ output = proc.communicate()[0].decode('latin-1')
+ rc = proc.wait()
if not output or rc:
return default
else:
diff --git a/Lib/pstats.py b/Lib/pstats.py
--- a/Lib/pstats.py
+++ b/Lib/pstats.py
@@ -159,15 +159,19 @@
# along with some printable description
sort_arg_dict_default = {
"calls" : (((1,-1), ), "call count"),
+ "ncalls" : (((1,-1), ), "call count"),
+ "cumtime" : (((3,-1), ), "cumulative time"),
"cumulative": (((3,-1), ), "cumulative time"),
"file" : (((4, 1), ), "file name"),
+ "filename" : (((4, 1), ), "file name"),
"line" : (((5, 1), ), "line number"),
"module" : (((4, 1), ), "file name"),
"name" : (((6, 1), ), "function name"),
"nfl" : (((6, 1),(4, 1),(5, 1),), "name/file/line"),
- "pcalls" : (((0,-1), ), "call count"),
+ "pcalls" : (((0,-1), ), "primitive call count"),
"stdname" : (((7, 1), ), "standard name"),
"time" : (((2,-1), ), "internal time"),
+ "tottime" : (((2,-1), ), "internal time"),
}
def get_sort_arg_defs(self):
diff --git a/Lib/socketserver.py b/Lib/socketserver.py
--- a/Lib/socketserver.py
+++ b/Lib/socketserver.py
@@ -562,7 +562,7 @@
self.collect_children()
def service_actions(self):
- """Collect the zombie child processes regularly in the ForkingMixin.
+ """Collect the zombie child processes regularly in the ForkingMixIn.
service_actions is called in the BaseServer's serve_forver loop.
"""
diff --git a/Lib/subprocess.py b/Lib/subprocess.py
--- a/Lib/subprocess.py
+++ b/Lib/subprocess.py
@@ -1445,9 +1445,16 @@
pid, sts = _waitpid(self.pid, _WNOHANG)
if pid == self.pid:
self._handle_exitstatus(sts)
- except _os_error:
+ except _os_error as e:
if _deadstate is not None:
self.returncode = _deadstate
+ elif e.errno == errno.ECHILD:
+ # This happens if SIGCLD is set to be ignored or
+ # waiting for child processes has otherwise been
+ # disabled for our process. This child is dead, we
+ # can't get the status.
+ # http://bugs.python.org/issue15756
+ self.returncode = 0
return self.returncode
diff --git a/Lib/test/subprocessdata/sigchild_ignore.py b/Lib/test/subprocessdata/sigchild_ignore.py
--- a/Lib/test/subprocessdata/sigchild_ignore.py
+++ b/Lib/test/subprocessdata/sigchild_ignore.py
@@ -1,6 +1,15 @@
-import signal, subprocess, sys
+import signal, subprocess, sys, time
# On Linux this causes os.waitpid to fail with OSError as the OS has already
# reaped our child process. The wait() passing the OSError on to the caller
# and causing us to exit with an error is what we are testing against.
signal.signal(signal.SIGCHLD, signal.SIG_IGN)
subprocess.Popen([sys.executable, '-c', 'print("albatross")']).wait()
+# Also ensure poll() handles an errno.ECHILD appropriately.
+p = subprocess.Popen([sys.executable, '-c', 'print("albatross")'])
+num_polls = 0
+while p.poll() is None:
+ # Waiting for the process to finish.
+ time.sleep(0.01) # Avoid being a CPU busy loop.
+ num_polls += 1
+ if num_polls > 3000:
+ raise RuntimeError('poll should have returned 0 within 30 seconds')
diff --git a/Lib/test/test_capi.py b/Lib/test/test_capi.py
--- a/Lib/test/test_capi.py
+++ b/Lib/test/test_capi.py
@@ -316,6 +316,17 @@
c, i, when_skipped, when_not_skipped))
self.assertIs(when_skipped, when_not_skipped, message)
+ def test_parse_tuple_and_keywords(self):
+ # parse_tuple_and_keywords error handling tests
+ self.assertRaises(TypeError, _testcapi.parse_tuple_and_keywords,
+ (), {}, 42, [])
+ self.assertRaises(ValueError, _testcapi.parse_tuple_and_keywords,
+ (), {}, b'', 42)
+ self.assertRaises(ValueError, _testcapi.parse_tuple_and_keywords,
+ (), {}, b'', [''] * 42)
+ self.assertRaises(ValueError, _testcapi.parse_tuple_and_keywords,
+ (), {}, b'', [42])
+
def test_main():
support.run_unittest(CAPITest, TestPendingCalls,
Test6012, EmbeddingTest, SkipitemTest)
diff --git a/Lib/test/test_httpservers.py b/Lib/test/test_httpservers.py
--- a/Lib/test/test_httpservers.py
+++ b/Lib/test/test_httpservers.py
@@ -62,6 +62,7 @@
def tearDown(self):
self.thread.stop()
+ self.thread = None
os.environ.__exit__()
support.threading_cleanup(*self._threads)
diff --git a/Lib/test/test_subprocess.py b/Lib/test/test_subprocess.py
--- a/Lib/test/test_subprocess.py
+++ b/Lib/test/test_subprocess.py
@@ -1,4 +1,5 @@
import unittest
+from test import script_helper
from test import support
import subprocess
import sys
@@ -191,15 +192,134 @@
p.wait()
self.assertEqual(p.stderr, None)
+ def _assert_python(self, pre_args, **kwargs):
+ # We include sys.exit() to prevent the test runner from hanging
+ # whenever python is found.
+ args = pre_args + ["import sys; sys.exit(47)"]
+ p = subprocess.Popen(args, **kwargs)
+ p.wait()
+ self.assertEqual(47, p.returncode)
+
+ # TODO: make this test work on Linux.
+ # This may be failing on Linux because of issue #7774.
+ @unittest.skipIf(sys.platform not in ('win32', 'darwin'),
+ "possible bug using executable argument on Linux")
+ def test_executable(self):
+ # Check that the executable argument works.
+ self._assert_python(["doesnotexist", "-c"], executable=sys.executable)
+
+ def test_executable_takes_precedence(self):
+ # Check that the executable argument takes precedence over args[0].
+ #
+ # Verify first that the call succeeds without the executable arg.
+ pre_args = [sys.executable, "-c"]
+ self._assert_python(pre_args)
+ self.assertRaises(FileNotFoundError, self._assert_python, pre_args,
+ executable="doesnotexist")
+
+ @unittest.skipIf(mswindows, "executable argument replaces shell")
+ def test_executable_replaces_shell(self):
+ # Check that the executable argument replaces the default shell
+ # when shell=True.
+ self._assert_python([], executable=sys.executable, shell=True)
+
+ # For use in the test_cwd* tests below.
+ def _normalize_cwd(self, cwd):
+ # Normalize an expected cwd (for Tru64 support).
+ # We can't use os.path.realpath since it doesn't expand Tru64 {memb}
+ # strings. See bug #1063571.
+ original_cwd = os.getcwd()
+ os.chdir(cwd)
+ cwd = os.getcwd()
+ os.chdir(original_cwd)
+ return cwd
+
+ # For use in the test_cwd* tests below.
+ def _split_python_path(self):
+ # Return normalized (python_dir, python_base).
+ python_path = os.path.realpath(sys.executable)
+ return os.path.split(python_path)
+
+ # For use in the test_cwd* tests below.
+ def _assert_cwd(self, expected_cwd, python_arg, **kwargs):
+ # Invoke Python via Popen, and assert that (1) the call succeeds,
+ # and that (2) the current working directory of the child process
+ # matches *expected_cwd*.
+ p = subprocess.Popen([python_arg, "-c",
+ "import os, sys; "
+ "sys.stdout.write(os.getcwd()); "
+ "sys.exit(47)"],
+ stdout=subprocess.PIPE,
+ **kwargs)
+ self.addCleanup(p.stdout.close)
+ p.wait()
+ self.assertEqual(47, p.returncode)
+ normcase = os.path.normcase
+ self.assertEqual(normcase(expected_cwd),
+ normcase(p.stdout.read().decode("utf-8")))
+
+ def test_cwd(self):
+ # Check that cwd changes the cwd for the child process.
+ temp_dir = tempfile.gettempdir()
+ temp_dir = self._normalize_cwd(temp_dir)
+ self._assert_cwd(temp_dir, sys.executable, cwd=temp_dir)
+
+ @unittest.skipIf(mswindows, "pending resolution of issue #15533")
+ def test_cwd_with_relative_arg(self):
+ # Check that Popen looks for args[0] relative to cwd if args[0]
+ # is relative.
+ python_dir, python_base = self._split_python_path()
+ rel_python = os.path.join(os.curdir, python_base)
+ with support.temp_cwd() as wrong_dir:
+ # Before calling with the correct cwd, confirm that the call fails
+ # without cwd and with the wrong cwd.
+ self.assertRaises(FileNotFoundError, subprocess.Popen,
+ [rel_python])
+ self.assertRaises(FileNotFoundError, subprocess.Popen,
+ [rel_python], cwd=wrong_dir)
+ python_dir = self._normalize_cwd(python_dir)
+ self._assert_cwd(python_dir, rel_python, cwd=python_dir)
+
+ @unittest.skipIf(mswindows, "pending resolution of issue #15533")
+ def test_cwd_with_relative_executable(self):
+ # Check that Popen looks for executable relative to cwd if executable
+ # is relative (and that executable takes precedence over args[0]).
+ python_dir, python_base = self._split_python_path()
+ rel_python = os.path.join(os.curdir, python_base)
+ doesntexist = "somethingyoudonthave"
+ with support.temp_cwd() as wrong_dir:
+ # Before calling with the correct cwd, confirm that the call fails
+ # without cwd and with the wrong cwd.
+ self.assertRaises(FileNotFoundError, subprocess.Popen,
+ [doesntexist], executable=rel_python)
+ self.assertRaises(FileNotFoundError, subprocess.Popen,
+ [doesntexist], executable=rel_python,
+ cwd=wrong_dir)
+ python_dir = self._normalize_cwd(python_dir)
+ self._assert_cwd(python_dir, doesntexist, executable=rel_python,
+ cwd=python_dir)
+
+ def test_cwd_with_absolute_arg(self):
+ # Check that Popen can find the executable when the cwd is wrong
+ # if args[0] is an absolute path.
+ python_dir, python_base = self._split_python_path()
+ abs_python = os.path.join(python_dir, python_base)
+ rel_python = os.path.join(os.curdir, python_base)
+ with script_helper.temp_dir() as wrong_dir:
+ # Before calling with an absolute path, confirm that using a
+ # relative path fails.
+ self.assertRaises(FileNotFoundError, subprocess.Popen,
+ [rel_python], cwd=wrong_dir)
+ wrong_dir = self._normalize_cwd(wrong_dir)
+ self._assert_cwd(wrong_dir, abs_python, cwd=wrong_dir)
+
@unittest.skipIf(sys.base_prefix != sys.prefix,
'Test is not venv-compatible')
def test_executable_with_cwd(self):
- python_dir = os.path.dirname(os.path.realpath(sys.executable))
- p = subprocess.Popen(["somethingyoudonthave", "-c",
- "import sys; sys.exit(47)"],
- executable=sys.executable, cwd=python_dir)
- p.wait()
- self.assertEqual(p.returncode, 47)
+ python_dir, python_base = self._split_python_path()
+ python_dir = self._normalize_cwd(python_dir)
+ self._assert_cwd(python_dir, "somethingyoudonthave",
+ executable=sys.executable, cwd=python_dir)
@unittest.skipIf(sys.base_prefix != sys.prefix,
'Test is not venv-compatible')
@@ -208,11 +328,7 @@
def test_executable_without_cwd(self):
# For a normal installation, it should work without 'cwd'
# argument. For test runs in the build directory, see #7774.
- p = subprocess.Popen(["somethingyoudonthave", "-c",
- "import sys; sys.exit(47)"],
- executable=sys.executable)
- p.wait()
- self.assertEqual(p.returncode, 47)
+ self._assert_cwd('', "somethingyoudonthave", executable=sys.executable)
def test_stdin_pipe(self):
# stdin redirection
@@ -369,24 +485,6 @@
p.wait()
self.assertEqual(p.stdin, None)
- def test_cwd(self):
- tmpdir = tempfile.gettempdir()
- # We cannot use os.path.realpath to canonicalize the path,
- # since it doesn't expand Tru64 {memb} strings. See bug 1063571.
- cwd = os.getcwd()
- os.chdir(tmpdir)
- tmpdir = os.getcwd()
- os.chdir(cwd)
- p = subprocess.Popen([sys.executable, "-c",
- 'import sys,os;'
- 'sys.stdout.write(os.getcwd())'],
- stdout=subprocess.PIPE,
- cwd=tmpdir)
- self.addCleanup(p.stdout.close)
- normcase = os.path.normcase
- self.assertEqual(normcase(p.stdout.read().decode("utf-8")),
- normcase(tmpdir))
-
def test_env(self):
newenv = os.environ.copy()
newenv["FRUIT"] = "orange"
diff --git a/Lib/test/test_threaded_import.py b/Lib/test/test_threaded_import.py
--- a/Lib/test/test_threaded_import.py
+++ b/Lib/test/test_threaded_import.py
@@ -225,11 +225,9 @@
@reap_threads
def test_main():
old_switchinterval = None
- # Issue #15599: FreeBSD/KVM cannot handle gil_interval == 1.
- new_switchinterval = 0.00001 if 'freebsd' in sys.platform else 0.00000001
try:
old_switchinterval = sys.getswitchinterval()
- sys.setswitchinterval(new_switchinterval)
+ sys.setswitchinterval(1e-5)
except AttributeError:
pass
try:
diff --git a/Lib/test/test_xml_etree.py b/Lib/test/test_xml_etree.py
--- a/Lib/test/test_xml_etree.py
+++ b/Lib/test/test_xml_etree.py
@@ -1893,10 +1893,23 @@
sample1 = ('<!DOCTYPE html PUBLIC'
' "-//W3C//DTD XHTML 1.0 Transitional//EN"'
' "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">'
- '<html>text</html>')
+ '<html>text<div>subtext</div>tail</html>')
sample2 = '''<toplevel>sometext</toplevel>'''
+ def _check_sample1_element(self, e):
+ self.assertEqual(e.tag, 'html')
+ self.assertEqual(e.text, 'text')
+ self.assertEqual(e.tail, None)
+ self.assertEqual(e.attrib, {})
+ children = list(e)
+ self.assertEqual(len(children), 1)
+ child = children[0]
+ self.assertEqual(child.tag, 'div')
+ self.assertEqual(child.text, 'subtext')
+ self.assertEqual(child.tail, 'tail')
+ self.assertEqual(child.attrib, {})
+
def test_dummy_builder(self):
class BaseDummyBuilder:
def close(self):
@@ -1929,7 +1942,7 @@
parser.feed(self.sample1)
e = parser.close()
- self.assertEqual(e.tag, 'html')
+ self._check_sample1_element(e)
def test_element_factory(self):
lst = []
@@ -1945,6 +1958,33 @@
self.assertEqual(lst, ['toplevel'])
+ def _check_element_factory_class(self, cls):
+ tb = ET.TreeBuilder(element_factory=cls)
+
+ parser = ET.XMLParser(target=tb)
+ parser.feed(self.sample1)
+ e = parser.close()
+ self.assertIsInstance(e, cls)
+ self._check_sample1_element(e)
+
+ def test_element_factory_subclass(self):
+ class MyElement(ET.Element):
+ pass
+ self._check_element_factory_class(MyElement)
+
+ def test_element_factory_pure_python_subclass(self):
+ # Mimick SimpleTAL's behaviour (issue #16089): both versions of
+ # TreeBuilder should be able to cope with a subclass of the
+ # pure Python Element class.
+ base = ET._Element
+ # Not from a C extension
+ self.assertEqual(base.__module__, 'xml.etree.ElementTree')
+ # Force some multiple inheritance with a C class to make things
+ # more interesting.
+ class MyElement(base, ValueError):
+ pass
+ self._check_element_factory_class(MyElement)
+
def test_doctype(self):
class DoctypeParser:
_doctype = None
diff --git a/Lib/xml/etree/ElementTree.py b/Lib/xml/etree/ElementTree.py
--- a/Lib/xml/etree/ElementTree.py
+++ b/Lib/xml/etree/ElementTree.py
@@ -303,7 +303,9 @@
self._children.insert(index, element)
def _assert_is_element(self, e):
- if not isinstance(e, Element):
+ # Need to refer to the actual Python implementation, not the
+ # shadowing C implementation.
+ if not isinstance(e, _Element):
raise TypeError('expected an Element, not %s' % type(e).__name__)
##
diff --git a/Misc/ACKS b/Misc/ACKS
--- a/Misc/ACKS
+++ b/Misc/ACKS
@@ -49,9 +49,9 @@
David Ascher
Chris AtLee
Aymeric Augustin
-Jesús Cea Avión
John Aycock
Donovan Baarda
+Arne Babenhauserheide
Attila Babo
Marcin Bachry
Alfonso Baciero
@@ -94,6 +94,7 @@
Thomas Bellman
Alexander “Саша” Belopolsky
Eli Bendersky
+David Benjamin
Andrew Bennetts
Andy Bensky
Bennett Benson
@@ -101,6 +102,7 @@
Michel Van den Bergh
Julian Berman
Brice Berna
+Olivier Bernard
Eric Beser
Steven Bethard
Stephen Bevan
@@ -183,6 +185,7 @@
Lorenzo M. Catucci
Donn Cave
Charles Cazabon
+Jesús Cea Avión
Per Cederqvist
Matej Cepl
Carl Cerecke
@@ -246,6 +249,7 @@
Jeremy Craven
Laura Creighton
Simon Cross
+Felipe Cruz
Drew Csillag
Joaquin Cuenca Abela
John Cugini
diff --git a/Misc/HISTORY b/Misc/HISTORY
--- a/Misc/HISTORY
+++ b/Misc/HISTORY
@@ -10,6 +10,5403 @@
======================================================================
+What's New in Python 3.2?
+=========================
+
+*Release date: 20-Feb-2011*
+
+Core and Builtins
+-----------------
+
+- Issue #11249: Fix potential crashes when using the limited API.
+
+Build
+-----
+
+- Issue #11222: Fix non-framework shared library build on Mac OS X.
+
+- Issue #11184: Fix large-file support on AIX.
+
+- Issue #941346: Fix broken shared library build on AIX.
+
+Documentation
+-------------
+
+- Issue #10709: Add updated AIX notes in Misc/README.AIX.
+
+
+What's New in Python 3.2 Release Candidate 3?
+=============================================
+
+*Release date: 13-Feb-2011*
+
+Core and Builtins
+-----------------
+
+- Issue #11134: Add missing fields to typeslots.h.
+
+- Issue #11135: Remove redundant doc field from PyType_Spec.
+
+- Issue #11067: Add PyType_GetFlags, to support PyUnicode_Check in the limited
+ ABI.
+
+- Issue #11118: Fix bogus export of None in python3.dll.
+
+Library
+-------
+
+- Issue #11116: any error during addition of a message to a mailbox now causes a
+ rollback, instead of leaving the mailbox partially modified.
+
+- Issue #11132: Fix passing of "optimize" parameter when recursing in
+ compileall.compile_dir().
+
+- Issue #11110: Fix a potential decref of a NULL in sqlite3.
+
+- Issue #8275: Fix passing of callback arguments with ctypes under Win64. Patch
+ by Stan Mihai.
+
+Build
+-----
+
+- Issue #11079: The /Applications/Python x.x folder created by the Mac OS X
+ installers now includes a link to the installed documentation and no longer
+ includes an Extras directory. The Tools directory is now installed in the
+ framework under share/doc.
+
+- Issue #11121: Fix building with --enable-shared.
+
+Tests
+-----
+
+- Issue #10971: test_zipimport_support is once again compatible with the refleak
+ hunter feature of test.regrtest.
+
+
+What's New in Python 3.2 Release Candidate 2?
+=============================================
+
+*Release date: 30-Jan-2011*
+
+Core and Builtins
+-----------------
+
+- Issue #10451: memoryview objects could allow to mutate a readable buffer.
+ Initial patch by Ross Lagerwall.
+
+Library
+-------
+
+- Issue #9124: mailbox now accepts binary input and reads and writes mailbox
+ files in binary mode, using the email package's binary support to parse
+ arbitrary email messages. StringIO and text file input is deprecated,
+ and string input fails early if non-ASCII characters are used, where
+ previously it would fail when the email was processed in a later step.
+
+- Issue #10845: Mitigate the incompatibility between the multiprocessing
+ module on Windows and the use of package, zipfile or directory execution
+ by special casing main modules that actually *are* called __main__.py.
+
+- Issue #11045: Protect logging call against None argument.
+
+- Issue #11052: Correct IDLE menu accelerators on Mac OS X for Save
+ commands.
+
+- Issue #11053: Fix IDLE "Syntax Error" windows to behave as in 2.x,
+ preventing a confusing hung appearance on OS X with the windows
+ obscured.
+
+- Issue #10940: Workaround an IDLE hang on Mac OS X 10.6 when using the
+ menu accelerators for Open Module, Go to Line, and New Indent Width.
+ The accelerators still work but no longer appear in the menu items.
+
+- Issue #10989: Fix a crash on SSLContext.load_verify_locations(None, True).
+
+- Issue #11020: Command-line pyclbr was broken because of missing 2-to-3
+ conversion.
+
+- Issue #11019: Fixed BytesGenerator so that it correctly handles a Message
+ with a None body.
+
+- Issue #11014: Make 'filter' argument in tarfile.Tarfile.add() into a
+ keyword-only argument. The preceding positional argument was deprecated,
+ so it made no sense to add filter as a positional argument.
+
+- Issue #11004: Repaired edge case in deque.count().
+
+- Issue #10974: IDLE no longer crashes if its recent files list includes files
+ with non-ASCII characters in their path names.
+
+- Have hashlib.algorithms_available and hashlib.algorithms_guaranteed both
+ return sets instead of one returning a tuple and the other a frozenset.
+
+- Issue #10987: Fix the recursion limit handling in the _pickle module.
+
+- Issue #10983: Fix several bugs making tunnel requests in http.client.
+
+- Issue #10955: zipimport uses ASCII encoding instead of cp437 to decode
+ filenames, at bootstrap, if the codec registry is not ready yet. It is still
+ possible to have non-ASCII filenames using the Unicode flag (UTF-8 encoding)
+ for all file entries in the ZIP file.
+
+- Issue #10949: Improved robustness of rotating file handlers.
+
+- Issue #10955: Fix a potential crash when trying to mmap() a file past its
+ length. Initial patch by Ross Lagerwall.
+
+- Issue #10898: Allow compiling the posix module when the C library defines
+ a symbol named FSTAT.
+
+- Issue #10980: the HTTP server now encodes headers with iso-8859-1 (latin1)
+ encoding. This is the preferred encoding of PEP 3333 and the base encoding
+ of HTTP 1.1.
+
+- To match the behaviour of HTTP server, the HTTP client library now also
+ encodes headers with iso-8859-1 (latin1) encoding. It was already doing
+ that for incoming headers which makes this behaviour now consistent in
+ both incoming and outgoing direction.
+
+- Issue #9509: argparse now properly handles IOErrors raised by
+ argparse.FileType.
+
+- Issue #10961: The new pydoc server now better handles exceptions raised
+ during request handling.
+
+- Issue #10680: Fix mutually exclusive arguments for argument groups in
+ argparse.
+
+Build
+-----
+
+- Issue #11054: Allow Mac OS X installer builds to again work on 10.5 with
+ the system-provided Python.
+
+
+What's New in Python 3.2 Release Candidate 1
+============================================
+
+*Release date: 16-Jan-2011*
+
+Core and Builtins
+-----------------
+
+- Issue #10889: range indexing and slicing now works correctly on ranges with
+ a length that exceeds sys.maxsize.
+
+- Issue #10892: Don't segfault when trying to delete __abstractmethods__ from a
+ class.
+
+- Issue #8020: Avoid a crash where the small objects allocator would read
+ non-Python managed memory while it is being modified by another thread. Patch
+ by Matt Bandy.
+
+- Issue #10841: On Windows, set the binary mode on stdin, stdout, stderr and all
+ io.FileIO objects (to not translate newlines, \r\n <=> \n). The Python parser
+ translates newlines (\r\n => \n).
+
+- Remove buffer API from stable ABI for now, see #10181.
+
+- Issue #8651: PyArg_Parse*() functions raise an OverflowError if the file
+ doesn't have PY_SSIZE_T_CLEAN define and the size doesn't fit in an int
+ (length bigger than 2^31-1 bytes).
+
+- Issue #9015, #9611: FileIO.readinto(), FileIO.write(), os.write() and
+ stdprinter.write() clamp the length to INT_MAX on Windows.
+
+- Issue #8278: On Windows and with a NTFS filesystem, os.stat() and os.utime()
+ can now handle dates after 2038.
+
+- Issue #10780: PyErr_SetFromWindowsErrWithFilename() and
+ PyErr_SetExcFromWindowsErrWithFilename() decode the filename from the
+ filesystem encoding instead of UTF-8.
+
+- Issue #10779: PyErr_WarnExplicit() decodes the filename from the filesystem
+ encoding instead of UTF-8.
+
+- Add sys.flags attribute for the new -q command-line option.
+
+- Issue #11506: Trying to assign to a bytes literal should result in a
+ SyntaxError.
+
+Library
+-------
+
+- Issue #10916: mmap should not segfault when a file is mapped using 0 as length
+ and a non-zero offset, and an attempt to read past the end of file is made
+ (IndexError is raised instead). Patch by Ross Lagerwall.
+
+- Issue #10154, #10090: change the normalization of UTF-8 to "UTF-8" instead
+ of "UTF8" in the locale module as the latter is not supported MacOSX and OpenBSD.
+
+- Issue #10907: Warn OS X 10.6 IDLE users to use ActiveState Tcl/Tk 8.5, rather
+ than the currently problematic Apple-supplied one, when running with the
+ 64-/32-bit installer variant.
+
+- Issue #4953: cgi.FieldStorage and cgi.parse() parse the request as bytes, not
+ as unicode, and accept binary files. Add encoding and errors attributes to
+ cgi.FieldStorage. Patch written by Pierre Quentel (with many inputs by Glenn
+ Linderman).
+
+- Add encoding and errors arguments to urllib.parse_qs() and urllib.parse_qsl().
+
+- Issue #10899: No function type annotations in the standard library. Removed
+ function type annotations from _pyio.py.
+
+- Issue #10875: Update Regular Expression HOWTO; patch by 'SilentGhost'.
+
+- Issue #10872: The repr() of TextIOWrapper objects now includes the mode
+ if available.
+
+- Issue #10869: Fixed bug where ast.increment_lineno modified the root node
+ twice.
+
+- Issue #5871: email.header.Header.encode now raises an error if any
+ continuation line in the formatted value has no leading white space and looks
+ like a header. Since Generator uses Header to format all headers, this check
+ is made for all headers in any serialized message at serialization time. This
+ provides protection against header injection attacks.
+
+- Issue #10859: Make ``contextlib.GeneratorContextManager`` officially
+ private by renaming it to ``_GeneratorContextManager``.
+
+- Issue #10042: Fixed the total_ordering decorator to handle cross-type
+ comparisons that could lead to infinite recursion.
+
+- Issue #10686: the email package now :rfc:`2047`\ -encodes headers with
+ non-ASCII bytes (parsed by a BytesParser) when doing conversion to 7bit-clean
+ presentation, instead of replacing them with ?s.
+
+- email.header.Header was incorrectly encoding folding whitespace when
+ rfc2047-encoding header values with embedded newlines, leaving them without
+ folding whitespace. It now uses the continuation_ws, as it does for
+ continuation lines that it creates itself.
+
+- Issue #1777412, #10827: Changed the rules for 2-digit years. The
+ time.asctime(), time.ctime() and time.strftime() functions will now format
+ any year when ``time.accept2dyear`` is False and will accept years >= 1000
+ otherwise. ``time.mktime`` and ``time.strftime`` now accept full range
+ supported by the OS. With Visual Studio or on Solaris, the year is limited to
+ the range [1; 9999]. Conversion of 2-digit years to 4-digit is deprecated.
+
+- Issue #7858: Raise an error properly when os.utime() fails under Windows
+ on an existing file.
+
+- Issue #3839: wsgiref should not override a Content-Length header set by
+ the application. Initial patch by Clovis Fabricio.
+
+- Issue #10492: bdb.Bdb.run() only traces the execution of the code, not the
+ compilation (if the input is a string).
+
+- Issue #7995: When calling accept() on a socket with a timeout, the returned
+ socket is now always blocking, regardless of the operating system.
+
+- Issue #10756: atexit normalizes the exception before displaying it. Patch by
+ Andreas Stührk.
+
+- Issue #10790: email.header.Header.append's charset logic now works correctly
+ for charsets whose output codec is different from its input codec.
+
+- Issue #10819: SocketIO.name property returns -1 when its closed, instead of
+ raising a ValueError, to fix repr().
+
+- Issue #8650: zlib.compress() and zlib.decompress() raise an OverflowError if
+ the input buffer length doesn't fit into an unsigned int (length bigger than
+ 2^32-1 bytes).
+
+- Issue #6643: Reinitialize locks held within the threading module after fork to
+ avoid a potential rare deadlock or crash on some platforms.
+
+- Issue #10806, issue #9905: Fix subprocess pipes when some of the standard file
+ descriptors (0, 1, 2) are closed in the parent process. Initial patch by Ross
+ Lagerwall.
+
+- `unittest.TestCase` can be instantiated without a method name; for simpler
+ exploration from the interactive interpreter.
+
+- Issue #10798: Reject supporting concurrent.futures if the system has too
+ few POSIX semaphores.
+
+- Issue #10807: Remove base64, bz2, hex, quopri, rot13, uu and zlib codecs from
+ the codec aliases. They are still accessible via codecs.lookup().
+
+- Issue #10801: In zipfile, support different encodings for the header and the
+ filenames.
+
+- Issue #6285: IDLE no longer crashes on missing help file; patch by Scott
+ David Daniels.
+
+- Fix collections.OrderedDict.setdefault() so that it works in subclasses that
+ define __missing__().
+
+- Issue #10786: unittest.TextTestRunner default stream no longer bound at import
+ time. `sys.stderr` now looked up at instantiation time. Fix contributed by
+ Mark Roddy.
+
+- Issue #10753: Characters ';', '=' and ',' in the PATH_INFO environment variable
+ won't be quoted when the URI is constructed by the wsgiref.util's request_uri
+ method. According to RFC 3986, these characters can be a part of params in
+ PATH component of URI and need not be quoted.
+
+- Issue #10738: Fix webbrowser.Opera.raise_opts.
+
+- Issue #9824: SimpleCookie now encodes , and ; in values to cater to how
+ browsers actually parse cookies.
+
+- Issue #9333: os.symlink now available regardless of user privileges. The
+ function now raises OSError on Windows >=6.0 when the user is unable to create
+ symbolic links. XP and 2003 still raise NotImplementedError.
+
+- Issue #10783: struct.pack() no longer implicitly encodes unicode to UTF-8.
+
+- Issue #10730: Add SVG mime types to mimetypes module.
+
+- Issue #10768: Make the Tkinter ScrolledText widget work again.
+
+- Issue #10777: Fix "dictionary changed size during iteration" bug in
+ ElementTree register_namespace().
+
+- Issue #10626: test_logging now preserves logger disabled states.
+
+- Issue #10774: test_logging now removes temp files created during tests.
+
+- Issue #5258/#10642: if site.py encounters a .pth file that generates an error,
+ it now prints the filename, line number, and traceback to stderr and skips
+ the rest of that individual file, instead of stopping processing entirely.
+
+- Issue #10763: subprocess.communicate() closes stdout and stderr if both are
+ pipes (bug specific to Windows).
+
+- Issue #1693546: fix email.message RFC 2231 parameter encoding to be in better
+ compliance (no "s around encoded values).
+
+- Improved the diff message in the unittest module's assertCountEqual().
+
+- Issue #1155362: email.utils.parsedate_tz now handles a missing space before
+ the '-' of a timezone field as well as before a '+'.
+
+- Issue #4871: The zipfile module now gives a more useful error message if
+ an attempt is made to use a string to specify the archive password.
+
+- Issue #10750: The ``raw`` attribute of buffered IO objects is now read-only.
+
+- Deprecated assertDictContainsSubset() in the unittest module.
+
+C-API
+-----
+
+- PyObject_CallMethod now passes along any underlying AttributeError from
+ PyObject_GetAttr, instead of replacing it with something less informative
+
+- Issue #10913: Deprecate misleading functions PyEval_AcquireLock() and
+ PyEval_ReleaseLock(). The thread-state aware APIs should be used instead.
+
+- Issue #10333: Remove ancient GC API, which has been deprecated since Python
+ 2.2.
+
+Build
+-----
+
+- Issue #10843: Update third-party library versions used in OS X 32-bit
+ installer builds: bzip2 1.0.6, readline 6.1.2, SQLite 3.7.4 (with FTS3/FTS4
+ and RTREE enabled), and ncursesw 5.5 (wide-char support enabled).
+
+- Issue #10820: Fix OS X framework installs to support version-specific
+ scripts (#10679).
+
+- Issue #7716: Under Solaris, don't assume existence of /usr/xpg4/bin/grep in
+ the configure script but use $GREP instead. Patch by Fabian Groffen.
+
+- Issue #10475: Don't hardcode compilers for LDSHARED/LDCXXSHARED on NetBSD
+ and DragonFly BSD. Patch by Nicolas Joly.
+
+- Issue #10679: The "idle", "pydoc" and "2to3" scripts are now installed with
+ a version-specific suffix on "make altinstall".
+
+- Issue #10655: Fix the build on PowerPC on Linux with GCC when building with
+ timestamp profiling (--with-tsc): the preprocessor test for the PowerPC
+ support now looks for "__powerpc__" as well as "__ppc__": the latter seems to
+ only be present on OS X; the former is the correct one for Linux with GCC.
+
+- Issue #1099: Fix the build on MacOSX when building a framework with pydebug
+ using GCC 4.0.
+
+Tools/Demos
+-----------
+
+- Issue #10843: Install the Tools directory on OS X in the applications Extras
+ (/Applications/Python 3.n/Extras/) where the Demo directory had previous been
+ installed.
+
+- Issue #7962: The Demo directory is gone. Most of the old and unmaintained
+ demos have been removed, others integrated in documentation or a new
+ Tools/demo subdirectory.
+
+- Issue #10502: Addition of the unittestgui tool. Originally by Steve Purcell.
+ Updated for test discovery by Mark Roddy and Python 3 compatibility by Brian
+ Curtin.
+
+Tests
+-----
+
+- Issue #11910: Fix test_heapq to skip the C tests when _heapq is missing.
+
+- Fix test_startfile to wait for child process to terminate before finishing.
+
+- Issue #10822: Fix test_posix:test_getgroups failure under Solaris. Patch
+ by Ross Lagerwall.
+
+- Make the --coverage flag work for test.regrtest.
+
+- Issue #1677694: Refactor and improve test_timeout. Original patch by
+ Björn Lindqvist.
+
+- Issue #5485: Add tests for the UseForeignDTD method of expat parser objects.
+ Patch by Jean-Paul Calderone and Sandro Tosi.
+
+- Issue #6293: Have regrtest.py echo back sys.flags. This is done by default in
+ whole runs and enabled selectively using ``--header`` when running an explicit
+ list of tests. Original patch by Collin Winter.
+
+
+What's New in Python 3.2 Beta 2?
+================================
+
+*Release date: 19-Dec-2010*
+
+Core and Builtins
+-----------------
+
+- Issue #8844: Regular and recursive lock acquisitions can now be interrupted
+ by signals on platforms using pthreads. Patch by Reid Kleckner.
+
+- Issue #4236: PyModule_Create2 now checks the import machinery directly
+ rather than the Py_IsInitialized flag, avoiding a Fatal Python
+ error in certain circumstances when an import is done in __del__.
+
+- Issue #5587: add a repr to dict_proxy objects. Patch by David Stanek and
+ Daniel Urban.
+
+Library
+-------
+
+- Issue #3243: Support iterable bodies in httplib. Patch Contributions by
+ Xuanji Li and Chris AtLee.
+
+- Issue #10611: SystemExit exception will no longer kill a unittest run.
+
+- Issue #9857: It is now possible to skip a test in a setUp, tearDown or clean
+ up function.
+
+- Issue #10573: use actual/expected consistently in unittest methods.
+ The order of the args of assertCountEqual is also changed.
+
+- Issue #9286: email.utils.parseaddr no longer concatenates blank-separated
+ words in the local part of email addresses, thereby preserving the input.
+
+- Issue #6791: Limit header line length (to 65535 bytes) in http.client
+ and http.server, to avoid denial of services from the other party.
+
+- Issue #10404: Use ctl-button-1 on OSX for the context menu in Idle.
+
+- Issue #9907: Fix tab handling on OSX when using editline by calling
+ rl_initialize first, then setting our custom defaults, then reading .editrc.
+
+- Issue #4188: Avoid creating dummy thread objects when logging operations
+ from the threading module (with the internal verbose flag activated).
+
+- Issue #10711: Remove HTTP 0.9 support from http.client. The ``strict``
+ parameter to HTTPConnection and friends is deprecated.
+
+- Issue #9721: Fix the behavior of urljoin when the relative url starts with a
+ ';' character. Patch by Wes Chow.
+
+- Issue #10714: Limit length of incoming request in http.server to 65536 bytes
+ for security reasons. Initial patch by Ross Lagerwall.
+
+- Issue #9558: Fix distutils.command.build_ext with VS 8.0.
+
+- Issue #10667: Fast path for collections.Counter().
+
+- Issue #10695: passing the port as a string value to telnetlib no longer
+ causes debug mode to fail.
+
+- Issue #1078919: add_header now automatically RFC2231 encodes parameters
+ that contain non-ascii values.
+
+- Issue #10188 (partial resolution): tempfile.TemporaryDirectory emits
+ a warning on sys.stderr rather than throwing a misleading exception
+ if cleanup fails due to nulling out of modules during shutdown.
+ Also avoids an AttributeError when mkdtemp call fails and issues
+ a ResourceWarning on implicit cleanup via __del__.
+
+- Issue #10107: Warn about unsaved files in IDLE on OSX.
+
+- Issue #7213: subprocess.Popen's default for close_fds has been changed.
+ It is now True in most cases other than on Windows when input, output or
+ error handles are provided.
+
+- Issue #6559: subprocess.Popen has a new pass_fds parameter (actually
+ added in 3.2beta1) to allow specifying a specific list of file descriptors
+ to keep open in the child process.
+
+- Issue #1731717: Fixed the problem where subprocess.wait() could cause an
+ OSError exception when The OS had been told to ignore SIGCLD in our process
+ or otherwise not wait for exiting child processes.
+
+Tests
+-----
+
+- Issue #775964: test_grp now skips YP/NIS entries instead of failing when
+ encountering them.
+
+Tools/Demos
+-----------
+
+- Issue #6075: IDLE on Mac OS X now works with both Carbon AquaTk and
+ Cocoa AquaTk.
+
+- Issue #10710: ``Misc/setuid-prog.c`` is removed from the source tree.
+
+- Issue #10706: Remove outdated script runtests.sh. Either ``make test``
+ or ``python -m test`` should be used instead.
+
+Build
+-----
+
+- The Windows build now uses Tcl/Tk 8.5.9 and sqlite3 3.7.4.
+
+- Issue #9234: argparse supports alias names for subparsers.
+
+
+What's New in Python 3.2 Beta 1?
+================================
+
+*Release date: 05-Dec-2010*
+
+Core and Builtins
+-----------------
+
+- Issue #10630: Return dict views from the dict proxy keys()/values()/items()
+ methods.
+
+- Issue #10596: Fix float.__mod__ to have the same behaviour as float.__divmod__
+ with respect to signed zeros. -4.0 % 4.0 should be 0.0, not -0.0.
+
+- Issue #1772833: Add the -q command-line option to suppress copyright and
+ version output in interactive mode.
+
+- Provide an *optimize* parameter in the built-in compile() function.
+
+- Fixed several corner case issues on Windows in os.stat/os.lstat related to
+ reparse points.
+
+- PEP 384 (Defining a Stable ABI) is implemented.
+
+- Issue #2690: Range objects support negative indices and slicing.
+
+- Issue #9915: Speed up sorting with a key.
+
+- Issue #8685: Speed up set difference ``a - b`` when source set ``a`` is much
+ larger than operand ``b``. Patch by Andrew Bennetts.
+
+- Issue #10518: Bring back the callable() builtin.
+
+- Issue #7094: Added alternate formatting (specified by '#') to ``__format__``
+ method of float, complex, and Decimal. This allows more precise control over
+ when decimal points are displayed.
+
+- Issue #10474: range.count() should return integers.
+
+- Issue #1574217: isinstance now catches only AttributeError, rather than
+ masking all errors.
+
+Library
+-------
+
+- logging: added "handler of last resort". See http://bit.ly/last-resort-handler
+
+- test.support: Added TestHandler and Matcher classes for better support of
+ assertions about logging.
+
+- Issue #4391: Use proper plural forms in argparse.
+
+- Issue #10601: sys.displayhook uses 'backslashreplace' error handler on
+ UnicodeEncodeError.
+
+- Add the "display" and "undisplay" pdb commands.
+
+- Issue #7245: Add a SIGINT handler in pdb that allows to break a program again
+ after a "continue" command.
+
+- Add the "interact" pdb command.
+
+- Issue #7905: Actually respect the keyencoding parameter to shelve.Shelf.
+
+- Issue #1569291: Speed up array.repeat().
+
+- Provide an interface to set the optimization level of compilation in
+ py_compile, compileall and zipfile.PyZipFile.
+
+- Issue #7904: Changes to urllib.parse.urlsplit to handle schemes as defined by
+ RFC3986. Anything before :// is considered a scheme and is followed by an
+ authority (or netloc) and by '/' led path, which is optional.
+
+- Issue #6045: dbm.gnu databases now support get() and setdefault() methods.
+
+- Issue #10620: `python -m unittest` can accept file paths instead of module
+ names for running specific tests.
+
+- Issue #9424: Deprecate the `unittest.TestCase` methods `assertEquals`,
+ `assertNotEquals`, `assertAlmostEquals`, `assertNotAlmostEquals` and `assert_`
+ and replace them with the correct methods in the Python test suite.
+
+- Issue #10272: The ssl module now raises socket.timeout instead of a generic
+ SSLError on socket timeouts.
+
+- Issue #10528: Allow translators to reorder placeholders in localizable
+ messages from argparse.
+
+- Issue #10497: Fix incorrect use of gettext in argparse.
+
+- Issue #10478: Reentrant calls inside buffered IO objects (for example by
+ way of a signal handler) now raise a RuntimeError instead of freezing the
+ current process.
+
+- logging: Added getLogRecordFactory/setLogRecordFactory with docs and tests.
+
+- Issue #10549: Fix pydoc traceback when text-documenting certain classes.
+
+- Issue #2001: New HTML server with enhanced Web page features. Patch by Ron
+ Adam.
+
+- Issue #10360: In WeakSet, do not raise TypeErrors when testing for membership
+ of non-weakrefable objects.
+
+- Issue #940286: pydoc.Helper.help() ignores input/output init parameters.
+
+- Issue #1745035: Add a command size and data size limit to smtpd.py, to prevent
+ DoS attacks. Patch by Savio Sena.
+
+- Issue #4925: Add filename to error message when executable can't be found in
+ subprocess.
+
+- Issue #10391: Don't dereference invalid memory in error messages in the ast
+ module.
+
+- Issue #10027: st_nlink was not being set on Windows calls to os.stat or
+ os.lstat. Patch by Hirokazu Yamamoto.
+
+- Issue #9333: Expose os.symlink only when the SeCreateSymbolicLinkPrivilege is
+ held by the user's account, i.e., when the function can actually be used.
+
+- Issue #8879: Add os.link support for Windows.
+
+- Issue #7911: ``unittest.TestCase.longMessage`` defaults to True for improved
+ failure messages by default. Patch by Mark Roddy.
+
+- Issue #1486713: HTMLParser now has an optional tolerant mode where it tries to
+ guess at the correct parsing of invalid html.
+
+- Issue #10554: Add context manager support to subprocess.Popen objects.
+
+- Issue #8989: email.utils.make_msgid now has a domain parameter that can
+ override the domain name used in the generated msgid.
+
+- Issue #9299: Add exist_ok parameter to os.makedirs to suppress the 'File
+ exists' exception when a target directory already exists with the specified
+ mode. Patch by Ray Allen.
+
+- Issue #9573: os.fork() now works correctly when triggered as a side effect of
+ a module import.
+
+- Issue #10464: netrc now correctly handles lines with embedded '#' characters.
+
+- Added itertools.accumulate().
+
+- Issue #4113: Added custom ``__repr__`` method to ``functools.partial``.
+ Original patch by Daniel Urban.
+
+- Issue #10273: Rename `assertRegexpMatches` and `assertRaisesRegexp` to
+ `assertRegex` and `assertRaisesRegex`.
+
+- Issue #10535: Enable silenced warnings in unittest by default.
+
+- Issue #9873: The URL parsing functions in urllib.parse now accept ASCII byte
+ sequences as input in addition to character strings.
+
+- Issue #10586: The statistics API for the new functools.lru_cache has been
+ changed to a single cache_info() method returning a named tuple.
+
+- Issue #10323: itertools.islice() now consumes the minimum number of inputs
+ before stopping. Formerly, the final state of the underlying iterator was
+ undefined.
+
+- Issue #10565: The collections.Iterator ABC now checks for both __iter__ and
+ __next__.
+
+- Issue #10242: Fixed implementation of unittest.ItemsEqual and gave it a new
+ more informative name, unittest.CountEqual.
+
+- Issue #10561: In pdb, clear the breakpoints by the breakpoint number.
+
+- Issue #2986: difflib.SequenceMatcher gets a new parameter, autojunk, which can
+ be set to False to turn off the previously undocumented 'popularity'
+ heuristic. Patch by Terry Reedy and Eli Bendersky.
+
+- Issue #10534: in difflib, expose bjunk and bpopular sets; deprecate
+ undocumented and now redundant isbjunk and isbpopular methods.
+
+- Issue #9846: zipfile is now correctly closing underlying file objects.
+
+- Issue #10459: Update CJK character names to Unicode 6.0.
+
+- Issue #4493: urllib.request adds '/' in front of path components which does not
+ start with '/. Common behavior exhibited by browsers and other clients.
+
+- Issue #6378: idle.bat now runs with the appropriate Python version rather than
+ the system default. Patch by Sridhar Ratnakumar.
+
+- Issue #10470: 'python -m unittest' will now run test discovery by default,
+ when no extra arguments have been provided.
+
+- Issue #3709: BaseHTTPRequestHandler will buffer the headers and write to
+ output stream only when end_headers is invoked. This is a speedup and an
+ internal optimization. Patch by Andrew Shaaf.
+
+- Issue #10220: Added inspect.getgeneratorstate. Initial patch by Rodolpho
+ Eckhardt.
+
+- Issue #10453: compileall now uses argparse instead of getopt, and thus
+ provides clean output when called with '-h'.
+
+- Issue #8078: Add constants for higher baud rates in the termios module. Patch
+ by Rodolpho Eckhardt.
+
+- Issue #10407: Fix two NameErrors in distutils.
+
+- Issue #10371: Deprecated undocumented functions in the trace module.
+
+- Issue #10467: Fix BytesIO.readinto() after seeking into a position after the
+ end of the file.
+
+- configparser: 100% test coverage.
+
+- Issue #10499: configparser supports pluggable interpolation handlers. The
+ default classic interpolation handler is called BasicInterpolation. Another
+ interpolation handler added (ExtendedInterpolation) which supports the syntax
+ used by zc.buildout (e.g. interpolation between sections).
+
+- configparser: the SafeConfigParser class has been renamed to ConfigParser.
+ The legacy ConfigParser class has been removed but its interpolation mechanism
+ is still available as LegacyInterpolation.
+
+- configparser: Usage of RawConfigParser is now discouraged for new projects
+ in favor of ConfigParser(interpolation=None).
+
+- Issue #1682942: configparser supports alternative option/value delimiters.
+
+- Issue #5412: configparser supports mapping protocol access.
+
+- Issue #9411: configparser supports specifying encoding for read operations.
+
+- Issue #9421: configparser's getint(), getfloat() and getboolean() methods
+ accept vars and default arguments just like get() does.
+
+- Issue #9452: configparser supports reading from strings and dictionaries
+ (thanks to the mapping protocol API, the latter can be used to copy data
+ between parsers).
+
+- configparser: accepted INI file structure is now customizable, including
+ comment prefixes, name of the DEFAULT section, empty lines in multiline
+ values, and indentation.
+
+- Issue #10326: unittest.TestCase instances can be pickled.
+
+- Issue #9926: Wrapped TestSuite subclass does not get __call__ executed.
+
+- Issue #9920: Skip tests for cmath.atan and cmath.atanh applied to complex
+ zeros on systems where the log1p function fails to respect the sign of zero.
+ This fixes a test failure on AIX.
+
+- Issue #9732: Addition of getattr_static to the inspect module.
+
+- Issue #10446: Module documentation generated by pydoc now links to a
+ version-specific online reference manual.
+
+- Make the 'No module named' exception message from importlib consistent.
+
+- Issue #10443: Add the SSLContext.set_default_verify_paths() method.
+
+- Issue #10440: Support RUSAGE_THREAD as a constant in the resource module.
+ Patch by Robert Collins.
+
+- Issue #10429: IMAP.starttls() stored the capabilities as bytes objects, rather
+ than strings.
+
+C-API
+-----
+
+- Issue #10557: Added a new API function, PyUnicode_TransformDecimalToASCII(),
+ which transforms non-ASCII decimal digits in a Unicode string to their ASCII
+ equivalents.
+
+- Issue #9518: Extend the PyModuleDef_HEAD_INIT macro to explicitly
+ zero-initialize all fields, fixing compiler warnings seen when building
+ extension modules with gcc with "-Wmissing-field-initializers" (implied by
+ "-W").
+
+- Issue #10255: Fix reference leak in Py_InitializeEx(). Patch by Neil
+ Schemenauer.
+
+- structseq.h is now included in Python.h.
+
+- Loosen PyArg_ValidateKeywordArguments to allow dict subclasses.
+
+Tests
+-----
+
+- regrtest.py once again ensures the test directory is removed from sys.path
+ when it is invoked directly as the __main__ module.
+
+- `python -m test` can be used to run the test suite as well as `python -m
+ test.regrtest`.
+
+- Do not fail test_socket when the IP address of the local hostname cannot be
+ looked up.
+
+- Issue #8886: Use context managers throughout test_zipfile. Patch by Eric
+ Carstensen.
+
+Build
+-----
+
+- Issue #10325: Fix two issues in the fallback definitions for PY_ULLONG_MAX and
+ PY_LLONG_MAX that made them unsuitable for use in preprocessor conditionals.
+
+Documentation
+-------------
+
+- Issue #10299: List the built-in functions in a table in functions.rst.
+
+
+What's New in Python 3.2 Alpha 4?
+=================================
+
+*Release date: 13-Nov-2010*
+
+Core and Builtins
+-----------------
+
+- Issue #10372: Import the warnings module only after the IO library is
+ initialized, so as to avoid bootstrap issues with the '-W' option.
+
+- Issue #10293: Remove obsolete field in the PyMemoryView structure, unused
+ undocumented value PyBUF_SHADOW, and strangely-looking code in
+ PyMemoryView_GetContiguous.
+
+- Issue #6081: Add str.format_map(), similar to ``str.format(**mapping)``.
+
+- If FileIO.__init__ fails, close the file descriptor.
+
+- Issue #10221: dict.pop(k) now has a key error message that includes the
+ missing key (same message d[k] returns for missing keys).
+
+- Issue #5437: A preallocated MemoryError instance should not keep traceback
+ data (including local variables caught in the stack trace) alive infinitely.
+
+- Issue #10186: Fix the SyntaxError caret when the offset is equal to the length
+ of the offending line.
+
+- Issue #10089: Add support for arbitrary -X options on the command line. They
+ can be retrieved through a new attribute ``sys._xoptions``.
+
+- Issue #4388: On Mac OS X, decode command line arguments from UTF-8, instead of
+ the locale encoding. If the LANG (and LC_ALL and LC_CTYPE) environment
+ variable is not set, the locale encoding is ISO-8859-1, whereas most programs
+ (including Python) expect UTF-8. Python already uses UTF-8 for the filesystem
+ encoding and to encode command line arguments on this OS.
+
+- Issue #9713, #10114: Parser functions (e.g. PyParser_ASTFromFile) expect
+ filenames encoded to the filesystem encoding with the surrogateescape error
+ handler (to support undecodable bytes), instead of UTF-8 in strict mode.
+
+- Issue #9997: Don't let the name "top" have special significance in scope
+ resolution.
+
+- Issue #9862: Compensate for broken PIPE_BUF in AIX by hard coding its value as
+ the default 512 when compiling on AIX.
+
+- Use locale encoding instead of UTF-8 to encode and decode filenames if
+ Py_FileSystemDefaultEncoding is not set.
+
+- Issue #10095: fp_setreadl() doesn't reopen the file, instead reuse the file
+ descriptor.
+
+- Issue #9418: Moved private string methods ``_formatter_parser`` and
+ ``_formatter_field_name_split`` into a new ``_string`` module.
+
+- Issue #9992: Remove PYTHONFSENCODING environment variable.
+
+Library
+-------
+
+- Issue #12943: python -m tokenize support has been added to tokenize.
+
+- Issue #10465: fix broken delegating of attributes by gzip._PaddedFile.
+
+- Issue #10356: Decimal.__hash__(-1) should return -2.
+
+- Issue #1553375: logging: Added stack_info kwarg to display stack information.
+
+- Issue #5111: IPv6 Host in the Header is wrapped inside [ ]. Patch by Chandru.
+
+- Fix Fraction.__hash__ so that Fraction.__hash__(-1) is -2. (See also issue
+ #10356.)
+
+- Issue #4471: Add the IMAP.starttls() method to enable encryption on standard
+ IMAP4 connections. Original patch by Lorenzo M. Catucci.
+
+- Issue #1466065: Add 'validate' option to base64.b64decode to raise an error if
+ there are non-base64 alphabet characters in the input.
+
+- Issue #10386: Add __all__ to token module; this simplifies importing in
+ tokenize module and prevents leaking of private names through ``import *``.
+
+- Issue #4471: Properly shutdown socket in IMAP.shutdown(). Patch by Lorenzo
+ M. Catucci.
+
+- Fix IMAP.login() to work properly.
+
+- Issue #9244: multiprocessing pool worker processes could terminate
+ unexpectedly if the return value of a task could not be pickled. Only the
+ ``repr`` of such errors are now sent back, wrapped in an
+ ``MaybeEncodingError`` exception.
+
+- Issue #9244: The ``apply_async()`` and ``map_async()`` methods of
+ ``multiprocessing.Pool`` now accepts a ``error_callback`` argument. This can
+ be a callback with the signature ``callback(exc)``, which will be called if
+ the target raises an exception.
+
+- Issue #10022: The dictionary returned by the ``getpeercert()`` method of SSL
+ sockets now has additional items such as ``issuer`` and ``notBefore``.
+
+- ``usenetrc`` is now false by default for NNTP objects.
+
+- Issue #1926: Add support for NNTP over SSL on port 563, as well as STARTTLS.
+ Patch by Andrew Vant.
+
+- Issue #10335: Add tokenize.open(), detect the file encoding using
+ tokenize.detect_encoding() and open it in read only mode.
+
+- Issue #10321: Add support for binary data to smtplib.SMTP.sendmail, and a new
+ method send_message to send an email.message.Message object.
+
+- Issue #6011: sysconfig and distutils.sysconfig use the surrogateescape error
+ handler to parse the Makefile file. Avoid a UnicodeDecodeError if the source
+ code directory name contains a non-ASCII character and the locale encoding is
+ ASCII.
+
+- Issue #10329: The trace module writes reports using the input Python script
+ encoding, instead of the locale encoding. Patch written by Alexander
+ Belopolsky.
+
+- Issue #10126: Fix distutils' test_build when Python was built with
+ --enable-shared.
+
+- Issue #9281: Prevent race condition with mkdir in distutils. Patch by
+ Arfrever.
+
+- Issue #10229: Fix caching error in gettext.
+
+- Issue #10252: Close file objects in a timely manner in distutils code and
+ tests. Patch by Brian Brazil, completed by Éric Araujo.
+
+- Issue #10180: Pickling file objects is now explicitly forbidden, since
+ unpickling them produced nonsensical results.
+
+- Issue #10311: The signal module now restores errno before returning from its
+ low-level signal handler. Patch by Hallvard B Furuseth.
+
+- Issue #10282: Add a ``nntp_implementation`` attribute to NNTP objects.
+
+- Issue #10283: Add a ``group_pattern`` argument to NNTP.list().
+
+- Issue #10155: Add IISCGIHandler to wsgiref.handlers to support IIS CGI
+ environment better, and to correct unicode environment values for WSGI 1.0.1.
+
+- Issue #10281: nntplib now returns None for absent fields in the OVER/XOVER
+ response, instead of raising an exception.
+
+- wsgiref now implements and validates PEP 3333, rather than an experimental
+ extension of PEP 333. (Note: earlier versions of Python 3.x may have
+ incorrectly validated some non-compliant applications as WSGI compliant; if
+ your app validates with Python <3.2b1+, but not on this version, it is likely
+ the case that your app was not compliant.)
+
+- Issue #10280: NNTP.nntp_version should reflect the highest version advertised
+ by the server.
+
+- Issue #10184: Touch directories only once when extracting a tarfile.
+
+- Issue #10199: New package, ``turtledemo`` now contains selected demo scripts
+ that were formerly found under Demo/turtle.
+
+- Issue #10265: Close file objects explicitly in sunau. Patch by Brian Brazil.
+
+- Issue #10266: uu.decode didn't close in_file explicitly when it was given as a
+ filename. Patch by Brian Brazil.
+
+- Issue #10110: Queue objects didn't recognize full queues when the maxsize
+ parameter had been reduced.
+
+- Issue #10160: Speed up operator.attrgetter. Patch by Christos Georgiou.
+
+- logging: Added style option to basicConfig() to allow %, {} or $-formatting.
+
+- Issue #5729: json.dumps() now supports using a string such as '\t' for
+ pretty-printing multilevel objects.
+
+- Issue #10253: FileIO leaks a file descriptor when trying to open a file for
+ append that isn't seekable. Patch by Brian Brazil.
+
+- Support context manager protocol for file-like objects returned by mailbox
+ ``get_file()`` methods.
+
+- Issue #10246: uu.encode didn't close file objects explicitly when filenames
+ were given to it. Patch by Brian Brazil.
+
+- Issue #10198: fix duplicate header written to wave files when writeframes() is
+ called without data.
+
+- Close file objects in modulefinder in a timely manner.
+
+- Close a io.TextIOWrapper object in email.parser in a timely manner.
+
+- Close a file object in distutils.sysconfig in a timely manner.
+
+- Close a file object in pkgutil in a timely manner.
+
+- Issue #10233: Close file objects in a timely manner in the tarfile module and
+ its test suite.
+
+- Issue #10093: ResourceWarnings are now issued when files and sockets are
+ deallocated without explicit closing. These warnings are silenced by default,
+ except in pydebug mode.
+
+- tarfile.py: Add support for all missing variants of the GNU sparse extensions
+ and create files with holes when extracting sparse members.
+
+- Issue #10218: Return timeout status from ``Condition.wait`` in threading.
+
+- Issue #7351: Add ``zipfile.BadZipFile`` spelling of the exception name and
+ deprecate the old name ``zipfile.BadZipfile``.
+
+- Issue #5027: The standard ``xml`` namespace is now understood by
+ xml.sax.saxutils.XMLGenerator as being bound to
+ http://www.w3.org/XML/1998/namespace. Patch by Troy J. Farrell.
+
+- Issue #5975: Add csv.unix_dialect class.
+
+- Issue #7761: telnetlib.interact failures on Windows fixed.
+
+- logging: Added style option to Formatter to allow %, {} or $-formatting.
+
+- Issue #5178: Added tempfile.TemporaryDirectory class that can be used as a
+ context manager.
+
+- Issue #1349106: Generator (and BytesGenerator) flatten method and Header
+ encode method now support a 'linesep' argument.
+
+- Issue #5639: Add a *server_hostname* argument to ``SSLContext.wrap_socket`` in
+ order to support the TLS SNI extension. ``HTTPSConnection`` and ``urlopen()``
+ also use this argument, so that HTTPS virtual hosts are now supported.
+
+- Issue #10166: Avoid recursion in pstats Stats.add() for many stats items.
+
+- Issue #10163: Skip unreadable registry keys during mimetypes initialization.
+
+- logging: Made StreamHandler terminator configurable.
+
+- logging: Allowed filters to be just callables.
+
+- logging: Added tests for _logRecordClass changes.
+
+- Issue #10092: Properly reset locale in calendar.Locale*Calendar classes.
+
+- logging: Added _logRecordClass, getLogRecordClass, setLogRecordClass to
+ increase flexibility of LogRecord creation.
+
+- Issue #5117: Case normalization was needed on ntpath.relpath(). Also fixed
+ root directory issue on posixpath.relpath(). (Ported working fixes from
+ ntpath.)
+
+- Issue #1343: xml.sax.saxutils.XMLGenerator now has an option
+ short_empty_elements to direct it to use self-closing tags when appropriate.
+
+- Issue #9807 (part 1): Expose the ABI flags in sys.abiflags. Add --abiflags
+ switch to python-config for command line access.
+
+- Issue #6098: Don't claim DOM level 3 conformance in minidom.
+
+- Issue #5762: Fix AttributeError raised by ``xml.dom.minidom`` when an empty
+ XML namespace attribute is encountered.
+
+- Issue #2830: Add the ``html.escape()`` function, which quotes all problematic
+ characters by default. Deprecate ``cgi.escape()``.
+
+- Issue #9409: Fix the regex to match all kind of filenames, for interactive
+ debugging in doctests.
+
+- Issue #9183: ``datetime.timezone(datetime.timedelta(0))`` will now return the
+ same instance as ``datetime.timezone.utc``.
+
+- Issue #7523: Add SOCK_CLOEXEC and SOCK_NONBLOCK to the socket module, where
+ supported by the system. Patch by Nikita Vetoshkin.
+
+- Issue #10063: file:// scheme will stop accessing remote hosts via ftp
+ protocol. file:// urls had fallback to access remote hosts via ftp. This was
+ not correct, change is made to raise a URLError when a remote host is tried to
+ access via file:// scheme.
+
+- Issue #1710703: Write structures for an empty ZIP archive when a ZipFile is
+ created in modes 'a' or 'w' and then closed without adding any files. Raise
+ BadZipfile (rather than IOError) when opening small non-ZIP files.
+
+- Issue #10041: The signature of optional arguments in socket.makefile() didn't
+ match that of io.open(), and they also didn't get forwarded properly to
+ TextIOWrapper in text mode. Patch by Kai Zhu.
+
+- Issue #9003: http.client.HTTPSConnection, urllib.request.HTTPSHandler and
+ urllib.request.urlopen now take optional arguments to allow for server
+ certificate checking, as recommended in public uses of HTTPS.
+
+- Issue #6612: Fix site and sysconfig to catch os.getcwd() error, eg. if the
+ current directory was deleted. Patch written by W. Trevor King.
+
+- Issue #3873: Speed up unpickling from file objects that have a peek() method.
+
+- Issue #10075: Add a session_stats() method to SSLContext objects.
+
+- Issue #9948: Fixed problem of losing filename case information.
+
+Extension Modules
+-----------------
+
+- Issue #5109: array.array constructor will now use fast code when
+ initial data is provided in an array object with correct type.
+
+- Issue #6317: Now winsound.PlaySound only accepts unicode.
+
+- Issue #6317: Now winsound.PlaySound can accept non ascii filename.
+
+- Issue #9377: Use Unicode API for gethostname on Windows.
+
+- Issue #10143: Update "os.pathconf" values.
+
+- Issue #6518: Support context manager protcol for ossaudiodev types.
+
+- Issue #678250: Make mmap flush a noop on ACCESS_READ and ACCESS_COPY.
+
+- Issue #9054: Fix a crash occurring when using the pyexpat module with expat
+ version 2.0.1.
+
+- Issue #5355: Provide mappings from Expat error numbers to string descriptions
+ and backwards, in order to actually make it possible to analyze error codes
+ provided by ExpatError.
+
+- The Unicode database was updated to 6.0.0.
+
+C-API
+-----
+
+- Issue #10288: The deprecated family of "char"-handling macros
+ (ISLOWER()/ISUPPER()/etc) have now been removed: use Py_ISLOWER() etc instead.
+
+- Issue #9778: Hash values are now always the size of pointers. A new Py_hash_t
+ type has been introduced.
+
+Tools/Demos
+-----------
+
+- Issue #10117: Tools/scripts/reindent.py now accepts source files that use
+ encoding other than ASCII or UTF-8. Source encoding is preserved when
+ reindented code is written to a file.
+
+- Issue #7287: Demo/imputil/knee.py was removed.
+
+Tests
+-----
+
+- Issue #3699: Fix test_bigaddrspace and extend it to test bytestrings as well
+ as unicode strings. Initial patch by Sandro Tosi.
+
+- Issue #10294: Remove dead code form test_unicode_file.
+
+- Issue #10123: Don't use non-ascii filenames in test_doctest tests. Add a new
+ test specific to unicode (non-ascii name and filename).
+
+Build
+-----
+
+- Issue #10268: Add a --enable-loadable-sqlite-extensions option to configure.
+
+- Issue #8852: Allow the socket module to build on OpenSolaris.
+
+- Drop -OPT:Olimit compiler option.
+
+- Issue #10094: Use versioned .so files on GNU/kfreeBSD and the GNU Hurd.
+
+- Accept Oracle Berkeley DB 5.0 and 5.1 as backend for the dbm extension.
+
+- Issue #7473: avoid link errors when building a framework with a different set
+ of architectures than the one that is currently installed.
+
+
+What's New in Python 3.2 Alpha 3?
+=================================
+
+*Release date: 09-Oct-2010*
+
+Core and Builtins
+-----------------
+
+- Issue #10068: Global objects which have reference cycles with their module's
+ dict are now cleared again. This causes issue #7140 to appear again.
+
+- Issue #9738: Document PyErr_SetString() and PyErr_SetFromErrnoWithFilename()
+ encodings.
+
+- ast.literal_eval() can now handle negative numbers. It is also a little more
+ liberal in what it accepts without compromising the safety of the evaluation.
+ For example, 3j+4 and 3+4+5 are both accepted.
+
+- Issue #10006: type.__abstractmethods__ now raises an AttributeError. As a
+ result metaclasses can now be ABCs (see #9533).
+
+- Issue #8670: ctypes.c_wchar supports non-BMP characters with 32 bits wchar_t.
+
+- Issue #8670: PyUnicode_AsWideChar() and PyUnicode_AsWideCharString() replace
+ UTF-16 surrogate pairs by single non-BMP characters for 16 bits Py_UNICODE and
+ 32 bits wchar_t (eg. Linux in narrow build).
+
+- Issue #10003: Allow handling of SIGBREAK on Windows. Fixes a regression
+ introduced by issue #9324.
+
+- Issue #9979: Create function PyUnicode_AsWideCharString().
+
+- Issue #7397: Mention that importlib.import_module() is probably what someone
+ really wants to be using in __import__'s docstring.
+
+- Issue #8521: Allow CreateKeyEx, OpenKeyEx, and DeleteKeyEx functions of winreg
+ to use named arguments.
+
+- Issue #9930: Remove bogus subtype check that was causing (e.g.)
+ float.__rdiv__(2.0, 3) to return NotImplemented instead of the expected 1.5.
+
+- Issue #9808: Implement os.getlogin for Windows. Patch by Jon Anglin.
+
+- Issue #9901: Destroying the GIL in Py_Finalize() can fail if some other
+ threads are still running. Instead, reinitialize the GIL on a second call to
+ Py_Initialize().
+
+- All SyntaxErrors now have a column offset and therefore a caret when the error
+ is printed.
+
+- Issue #9252: PyImport_Import no longer uses a fromlist hack to return the
+ module that was imported, but instead gets the module from sys.modules.
+
+- Issue #9213: The range type_items now provides index() and count() methods, to
+ conform to the Sequence ABC. Patch by Daniel Urban and Daniel Stutzbach.
+
+- Issue #7994: Issue a PendingDeprecationWarning if object.__format__ is called
+ with a non-empty format string. This is an effort to future-proof user
+ code. If a derived class does not currently implement __format__ but later
+ adds its own __format__, it would most likely break user code that had
+ supplied a format string. This will be changed to a DeprecationWaring in
+ Python 3.3 and it will be an error in Python 3.4.
+
+- Issue #9828: Destroy the GIL in Py_Finalize(), so that it gets properly
+ re-created on a subsequent call to Py_Initialize(). The problem (a crash)
+ wouldn't appear in 3.1 or 2.7 where the GIL's structure is more trivial.
+
+- Issue #9210: Configure option --with-wctype-functions was removed. Using the
+ functions from the libc caused the methods .upper() and lower() to become
+ locale aware and created subtly wrong results.
+
+- Issue #9738: PyUnicode_FromFormat() and PyErr_Format() raise an error on a
+ non-ASCII byte in the format string.
+
+- Issue #4617: Previously it was illegal to delete a name from the local
+ namespace if it occurs as a free variable in a nested block. This limitation
+ of the compiler has been lifted, and a new opcode introduced (DELETE_DEREF).
+
+- Issue #9804: ascii() now always represents unicode surrogate pairs as a single
+ ``\UXXXXXXXX``, regardless of whether the character is printable or not.
+ Also, the "backslashreplace" error handler now joins surrogate pairs into a
+ single character on UCS-2 builds.
+
+- Issue #9757: memoryview objects get a release() method to release the
+ underlying buffer (previously this was only done when deallocating the
+ memoryview), and gain support for the context management protocol.
+
+- Issue #9797: pystate.c wrongly assumed that zero couldn't be a valid
+ thread-local storage key.
+
+Library
+-------
+
+- Issue #2236: distutils' mkpath ignored the mode parameter.
+
+- Fix typo in one sdist option (medata-check).
+
+- Issue #9199: Fix incorrect use of distutils.cmd.Command.announce.
+
+- Issue #1718574: Fix options that were supposed to accept arguments but did
+ not in build_clib.
+
+- Issue #9437: Fix building C extensions with non-default LDFLAGS.
+
+- Issue #4661: email can now parse bytes input and generate either converted
+ 7bit output or bytes output. Email version bumped to 5.1.0.
+
+- Issue #1589: Add ssl.match_hostname(), to help implement server identity
+ verification for higher-level protocols.
+
+- Issue #9759: GzipFile now raises ValueError when an operation is attempted
+ after the file is closed. Patch by Jeffrey Finkelstein.
+
+- Issue #9042: Fix interaction of custom translation classes and caching in
+ gettext.
+
+- Issue #6706: asyncore.dispatcher now provides a handle_accepted() method
+ returning a (sock, addr) pair which is called when a connection has been
+ established with a new remote endpoint. This is supposed to be used as a
+ replacement for old handle_accept() and avoids the user to call accept()
+ directly.
+
+- Issue #9065: tarfile no longer uses "root" as the default for the uname and
+ gname field.
+
+- Issue #8980: Fixed a failure in distutils.command check that was shadowed by
+ an environment that does not have docutils. Patch by Arfrever.
+
+- Issue #1050268: parseaddr now correctly quotes double quote and backslash
+ characters that appear inside quoted strings in email addresses.
+
+- Issue #10004: quoprimime no longer generates a traceback when confronted with
+ invalid characters after '=' in a Q-encoded word.
+
+- Issue #1491: BaseHTTPServer nows send a ``100 Continue`` response before
+ sending a 200 OK for the Expect: 100-continue request header.
+
+- Issue #9360: Cleanup and improvements to the nntplib module. The API now
+ conforms to the philosophy of bytes and unicode separation in Python 3. A
+ test suite has also been added.
+
+- Issue #9962: GzipFile now has the peek() method.
+
+- Issue #9090: When a socket with a timeout fails with EWOULDBLOCK or EAGAIN,
+ retry the select() loop instead of bailing out. This is because select() can
+ incorrectly report a socket as ready for reading (for example, if it received
+ some data with an invalid checksum).
+
+- Issue #3612: Added new types to ctypes.wintypes. (CHAR and pointers)
+
+- Issue #9950: Fix socket.sendall() crash or misbehaviour when a signal is
+ received. Now sendall() properly calls signal handlers if necessary, and
+ retries sending if these returned successfully, including on sockets with a
+ timeout.
+
+- Issue #9947: logging: Fixed locking bug in stopListening.
+
+- Issue #9945: logging: Fixed locking bugs in addHandler/removeHandler.
+
+- Issue #9936: Fixed executable lines' search in the trace module.
+
+- Issue #9790: Rework imports necessary for samefile and sameopenfile
+ in ntpath.
+
+- Issue #9928: Properly initialize the types exported by the bz2 module.
+
+- Issue #1675951: Allow GzipFile to work with unseekable file objects. Patch by
+ Florian Festi.
+
+- Logging: Added QueueListener class to facilitate logging usage for
+ performance-critical threads.
+
+- Issue #9916: Add some missing errno symbols.
+
+- Issue #9877: Expose sysconfig.get_makefile_filename()
+
+- logging: Added hasHandlers() method to Logger and LoggerAdapter.
+
+- Issue #9908: Fix os.stat() on bytes paths under Windows 7.
+
+- Issue #2643: msync() is not called anymore when deallocating an open mmap
+ object, only munmap().
+
+- logging: Changed LoggerAdapter implementation internally, to make it easier to
+ subclass in a useful way.
+
+- logging: hasHandlers method was added to Logger, and isEnabledFor,
+ getEffectiveLevel, hasHandlers and setLevel were added to LoggerAdapter.
+ LoggerAdapter was introduced into the unit tests for logging.
+
+- Issue #1686: Fix string.Template when overriding the pattern attribute.
+
+- Issue #9854: SocketIO objects now observe the RawIOBase interface in
+ non-blocking mode: they return None when an operation would block (instead of
+ raising an exception).
+
+- Issue #1730136: Fix the comparison between a tk.font.Font and an object of
+ another kind.
+
+- Issue #9441: logging has better coverage for rotating file handlers.
+
+- Issue #9865: collections.OrderedDict now has a __sizeof__ method.
+
+- Issue #9854: The default read() implementation in io.RawIOBase now handles
+ non-blocking readinto() returning None correctly.
+
+- Issue #1552: socket.socketpair() now returns regular socket.socket objects
+ supporting the whole socket API (rather than the "raw" _socket.socket
+ objects).
+
+- Issue #9853: Fix the signature of SSLSocket.recvfrom() and SSLSocket.sendto()
+ to match the corresponding socket methods.
+
+- Issue #9840: Added a decorator to reprlib for wrapping __repr__ methods to make
+ them handle recursive calls within the same thread.
+
+- logging: Enhanced HTTPHandler with secure and credentials initializers.
+
+- Issue #767645: Set os.path.supports_unicode_filenames to True on Mac OS X.
+
+- Issue #9837: The read() method of ZipExtFile objects (as returned by
+ ZipFile.open()) could return more bytes than requested.
+
+- Issue #9826: OrderedDict.__repr__ can now handle self-referential values:
+ d['x'] = d.
+
+- Issue #9825: Using __del__ in the definition of collections.OrderedDict made
+ it possible for the user to create self-referencing ordered dictionaries which
+ become permanently uncollectable GC garbage. Reinstated the Python 3.1
+ approach of using weakref proxies so that reference cycles never get created
+ in the first place.
+
+- Issue #9579, #9580: Fix os.confstr() for value longer than 255 bytes and
+ encode the value with filesystem encoding and surrogateescape (instead of
+ utf-8 in strict mode) . Patch written by David Watson.
+
+- Issue #9632: Remove sys.setfilesystemencoding() function: use PYTHONFSENCODING
+ environment variable to set the filesystem encoding at Python startup.
+ sys.setfilesystemencoding() creates inconsistencies because it is unable to
+ reencode all filenames in all objects.
+
+- Issue #9410: Various optimizations to the pickle module, leading to speedups
+ up to 4x (depending on the benchmark). Mostly ported from Unladen Swallow;
+ initial patch by Alexandre Vassalotti.
+
+- The pprint module now supports printing OrderedDicts in their given order
+ (formerly, it would sort the keys).
+
+- Logging: Added QueueHandler class to facilitate logging usage with
+ multiprocessing.
+
+- Issue #9707: Rewritten reference implementation of threading.local which is
+ friendlier towards reference cycles. This change is not normally visible
+ since an optimized C implementation (_thread._local) is used instead.
+
+- Issue #6394: os.getppid() is now supported on Windows. Note that it will
+ still return the id of the parent process after it has exited. This process
+ id may even have been reused by another unrelated process.
+
+- Issue #9792: In case of connection failure, socket.create_connection() would
+ swallow the exception and raise a new one, making it impossible to fetch the
+ original errno, or to filter timeout errors. Now the original error is
+ re-raised.
+
+- Issue #9758: When fcntl.ioctl() was called with mutable_flag set to True, and
+ the passed buffer was exactly 1024 bytes long, the buffer wouldn't be updated
+ back after the system call. Original patch by Brian Brazil.
+
+- Updates to the random module:
+
+ * Document which parts of the module are guaranteed to stay the same across
+ versions and which parts are subject to change.
+
+ * Update the seed() method to use all of the bits in a string instead of just
+ the hash value. This makes better use of the seed value and assures the
+ seeding is platform independent. Issue #7889.
+
+ * Improved the random()-->integer algorithm used in choice(), shuffle(),
+ sample(), randrange(), and randint(). Formerly, it used int(n*random())
+ which has a slight bias whenever n is not a power of two. Issue #9025.
+
+ * Improved documentation of arguments to randrange(). Issue #9379.
+
+- collections.OrderedDict now supports a new method for repositioning keys to
+ either end.
+
+- Issue #9754: Similarly to assertRaises and assertRaisesRegexp, unittest test
+ cases now also have assertWarns and assertWarnsRegexp methods to check that a
+ given warning type was triggered by the code under test.
+
+- Issue #5506: BytesIO objects now have a getbuffer() method exporting a view of
+ their contents without duplicating them. The view is both readable and
+ writable.
+
+- Issue #7566: Implement os.path.sameopenfile for Windows.
+
+- Issue #9293: I/O streams now raise ``io.UnsupportedOperation`` when an
+ unsupported operation is attempted (for example, writing to a file open only
+ for reading).
+
+- hashlib has two new constant attributes: algorithms_guaranteed and
+ algorithms_avaiable that respectively list the names of hash algorithms
+ guaranteed to exist in all Python implementations and the names of hash
+ algorithms available in the current process.
+
+- A new package ``concurrent.futures`` as defined by PEP 3148.
+
+C-API
+-----
+
+- Add PyErr_SyntaxLocationEx, which supports passing a column offset.
+
+- Issue #9834: Don't segfault in PySequence_GetSlice, PySequence_SetSlice, or
+ PySequence_DelSlice when the object doesn't have any mapping operations
+ defined.
+
+Tools/Demos
+-----------
+
+- Issue #9188: The gdb extension now handles correctly narrow (UCS2) as well as
+ wide (UCS4) unicode builds for both the host interpreter (embedded inside gdb)
+ and the interpreter under test.
+
+Tests
+-----
+
+- Issue #9308: Added tests for importing encoded modules that do not
+ depend on specific stdlib modules being encoded in a certain way.
+
+- Issue #1051: Add a script (Lib/test/make_ssl_certs.py) to generate the custom
+ certificate and private key files used by SSL-related certs.
+
+- Issue #9978: Wait until subprocess completes initialization. (Win32KillTests
+ in test_os)
+
+- Issue #7110: regrtest now sends test failure reports and single-failure
+ tracebacks to stderr rather than stdout.
+
+- Issue #9628: fix runtests.sh -x option so more than one test can be excluded.
+
+- Issue #9899: Fix test_tkinter.test_font on various platforms. Patch by Ned
+ Deily.
+
+- Issue #9894: Do not hardcode ENOENT in test_subprocess.
+
+- Issue #9315: Added tests for the trace module. Patch by Eli Bendersky.
+
+- Issue #9323: Make test.regrtest.__file__ absolute, this was not always the
+ case when running profile or trace, for example.
+
+- Issue #9568: Fix test_urllib2_localnet on OS X 10.3.
+
+Build
+-----
+
+- Issue #10062: Allow building on platforms which do not have sem_timedwait.
+
+- Issue #10054: Some platforms provide uintptr_t in inttypes.h. Patch by Akira
+ Kitada.
+
+- Issue #10055: Make json C89-compliant in UCS4 mode.
+
+- Issue #9552: Avoid unnecessary rebuild of OpenSSL. (Windows)
+
+- Issue #1633863: Don't ignore $CC under AIX.
+
+- Issue #9810: Compile bzip2 source files in Python's project file directly. It
+ used to be built with bzip2's makefile.
+
+- Issue #9848: Stopping trying to build _weakref in setup.py as it is a built-in
+ module.
+
+- Issue #9806: python-config now has an ``--extension-suffix`` option that
+ outputs the suffix for dynamic libraries including the ABI version name
+ defined by PEP 3149.
+
+- Issue #941346: Improve the build process under AIX and allow Python to be
+ built as a shared library. Patch by Sébastien Sablé.
+
+- Issue #4026: Make the fcntl extension build under AIX. Patch by Sébastien
+ Sablé.
+
+- Issue #9701: The MacOSX installer can patch the shell profile to ensure that
+ the "bin" directory inside the framework is on the shell's search path. This
+ feature now also supports the ZSH shell.
+
+
+What's New in Python 3.2 Alpha 2?
+=================================
+
+*Release date: 05-Sep-2010*
+
+Core and Builtins
+-----------------
+
+- Issue #9225: Remove the ROT_FOUR and DUP_TOPX opcode, the latter replaced by
+ the new (and simpler) DUP_TOP_TWO. Performance isn't changed, but our
+ bytecode is a bit simplified. Patch by Demur Rumed.
+
+- Issue #9766: Rename poorly named variables exposed by _warnings to prevent
+ confusion with the proper variables names from 'warnings' itself.
+
+- Issue #9212: dict_keys and dict_items now provide the isdisjoint() method, to
+ conform to the Set ABC. Patch by Daniel Urban.
+
+- Issue #9737: Fix a crash when trying to delete a slice or an item from a
+ memoryview object.
+
+- Issue #9549: sys.setdefaultencoding() and PyUnicode_SetDefaultEncoding() are
+ now removed, since their effect was inexistent in 3.x (the default encoding is
+ hardcoded to utf-8 and cannot be changed).
+
+- Issue #7415: PyUnicode_FromEncodedObject() now uses the new buffer API
+ properly. Patch by Stefan Behnel.
+
+- Issue #5553: The Py_LOCAL_INLINE macro now results in inlining on most
+ platforms. Previously, it inlined only when using Microsoft Visual C.
+
+- Issue #9712: Fix tokenize on identifiers that start with non-ascii names.
+
+- Issue #9688: __basicsize__ and __itemsize__ must be accessed as Py_ssize_t.
+
+- Issue #9684: Added a definition for SIZEOF_WCHAR_T to PC/pyconfig.h, to match
+ the pyconfig.h generated by configure on other systems.
+
+- Issue #9666: Only catch AttributeError in hasattr(). All other exceptions that
+ occur during attribute lookup are now propagated to the caller.
+
+- Issue #8622: Add PYTHONFSENCODING environment variable to override the
+ filesystem encoding.
+
+- Issue #5127: The C functions that access the Unicode Database now accept and
+ return characters from the full Unicode range, even on narrow unicode builds
+ (Py_UNICODE_TOLOWER, Py_UNICODE_ISDECIMAL, and others). A visible difference
+ in Python is that unicodedata.numeric() now returns the correct value for
+ large code points, and repr() may consider more characters as printable.
+
+- Issue #9425: Create PyModule_GetFilenameObject() function to get the filename
+ as a unicode object, instead of a byte string. Function needed to support
+ unencodable filenames. Deprecate PyModule_GetFilename() in favor on the new
+ function.
+
+- Issue #8063: Call _PyGILState_Init() earlier in Py_InitializeEx().
+
+- Issue #9612: The set object is now 64-bit clean under Windows.
+
+- Issue #8202: sys.argv[0] is now set to '-m' instead of '-c' when searching for
+ the module file to be executed with the -m command line option.
+
+- Issue #9599: Create PySys_FormatStdout() and PySys_FormatStderr() functions to
+ write a message formatted by PyUnicode_FromFormatV() to sys.stdout and
+ sys.stderr.
+
+- Issue #9542: Create PyUnicode_FSDecoder() function, a ParseTuple converter:
+ decode bytes objects to unicode using PyUnicode_DecodeFSDefaultAndSize(); str
+ objects are output as-is.
+
+- Issue #9203: Computed gotos are now enabled by default on supported compilers
+ (which are detected by the configure script). They can still be disable
+ selectively by specifying --without-computed-gotos.
+
+- Issue #9425: Create PyErr_WarnFormat() function, similar to PyErr_WarnEx() but
+ use PyUnicode_FromFormatV() to format the warning message.
+
+- Issue #8530: Prevent stringlib fastsearch from reading beyond the front of an
+ array.
+
+- Issue #5319: Print an error if flushing stdout fails at interpreter shutdown.
+
+- Issue #9337: The str() of a float or complex number is now identical to its
+ repr().
+
+- Issue #9416: Fix some issues with complex formatting where the output with no
+ type specifier failed to match the str output:
+
+ - format(complex(-0.0, 2.0), '-') omitted the real part from the output,
+ - format(complex(0.0, 2.0), '-') included a sign and parentheses.
+
+Extension Modules
+-----------------
+
+- Issue #8013: time.asctime and time.ctime no longer call system
+ asctime and ctime functions. The year range for time.asctime is now
+ 1900 through maxint. The range for time.ctime is the same as for
+ time.localtime. The string produced by these functions is longer
+ than 24 characters when year is greater than 9999.
+
+- Issue #6608: time.asctime is now checking struct tm fields its input
+ before passing it to the system asctime. Patch by MunSic Jeong.
+
+- Issue #8734: Avoid crash in msvcrt.get_osfhandle() when an invalid file
+ descriptor is provided. Patch by Pascal Chambon.
+
+- Issue #7736: Release the GIL around calls to opendir() and closedir() in the
+ posix module. Patch by Marcin Bachry.
+
+- Issue #4835: make PyLong_FromSocket_t() and PyLong_AsSocket_t() private to the
+ socket module, and fix the width of socket descriptors to be correctly
+ detected under 64-bit Windows.
+
+- Issue #1027206: Support IDNA in gethostbyname, gethostbyname_ex, getaddrinfo
+ and gethostbyaddr. getnameinfo is now restricted to numeric addresses as
+ input.
+
+- Issue #9214: Set operations on a KeysView or ItemsView in collections now
+ correctly return a set. Patch by Eli Bendersky.
+
+- Issue #5737: Add Solaris-specific mnemonics in the errno module. Patch by
+ Matthew Ahrens.
+
+- Restore GIL in nis_cat in case of error. Decode NIS data to fs encoding, using
+ the surrogate error handler.
+
+- Issue #665761: ``functools.reduce()`` will no longer mask exceptions other
+ than ``TypeError`` raised by the iterator argument.
+
+- Issue #9570: Use PEP 383 decoding in os.mknod and os.mkfifo.
+
+- Issue #6915: Under Windows, os.listdir() didn't release the Global Interpreter
+ Lock around all system calls. Original patch by Ryan Kelly.
+
+- Issue #8524: Add a detach() method to socket objects, so as to put the socket
+ into the closed state without closing the underlying file descriptor.
+
+- Issue #477863: Emit a ResourceWarning at shutdown if gc.garbage is not empty.
+
+- Issue #6869: Fix a refcount problem in the _ctypes extension.
+
+- Issue #5504: ctypes should now work with systems where mmap can't be
+ PROT_WRITE and PROT_EXEC.
+
+- Issue #9507: Named tuple repr will now automatically display the right name in
+ a tuple subclass.
+
+- Issue #9324: Add parameter validation to signal.signal on Windows in order to
+ prevent crashes.
+
+- Issue #9526: Remove some outdated (int) casts that were preventing the array
+ module from working correctly with arrays of more than 2**31 elements.
+
+- Fix memory leak in ssl._ssl._test_decode_cert.
+
+- Issue #8065: Fix memory leak in readline module (from failure to free the
+ result of history_get_history_state()).
+
+- Issue #9450: Fix memory leak in readline.replace_history_item and
+ readline.remove_history_item for readline version >= 5.0.
+
+- Issue #8105: Validate file descriptor passed to mmap.mmap on Windows.
+
+- Issue #8046: Add context manager protocol support and .closed property to mmap
+ objects.
+
+Library
+-------
+
+- Issue #7451: Improve decoding performance of JSON objects, and reduce the
+ memory consumption of said decoded objects when they use the same strings as
+ keys.
+
+- Issue #1100562: Fix deep-copying of objects derived from the list and dict
+ types. Patch by Michele Orrù and Björn Lindqvist.
+
+- Issue #9753: Fixed socket.dup, which did not always work correctly on Windows.
+
+- Issue #9421: Made the get<type> methods consistently accept the vars and
+ default arguments on all parser classes.
+
+- Issue #7005: Fixed output of None values for RawConfigParser.write and
+ ConfigParser.write.
+
+- Issue #8990: array.fromstring() and array.tostring() get renamed to
+ frombytes() and tobytes(), respectively, to avoid confusion. Furthermore,
+ array.frombytes(), array.extend() as well as the array.array() constructor now
+ accept bytearray objects. Patch by Thomas Jollans.
+
+- Issue #808164: Fixed socket.close to avoid references to globals, to avoid
+ issues when socket.close is called from a __del__ method.
+
+- Issue #9706: ssl module provides a better error handling in various
+ circumstances.
+
+- Issue #1868: Eliminate subtle timing issues in thread-local objects by getting
+ rid of the cached copy of thread-local attribute dictionary.
+
+- Issue #1512791: In setframerate() in the wave module, non-integral frame rates
+ are rounded to the nearest integer.
+
+- Issue #8797: urllib2 does a retry for Basic Authentication failure instead of
+ falling into recursion.
+
+- Issue #1194222: email.utils.parsedate now returns RFC2822 compliant four
+ character years even if the message contains RFC822 two character years.
+
+- Issue #8750: Fixed MutableSet's methods to correctly handle reflexive
+ operations on its self, namely x -= x and x ^= x.
+
+- Issue #9129: smtpd.py is vulnerable to DoS attacks deriving from missing error
+ handling when accepting a new connection.
+
+- Issue #9601: ftplib now provides a workaround for non-compliant
+ implementations such as IIS shipped with Windows server 2003 returning invalid
+ response codes for MKD and PWD commands.
+
+- Issue #658749: asyncore's connect() method now correctly interprets winsock
+ errors.
+
+- Issue #9501: Fixed logging regressions in cleanup code.
+
+- Fix functools.total_ordering() to skip methods inherited from object.
+
+- Issue #9572: Importlib should not raise an exception if a directory it thought
+ it needed to create was done concurrently by another process.
+
+- Issue #9617: Signals received during a low-level write operation aren't
+ ignored by the buffered IO layer anymore.
+
+- Issue #843590: Make "macintosh" an alias to the "mac_roman" encoding.
+
+- Create os.fsdecode(): decode from the filesystem encoding with surrogateescape
+ error handler, or strict error handler on Windows.
+
+- Issue #3488: Provide convenient shorthand functions ``gzip.compress`` and
+ ``gzip.decompress``. Original patch by Anand B. Pillai.
+
+- Issue #8807: poplib.POP3_SSL class now accepts a context parameter, which is a
+ ssl.SSLContext object allowing bundling SSL configuration options,
+ certificates and private keys into a single (potentially long-lived)
+ structure.
+
+- Issue #8866: parameters passed to socket.getaddrinfo can now be specified as
+ single keyword arguments.
+
+- Address XXX comment in dis.py by having inspect.py prefer to reuse the dis.py
+ compiler flag values over defining its own.
+
+- Issue #9147: Added dis.code_info() which is similar to show_code() but returns
+ formatted code information in a string rather than displaying on screen.
+
+- Issue #9567: functools.update_wrapper now adds a __wrapped__ attribute
+ pointing to the original callable.
+
+- Issue #3445: functools.update_wrapper now tolerates missing attributes on
+ wrapped callables.
+
+- Issue #5867: Add abc.abstractclassmethod and abc.abstractstaticmethod.
+
+- Issue #9605: posix.getlogin() decodes the username with file filesystem
+ encoding and surrogateescape error handler. Patch written by David Watson.
+
+- Issue #9604: posix.initgroups() encodes the username using the fileystem
+ encoding and surrogateescape error handler. Patch written by David Watson.
+
+- Issue #9603: posix.ttyname() and posix.ctermid() decode the terminal name
+ using the filesystem encoding and surrogateescape error handler. Patch written
+ by David Watson.
+
+- Issue #7647: The posix module now has the ST_RDONLY and ST_NOSUID constants,
+ for use with the statvfs() function. Patch by Adam Jackson.
+
+- Issue #8688: MANIFEST files created by distutils now include a magic comment
+ indicating they are generated. Manually maintained MANIFESTs without this
+ marker will not be overwritten or removed.
+
+- Issue #7467: when reading a file from a ZIP archive, its CRC is checked and a
+ BadZipfile error is raised if it doesn't match (as used to be the case in
+ Python 2.5 and earlier).
+
+- Issue #9550: a BufferedReader could issue an additional read when the original
+ read request had been satisfied, which could block indefinitely when the
+ underlying raw IO channel was e.g. a socket. Report and original patch by
+ Jason V. Miller.
+
+- Issue #3757: thread-local objects now support cyclic garbage collection.
+ Thread-local objects involved in reference cycles will be deallocated timely
+ by the cyclic GC, even if the underlying thread is still running.
+
+- Issue #9452: Add read_file, read_string, and read_dict to the configparser
+ API; new source attribute to exceptions.
+
+- Issue #6231: Fix xml.etree.ElementInclude to include the tail of the current
+ node.
+
+- Issue #8047: Fix the xml.etree serializer to return bytes by default. Use
+ ``encoding="unicode"`` to generate a Unicode string.
+
+- Issue #8280: urllib2's Request method will remove fragments in the url. This
+ is how it is supposed to work, wget and curl do the same. Previous behavior
+ was wrong.
+
+- Issue #6683: For SMTP logins we now try all authentication methods advertised
+ by the server. Many servers are buggy and advertise authentication methods
+ they do not support in reality.
+
+- Issue #8814: function annotations (the ``__annotations__`` attribute) are now
+ included in the set of attributes copied by default by functools.wraps and
+ functools.update_wrapper. Patch by Terrence Cole.
+
+- Issue #2944: asyncore doesn't handle connection refused correctly.
+
+- Issue #4184: Private attributes on smtpd.SMTPChannel made public and deprecate
+ the private attributes. Add tests for smtpd module.
+
+- Issue #3196: email header decoding is now forgiving if an RFC2047 encoded word
+ encoded in base64 is lacking padding.
+
+- Issue #9444: Argparse now uses the first element of prefix_chars as the option
+ character for the added 'h/help' option if prefix_chars does not contain a
+ '-', instead of raising an error.
+
+- Issue #7372: Fix pstats regression when stripping paths from profile data
+ generated with the profile module.
+
+- Issue #9428: Fix running scripts with the profile/cProfile modules from the
+ command line.
+
+- Issue #7781: Fix restricting stats by entry counts in the pstats interactive
+ browser.
+
+- Issue #9209: Do not crash in the pstats interactive browser on invalid regular
+ expressions.
+
+- Update collections.OrderedDict to match the implementation in Py2.7 (based on
+ lists instead of weakly referenced Link objects).
+
+- Issue #8397: Raise an error when attempting to mix iteration and regular reads
+ on a BZ2File object, rather than returning incorrect results.
+
+- Issue #9448: Fix a leak of OS resources (mutexes or semaphores) when
+ re-initializing a buffered IO object by calling its ``__init__`` method.
+
+- Issue #1713: Fix os.path.ismount(), which returned true for symbolic links
+ across devices.
+
+- Issue #8826: Properly load old-style "expires" attribute in http.cookies.
+
+- Issue #1690103: Fix initial namespace for code run with trace.main().
+
+- Issue #7395: Fix tracebacks in pstats interactive browser.
+
+- Issue #8230: Fix Lib/test/sortperf.py.
+
+- Issue #8620: when a cmd.Cmd() is fed input that reaches EOF without a final
+ newline, it no longer truncates the last character of the last command line.
+
+- Issue #5146: Handle UID THREAD command correctly in imaplib.
+
+- Issue #5147: Fix the header generated for cookie files written by
+ http.cookiejar.MozillaCookieJar.
+
+- Issue #8198: In pydoc, output all help text to the correct stream when
+ sys.stdout is reassigned.
+
+- Issue #7909: Do not touch paths with the special prefixes ``\\.\`` or ``\\?\``
+ in ntpath.normpath().
+
+- Issue #1286: Allow using fileinput.FileInput as a context manager.
+
+- Add lru_cache() decorator to the functools module.
+
+Tools/Demos
+-----------
+
+- Fix ``Tools/scripts/checkpyc.py`` after PEP 3147.
+
+- Issue #8867: Fix ``Tools/scripts/serve.py`` to work with files containing
+ non-ASCII content.
+
+Tests
+-----
+
+- Issue #9601: Provide a test case for ftplib.parse257.
+
+- Issue #8857: Provide a test case for socket.getaddrinfo.
+
+- Issue #7564: Skip test_ioctl if another process is attached to /dev/tty.
+
+- Issue #8433: Fix test_curses failure with newer versions of ncurses.
+
+- Issue #9496: Provide a test suite for the rlcompleter module. Patch by
+ Michele Orrù.
+
+- Issue #8687: provide a test suite for sched.py module.
+
+Build
+-----
+
+- Issue #1303434: Generate ZIP file containing all PDBs.
+
+- Issue #9193: PEP 3149 is accepted.
+
+- Issue #3101: Helper functions _add_one_to_index_C() and _add_one_to_index_F()
+ become _Py_add_one_to_index_C() and _Py_add_one_to_index_F(), respectively.
+
+- Issue #9700: define HAVE_BROKEN_POSIX_SEMAPHORES under AIX 6.x. Patch by
+ Sébastien Sablé.
+
+- Don't run pgen twice when using make -j.
+
+
+What's New in Python 3.2 Alpha 1?
+=================================
+
+*Release date: 01-Aug-2010*
+
+Core and Builtins
+-----------------
+
+- Issue #8991: convertbuffer() rejects discontigious buffers.
+
+- Issue #7616: Fix copying of overlapping memoryview slices with the Intel
+ compiler.
+
+- Issue #8413: structsequence now subclasses tuple.
+
+- Issue #8271: during the decoding of an invalid UTF-8 byte sequence, only the
+ start byte and the continuation byte(s) are now considered invalid, instead of
+ the number of bytes specified by the start byte. E.g.:
+ '\xf1\x80AB'.decode('utf-8', 'replace') now returns u'\ufffdAB' and replaces
+ with U+FFFD only the start byte ('\xf1') and the continuation byte ('\x80')
+ even if '\xf1' is the start byte of a 4-bytes sequence. Previous versions
+ returned a single u'\ufffd'.
+
+- Issue #9011: A negated imaginary literal (e.g., "-7j") now has real part -0.0
+ rather than 0.0. So "-7j" is now exactly equivalent to "-(7j)".
+
+- Be more specific in error messages about positional arguments.
+
+- Issue #8949: "z" format of PyArg_Parse*() functions doesn't accept bytes
+ objects, as described in the documentation.
+
+- Issue #6543: Write the traceback in the terminal encoding instead of utf-8.
+ Fix the encoding of the modules filename. Patch written by Amaury Forgeot
+ d'Arc.
+
+- Issue #9011: Remove buggy and unnecessary (in 3.x) ST->AST compilation code
+ dealing with unary minus applied to a constant. The removed code was mutating
+ the ST, causing a second compilation to fail.
+
+- Issue #850997: mbcs encoding (Windows only) handles errors argument: strict
+ mode raises unicode errors. The encoder only supports "strict" and "replace"
+ error handlers, the decoder only supports "strict" and "ignore" error
+ handlers. Patch written by Mark Hammond.
+
+- Issue #8850: Remove "w" and "w#" formats from PyArg_Parse*() functions, use
+ "w*" format instead. Add tests for "w*" format.
+
+- Issue #8592: PyArg_Parse*() functions raise a TypeError for "y", "u" and "Z"
+ formats if the string contains a null byte/character. Write unit tests for
+ string formats.
+
+- Issue #7490: To facilitate sharing of doctests between 2.x and 3.x test
+ suites, the IGNORE_EXCEPTION_DETAIL directive now also ignores the module
+ location of the raised exception.
+
+- Issue #8969: On Windows, use mbcs codec in strict mode to encode and decode
+ filenames and enable os.fsencode().
+
+- Issue #9058: Remove assertions about INT_MAX in UnicodeDecodeError.
+
+- Issue #8941: Decoding big endian UTF-32 data in UCS-2 builds could crash the
+ interpreter with characters outside the Basic Multilingual Plane (higher than
+ 0x10000).
+
+- Issue #8950: (See also issue #5080). Py_ArgParse*() functions now raise
+ TypeError instead of giving a DeprecationWarning when a float is parsed using
+ the 'L' code (for long long). (All other integer codes already raise
+ TypeError in this case.)
+
+- Issue #8922: Normalize the encoding name in PyUnicode_AsEncodedString() to
+ enable shortcuts for upper case encoding name. Add also a shortcut for
+ "iso-8859-1" in PyUnicode_AsEncodedString() and PyUnicode_Decode().
+
+- Issue #8838: Remove codecs.charbuffer_encode() function. The buffer protocol
+ doesn't support "char buffer" anymore in Python 3.
+
+- Issue #8339: Remove "t#" format of PyArg_Parse*() functions, use "s#" or "s*"
+ instead. codecs.charbuffer_encode() now accepts modifiable buffer objects
+ like bytearray.
+
+- Issue #8837: Remove "O?" format of PyArg_Parse*() functions. The format is no
+ used anymore and it was never documented.
+
+- In str.format(), raise a ValueError when indexes to arguments are too large.
+
+- Issue #2844: Make int('42', n) consistently raise ValueError for invalid
+ integers n (including n = -909).
+
+- Issue #8188: Introduce a new scheme for computing hashes of numbers (instances
+ of int, float, complex, decimal.Decimal and fractions.Fraction) that makes it
+ easy to maintain the invariant that hash(x) == hash(y) whenever x and y have
+ equal value.
+
+- Issue #8748: Fix two issues with comparisons between complex and integer
+ objects. (1) The comparison could incorrectly return True in some cases
+ (2**53+1 == complex(2**53) == 2**53), breaking transitivity of equality.
+ (2) The comparison raised an OverflowError for large integers, leading to
+ unpredictable exceptions when combining integers and complex objects in sets
+ or dicts.
+
+- Issue #8766: Initialize _warnings module before importing the first module.
+ Fix a crash if an empty directory called "encodings" exists in sys.path.
+
+- Issue #8589: Decode PYTHONWARNINGS environment variable with the file system
+ encoding and surrogateescape error handler instead of the locale encoding to
+ be consistent with os.environ. Add PySys_AddWarnOptionUnicode() function.
+
+- PyObject_Dump() encodes unicode objects to utf8 with backslashreplace (instead
+ of strict) error handler to escape surrogates.
+
+- Issue #8715: Create PyUnicode_EncodeFSDefault() function: Encode a Unicode
+ object to Py_FileSystemDefaultEncoding with the "surrogateescape" error
+ handler, and return bytes. If Py_FileSystemDefaultEncoding is not set, fall
+ back to UTF-8.
+
+- Enable shortcuts for common encodings in PyUnicode_AsEncodedString() for any
+ error handler, not only the default error handler (strict).
+
+- Issue #8610: Load file system codec at startup, and display a fatal error on
+ failure. Set the file system encoding to utf-8 (instead of None) if getting
+ the locale encoding failed, or if nl_langinfo(CODESET) function is missing.
+
+- PyFile_FromFd() uses PyUnicode_DecodeFSDefault() instead of
+ PyUnicode_FromString() to support surrogates in the filename and use the right
+ encoding.
+
+- Issue #7507: Quote "!" in pipes.quote(); it is special to some shells.
+
+- PyUnicode_DecodeFSDefaultAndSize() uses surrogateescape error handler.
+
+- Issue #8419: Prevent the dict constructor from accepting non-string keyword
+ arguments.
+
+- Issue #8124: PySys_WriteStdout() and PySys_WriteStderr() don't execute
+ indirectly Python signal handlers anymore because mywrite() ignores exceptions
+ (KeyboardInterrupt).
+
+- Issue #8092: Fix PyUnicode_EncodeUTF8() to support error handler producing
+ unicode string (eg. backslashreplace).
+
+- Issue #8485: PyUnicode_FSConverter() doesn't accept byteearray objects
+ anymore, you have to convert your bytearray filenames to bytes.
+
+- Issue #7332: Remove the 16KB stack-based buffer in
+ PyMarshal_ReadLastObjectFromFile, which doesn't bring any noticeable benefit
+ compared to the dynamic memory allocation fallback. Patch by Charles-François
+ Natali.
+
+- Issue #8417: Raise an OverflowError when an integer larger than sys.maxsize is
+ passed to bytes or bytearray.
+
+- Issue #7301: Add environment variable $PYTHONWARNINGS.
+
+- Issue #8329: Don't return the same lists from select.select when no fds are
+ changed.
+
+- Issue #8259: 1L << (2**31) no longer produces an 'outrageous shift error' on
+ 64-bit machines. The shift count for either left or right shift is permitted
+ to be up to sys.maxsize.
+
+- Ensure that tokenization of identifiers is not affected by locale.
+
+- Issue #1222585: Added LDCXXSHARED for C++ support. Patch by Arfrever.
+
+- Raise a TypeError when trying to delete a T_STRING_INPLACE struct member.
+
+- Issue #8211: Save/restore CFLAGS around AC_PROG_CC in configure.in, in case it
+ is set.
+
+- Issue #8226: sys.setfilesystemencoding() raises a LookupError if the encoding
+ is unknown.
+
+- Issue #1583863: A str subclass can now override the __str__ method.
+
+- Issue #8014: Setting a T_UINT or T_PYSSIZET attribute of an object with
+ PyMemberDefs could produce an internal error; raise TypeError instead.
+
+- Issue #7845: Rich comparison methods on the complex type now return
+ NotImplemented rather than raising a TypeError when comparing with an
+ incompatible type; this allows user-defined classes to implement their own
+ comparisons with complex.
+
+- Issue #3137: Don't ignore errors at startup, especially a keyboard interrupt
+ (SIGINT). If an error occurs while importing the site module, the error is
+ printed and Python exits. Initialize the GIL before importing the site module.
+
+- Issue #7173: Generator finalization could invalidate sys.exc_info().
+
+- Issue #7544: Preallocate thread memory before creating the thread to avoid a
+ fatal error in low memory condition.
+
+- Issue #7820: The parser tokenizer restores all bytes in the right if the BOM
+ check fails.
+
+- Handle errors from looking up __prepare__ correctly.
+
+- Issue #5939: Add additional runtime checking to ensure a valid capsule in
+ Modules/_ctypes/callproc.c.
+
+- Issue #7309: Fix unchecked attribute access when converting
+ UnicodeEncodeError, UnicodeDecodeError, and UnicodeTranslateError to strings.
+
+- Issue #6902: Fix problem with built-in types format incorrectly with 0
+ padding.
+
+- Issue #7988: Fix default alignment to be right aligned for complex.__format__.
+ Now it matches other numeric types.
+
+- Issue #5988: Remove deprecated functions PyOS_ascii_formatd,
+ PyOS_ascii_strtod, and PyOS_ascii_atof. Use PyOS_double_to_string and
+ PyOS_string_to_double instead. See issue #5835 for the original deprecations.
+
+- Issue #7385: Fix a crash in `MemoryView_FromObject` when `PyObject_GetBuffer`
+ fails. Patch by Florent Xicluna.
+
+- Issue #7788: Fix an interpreter crash produced by deleting a list slice with
+ very large step value.
+
+- Issue #7766: Change sys.getwindowsversion() return value to a named tuple and
+ add the additional members returned in an OSVERSIONINFOEX structure. The new
+ members are service_pack_major, service_pack_minor, suite_mask, and
+ product_type.
+
+- Issue #7561: Operations on empty bytearrays (such as `int(bytearray())`) could
+ crash in many places because of the PyByteArray_AS_STRING() macro returning
+ NULL. The macro now returns a statically allocated empty string instead.
+
+- Issue #6690: Optimize the bytecode for expressions such as `x in {1, 2, 3}`,
+ where the right hand operand is a set of constants, by turning the set into a
+ frozenset and pre-building it as a constant. The comparison operation is made
+ against the constant instead of building a new set each time it is executed (a
+ similar optimization already existed which turned a list of constants into a
+ pre-built tuple). Patch and additional tests by Dave Malcolm.
+
+- Issue #7622: Improve the split(), rsplit(), splitlines() and replace() methods
+ of bytes, bytearray and unicode objects by using a common implementation based
+ on stringlib's fast search. Patch by Florent Xicluna.
+
+- Issue #7632: Fix various str -> float conversion bugs present in 2.7 alpha 2,
+ including: (1) a serious 'wrong output' bug that could occur for long (> 40
+ digit) input strings, (2) a crash in dtoa.c that occurred in debug builds when
+ parsing certain long numeric strings corresponding to subnormal values, (3) a
+ memory leak for some values large enough to cause overflow, and (4) a number
+ of flaws that could lead to incorrectly rounded results.
+
+- The __complex__ method is now looked up on the class of instances to make it
+ consistent with other special methods.
+
+- Issue #7462: Implement the stringlib fast search algorithm for the `rfind`,
+ `rindex`, `rsplit` and `rpartition` methods. Patch by Florent Xicluna.
+
+- Issue #7604: Deleting an unset slotted attribute did not raise an
+ AttributeError.
+
+- Issue #7534: Fix handling of IEEE specials (infinities, nans, negative zero)
+ in ** operator. The behaviour now conforms to that described in C99 Annex F.
+
+- Issue #1811: improve accuracy and cross-platform consistency for true division
+ of integers: the result of a/b is now correctly rounded for ints a and b (at
+ least on IEEE 754 platforms), and in particular does not depend on the
+ internal representation of an int.
+
+- Issue #6834: replace the implementation for the 'python' and 'pythonw'
+ executables on OSX.
+
+ These executables now work properly with the arch(1) command: ``arch -ppc
+ python`` will start a universal binary version of python in PPC mode (unlike
+ previous releases).
+
+- Issue #7466: Segmentation fault when the garbage collector is called in the
+ middle of populating a tuple. Patch by Florent Xicluna.
+
+- Issue #7419: setlocale() could crash the interpreter on Windows when called
+ with invalid values.
+
+- Issue #6077: On Windows, files opened with tempfile.TemporaryFile in "wt+"
+ mode would appear truncated on the first '0x1a' byte (aka. Ctrl+Z).
+
+- Issue #7085: Fix crash when importing some extensions in a thread on MacOSX
+ 10.6.
+
+- Issue #1757126: Fix the cyrillic-asian alias for the ptcp154 encoding.
+
+- Issue #6970: Remove redundant calls when comparing objects that don't
+ implement the relevant rich comparison methods.
+
+- Issue #7298: Fixes for range and reversed(range(...)). Iteration over
+ range(a, b, c) incorrectly gave an empty iterator when a, b and c fit in C
+ long but the length of the range did not. Also fix several cases where
+ reversed(range(a, b, c)) gave wrong results, and fix a refleak for
+ reversed(range(a, b, c)) with large arguments.
+
+- Issue #7244: itertools.izip_longest() no longer ignores exceptions raised
+ during the formation of an output tuple.
+
+- Issue #3297: On wide unicode builds, do not split unicode characters into
+ surrogates.
+
+- Remove length limitation when constructing a complex number from a string.
+
+- Issue #1087418: Boost performance of bitwise operations for longs.
+
+- Support for AtheOS has been completely removed from the code base. It was
+ disabled since Python 3.0.
+
+- Support for several legacy threading libraries has been disabled. These
+ libraries are: Mach C threads, SunOS LWP, GNU pth, Irix threads. Support code
+ will be entirely removed in 3.3.
+
+- Support for OSF* has been disabled. If nobody stands up, support will be
+ removed in 3.3. See <http://bugs.python.org/issue8606>.
+
+- Peephole constant folding had missed UNARY_POSITIVE.
+
+- Issue #1722344: threading._shutdown() is now called in Py_Finalize(), which
+ fixes the problem of some exceptions being thrown at shutdown when the
+ interpreter is killed. Patch by Adam Olsen.
+
+- Issue #7147: Remove support for compiling Python without complex number
+ support.
+
+- Issue #7120: logging: Removed import of multiprocessing which is causing crash
+ in GAE.
+
+- Issue #1754094: Improve the stack depth calculation in the compiler. There
+ should be no other effect than a small decrease in memory use. Patch by
+ Christopher Tur Lesniewski-Laas.
+
+- Issue #7065: Fix a crash in bytes.maketrans and bytearray.maketrans when using
+ byte values greater than 127. Patch by Derk Drukker.
+
+- Issue #1571184: The Unicode database contains properties for more characters.
+ The tables for code points representing numeric values, white spaces or line
+ breaks are now generated from the official Unicode Character Database files,
+ and include information from the Unihan.txt file.
+
+- Issue #7019: Raise ValueError when unmarshalling bad long data, instead of
+ producing internally inconsistent Python longs.
+
+- Issue #6990: Fix threading.local subclasses leaving old state around after a
+ reference cycle GC which could be recycled by new locals.
+
+- Issue #5460: Fix an ambiguity in the grammar.
+
+- Issue #1766304: Improve performance of membership tests on range objects.
+
+- Issue #6713: Improve performance of integer -> string conversions.
+
+- Issue #6846: Fix bug where bytearray.pop() returns negative integers.
+
+- Issue #6750: A text file opened with io.open() could duplicate its output when
+ writing from multiple threads at the same time.
+
+- Issue #6707: dir() on an uninitialized module caused a crash.
+
+- Issue #6540: Fixed crash for bytearray.translate() with invalid parameters.
+
+- Issue #6573: set.union() stopped processing inputs if an instance of self
+ occurred in the argument chain.
+
+- Issue #6070: On posix platforms import no longer copies the execute bit from
+ the .py file to the .pyc file if it is set.
+
+- Issue #1616979: Added the cp720 (Arabic DOS) encoding.
+
+- Issue #6428: Since Python 3.0, the __bool__ method must return a bool object,
+ and not an int. Fix the corresponding error message, and the documentation.
+
+- The deprecated PyCObject has been removed.
+
+- Issue #6347: Include inttypes.h as well as stdint.h in pyport.h. This fixes a
+ build failure on HP-UX: int32_t and uint32_t are defined in inttypes.h instead
+ of stdint.h on that platform.
+
+- Issue #6373: Fixed a SystemError when encoding with the latin-1 codec and the
+ 'surrogateescape' error handler, a string which contains unpaired surrogates.
+
+- Issue #4856: Remove checks for win NT.
+
+- Issue #6687: PyBytes_FromObject() no longer accepts an integer as its argument
+ to construct a null-initialized bytes object.
+
+- Issue #1023290: Add from_bytes() and to_bytes() methods to integers. These
+ methods allow the conversion of integers to bytes, and vice-versa.
+
+- Issue #7382: Fix bug in bytes.__getnewargs__ that prevented bytes instances
+ from being copied with copy.copy(), and bytes subclasses from being pickled
+ properly.
+
+- Code objects now support weak references.
+
+- Issue #7072: isspace(0xa0) is true on Mac OS X.
+
+- Issue #8084: PEP 370 now conforms to system conventions for framework builds
+ on MacOS X. That is, "python setup.py install --user" will install into
+ "~/Library/Python/2.7" instead of "~/.local".
+
+C-API
+-----
+
+- Issue #2443: A new macro, `Py_VA_COPY`, copies the state of the
+ variable argument list. `Py_VA_COPY` is equivalent to C99
+ `va_copy`, but available on all python platforms.
+
+- PySlice_GetIndicesEx now clips the step to [-PY_SSIZE_T_MAX, PY_SSIZE_T_MAX]
+ instead of [-PY_SSIZE_T_MAX-1, PY_SSIZE_T_MAX]. This makes it safe to do
+ "step = -step" when reversing a slice.
+
+- Issue #5753: A new C API function, `PySys_SetArgvEx`, allows embedders of the
+ interpreter to set sys.argv without also modifying sys.path. This helps fix
+ `CVE-2008-5983
+ <http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2008-5983>`_.
+
+- Add PyArg_ValidateKeywordArguments, which checks if all keyword arguments are
+ strings in an efficient manner.
+
+- Issue #8276: PyEval_CallObject() is now only available in macro form. The
+ function declaration, which was kept for backwards compatibility reasons, is
+ now removed (the macro was introduced in 1997!).
+
+- Issue #7767: New function PyLong_AsLongLongAndOverflow added, analogous to
+ PyLong_AsLongAndOverflow.
+
+- Make PyUnicode_CompareWithASCIIString return not equal if the Python string
+ has '\0' at the end.
+
+- Issue #5080: The argument parsing functions PyArg_ParseTuple,
+ PyArg_ParseTupleAndKeywords, PyArg_VaParse, PyArg_VaParseTupleAndKeywords and
+ PyArg_Parse now raise a DeprecationWarning for float arguments passed with the
+ 'L' format code. This will become a TypeError in a future version of Python,
+ to match the behaviour of the other integer format codes.
+
+- Issue #7033: Function ``PyErr_NewExceptionWithDoc()`` added.
+
+- Issue #7414: 'C' code wasn't being skipped properly (for keyword arguments) in
+ PyArg_ParseTupleAndKeywords.
+
+- Issue #7228: Add '%lld' and '%llu' support to PyString_FromFormat(V) and
+ PyErr_Format, on machines with HAVE_LONG_LONG defined.
+
+- Issue #6151: Made PyDescr_COMMON conform to standard C (like PyObject_HEAD in
+ PEP 3123). The PyDescr_TYPE and PyDescr_NAME macros should be should used for
+ accessing the d_type and d_name members of structures using PyDescr_COMMON.
+
+- Issue #6405: Remove duplicate type declarations in descrobject.h.
+
+- The code flags for old __future__ features are now available again.
+
+- Issue #5954: Add a PyFrame_GetLineNumber() function to replace most uses of
+ PyCode_Addr2Line().
+
+- Issue #5959: Add a PyCode_NewEmpty() function to create a new empty code
+ object at a specified file, function, and line number.
+
+- Issue #1419652: Change the first argument to PyImport_AppendInittab() to
+ ``const char *`` as the string is stored beyond the call.
+
+- Issue #2422: When compiled with the ``--with-valgrind`` option, the pymalloc
+ allocator will be automatically disabled when running under Valgrind. This
+ gives improved memory leak detection when running under Valgrind, while taking
+ advantage of pymalloc at other times.
+
+Library
+-------
+
+- In pdb, when Ctrl-C is entered while defining commands for a breakpoint, the
+ old commands are restored.
+
+- For traceback debugging, the pdb listing now also shows the locations where
+ the exception was originally (re)raised, if it differs from the last line
+ executed (e.g. in case of finally clauses).
+
+- The pdb command "source" has been added. It displays the source code for a
+ given object, if possible.
+
+- The pdb command "longlist" has been added. It displays the whole source code
+ for the current function.
+
+- Issue #1503502: Make pdb.Pdb easier to subclass by putting message and error
+ output into methods.
+
+- Issue #809887: Make the output of pdb's breakpoint deletions more consistent;
+ emit a message when a breakpoint is enabled or disabled.
+
+- Issue #5294: Fix the behavior of pdb's "continue" command when called in the
+ top-level debugged frame.
+
+- Issue #5727: Restore the ability to use readline when calling into pdb in
+ doctests.
+
+- Issue #6719: In pdb, do not stop somewhere in the encodings machinery if the
+ source file to be debugged is in a non-builtin encoding.
+
+- Issue #8048: Prevent doctests from failing when sys.displayhook has been
+ reassigned.
+
+- Issue #8015: In pdb, do not crash when an empty line is entered as a
+ breakpoint command.
+
+- In pdb, allow giving a line number to the "until" command.
+
+- Issue #1437051: For pdb, allow "continue" and related commands in .pdbrc
+ files. Also, add a command-line option "-c" that runs a command as if given
+ in .pdbrc.
+
+- Issue #4179: In pdb, allow "list ." as a command to return to the currently
+ debugged line.
+
+- Issue #4108: In urllib.robotparser, if there are multiple ``User-agent: *``
+ entries, consider the first one.
+
+- Issue #6630: Allow customizing regex flags when subclassing the
+ string.Template class.
+
+- Issue #9411: Allow specifying an encoding for config files in the configparser
+ module.
+
+- Issue #1682942: Improvements to configparser: support alternate delimiters,
+ alternate comment prefixes and empty lines in values.
+
+- Issue #9354: Provide getsockopt() in asyncore's file_wrapper.
+
+- Issue #8966: ctypes: Remove implicit bytes-unicode conversion.
+
+- Issue #9378: python -m pickle <pickle file> will now load and display the
+ first object in the pickle file.
+
+- Issue #4770: Restrict binascii module to accept only bytes (as specified).
+ And fix the email package to encode to ASCII instead of ``raw-unicode-escape``
+ before ASCII-to-binary decoding.
+
+- Issue #9384: ``python -m tkinter`` will now display a simple demo applet.
+
+- The default size of the re module's compiled regular expression cache has been
+ increased from 100 to 500 and the cache replacement policy has changed from
+ simply clearing the entire cache on overflow to forgetting the least recently
+ used cached compiled regular expressions. This is a performance win for
+ applications that use a lot of regular expressions and limits the impact of
+ the performance hit anytime the cache is exceeded.
+
+- Issue #7113: Speed up loading in configparser. Patch by Łukasz Langa.
+
+- Issue #9032: XML-RPC client retries the request on EPIPE error. The EPIPE
+ error occurs when the server closes the socket and the client sends a big
+ XML-RPC request.
+
+- Issue #4629: getopt raises an error if an argument ends with "=", whereas
+ getopt doesn't accept a value (eg. --help= is rejected if getopt uses
+ ['help='] long options).
+
+- Issue #7989: Added pure python implementation of the `datetime` module. The C
+ module is renamed to `_datetime` and if available, overrides all classes
+ defined in datetime with fast C impementation. Python implementation is based
+ on the original python prototype for the datetime module by Tim Peters with
+ minor modifications by the PyPy project. The test suite now tests `datetime`
+ module with and without `_datetime` acceleration using the same test cases.
+
+- Issue #7895: platform.mac_ver() no longer crashes after calling os.fork().
+
+- Issue #9323: Fixed a bug in trace.py that resulted in loosing the name of the
+ script being traced. Patch by Eli Bendersky.
+
+- Issue #9282: Fixed --listfuncs option of trace.py. Thanks Eli Bendersky for
+ the patch.
+
+- Issue #3704: http.cookiejar was not properly handling URLs with a / in the
+ parameters.
+
+- Issue #9268: ``pickletools.dis()`` now has an optional *annotate* argument
+ which controls printing of opcode descriptions in ``dis()`` output.
+
+- Issue #1555570: email no longer inserts extra blank lines when a \r\n combo
+ crosses an 8192 byte boundary.
+
+- Issue #9243: Fix sndhdr module and add unit tests, contributed by James Lee.
+
+- ``ast.literal_eval()`` now allows byte literals.
+
+- Issue #9137: Fix issue in MutableMapping.update, which incorrectly treated
+ keyword arguments called 'self' or 'other' specially.
+
+- ``ast.literal_eval()`` now allows set literals.
+
+- Issue #9164: Ensure that sysconfig handles duplicate -arch flags in CFLAGS.
+
+- Issue #7646: The fnmatch pattern cache no longer grows without bound.
+
+- Issue #9136: Fix 'dictionary changed size during iteration' RuntimeError
+ produced when profiling the decimal module. This was due to a dangerous
+ iteration over 'locals()' in Context.__init__.
+
+- Fix extreme speed issue in Decimal.pow when the base is an exact power of 10
+ and the exponent is tiny (for example, ``Decimal(10) **
+ Decimal('1e-999999999')``).
+
+- Issue #9186: Fix math.log1p(-1.0) to raise ValueError, not OverflowError.
+
+- Issue #9130: Fix validation of relative imports in parser module.
+
+- Issue #9128: Fix validation of class decorators in parser module.
+
+- Issue #9094: python -m pickletools will now disassemble pickle files listed in
+ the command line arguments. See output of python -m pickletools -h for more
+ details.
+
+- Issue #5468: urlencode to handle bytes type and other encodings in its query
+ parameter. Patch by Dan Mahn.
+
+- Issue #7673: Fix security vulnerability (CVE-2010-2089) in the audioop module,
+ ensure that the input string length is a multiple of the frame size.
+
+- Issue #6507: Accept source strings in dis.dis(). Original patch by Daniel
+ Urban.
+
+- Issue #7829: Clearly document that the dis module is exposing an
+ implementation detail that is not stable between Python VMs or releases.
+
+- Issue #6589: cleanup asyncore.socket_map in case smtpd.SMTPServer constructor
+ raises an exception.
+
+- Issue #9110: Addition of ContextDecorator to contextlib, for creating APIs
+ that act as both context managers and decorators. contextmanager changes to
+ use ContextDecorator.
+
+- Implement importlib.abc.SourceLoader and deprecate PyLoader and PyPycLoader
+ for removal in Python 3.4.
+
+- Issue #9064: pdb's "up" and "down" commands now accept an optional argument
+ giving the number of frames to go.
+
+- Issue #9018: os.path.normcase() now raises a TypeError if the argument is not
+ ``str`` or ``bytes``.
+
+- Issue #9075: In the ssl module, remove the setting of a ``debug`` flag on an
+ OpenSSL structure.
+
+- Issue #8682: The ssl module now temporary increments the reference count of a
+ socket object got through ``PyWeakref_GetObject``, so as to avoid possible
+ deallocation while the object is still being used.
+
+- Issue #1368368: FancyURLOpener class changed to throw an Exception on wrong
+ password instead of presenting an interactive prompt. Older behavior can be
+ obtained by passing retry=True to http_error_xxx methods of FancyURLOpener.
+
+- Issue #8720: Fix regression caused by fix for #4050 by making getsourcefile
+ smart enough to find source files in the linecache.
+
+- Issue #5610: feedparser no longer eats extra characters at the end of a body
+ part if the body part ends with a ``\r\n``.
+
+- Issue #8986: math.erfc was incorrectly raising OverflowError for values
+ between -27.3 and -30.0 on some platforms.
+
+- Issue #8784: Set tarfile default encoding to 'utf-8' on Windows.
+
+- Issue #8966: If a ctypes structure field is an array of c_char, convert its
+ value to bytes instead of str (as done for c_char and c_char_p).
+
+- Issue #8188: Comparisons between Decimal and Fraction objects are now
+ permitted, returning a result based on the exact numerical values of the
+ operands. This builds on issue #2531, which allowed Decimal-to-float
+ comparisons; all comparisons involving numeric types (bool, int, float,
+ complex, Decimal, Fraction) should now act as expected.
+
+- Issue #8897: Fix sunau module, use bytes to write the header. Patch written by
+ Thomas Jollans.
+
+- Issue #8899: time.struct_time now has class and attribute docstrings.
+
+- Issue #6470: Drop UNC prefix in FixTk.
+
+- Issue #4768: base64 encoded email body parts were incorrectly stored as binary
+ strings. They are now correctly converted to strings.
+
+- Issue #8833: tarfile created hard link entries with a size field != 0 by
+ mistake.
+
+- Charset.body_encode now correctly handles base64 encoding by encoding with the
+ output_charset before calling base64mime.encode. Passes the tests from 2.x
+ issue #1368247.
+
+- Issue #8845: sqlite3 Connection objects now have a read-only in_transaction
+ attribute that is True iff there are uncommitted changes.
+
+- Issue #1289118: datetime.timedelta objects can now be multiplied by float and
+ divided by float and int objects. Results are rounded to the nearest multiple
+ of timedelta.resolution with ties resolved using round-half-to-even method.
+
+- Issue #7150: Raise OverflowError if the result of adding or subtracting
+ timedelta from date or datetime falls outside of the MINYEAR:MAXYEAR range.
+
+- Issue #8806: add SSL contexts support to ftplib.
+
+- Issue #4769: Fix main() function of the base64 module, use sys.stdin.buffer
+ and sys.stdout.buffer (instead of sys.stdin and sys.stdout) to use the bytes
+ API.
+
+- Issue #8770: Now sysconfig displays information when it's called as a script.
+ Initial idea by Sridhar Ratnakumar.
+
+- Issue #6662: Fix parsing of malformatted charref (&#bad;), patch written by
+ Fredrik Håård.
+
+- Issue #8540: Decimal module: rename the Context._clamp attribute to
+ Context.clamp and make it public. This is useful in creating contexts that
+ correspond to the decimal interchange formats specified in IEEE 754.
+
+- Issue #6268: Fix seek() method of codecs.open(), don't read or write the BOM
+ twice after seek(0). Fix also reset() method of codecs, UTF-16, UTF-32 and
+ StreamWriter classes.
+
+- Issue #3798: sys.exit(message) writes the message to sys.stderr file, instead
+ of the C file stderr, to use stderr encoding and error handler.
+
+- Issue #8782: Add a trailing newline in linecache.updatecache to the last line
+ of files without one.
+
+- Issue #8729: Return NotImplemented from collections.Mapping.__eq__ when
+ comparing to a non-mapping.
+
+- Issue #8774: tabnanny uses the encoding cookie (#coding:...) to use the
+ correct encoding.
+
+- Issue #4870: Add an `options` attribute to SSL contexts, as well as several
+ ``OP_*`` constants to the `ssl` module. This allows to selectively disable
+ protocol versions, when used in combination with `PROTOCOL_SSLv23`.
+
+- Issue #8759: Fixed user paths in sysconfig for posix and os2 schemes.
+
+- Issue #8663: distutils.log emulates backslashreplace error handler. Fix
+ compilation in a non-ASCII directory if stdout encoding is ASCII (eg. if
+ stdout is not a TTY).
+
+- Issue #8513: os.get_exec_path() supports b'PATH' key and bytes value.
+ subprocess.Popen() and os._execvpe() support bytes program name. Add
+ os.supports_bytes_environ flag: True if the native OS type of the environment
+ is bytes (eg. False on Windows).
+
+- Issue #8633: tarfile is now able to read and write archives with "raw" binary
+ pax headers as described in POSIX.1-2008.
+
+- Issue #1285086: Speed up urllib.parse functions: quote, quote_from_bytes,
+ unquote, unquote_to_bytes.
+
+- Issue #8688: Distutils now recalculates MANIFEST everytime.
+
+- Issue #8477: ssl.RAND_egd() and ssl._test_decode_cert() support str with
+ surrogates and bytes for the filename.
+
+- Issue #8550: Add first class ``SSLContext`` objects to the ssl module.
+
+- Issue #8681: Make the zlib module's error messages more informative when the
+ zlib itself doesn't give any detailed explanation.
+
+- The audioop module now supports sound fragments of length greater than 2**31
+ bytes on 64-bit machines, and is PY_SSIZE_T_CLEAN.
+
+- Issue #4972: Add support for the context manager protocol to the ftplib.FTP
+ class.
+
+- Issue #8664: In py_compile, create __pycache__ when the compiled path is
+ given.
+
+- Issue #8514: Add os.fsencode() function (Unix only): encode a string to bytes
+ for use in the file system, environment variables or the command line.
+
+- Issue #8571: Fix an internal error when compressing or decompressing a chunk
+ larger than 1GB with the zlib module's compressor and decompressor objects.
+
+- Issue #8603: Support bytes environmental variables on Unix: Add os.environb
+ mapping and os.getenvb() function. os.unsetenv() encodes str argument to the
+ file system encoding with the surrogateescape error handler (instead of
+ utf8/strict) and accepts bytes. posix.environ keys and values are now bytes.
+
+- Issue #8573: asyncore _strerror() function might throw ValueError.
+
+- Issue #8483: asyncore.dispatcher's __getattr__ method produced confusing error
+ messages when accessing undefined class attributes because of the cheap
+ inheritance with the underlying socket object. The cheap inheritance has been
+ deprecated.
+
+- Issue #4265: shutil.copyfile() was leaking file descriptors when disk fills.
+ Patch by Tres Seaver.
+
+- Issue #8390: tarfile uses surrogateescape as the default error handler
+ (instead of replace in read mode or strict in write mode).
+
+- Issue #7755: Use an unencumbered audio file for tests.
+
+- Issue #8621: uuid.uuid4() returned the same sequence of values in the parent
+ and any children created using ``os.fork`` on MacOS X 10.6.
+
+- Issue #8567: Fix precedence of signals in Decimal module: when a Decimal
+ operation raises multiple signals and more than one of those signals is
+ trapped, the specification determines the order in which the signals should be
+ handled. In many cases this order wasn't being followed, leading to the wrong
+ Python exception being raised.
+
+- Issue #7865: The close() method of ``io`` objects should not swallow
+ exceptions raised by the implicit flush(). Also qensure that calling close()
+ several times is supported. Patch by Pascal Chambon.
+
+- Issue #4687: Fix accuracy of garbage collection runtimes displayed with
+ gc.DEBUG_STATS.
+
+- Issue #8354: The siginterrupt setting is now preserved for all signals, not
+ just SIGCHLD.
+
+- Issue #7192: webbrowser.get("firefox") now works on Mac OS X, as does
+ webbrowser.get("safari").
+
+- Issue #8464: tarfile no longer creates files with execute permissions set when
+ mode="w|" is used.
+
+- Issue #7834: Fix connect() of Bluetooth L2CAP sockets with recent versions of
+ the Linux kernel. Patch by Yaniv Aknin.
+
+- Issue #8295: Added shutil.unpack_archive.
+
+- Issue #6312: Fixed http HEAD request when the transfer encoding is chunked.
+ It should correctly return an empty response now.
+
+- Issue #8546: Reject None given as the buffering argument to _pyio.open.
+
+- Issue #8549: Fix compiling the _ssl extension under AIX. Patch by
+ Sridhar Ratnakumar.
+
+- Issue #6656: fix locale.format_string to handle escaped percents
+ and mappings.
+
+- Issue #2302: Fix a race condition in SocketServer.BaseServer.shutdown, where
+ the method could block indefinitely if called just before the event loop
+ started running. This also fixes the occasional freezes witnessed in
+ test_httpservers.
+
+- Issue #8524: When creating an SSL socket, the timeout value of the original
+ socket wasn't retained (instead, a socket with a positive timeout would be
+ turned into a non-blocking SSL socket).
+
+- Issue #5103: SSL handshake would ignore the socket timeout and block
+ indefinitely if the other end didn't respond.
+
+- The do_handshake() method of SSL objects now adjusts the blocking mode of the
+ SSL structure if necessary (as other methods already do).
+
+- Issue #8391: os.execvpe() and os.getenv() supports unicode with surrogates and
+ bytes strings for environment keys and values.
+
+- Issue #8467: Pure Python implementation of subprocess encodes the error
+ message using surrogatepass error handler to support surrogates in the
+ message.
+
+- Issue #8468: bz2.BZ2File() accepts str with surrogates and bytes filenames.
+
+- Issue #8451: Syslog module now uses basename(sys.argv[0]) instead of the
+ string "python" as the *ident*. openlog() arguments are all optional and
+ keywords.
+
+- Issue #8108: Fix the unwrap() method of SSL objects when the socket has a
+ non-infinite timeout. Also make that method friendlier with applications
+ wanting to continue using the socket in clear-text mode, by disabling
+ OpenSSL's internal readahead. Thanks to Darryl Miles for guidance.
+
+- Issue #8496: make mailcap.lookup() always return a list, rather than an
+ iterator. Patch by Gregory Nofi.
+
+- Issue #8195: Fix a crash in sqlite Connection.create_collation() if the
+ collation name contains a surrogate character.
+
+- Issue #8484: Load all ciphers and digest algorithms when initializing the _ssl
+ extension, such that verification of some SSL certificates doesn't fail
+ because of an "unknown algorithm".
+
+- Issue #6547: Added the ignore_dangling_symlinks option to shutil.copytree.
+
+- Issue #1540112: Now allowing the choice of a copy function in shutil.copytree.
+
+- Issue #4814: timeout parameter is now applied also for connections resulting
+ from PORT/EPRT commands.
+
+- Issue #8463: added missing reference to bztar in shutil's documentation.
+
+- Issue #7154: urllib.request can now detect the proxy settings on OSX 10.6 (as
+ long as the user didn't specify 'automatic proxy configuration').
+
+- Issue #3817: ftplib.FTP.abort() method now considers 225 a valid response code
+ as stated in RFC-959 at chapter 5.4.
+
+- Issue #8394: _ctypes.dlopen() accepts bytes, bytearray and str with
+ surrogates.
+
+- Issue #850728: Add a *timeout* parameter to the `acquire()` method of
+ `threading.Semaphore` objects. Original patch by Torsten Landschoff.
+
+- Issue #8322: Add a *ciphers* argument to SSL sockets, so as to change the
+ available cipher list. Helps fix test_ssl with OpenSSL 1.0.0.
+
+- Issue #8393: subprocess accepts bytes, bytearray and str with surrogates for
+ the current working directory.
+
+- Issue #7606: XML-RPC traceback stored in X-traceback is now encoded to ASCII
+ using backslashreplace error handler.
+
+- Issue #8412: os.system() now accepts bytes, bytearray and str with surrogates.
+
+- Issue #2987: RFC2732 support for urlparse (IPv6 addresses). Patch by Tony
+ Locke and Hans Ulrich Niedermann.
+
+- Issue #5277: Fix quote counting when parsing RFC 2231 encoded parameters.
+
+- Issue #7316: The acquire() method of lock objects in the ``threading``
+ module now takes an optional timeout argument in seconds. Timeout support
+ relies on the system threading library, so as to avoid a semi-busy wait loop.
+
+- Issue #8383: pickle and pickletools use surrogatepass error handler when
+ encoding unicode as utf8 to support lone surrogates and stay compatible with
+ Python 2.x and 3.x.
+
+- Issue #7585: difflib context and unified diffs now place a tab between
+ filename and date, conforming to the 'standards' they were originally designed
+ to follow. This improves compatibility with patch tools.
+
+- Issue #7472: Fixed typo in email.encoders module; messages using ISO-2022
+ character sets will now consistently use a Content-Transfer-Encoding of 7bit
+ rather than sometimes being marked as 8bit.
+
+- Issue #8375: test_distutils now checks if the temporary directory are still
+ present before it cleans them.
+
+- Issue #8374: Update the internal alias table in the ``locale`` module to
+ cover recent locale changes and additions.
+
+- Issue #8321: Give access to OpenSSL version numbers from the `ssl` module,
+ using the new attributes `ssl.OPENSSL_VERSION`, `ssl.OPENSSL_VERSION_INFO` and
+ `ssl.OPENSSL_VERSION_NUMBER`.
+
+- Add functools.total_ordering() and functools.cmp_to_key().
+
+- Issue #8257: The Decimal construct now accepts a float instance directly,
+ converting that float to a Decimal of equal value:
+
+ >>> Decimal(1.1)
+ Decimal('1.100000000000000088817841970012523233890533447265625')
+
+- Issue #8294: The Fraction constructor now accepts Decimal and float instances
+ directly.
+
+- Issue #7279: Comparisons involving a Decimal signaling NaN now signal
+ InvalidOperation instead of returning False. (Comparisons involving a quiet
+ NaN are unchanged.) Also, Decimal quiet NaNs are now hashable; Decimal
+ signaling NaNs remain unhashable.
+
+- Issue #2531: Comparison operations between floats and Decimal instances now
+ return a result based on the numeric values of the operands; previously they
+ returned an arbitrary result based on the relative ordering of id(float) and
+ id(Decimal). See also issue #8188, which adds Decimal-to-Fraction
+ comparisons.
+
+- Added a subtract() method to collections.Counter().
+
+- Issue #8233: When run as a script, py_compile.py optionally takes a single
+ argument `-` which tells it to read files to compile from stdin. Each line is
+ read on demand and the named file is compiled immediately. (Original patch by
+ Piotr Ożarowski).
+
+- Backwards incompatible change: Unicode codepoints line tabulation (0x0B) and
+ form feed (0x0C) are now considered linebreaks, as specified in Unicode
+ Standard Annex #14. See issue #7643. http://www.unicode.org/reports/tr14/
+
+- Comparisons using one of <, <=, >, >= between a complex instance and a
+ Fractions instance now raise TypeError instead of returning True/False. This
+ makes Fraction <=> complex comparisons consistent with int <=> complex, float
+ <=> complex, and complex <=> complex comparisons.
+
+- Issue #8139: ossaudiodev didn't initialize its types properly, therefore some
+ methods (such as oss_mixer_device.fileno()) were not available. Initial patch
+ by Bertrand Janin.
+
+- Issue #8205: Remove the "Modules" directory from sys.path when Python is
+ running from the build directory (POSIX only).
+
+- Issue #7512: shutil.copystat() could raise an OSError when the filesystem
+ didn't support chflags() (for example ZFS under FreeBSD). The error is now
+ silenced.
+
+- Issue #7860: platform.uname now reports the correct 'machine' type when Python
+ is running in WOW64 mode on 64 bit Windows.
+
+- Issue #3890, #8222: Fix recv() and recv_into() on non-blocking SSL sockets.
+ Also, enable the SSL_MODE_AUTO_RETRY flag on SSL sockets, so that blocking
+ reads and writes are always retried by OpenSSL itself.
+
+- Issue #4282: Fix the main function of the profile module for a non-ASCII
+ script, open the file in binary mode and not in text mode with the default
+ (utf8) encoding.
+
+- Issue #8179: Fix macpath.realpath() on a non-existing path.
+
+- Issue #8024: Update the Unicode database to 5.2.
+
+- Issue #8168: py_compile now handles files with utf-8 BOMS.
+
+- ``tokenize.detect_encoding`` now returns ``'utf-8-sig'`` when a UTF-8 BOM is
+ detected.
+
+- Issue #6716/2: Backslash-replace error output in compilall.
+
+- Issue #4961: Inconsistent/wrong result of askyesno function in tkMessageBox
+ with Tcl/Tk-8.5.
+
+- Issue #8140: extend compileall to compile single files. Add -i option.
+
+- Issue #7356: ctypes.util: Make parsing of ldconfig output independent of the
+ locale.
+
+- The internals of the subprocess module on POSIX systems have been replaced by
+ an extension module (_posixsubprocess) so that the fork()+exec() can be done
+ safely without the possibility of deadlock in multithreaded applications.
+
+- subprocess.Popen now has restore_signals and start_new_session features. The
+ default of restore_signals=True is a new behavior compared to earlier Python
+ versions. This means that signals such as SIGPIPE are not ignored by default
+ in subprocesses launched by Python (Issue #1652).
+
+- Issue #6472: The xml.etree package is updated to ElementTree 1.3. The
+ cElementTree module is updated too.
+
+- Issue #7774: Set sys.executable to an empty string if argv[0] has been set to
+ an non existent program name and Python is unable to retrieve the real program
+ name.
+
+- Issue #7880: Fix sysconfig when the python executable is a symbolic link.
+
+- Issue #6509: fix re.sub to work properly when the pattern, the string, and the
+ replacement were all bytes. Patch by Antoine Pitrou.
+
+- The sqlite3 module was updated to pysqlite 2.6.0. This fixes several obscure
+ bugs and allows loading SQLite extensions from shared libraries.
+
+- Issue #1054943: Fix ``unicodedata.normalize('NFC', text)`` for the Public
+ Review Issue #29 (http://unicode.org/review/pr-29.html).
+
+- Issue #7494: fix a crash in _lsprof (cProfile) after clearing the profiler,
+ reset also the pointer to the current pointer context.
+
+- Issue #7232: Add support for the context manager protocol to the TarFile
+ class.
+
+- Issue #7250: Fix info leak of os.environ across multi-run uses of
+ wsgiref.handlers.CGIHandler.
+
+- Issue #1729305: Fix doctest to handle encode error with "backslashreplace".
+
+- Issue #691291: codecs.open() should not convert end of lines on reading and
+ writing.
+
+- Issue #7869: logging: improved diagnostic for format-time errors.
+
+- Issue #7868: logging: added loggerClass attribute to Manager.
+
+- logging: Implemented PEP 391.
+
+- Issue #1537721: Add a writeheader() method to csv.DictWriter.
+
+- Issue #7959: ctypes callback functions are now registered correctly with the
+ cycle garbage collector.
+
+- Issue #5801: removed spurious empty lines in wsgiref.
+
+- Issue #6666: fix bug in trace.py that applied the list of directories to be
+ ignored only to the first file. Noted by Bogdan Opanchuk.
+
+- Issue #7597: curses.use_env() can now be called before initscr(). Noted by
+ Kan-Ru Chen.
+
+- Issue #7310: fix the __repr__ of os.environ to show the environment variables.
+
+- Issue #7970: email.Generator.flatten now correctly flattens message/rfc822
+ messages parsed by email.Parser.HeaderParser.
+
+- Issue #7361: Importlib was not properly checking the number of bytes in
+ bytecode file when it was less then 8 bytes.
+
+- Issue #7633: In the decimal module, Context class methods (with the exception
+ of canonical and is_canonical) now accept instances of int and long wherever a
+ Decimal instance is accepted, and implicitly convert that argument to Decimal.
+ Previously only some arguments were converted.
+
+- Issue #7835: shelve should no longer produce mysterious warnings during
+ interpreter shutdown.
+
+- Issue #2746: Don't escape ampersands and angle brackets ("&", "<", ">") in XML
+ processing instructions and comments. These raw characters are allowed by the
+ XML specification, and are necessary when outputting e.g. PHP code in a
+ processing instruction. Patch by Neil Muller.
+
+- Issue #6233: ElementTree failed converting unicode characters to XML entities
+ when they could't be represented in the requested output encoding. Patch by
+ Jerry Chen.
+
+- Issue #6003: add an argument to ``zipfile.Zipfile.writestr`` to specify the
+ compression type.
+
+- Issue #4772: Raise a ValueError when an unknown Bluetooth protocol is
+ specified, rather than fall through to AF_PACKET (in the `socket` module).
+ Also, raise ValueError rather than TypeError when an unknown TIPC address type
+ is specified. Patch by Brian Curtin.
+
+- Issue #6939: Fix file I/O objects in the `io` module to keep the original file
+ position when calling `truncate()`. It would previously change the file
+ position to the given argument, which goes against the tradition of
+ ftruncate() and other truncation APIs. Patch by Pascal Chambon.
+
+- Issue #7610: Reworked implementation of the internal
+ ``zipfile.ZipExtFile`` class used to represent files stored inside an
+ archive. The new implementation is significantly faster and can be wrapped in
+ a ``io.BufferedReader`` object for more speedups. It also solves an
+ issue where interleaved calls to `read()` and `readline()` give wrong results.
+ Patch by Nir Aides.
+
+- Issue #6963: Added "maxtasksperchild" argument to multiprocessing.Pool,
+ allowing for a maximum number of tasks within the pool to be completed by the
+ worker before that worker is terminated, and a new one created to replace it.
+
+- Issue #7792: Registering non-classes to ABCs raised an obscure error.
+
+- Issue #7785: Don't accept bytes in FileIO.write().
+
+- Removed the functions 'verify' and 'vereq' from Lib/test/support.py.
+
+- Issue #7773: Fix an UnboundLocalError in platform.linux_distribution() when
+ the release file is empty.
+
+- Issue #7561: Fix crashes when using bytearray objects with the posix
+ module.
+
+- Issue #1670765: Prevent email.generator.Generator from re-wrapping headers in
+ multipart/signed MIME parts, which fixes one of the sources of invalid
+ modifications to such parts by Generator.
+
+- Issue #7703: Add support for the new buffer API to `binascii.a2bhqx`. Patch
+ by Florent Xicluna, along with some additional tests.
+
+- Issue #7701: Fix crash in binascii.b2a_uu() in debug mode when given a 1-byte
+ argument. Patch by Victor Stinner.
+
+- Issue #3299: Fix possible crash in the _sre module when given bad argument
+ values in debug mode. Patch by Victor Stinner.
+
+- Issue #2846: Add support for gzip.GzipFile reading zero-padded files. Patch
+ by Brian Curtin.
+
+- Issue #7681: Use floor division in appropiate places in the wave module.
+
+- Issue #5372: Drop the reuse of .o files in Distutils' ccompiler (since
+ Extension extra options may change the output without changing the .c
+ file). Initial patch by Collin Winter.
+
+- Issue #7617: Make sure distutils.unixccompiler.UnixCCompiler recognizes gcc
+ when it has a fully qualified configuration prefix. Initial patch by Arfrever.
+
+- Issue #7105: Make WeakKeyDictionary and WeakValueDictionary robust against the
+ destruction of weakref'ed objects while iterating.
+
+- Issue #7455: Fix possible crash in cPickle on invalid input. Patch by Victor
+ Stinner.
+
+- Issue #1628205: Socket file objects returned by socket.socket.makefile() now
+ properly handles EINTR within the read, readline, write & flush methods. The
+ socket.sendall() method now properly handles interrupted system calls.
+
+- Issue #7471: Improve the performance of GzipFile's buffering mechanism, and
+ make it implement the `io.BufferedIOBase` ABC to allow for further speedups by
+ wrapping it in an `io.BufferedReader`. Patch by Nir Aides.
+
+- Issue #3972: http.client.HTTPConnection now accepts an optional source_address
+ parameter to allow specifying where your connections come from.
+
+- socket.create_connection now accepts an optional source_address parameter.
+
+- Issue #5511: now zipfile.ZipFile can be used as a context manager. Initial
+ patch by Brian Curtin.
+
+- Issue #7556: Make sure Distutils' msvc9compile reads and writes the MSVC XML
+ Manifest file in text mode so string patterns can be used in regular
+ expressions.
+
+- Issue #7552: Removed line feed in the base64 Authorization header in the
+ Distutils upload command to avoid an error when PyPI reads it. This occurs on
+ long passwords. Initial patch by JP St. Pierre.
+
+- Issue #7231: urllib2 cannot handle https with proxy requiring auth. Patch by
+ Tatsuhiro Tsujikawa.
+
+- Issue #4757: `zlib.compress` and other methods in the zlib module now raise a
+ TypeError when given an `str` object (rather than a `bytes`-like object).
+ Patch by Victor Stinner and Florent Xicluna.
+
+- Issue #7349: Make methods of file objects in the io module accept None as an
+ argument where file-like objects (ie StringIO and BytesIO) accept them to mean
+ the same as passing no argument.
+
+- Issue #7357: tarfile no longer suppresses fatal extraction errors by default.
+
+- Issue #5949: added check for correct lineends in input from IMAP server in
+ imaplib.
+
+- Add count() and reverse() methods to collections.deque().
+
+- Fix variations of extending deques: d.extend(d) d.extendleft(d) d+=d
+
+- Issue #6986: Fix crash in the JSON C accelerator when called with the wrong
+ parameter types. Patch by Victor Stinner.
+
+- Issue #7457: added a read_pkg_file method to
+ distutils.dist.DistributionMetadata.
+
+- logging: Added optional `secure` parameter to SMTPHandler, to enable use of
+ TLS with authentication credentials.
+
+- Issue #1923: Fixed the removal of meaningful spaces when PKG-INFO is generated
+ in Distutils. Patch by Stephen Emslie.
+
+- Issue #4120: Drop reference to CRT from manifest when building extensions with
+ msvc9compiler.
+
+- Issue #7333: The `posix` module gains an `initgroups()` function providing
+ access to the initgroups(3) C library call on Unix systems which implement it.
+ Patch by Jean-Paul Calderone.
+
+- Issue #7408: Fixed distutils.tests.sdist so it doesn't check for group
+ ownership when the group is not forced, because the group may be different
+ from the user's group and inherit from its container when the test is run.
+
+- Issue #4486: When an exception has an explicit cause, do not print its
+ implicit context too. This affects the `traceback` module as well as built-in
+ exception printing.
+
+- Issue #1515: Enable use of deepcopy() with instance methods. Patch by Robert
+ Collins.
+
+- Issue #7403: logging: Fixed possible race condition in lock creation.
+
+- Issue #6845: Add restart support for binary upload in ftplib. The
+ `storbinary()` method of FTP and FTP_TLS objects gains an optional `rest`
+ argument. Patch by Pablo Mouzo.
+
+- Issue #5788: `datetime.timedelta` objects get a new `total_seconds()` method
+ returning the total number of seconds in the duration. Patch by Brian
+ Quinlan.
+
+- Issue #7133: SSL objects now support the new buffer API.
+
+- Issue #1488943: difflib.Differ() doesn't always add hints for tab characters.
+
+- Issue #6123: tarfile now opens empty archives correctly and consistently
+ raises ReadError on empty files.
+
+- Issue #7354: distutils.tests.test_msvc9compiler - dragfullwindows can be 2.
+
+- Issue #5037: Proxy the __bytes__ special method instead to __bytes__ instead
+ of __str__.
+
+- Issue #7341: Close the internal file object in the TarFile constructor in case
+ of an error.
+
+- Issue #7293: distutils.test_msvc9compiler is fixed to work on any fresh
+ Windows box. Help provided by David Bolen.
+
+- Issue #2054: ftplib now provides an FTP_TLS class to do secure FTP using TLS
+ or SSL. Patch by Giampaolo Rodola'.
+
+- Issue #7328: pydoc no longer corrupts sys.path when run with the '-m' switch.
+
+- Issue #4969: The mimetypes module now reads the MIME database from the
+ registry under Windows. Patch by Gabriel Genellina.
+
+- Issue #6816: runpy now provides a run_path function that allows Python code to
+ execute file paths that refer to source or compiled Python files as well as
+ zipfiles, directories and other valid sys.path entries that contain a
+ __main__.py file. This allows applications that run other Python scripts to
+ support the same flexibility as the CPython command line itself.
+
+- Issue #7318: multiprocessing now uses a timeout when it fails to establish a
+ connection with another process, rather than looping endlessly. The default
+ timeout is 20 seconds, which should be amply sufficient for local connections.
+
+- Issue #7197: Allow unittest.TextTestRunner objects to be pickled and
+ unpickled. This fixes crashes under Windows when trying to run
+ test_multiprocessing in verbose mode.
+
+- Issue #7893: ``unittest.TextTestResult`` is made public and a ``resultclass``
+ argument added to the TextTestRunner constructor allowing a different result
+ class to be used without having to subclass.
+
+- Issue #7588: ``unittest.TextTestResult.getDescription`` now includes the test
+ name in failure reports even if the test has a docstring.
+
+- Issue #3001: Add a C implementation of recursive locks which is used by
+ default when instantiating a `threading.RLock` object. This makes recursive
+ locks as fast as regular non-recursive locks (previously, they were slower by
+ 10x to 15x).
+
+- Issue #7282: Fix a memory leak when an RLock was used in a thread other than
+ those started through `threading.Thread` (for example, using
+ `_thread.start_new_thread()`).
+
+- Issue #7187: Importlib would not silence the IOError raised when trying to
+ write new bytecode when it was made read-only.
+
+- Issue #7264: Fix a possible deadlock when deallocating thread-local objects
+ which are part of a reference cycle.
+
+- Issue #7211: Allow 64-bit values for the `ident` and `data` fields of kevent
+ objects on 64-bit systems. Patch by Michael Broghton.
+
+- Issue #6896: mailbox.Maildir now invalidates its internal cache each time a
+ modification is done through it. This fixes inconsistencies and test failures
+ on systems with slightly bogus mtime behaviour.
+
+- Issue #7246 & Issue #7208: getpass now properly flushes input before reading
+ from stdin so that existing input does not confuse it and lead to incorrect
+ entry or an IOError. It also properly flushes it afterwards to avoid the
+ terminal echoing the input afterwards on OSes such as Solaris.
+
+- Issue #7233: Fix a number of two-argument Decimal methods to make sure that
+ they accept an int or long as the second argument. Also fix buggy handling of
+ large arguments (those with coefficient longer than the current precision) in
+ shift and rotate.
+
+- Issue #4750: Store the basename of the original filename in the gzip FNAME
+ header as required by RFC 1952.
+
+- Issue #1180: Added a new global option to ignore ~/.pydistutils.cfg in
+ Distutils.
+
+- Issue #7218: Fix test_site for win32, the directory comparison was done with
+ an uppercase.
+
+- Issue #7205: Fix a possible deadlock when using a BZ2File object from
+ several threads at once.
+
+- Issue #7077: logging: SysLogHandler now treats Unicode as per RFC 5424.
+
+- Issue #7099: Decimal.is_normal now returns True for numbers with exponent
+ larger than emax.
+
+- Issue #7080: locale.strxfrm() raises a MemoryError on 64-bit non-Windows
+ platforms, and assorted locale fixes by Derk Drukker.
+
+- Issue #5833: Fix extra space character in readline completion with the GNU
+ readline library version 6.0.
+
+- Issue #6894: Fixed the issue urllib2 doesn't respect "no_proxy" environment.
+
+- Issue #7086: Added TCP support to SysLogHandler, and tidied up some
+ anachronisms in the code which were a relic of 1.5.2 compatibility.
+
+- Issue #7082: When falling back to the MIME 'name' parameter, the correct place
+ to look for it is the Content-Type header.
+
+- Make tokenize.detect_coding() normalize utf-8 and iso-8859-1 variants like the
+ builtin tokenizer.
+
+- Issue #7048: Force Decimal.logb to round its result when that result is too
+ large to fit in the current precision.
+
+- Issue #6236, #6348: Fix various failures in the I/O library under AIX and
+ other platforms, when using a non-gcc compiler. Patch by Derk Drukker.
+
+- Issue #4606: Passing 'None' if ctypes argtype is set to POINTER(...) does now
+ always result in NULL.
+
+- Issue #5042: Structure sub-subclass does now initialize correctly with base
+ class positional arguments.
+
+- Issue #6882: Import uuid creates zombies processes.
+
+- Issue #6635: Fix profiler printing usage message.
+
+- Issue #6856: Add a filter keyword argument to TarFile.add().
+
+- Issue #6888: pdb's alias command was broken when no arguments were given.
+
+- Issue #6857: Default format() alignment should be '>' for Decimal instances.
+
+- Issue #6795: int(Decimal('nan')) now raises ValueError instead of returning
+ NaN or raising InvalidContext. Also, fix infinite recursion in
+ long(Decimal('nan')).
+
+- Issue #6850: Fix bug in Decimal._parse_format_specifier for formats with no
+ type specifier.
+
+- Issue #6239: ctypes.c_char_p return value must return bytes.
+
+- Issue #6838: Use a list to accumulate the value instead of repeatedly
+ concatenating strings in http.client's HTTPResponse._read_chunked providing a
+ significant speed increase when downloading large files servend with a
+ Transfer-Encoding of 'chunked'.
+
+- Trying to import a submodule from a module that is not a package, ImportError
+ should be raised, not AttributeError.
+
+- When the globals past to importlib.__import__() has __package__ set to None,
+ fall back to computing what __package__ should be instead of giving up.
+
+- Raise a TypeError when the name of a module to be imported for
+ importlib.__import__ is not a string (was raising an AttributeError before).
+
+- Allow the fromlist passed into importlib.__import__ to be any iterable.
+
+- Have importlib raise ImportError if None is found in sys.modules.
+
+- Issue #6054: Do not normalize stored pathnames in tarfile.
+
+- Issue #6794: Fix Decimal.compare_total and Decimal.compare_total_mag: NaN
+ payloads are now ordered by integer value rather than lexicographically.
+
+- Issue #1356969: Add missing info methods in tix.HList.
+
+- Issue #1522587: New constants and methods for the tix.Grid widget.
+
+- Issue #1250469: Fix the return value of tix.PanedWindow.panes.
+
+- Issue #1119673: Do not override tkinter.Text methods when creating a
+ ScrolledText.
+
+- Issue #6665: Fix fnmatch to properly match filenames with newlines in them.
+
+- Issue #1135: Add the XView and YView mix-ins to avoid duplicating the xview*
+ and yview* methods.
+
+- Issue #6629: Fix a data corruption issue in the new I/O library, which could
+ occur when writing to a BufferedRandom object (e.g. a file opened in "rb+" or
+ "wb+" mode) after having buffered a certain amount of data for reading. This
+ bug was not present in the pure Python implementation.
+
+- Issue #6622: Fix "local variable 'secret' referenced before assignment" bug in
+ POP3.apop.
+
+- Issue #2715: Remove remnants of Carbon.File from binhex module.
+
+- Issue #6595: The Decimal constructor now allows arbitrary Unicode decimal
+ digits in input, as recommended by the standard. Previously it was restricted
+ to accepting [0-9].
+
+- Issue #6106: telnetlib.Telnet.process_rawq doesn't handle default WILL/WONT
+ DO/DONT correctly.
+
+- Issue #1424152: Fix for http.client, urllib.request to support SSL while
+ working through proxy. Original patch by Christopher Li, changes made by
+ Senthil Kumaran.
+
+- Add importlib.abc.ExecutionLoader to represent the PEP 302 protocol for
+ loaders that allow for modules to be executed. Both importlib.abc.PyLoader and
+ PyPycLoader inherit from this class and provide implementations in relation to
+ other methods required by the ABCs.
+
+- importlib.abc.PyLoader did not inherit from importlib.abc.ResourceLoader like
+ the documentation said it did even though the code in PyLoader relied on the
+ abstract method required by ResourceLoader.
+
+- Issue #6431: Make Fraction type return NotImplemented when it doesn't know how
+ to handle a comparison without loss of precision. Also add correct handling
+ of infinities and nans for comparisons with float.
+
+- Issue #6415: Fixed warnings.warn segfault on bad formatted string.
+
+- Issue #6358: The exit status of a command started with os.popen() was reported
+ differently than it did with python 2.x.
+
+- Issue #6323: The pdb debugger did not exit when running a script with a syntax
+ error.
+
+- Issue #3392: The subprocess communicate() method no longer fails in select()
+ when file descriptors are large; communicate() now uses poll() when possible.
+
+- Issue #6369: Fix an RLE decompression bug in the binhex module.
+
+- Issue #6344: Fixed a crash of mmap.read() when passed a negative argument.
+
+- The deprecated function string.maketrans has been removed.
+
+- Issue #4005: Fixed a crash of pydoc when there was a zip file present in
+ sys.path.
+
+- Issue #6218: io.StringIO and io.BytesIO instances are now picklable.
+
+- The os.get_exec_path() function to return the list of directories that will be
+ searched for an executable when launching a subprocess was added.
+
+- Issue #7481: When a threading.Thread failed to start it would leave the
+ instance stuck in initial state and present in threading.enumerate().
+
+- Issue #1068268: The subprocess module now handles EINTR in internal os.waitpid
+ and os.read system calls where appropriate.
+
+- Issue #6729: Added ctypes.c_ssize_t to represent ssize_t.
+
+- Issue #6247: The argparse module has been added to the standard library.
+
+- Issue #8235: _socket: Add the constant ``SO_SETFIB``. SO_SETFIB is a socket
+ option available on FreeBSD 7.1 and newer.
+
+- Issue #9315: Fix for the trace module to record correct class name
+ for tracing methods.
+
+Extension Modules
+-----------------
+
+- Issue #9959: Tweak formula used for computing math.log of an integer,
+ making it marginally more accurate for exact powers of 2.
+
+- Issue #9422: Fix memory leak when re-initializing a struct.Struct object.
+
+- Issue #7900: The getgroups(2) system call on MacOSX behaves rather oddly
+ compared to other unix systems. In particular, os.getgroups() does not reflect
+ any changes made using os.setgroups() but basicly always returns the same
+ information as the id command. os.getgroups() can now return more than 16
+ groups on MacOSX.
+
+- Issue #6095: Make directory argument to os.listdir optional.
+
+- Issue #9277: Fix bug in struct.pack for bools in standard mode (e.g.,
+ struct.pack('>?')): if conversion to bool raised an exception then that
+ exception wasn't properly propagated on machines where char is unsigned.
+
+- Issue #5180: Fixed a bug that prevented loading 2.x pickles in 3.x python when
+ they contain instances of old-style classes.
+
+- Issue #9165: Add new functions math.isfinite and cmath.isfinite, to accompany
+ existing isinf and isnan functions.
+
+- Issue #1578269: Implement os.symlink for Windows 6.0+. Patch by Jason
+ R. Coombs.
+
+- In struct.pack, correctly propogate exceptions from computing the truth of an
+ object in the '?' format.
+
+- Issue #9000: datetime.timezone objects now have eval-friendly repr.
+
+- In the math module, correctly lookup __trunc__, __ceil__, and __floor__ as
+ special methods.
+
+- Issue #9005: Prevent utctimetuple() from producing year 0 or year 10,000.
+ Prior to this change, timezone adjustment in utctimetuple() could produce
+ tm_year value of 0 or 10,000. Now an OverflowError is raised in these edge
+ cases.
+
+- Issue #6641: The ``datetime.strptime`` method now supports the ``%z``
+ directive. When the ``%z`` directive is present in the format string, an
+ aware ``datetime`` object is returned with ``tzinfo`` bound to a
+ ``datetime.timezone`` instance constructed from the parsed offset. If both
+ ``%z`` and ``%Z`` are present, the data in ``%Z`` field is used for timezone
+ name, but ``%Z`` data without ``%z`` is discarded.
+
+- Issue #5094: The ``datetime`` module now has a simple concrete class
+ implementing ``datetime.tzinfo`` interface. Instances of the new class,
+ ``datetime.timezone``, return fixed name and UTC offset from their
+ ``tzname(dt)`` and ``utcoffset(dt)`` methods. The ``dst(dt)`` method always
+ returns ``None``. A class attribute, ``utc`` contains an instance
+ representing the UTC timezone. Original patch by Rafe Kaplan.
+
+- Issue #8973: Add __all__ to struct module; this ensures that help(struct)
+ includes documentation for the struct.Struct class.
+
+- Issue #3129: Trailing digits in struct format string are no longer ignored.
+ For example, "1" or "ilib123" are now invalid formats and cause
+ ``struct.error`` to be raised. Patch by Caleb Deveraux.
+
+- Issue #7384: If the system readline library is linked against ncurses, the
+ curses module must be linked against ncurses as well. Otherwise it is not safe
+ to load both the readline and curses modules in an application.
+
+- Issue #2810: Fix cases where the Windows registry API returns ERROR_MORE_DATA,
+ requiring a re-try in order to get the complete result.
+
+- Issue #8692: Optimize math.factorial: replace the previous naive algorithm
+ with an improved 'binary-split' algorithm that uses fewer multiplications and
+ allows many of the multiplications to be performed using plain C integer
+ arithmetic instead of PyLong arithmetic. Also uses a lookup table for small
+ arguments.
+
+- Issue #8674: Fixed a number of incorrect or undefined-behaviour-inducing
+ overflow checks in the audioop module.
+
+- Issue #8644: The accuracy of td.total_seconds() has been improved (by
+ calculating with integer arithmetic instead of float arithmetic internally):
+ the result is now always correctly rounded, and is equivalent to ``td /
+ timedelta(seconds=1)``.
+
+- Issue #2706: Allow division of a timedelta by another timedelta: timedelta /
+ timedelta, timedelta % timedelta, timedelta // timedelta and divmod(timedelta,
+ timedelta) are all supported.
+
+- Issue #8314: Fix unsigned long long bug in libffi on Sparc v8.
+
+- Issue #8300: When passing a non-integer argument to struct.pack with any
+ integer format code, struct.pack first attempts to convert the non-integer
+ using its __index__ method. If that method is non-existent or raises
+ TypeError it goes on to try the __int__ method, as described below.
+
+- Issue #8142: Update libffi to the 3.0.9 release.
+
+- Issue #6949: Allow the _dbm extension to be built with db 4.8.x.
+
+- Issue #6544: Fix a reference leak in the kqueue implementation's error
+ handling.
+
+- Stop providing crtassem.h symbols when compiling with Visual Studio 2010, as
+ msvcr100.dll is not a platform assembly anymore.
+
+- Issue #6508: Add posix.{getresuid,getresgid,setresuid,setresgid}.
+
+- Issue #7078: Set struct.__doc__ from _struct.__doc__.
+
+- Issue #3366: Add erf, erfc, expm1, gamma, lgamma functions to math module.
+
+- Issue #6877: It is now possible to link the readline extension to the libedit
+ readline emulation on OSX 10.5 or later.
+
+- Issue #6848: Fix curses module build failure on OS X 10.6.
+
+- Fix a segfault that could be triggered by expat with specially formed input.
+
+- Issue #6561: '\d' in a regex now matches only characters with Unicode category
+ 'Nd' (Number, Decimal Digit). Previously it also matched characters with
+ category 'No'.
+
+- Issue #4509: Array objects are no longer modified after an operation failing
+ due to the resize restriction in-place when the object has exported buffers.
+
+- Issue #2389: Array objects are now pickled in a portable manner.
+
+- Expat: Fix DoS via XML document with malformed UTF-8 sequences
+ (CVE_2009_3560).
+
+- Issue #7242: On Solaris 9 and earlier calling os.fork() from within a thread
+ could raise an incorrect RuntimeError about not holding the import lock. The
+ import lock is now reinitialized after fork.
+
+- Issue #7999: os.setreuid() and os.setregid() would refuse to accept a -1
+ parameter on some platforms such as OS X.
+
+- Build the ossaudio extension on GNU/kFreeBSD.
+
+- Issue #7347: winreg: Add CreateKeyEx and DeleteKeyEx, as well as fix a bug in
+ the return value of QueryReflectionKey.
+
+- Issue #7567: PyCurses_setupterm: Don't call ``setupterm`` twice.
+
+Build
+-----
+
+- Use OpenSSL 1.0.0a on Windows.
+
+- Issue #9280: Make sharedinstall depend on sharedmods.
+
+- Issue #9189: Make a user-specified CFLAGS, CPPFLAGS, or LDFLAGS setting
+ override the configure and makefile defaults, without deleting options the
+ user didn't intend to override. Developers should no longer need to specify
+ OPT or EXTRA_CFLAGS, although those variables are still present for
+ backward-compatibility.
+
+- Issue #8854: Fix finding Visual Studio 2008 on Windows x64.
+
+- Issue #1759169, #8864: Drop _XOPEN_SOURCE on Solaris, define it for
+ multiprocessing only.
+
+- Issue #8625: Turn off optimization in --with-pydebug builds with gcc.
+ (Optimization was unintentionally turned on in gcc --with-pydebug builds as a
+ result of the issue #1628484 fix, combined with autoconf's strange choice of
+ default CFLAGS produced by AC_PROG_CC for gcc.)
+
+- Issue #3646: It is now easily possible to install a Python framework into your
+ home directory on MacOSX, see Mac/README for more information.
+
+- Issue #3928: os.mknod() now available in Solaris, also.
+
+- Issue #3326: Build Python without -fno-strict-aliasing when the gcc does not
+ give false warnings.
+
+- Issue #1628484: The Makefile doesn't ignore the CFLAGS environment variable
+ anymore. It also forwards the LDFLAGS settings to the linker when building a
+ shared library.
+
+- Issue #6716: Quote -x arguments of compileall in MSI installer. Exclude 2to3
+ tests from compileall.
+
+- Issue #3920, #7903: Define _BSD_SOURCE on OpenBSD 4.4 through 4.9.
+
+- Issue #7632: When Py_USING_MEMORY_DEBUGGER is defined, disable the private
+ memory allocation scheme in dtoa.c and use PyMem_Malloc and PyMem_Free
+ instead. Also disable caching of powers of 5.
+
+- Issue #6491: Allow --with-dbmliborder to specify that no dbms will be built.
+
+- Issue #6943: Use pkg-config to find the libffi headers when the
+ --with-system-ffi flag is used.
+
+- Issue #7609: Add a --with-system-expat option that causes the system's expat
+ library to be used for the pyexpat module instead of the one included with
+ Python.
+
+- Issue #7589: Only build the nis module when the correct header files are
+ found.
+
+- Switch to OpenSSL 0.9.8l and sqlite 3.6.21 on Windows.
+
+- Issue #5792: Extend the short float repr support to x86 systems using
+ icc or suncc.
+
+- Issue #6603: Change READ_TIMESTAMP macro in ceval.c so that it compiles
+ correctly under gcc on x86-64. This fixes a reported problem with the
+ --with-tsc build on x86-64.
+
+- Issue #6802: Fix build issues on MacOSX 10.6.
+
+- Issue #6244: Allow detect_tkinter to look for Tcl/Tk 8.6.
+
+- Issue #4601: 'make install' did not set the appropriate permissions on
+ directories.
+
+- Issue #5390: Add uninstall icon independent of whether file extensions are
+ installed.
+
+- Issue #7541: When using ``python-config`` with a framework install the
+ compiler might use the wrong library.
+
+- python-config now supports multiple options on the same command line.
+
+- Issue #8509: Fix quoting in help strings and code snippets in configure.in.
+
+- Issue #8510: Update to autoconf2.65.
+
+Documentation
+-------------
+
+- Issue #9817: Add expat COPYING file; add expat, libffi and expat licenses
+ to Doc/license.rst.
+
+- Issue #9524: Document that two CTRL* signals are meant for use only
+ with os.kill.
+
+- Issue #9255: Document that the 'test' package is meant for internal Python use
+ only.
+
+- A small WSGI server was added as Tools/scripts/serve.py, and is used to
+ implement a local documentation server via 'make serve' in the doc directory.
+
+- Updating `Using Python` documentation to include description of CPython's -J
+ and -X options.
+
+- Document that importing a module that has None in sys.modules triggers an
+ ImportError.
+
+- Issue #6556: Fixed the Distutils configuration files location explanation for
+ Windows.
+
+- Update python manual page (options -B, -O0, -s, environment variables
+ PYTHONDONTWRITEBYTECODE, PYTHONNOUSERSITE).
+
+- Issue #8909: Added the size of the bitmap used in the installer created by
+ distutils' bdist_wininst. Patch by Anatoly Techtonik.
+
+Tests
+-----
+
+- Issue #9251: test_threaded_import didn't fail when run through regrtest if the
+ import lock was disabled.
+
+- Issue #8605: Skip test_gdb if Python is compiled with optimizations.
+
+- Issue #7449: Skip test_socketserver if threading support is disabled.
+
+- Issue #8672: Add a zlib test ensuring that an incomplete stream can be handled
+ by a decompressor object without errors (it returns incomplete uncompressed
+ data).
+
+- Issue #8533: regrtest uses backslashreplace error handler for stdout to avoid
+ UnicodeEncodeError (write non-ASCII character to stdout using ASCII encoding).
+
+- Issue #8576: Remove use of find_unused_port() in test_smtplib and
+ test_multiprocessing. Patch by Paul Moore.
+
+- Issue #7449: Fix many tests to support Python compiled without thread
+ support. Patches written by Jerry Seutter.
+
+- Issue #8108: test_ftplib's non-blocking SSL server now has proper handling of
+ SSL shutdowns.
+
+- Issues #8279, #8330, #8437, #8480, #8495: Fix test_gdb failures, patch written
+ by Dave Malcolm.
+
+- Issue #3864: Skip three test_signal tests on freebsd6 because they fail if any
+ thread was previously started, most likely due to a platform bug.
+
+- Issue #8193: Fix test_zlib failure with zlib 1.2.4.
+
+- Issue #8248: Add some tests for the bool type. Patch by Gregory Nofi.
+
+- Issue #8263: Now regrtest.py will report a failure if it receives a
+ KeyboardInterrupt (SIGINT).
+
+- Issue #8180 and #8207: Fix test_pep277 on OS X and add more tests for special
+ Unicode normalization cases.
+
+- Issue #7783: test.support.open_urlresource invalidates the outdated files from
+ the local cache.
+
+- Issue #7849: Now the utility ``check_warnings`` verifies if the warnings are
+ effectively raised.
+
+- The four path modules (genericpath, macpath, ntpath, posixpath) share a common
+ TestCase for some tests: test_genericpath.CommonTest.
+
+- Print platform information when running the whole test suite, or using the
+ --verbose flag.
+
+- Issue #767675: enable test_pep277 on POSIX platforms with Unicode-friendly
+ filesystem encoding.
+
+- Issue #6292: for the moment at least, the test suite runs cleanly if python is
+ run with the -OO flag. Tests requiring docstrings are skipped.
+
+- Issue #7712: test.support gained a new `temp_cwd` context manager which is now
+ also used by regrtest to run all the tests in a temporary directory. The
+ original CWD is saved in `support.SAVEDCWD`. Thanks to Florent Xicluna who
+ helped with the patch.
+
+- Issue #7924: Fix an intermittent 'XXX undetected error' failure in test_capi
+ (only seen so far on platforms where the curses module wasn't built), due to
+ an uncleared exception.
+
+- Issue #7728: test_timeout was changed to use support.bind_port instead of a
+ hard coded port.
+
+- Issue #7376: Instead of running a self-test (which was failing) when called
+ with no arguments, doctest.py now gives a usage message.
+
+- Issue #7396: fix regrtest -s, which was broken by the -j enhancement.
+
+- Issue #7498: test_multiprocessing now uses test.support.find_unused_port
+ instead of a hardcoded port number in test_rapid_restart.
+
+- Issue #7431: Use TESTFN in test_linecache instead of trying to create a file
+ in the Lib/test directory, which might be read-only for the user running the
+ tests.
+
+- Issue #7324: Add a sanity check to regrtest argument parsing to catch the case
+ of an option with no handler.
+
+- Issue #7312: Add a -F flag to run the selected tests in a loop until a test
+ fails. Can be combined with -j.
+
+- Issue #6551: test_zipimport could import and then destroy some modules of the
+ encodings package, which would make other tests fail further down the road
+ because the internally cached encoders and decoders would point to empty
+ global variables.
+
+- Issue #7295: Do not use a hardcoded file name in test_tarfile.
+
+- Issue #7270: Add some dedicated unit tests for multi-thread synchronization
+ primitives such as Lock, RLock, Condition, Event and Semaphore.
+
+- Issue #7248 (part 2): Use a unique temporary directory for importlib source
+ tests instead of tempfile.tempdir. This prevents the tests from sharing state
+ between concurrent executions on the same system.
+
+- Issue #7248: In importlib.test.source.util a try/finally block did not make
+ sure that some referenced objects actually were created in the block before
+ calling methods on the object.
+
+- Issue #7222: Make thread "reaping" more reliable so that reference
+ leak-chasing test runs give sensible results. The previous method of reaping
+ threads could return successfully while some Thread objects were still
+ referenced. This also introduces a new private function:
+ ``_thread._count()``.
+
+- Issue #7151: Fixed regrtest -j so that output to stderr from a test no longer
+ runs the risk of causing the worker thread to fail.
+
+- Issue #7055: test___all__ now greedily detects all modules which have an
+ __all__ attribute, rather than using a hardcoded and incomplete list.
+
+- Issue #7058: Added save/restore for things like sys.argv and cwd to
+ runtest_inner in regrtest, with warnings if the called test modifies them, and
+ a new section in the summary report at the end.
+
+- Issue #7042: Fix test_signal (test_itimer_virtual) failure on OS X 10.6.
+
+- Fixed tests in importlib.test.source.test_abc_loader that were masking the
+ proper exceptions that should be raised for missing or improper code object
+ bytecode.
+
+- Removed importlib's custom test discovery code and switched to
+ unittest.TestLoader.discover().
+
+Tools/Demos
+-----------
+
+- Issue #5464, #8974: Implement plural forms in msgfmt.py.
+
+- iobench (a file I/O benchmark) and ccbench (a concurrency benchmark) were
+ added to the `Tools/` directory. They were previously living in the sandbox.
+
+
+What's New in Python 3.1?
+=========================
+
+*Release date: 27-June-2009*
+
+Core and Builtins
+-----------------
+
+- Issue #6334: Fix bug in range length calculation for ranges with
+ large arguments.
+
+- Issue #6329: Fixed iteration for memoryview objects (it was being blocked
+ because it wasn't recognized as a sequence).
+
+Library
+-------
+
+- Issue #6126: Fixed pdb command-line usage.
+
+- Issue #6314: logging: performs extra checks on the "level" argument.
+
+- Issue #6274: Fixed possible file descriptors leak in subprocess.py
+
+- Accessing io.StringIO.buffer now raises an AttributeError instead of
+ io.UnsupportedOperation.
+
+- Issue #6271: mmap tried to close invalid file handle (-1) when anonymous.
+ (On Unix)
+
+- Issue #1202: zipfile module would cause a struct.error when attempting to
+ store files with a CRC32 > 2**31-1.
+
+Extension Modules
+-----------------
+
+- Issue #5590: Remove unused global variable in pyexpat extension.
+
+
+What's New in Python 3.1 Release Candidate 2?
+=============================================
+
+*Release date: 13-June-2009*
+
+Core and Builtins
+-----------------
+
+- Fixed SystemError triggered by "range([], 1, -1)".
+
+- Issue #5924: On Windows, a large PYTHONPATH environment variable
+ (more than 255 characters) would be completely ignored.
+
+- Issue #4547: When debugging a very large function, it was not always
+ possible to update the lineno attribute of the current frame.
+
+- Issue #5330: C functions called with keyword arguments were not reported by
+ the various profiling modules (profile, cProfile). Patch by Hagen Fürstenau.
+
+Library
+-------
+
+- Issue #6438: Fixed distutils.cygwinccompiler.get_versions : the regular
+ expression string pattern was trying to match against a bytes returned by
+ Popen. Tested under win32 to build the py-postgresql project.
+
+- Issue #6258: Support AMD64 in bdist_msi.
+
+- Issue #6195: fixed doctest to no longer try to read 'source' data from
+ binary files.
+
+- Issue #5262: Fixed bug in next rollover time computation in
+ TimedRotatingFileHandler.
+
+- Issue #6217: The C implementation of io.TextIOWrapper didn't include the
+ errors property. Additionally, the errors and encoding properties of StringIO
+ are always None now.
+
+- Issue #6137: The pickle module now translates module names when loading
+ or dumping pickles with a 2.x-compatible protocol, in order to make data
+ sharing and migration easier. This behaviour can be disabled using the
+ new `fix_imports` optional argument.
+
+- Removed the ipaddr module.
+
+- Issue #3613: base64.{encode,decode}string are now called
+ base64.{encode,decode}bytes which reflects what type they accept and return.
+ The old names are still there as deprecated aliases.
+
+- Issue #5767: Remove sgmlop support from xmlrpc.client.
+
+- Issue #6150: Fix test_unicode on wide-unicode builds.
+
+- Issue #6149: Fix initialization of WeakValueDictionary objects from non-empty
+ parameters.
+
+Windows
+-------
+
+- Issue #6221: Delete test registry key before running the test.
+
+- Issue #6158: Package Sine-1000Hz-300ms.aif in MSI file.
+
+C-API
+-----
+
+- Issue #5735: Python compiled with --with-pydebug should throw an
+ ImportError when trying to import modules compiled without
+ --with-pydebug, and vice-versa.
+
+
+Build
+-----
+
+- Issue #6154: Make sure the intl library is added to LIBS if needed. Also
+ added LIBS to OS X framework builds.
+
+- Issue #5809: Specifying both --enable-framework and --enable-shared is
+ an error. Configure now explicity tells you about this.
+
+
+
+What's New in Python 3.1 release candidate 1?
+=============================================
+
+*Release date: 2009-05-30*
+
+Core and Builtins
+-----------------
+
+- Issue #6097: Escape UTF-8 surrogates resulting from mbstocs conversion
+ of the command line.
+
+- Issue #6012: Add cleanup support to O& argument parsing.
+
+- Issue #6089: Fixed str.format with certain invalid field specifiers
+ that would raise SystemError.
+
+- Issue #5982: staticmethod and classmethod now expose the wrapped
+ function with __func__.
+
+- Added support for multiple context managers in the same with-statement.
+ Deprecated contextlib.nested() which is no longer needed.
+
+- Issue #5829: complex("1e500") no longer raises OverflowError. This
+ makes it consistent with float("1e500") and interpretation of real
+ and imaginary literals.
+
+- Issue #3527: Removed Py_WIN_WIDE_FILENAMES which is not used any more.
+
+- Issue #5994: the marshal module now has docstrings.
+
+- Issue #5981: Fix three minor inf/nan issues in float.fromhex:
+ (1) inf and nan strings with trailing whitespace were incorrectly
+ rejected; (2) parsing of strings representing infinities and nans
+ was locale aware; and (3) the interpretation of fromhex('-nan')
+ didn't match that of float('-nan').
+
+Library
+-------
+
+- Issue #4859: Implement PEP 383 for pwd, spwd, and grp.
+
+- smtplib 'login' and 'cram-md5' login are also fixed (see Issue #5259).
+
+- Issue #6121: pydoc now ignores leading and trailing spaces in the
+ argument to the 'help' function.
+
+- Issue #6118: urllib.parse.quote_plus ignored the encoding and errors
+ arguments for strings with a space in them.
+
+- collections.namedtuple() was not working with the following field
+ names: cls, self, tuple, itemgetter, and property.
+
+- In unittest, using a skipping decorator on a class is now equivalent to
+ skipping every test on the class. The ClassTestSuite class has been removed.
+
+- Issue #6050: Don't fail extracting a directory from a zipfile if
+ the directory already exists.
+
+- Issue #1309352: fcntl now converts its third arguments to a C `long` rather
+ than an int, which makes some operations possible under 64-bit Linux (e.g.
+ DN_MULTISHOT with F_NOTIFY).
+
+- Issue #5761: Add the name of the underlying file to the repr() of various
+ IO objects.
+
+- Issue #5259: smtplib plain auth login no longer gives a traceback. Fix
+ by Musashi Tamura, tests by Marcin Bachry.
+
+- Issue #1983: Fix functions taking or returning a process identifier to use
+ the dedicated C type ``pid_t`` instead of a C ``int``. Some platforms have
+ a process identifier type wider than the standard C integer type.
+
+- Issue #4066: smtplib.SMTP_SSL._get_socket now correctly returns the socket.
+ Patch by Farhan Ahmad, test by Marcin Bachry.
+
+- Issue #2116: Weak references and weak dictionaries now support copy()ing and
+ deepcopy()ing.
+
+- Issue #1655: Make imaplib IPv6-capable. Patch by Derek Morr.
+
+- Issue #5918: Fix a crash in the parser module.
+
+- Issue #1664: Make nntplib IPv6-capable. Patch by Derek Morr.
+
+- Issue #5006: Better handling of unicode byte-order marks (BOM) in the io
+ library. This means, for example, that opening an UTF-16 text file in
+ append mode doesn't add a BOM at the end of the file if the file isn't
+ empty.
+
+- Issue #4050: inspect.findsource/getsource now raise an IOError if the 'source'
+ file is a binary. Patch by Brodie Rao, tests by Daniel Diniz. This fix
+ corrects a pydoc regression.
+
+- Issue #5955: aifc's close method did not close the file it wrapped,
+ now it does. This also means getfp method now returns the real fp.
+
+Installation
+------------
+
+- Issue #6047: fullinstall has been removed because Python 3's executable will
+ now be known as python3.
+
+- Lib/smtpd.py is no longer installed as a script.
+
+Extension Modules
+-----------------
+
+- Issue #3061: Use wcsftime for time.strftime where available.
+
+- Issue #4873: Fix resource leaks in error cases of pwd and grp.
+
+- Issue #6093: Fix off-by-one error in locale.strxfrm.
+
+- The _functools and _locale modules are now built into the libpython shared
+ library instead of as extension modules.
+
+Build
+-----
+
+- Issue #3585: Add pkg-config support. It creates a python-2.7.pc file
+ and a python3.pc symlink in the $(LIBDIR)/pkgconfig directory. Patch by
+ Clinton Roy.
+
+Tests
+-----
+
+- Issue #5442: Tests for importlib were not properly skipping case-sensitivity
+ tests on darwin even when the OS was installed on a case-sensitive
+ filesystem. Also fixed tests that should not be run when
+ sys.dont_write_bytecode is true.
+
+
+What's New in Python 3.1 beta 1?
+================================
+
+*Release date: 2009-05-06*
+
+Core and Builtins
+-----------------
+
+- Issue #5914: Add new C API function PyOS_string_to_double, and
+ deprecate PyOS_ascii_strtod and PyOS_ascii_atof.
+
+- Issue #3382: float.__format__, complex.__format__, and %-formatting
+ no longer map 'F' to 'f'. Because of issue #5859 (below), this only
+ affects nan -> NAN and inf -> INF.
+
+- Issue #5799: ntpath (ie, os.path on Windows) fully supports UNC pathnames
+ in all operations, including splitdrive, split, etc. splitunc() now issues
+ a PendingDeprecation warning.
+
+- Issue #5920: For float.__format__, change the behavior with the
+ empty presentation type (that is, not one of 'e', 'f', 'g', or 'n')
+ to be like 'g' but with at least one decimal point and with a
+ default precision of 12. Previously, the behavior the same but with
+ a default precision of 6. This more closely matches str(), and
+ reduces surprises when adding alignment flags to the empty
+ presentation type. This also affects the new complex.__format__ in
+ the same way.
+
+- Implement PEP 383, Non-decodable Bytes in System Character Interfaces.
+
+- Issue #5890: in subclasses of 'property' the __doc__ attribute was
+ shadowed by classtype's, even if it was None. property now
+ inserts the __doc__ into the subclass instance __dict__.
+
+- Issue #4426: The UTF-7 decoder was too strict and didn't accept some legal
+ sequences. Patch by Nick Barnes and Victor Stinner.
+
+- Issue #3672: Reject surrogates in utf-8 codec; add surrogatepass error handler.
+
+- Issue #5883: In the io module, the BufferedIOBase and TextIOBase ABCs have
+ received a new method, detach(). detach() disconnects the underlying stream
+ from the buffer or text IO and returns it.
+
+- Issue #5859: Remove switch from '%f' to '%g'-style formatting for
+ floats with absolute value over 1e50. Also remove length
+ restrictions for float formatting: '%.67f' % 12.34 and '%.120e' %
+ 12.34 no longer raise an exception.
+
+- Issue #1588: Add complex.__format__. For example,
+ format(complex(1, 2./3), '.5') now produces a sensible result.
+
+- Issue #5864: Fix empty format code formatting for floats so that it
+ never gives more than the requested number of significant digits.
+
+- Issue #5793: Rationalize isdigit / isalpha / tolower, etc. Includes
+ new Py_ISDIGIT / Py_ISALPHA / Py_TOLOWER, etc. in pctypes.h.
+
+- Issue #5835: Deprecate PyOS_ascii_formatd.
+
+- Issue #4971: Fix titlecase for characters that are their own
+ titlecase, but not their own uppercase.
+
+- Issue #5283: Setting __class__ in __del__ caused a segfault.
+
+- Issue #5816: complex(repr(z)) now recovers z exactly, even when
+ z involves nans, infs or negative zeros.
+
+- Issue #3166: Make int -> float conversions correctly rounded.
+
+- Issue #1869 (and many duplicates): make round(x, n) correctly
+ rounded for a float x, by using the decimal <-> binary conversions
+ from Python/dtoa.c. As a consequence, (e.g.) round(x, 2) now
+ consistently agrees with format(x, '.2f').
+
+- Issue #5787: object.__getattribute__(some_type, "__bases__") segfaulted on
+ some builtin types.
+
+- Issue #5772: format(1e100, '<') produces '1e+100', not '1.0e+100'.
+
+- Issue #5515: str.format() type 'n' combined with commas and leading
+ zeros no longer gives odd results with ints and floats.
+
+- Implement PEP 378, Format Specifier for Thousands Separator, for
+ floats.
+
+- The str function switches to exponential notation at
+ 1e11, not 1e12. This avoids printing 13 significant digits in
+ situations where only 12 of them are correct. Example problem
+ value: str(1e11 + 0.5). (This minor issue has existed in 2.x for a
+ long time.)
+
+- Issue #1580: On most platforms, use a 'short' float repr: for a
+ finite float x, repr(x) now outputs a string based on the shortest
+ sequence of decimal digits that rounds to x. Previous behaviour was
+ to output 17 significant digits and then strip trailing zeros.
+ Another minor difference is that the new repr switches to
+ exponential notation at 1e16 instead of the previous 1e17; this
+ avoids misleading output in some cases.
+
+ There's a new sys attribute sys.float_repr_style, which takes
+ the value 'short' to indicate that we're using short float repr,
+ and 'legacy' if the short float repr isn't available for one
+ reason or another.
+
+ The float repr change involves incorporating David Gay's 'perfect
+ rounding' code into the Python core (it's in Python/dtoa.c). As a
+ secondary consequence, all string-to-float and float-to-string
+ conversions (including all float formatting operations) will be
+ correctly rounded on these platforms.
+
+ See issue #1580 discussions for details of platforms for which
+ this change does not apply.
+
+- Issue #5759: float() didn't call __float__ on str subclasses.
+
+- The string.maketrans() function is deprecated; there is a new static method
+ maketrans() on the bytes and bytearray classes. This removes confusion about
+ the types string.maketrans() is supposed to work with, and mirrors the
+ methods available on the str class.
+
+- Issue #2170: refactored xml.dom.minidom.normalize, increasing both
+ its clarity and its speed.
+
+- Issue #1113244: Py_XINCREF, Py_DECREF, Py_XDECREF: Add ``do { ... } while (0)``
+ to avoid compiler warnings.
+
+- Issue #3739: The unicode-internal encoder now reports the number of characters
+ consumed like any other encoder (instead of the number of bytes).
+
+Installation
+------------
+
+- Issue #5756: Install idle and pydoc with a 3 suffix.
+
+Library
+-------
+
+- Issue #8203: Fix IDLE Credits dialog: view_file() uses its encoding argument.
+
+- Issue #5311: bdist_msi can now build packages that do not depend on a
+ specific Python version.
+
+- Issue #5150: IDLE's format menu now has an option to strip trailing
+ whitespace.
+
+- Issue #5940: distutils.command.build_clib.check_library_list was not doing
+ the right type checkings anymore.
+
+- Issue #4875: On win32, ctypes.util.find_library does no longer
+ return directories.
+
+- Issue #5142: Add the ability to skip modules while stepping to pdb.
+
+- Issue #1309567: Fix linecache behavior of stripping subdirectories when
+ looking for files given by a relative filename.
+
+- Issue #5923: Update the ``turtle`` module to version 1.1, add two new
+ turtle demos in Demo/turtle.
+
+- Issue #5692: In ``zipfile.Zipfile``, fix wrong path calculation when
+ extracting a file to the root directory.
+
+- Issue #5913: os.listdir() should fail for empty path on windows.
+
+- Issue #5084: unpickling now interns the attribute names of pickled objects,
+ saving memory and avoiding growth in size of subsequent pickles. Proposal
+ and original patch by Jake McGuire.
+
+- The json module now works exclusively with str and not bytes.
+
+- Issue #3959: The ipaddr module has been added to the standard library.
+ Contributed by Google.
+
+- Issue #3002: ``shutil.copyfile()`` and ``shutil.copytree()`` now raise an
+ error when a named pipe is encountered, rather than blocking infinitely.
+
+- Issue #5857: tokenize.tokenize() now returns named tuples.
+
+- Issue #4305: ctypes should now build again on mipsel-linux-gnu
+
+- Issue #1734234: Massively speedup ``unicodedata.normalize()`` when the
+ string is already in normalized form, by performing a quick check beforehand.
+ Original patch by Rauli Ruohonen.
+
+- Issue #5853: calling a function of the mimetypes module from several threads
+ at once could hit the recursion limit if the mimetypes database hadn't been
+ initialized before.
+
+- Issue #5854: Updated __all__ to include some missing names and remove some
+ names which should not be exported.
+
+- Issue #3102: All global symbols that the _ctypes extension defines
+ are now prefixed with 'Py' or '_ctypes'.
+
+- Issue #5041: ctypes does now allow pickling wide character.
+
+- Issue #5812: For the two-argument form of the Fraction constructor,
+ Fraction(m, n), m and n are permitted to be arbitrary Rational
+ instances.
+
+- Issue #5812: Fraction('1e6') is valid: more generally, any string
+ that's valid for float() is now valid for Fraction(), with the
+ exception of strings representing NaNs and infinities.
+
+- Issue #5734: BufferedRWPair was poorly tested and had several glaring
+ bugs. Patch by Brian Quinlan.
+
+- Issue #1161031: fix readwrite select flag handling: POLLPRI now
+ results in a handle_expt_event call, not handle_read_event, and POLLERR
+ and POLLNVAL now call handle_close, not handle_expt_event. Also,
+ dispatcher now has an 'ignore_log_types' attribute for suppressing
+ log messages, which is set to 'warning' by default.
+
+- Issue #2703: SimpleXMLRPCDispatcher.__init__: Provide default values for
+ new arguments introduced in 2.5.
+
+- Issue #5828 (Invalid behavior of unicode.lower): Fixed bogus logic in
+ makeunicodedata.py and regenerated the Unicode database (This fixes
+ u'\u1d79'.lower() == '\x00').
+
+Extension Modules
+-----------------
+
+- Issue #5881: Remove old undocumented compatibility interfaces in hashlib and
+ pwd.
+
+- Issue #5463: In struct module, remove deprecated float coercion
+ for integer type codes: struct.pack('L', 0.3) should now raise
+ an error. The _PY_STRUCT_FLOAT_COERCE constant has been removed.
+ The version number has been bumped to 0.3.
+
+- Issue #5359: Readd the Berkeley DB detection code to allow _dbm be built
+ using Berkeley DB.
+
+Tests
+-----
+
+- Issue #5354: New test support function import_fresh_module() makes
+ it easy to import both normal and optimised versions of modules.
+ test_heapq and test_warnings have been adjusted to use it, tests for
+ other modules with both C and Python implementations in the stdlib
+ can be adjusted to use it over time.
+
+- Issue #5837: Certain sequences of calls to set() and unset() for
+ support.EnvironmentVarGuard objects restored the environment variables
+ incorrectly on __exit__.
+
+C-API
+-----
+
+- Issue #5630: A replacement PyCObject API, PyCapsule, has been added.
+
+
+What's New in Python 3.1 alpha 2?
+=================================
+
+*Release date: 2009-4-4*
+
+Core and Builtins
+-----------------
+
+- Implement PEP 378, Format Specifier for Thousands Separator, for
+ integers.
+
+- Issue #5666: Py_BuildValue's 'c' code should create byte strings.
+
+- Issue #5499: The 'c' code for argument parsing functions now only accepts a
+ byte, and the 'C' code only accepts a unicode character.
+
+- Fix a problem in PyErr_NormalizeException that leads to "undetected errors"
+ when hitting the recursion limit under certain circumstances.
+
+- Issue #1665206: Remove the last eager import in _warnings.c and make it lazy.
+
+- Fix a segfault when running test_exceptions with coverage, caused by
+ insufficient checks in accessors of Exception.__context__.
+
+- Issue #5604: non-ASCII characters in module name passed to
+ imp.find_module() were converted to UTF-8 while the path is
+ converted to the default filesystem encoding, causing nonsense.
+
+- Issue #5126: str.isprintable() returned False for space characters.
+
+- Issue #4865: On MacOSX /Library/Python/2.7/site-packages is added to
+ the end sys.path, for compatibility with the system install of Python.
+
+- Issue #4688: Add a heuristic so that tuples and dicts containing only
+ untrackable objects are not tracked by the garbage collector. This can
+ reduce the size of collections and therefore the garbage collection overhead
+ on long-running programs, depending on their particular use of datatypes.
+
+- Issue #5512: Rewrite PyLong long division algorithm (x_divrem) to
+ improve its performance. Long divisions and remainder operations
+ are now between 50% and 150% faster.
+
+- Issue #4258: Make it possible to use base 2**30 instead of base
+ 2**15 for the internal representation of integers, for performance
+ reasons. Base 2**30 is enabled by default on 64-bit machines. Add
+ --enable-big-digits option to configure, which overrides the
+ default. Add sys.int_info structseq to provide information about
+ the internal format.
+
+- Issue #4474: PyUnicode_FromWideChar now converts characters outside
+ the BMP to surrogate pairs, on systems with sizeof(wchar_t) == 4
+ and sizeof(Py_UNICODE) == 2.
+
+- Issue #5237: Allow auto-numbered fields in str.format(). For
+ example: '{} {}'.format(1, 2) == '1 2'.
+
+- Issue #5392: when a very low recursion limit was set, the interpreter would
+ abort with a fatal error after the recursion limit was hit twice.
+
+- Issue #3845: In PyRun_SimpleFileExFlags avoid invalid memory access with
+ short file names.
+
+Library
+-------
+
+- Issue #2625: added missing items() call to the for loop in
+ mailbox.MH.get_message().
+
+- Issue #5640: Fix _multibytecodec so that CJK codecs don't repeat
+ error substitutions from non-strict codec error callbacks in
+ incrementalencoder and StreamWriter.
+
+- Issue #5656: Fix the coverage reporting when running the test suite with
+ the -T argument.
+
+- Issue #5647: MutableSet.__iand__() no longer mutates self during iteration.
+
+- Issue #5624: Fix the _winreg module name still used in several modules.
+
+- Issue #5628: Fix io.TextIOWrapper.read() with a unreadable buffer.
+
+- Issue #5619: Multiprocessing children disobey the debug flag and causes
+ popups on windows buildbots. Patch applied to work around this issue.
+
+- Issue #5400: Added patch for multiprocessing on netbsd compilation/support
+
+- Issue #5387: Fixed mmap.move crash by integer overflow.
+
+- Issue #5261: Patch multiprocessing's semaphore.c to support context
+ manager use: "with multiprocessing.Lock()" works now.
+
+- Issue #5236: Change time.strptime() to only take strings. Didn't work with
+ bytes already but the failure was non-obvious.
+
+- Issue #5177: Multiprocessing's SocketListener class now uses
+ socket.SO_REUSEADDR on all connections so that the user no longer needs
+ to wait 120 seconds for the socket to expire.
+
+- Issue #5595: Fix UnboundedLocalError in ntpath.ismount().
+
+- Issue #1174606: Calling read() without arguments of an unbounded file
+ (typically /dev/zero under Unix) could crash the interpreter.
+
+- The max_buffer_size arguments of io.BufferedWriter, io.BufferedRWPair, and
+ io.BufferedRandom have been deprecated for removal in Python 3.2.
+
+- Issue #5068: Fixed the tarfile._BZ2Proxy.read() method that would loop
+ forever on incomplete input. That caused tarfile.open() to hang when used
+ with mode 'r' or 'r:bz2' and a fileobj argument that contained no data or
+ partial bzip2 compressed data.
+
+- Issue #2110: Add support for thousands separator and 'n' type
+ specifier to Decimal.__format__
+
+- Fix Decimal.__format__ bug that swapped the meanings of the '<' and
+ '>' alignment characters.
+
+- The error detection code in FileIO.close() could fail to reflect the `errno`
+ value, and report it as -1 instead.
+
+- Issue #5016: FileIO.seekable() could return False if the file position
+ was negative when truncated to a C int. Patch by Victor Stinner.
+
+Extension Modules
+-----------------
+
+- Issue #5391: mmap now deals exclusively with bytes.
+
+- Issue #5463: In struct module, remove deprecated overflow wrapping
+ when packing an integer: struct.pack('=L', -1) now raises
+ struct.error instead of returning b'\xff\xff\xff\xff'. The
+ _PY_STRUCT_RANGE_CHECKING and _PY_STRUCT_OVERFLOW_MASKING constants
+ have been removed from the struct module.
+
+
+What's New in Python 3.1 alpha 1
+================================
+
+*Release date: 2009-03-07*
+
+Core and Builtins
+-----------------
+
+- The io module has been reimplemented in C for speed.
+
+- Give dict views an informative __repr__.
+
+- Issue #5247: Improve error message when unknown format codes are
+ used when using str.format() with str, int, and float arguments.
+
+- Issue #5249: time.strftime returned malformed string when format string
+ contained non ascii character on windows.
+
+- Issue #4626: compile(), exec(), and eval() ignore the coding cookie if the
+ source has already been decoded into str.
+
+- Issue #5186: Reduce hash collisions for objects with no __hash__ method by
+ rotating the object pointer by 4 bits to the right.
+
+- Issue #4575: Fix Py_IS_INFINITY macro to work correctly on x87 FPUs:
+ it now forces its argument to double before testing for infinity.
+
+- Issue #5137: Make len() correctly raise a TypeError when a __len__ method
+ returns a non-number type.
+
+- Issue #5182: Removed memoryview.__str__.
+
+- Issue #1717: Removed builtin cmp() function, dropped tp_compare
+ slot, the C API functions PyObject_Compare and PyUnicode_Compare and
+ the type definition cmpfunc. The tp_compare slot has been renamed
+ to tp_reserved, and is reserved for future usage.
+
+- Issue #1242657: the __len__() and __length_hint__() calls in several tools
+ were suppressing all exceptions. These include list() and bytearray().
+
+- Issue #4707: round(x, n) now returns an integer if x is an integer.
+ Previously it returned a float.
+
+- Issue #4753: By enabling a configure option named '--with-computed-gotos'
+ on compilers that support it (notably: gcc, SunPro, icc), the bytecode
+ evaluation loop is compiled with a new dispatch mechanism which gives
+ speedups of up to 20%, depending on the system, on various benchmarks.
+
+- Issue #4874: Most builtin decoders now reject unicode input.
+
+- Issue #4842: Don't allow trailing 'L' when constructing an integer
+ from a string.
+
+- Issue #4991: os.fdopen now raises an OSError for invalid file descriptors.
+
+- Issue #4838: When a module is deallocated, free the memory backing the
+ optional module state data.
+
+- Issue #4910: Rename nb_long slot to nb_reserved, and change its
+ type to ``(void *)``.
+
+- Issue #4935: The overflow checking code in the expandtabs() method common
+ to str, bytes and bytearray could be optimized away by the compiler, letting
+ the interpreter segfault instead of raising an error.
+
+- Issue #3720: Fix a crash when an iterator modifies its class and removes its
+ __next__ method.
+
+- Issue #4910: Builtin int() function and PyNumber_Long/PyNumber_Int API
+ function no longer attempt to call the __long__ slot to convert an object
+ to an integer. Only the __int__ and __trunc__ slots are examined.
+
+- Issue #4893: Use NT threading on CE.
+
+- Issue #4915: Port sysmodule to Windows CE.
+
+- Issue #4868: utf-8, utf-16 and latin1 decoding are now 2x to 4x faster. The
+ common cases are optimized thanks to a dedicated fast path and a moderate
+ amount of loop unrolling.
+
+- Issue #4074: Change the criteria for doing a full garbage collection (i.e.
+ collecting the oldest generation) so that allocating lots of objects without
+ destroying them does not show quadratic performance. Based on a proposal by
+ Martin von Löwis at
+ http://mail.python.org/pipermail/python-dev/2008-June/080579.html.
+
+- Issue #4604: Some objects of the I/O library could still be used after
+ having been closed (for instance, a read() call could return some
+ previously buffered data). Patch by Dmitry Vasiliev.
+
+- Issue #4705: Fix the -u ("unbuffered binary stdout and stderr") command-line
+ flag to work properly. Furthermore, when specifying -u, the text stdout
+ and stderr streams have line-by-line buffering enabled (the default being
+ to buffer arbitrary chunks of data).
+
+- The internal table, _PyLong_DigitValue, is now an array of unsigned chars
+ instead of ints (reducing its size from 4 to 8 times thereby reducing
+ Python's overall memory).
+
+- Issue #1180193: When importing a module from a .pyc (or .pyo) file with
+ an existing .py counterpart, override the co_filename attributes of all
+ code objects if the original filename is obsolete (which can happen if the
+ file has been renamed, moved, or if it is accessed through different paths).
+ Patch by Ziga Seilnacht and Jean-Paul Calderone.
+
+- Issue #4580: Fix slicing of memoryviews when the item size is greater than
+ one byte. Also fixes the meaning of len() so that it returns the number of
+ items, rather than the size in bytes.
+
+- Issue #4075: Use OutputDebugStringW in Py_FatalError.
+
+- Issue #4747: When the terminal does not use utf-8, executing a script with
+ non-ascii characters in its name could fail with a "SyntaxError: None" error.
+
+- Issue #4797: IOError.filename was not set when ``_fileio.FileIO`` failed
+ to open file with a bytes filename on Windows.
+
+- Issue #3680: Reference cycles created through a dict, set or deque iterator
+ did not get collected.
+
+- Issue #4701: PyObject_Hash now implicitly calls PyType_Ready on types
+ where the tp_hash and tp_dict slots are both NULL.
+
+- Issue #4759: None is now allowed as the first argument of
+ bytearray.translate(). It was always allowed for bytes.translate().
+
+- Added test case to ensure attempts to read from a file opened for writing
+ fail.
+
+- Issue #3106: Speedup some comparisons (str/str and int/int).
+
+- Issue #2183: Simplify and optimize bytecode for list, dict and set
+ comprehensions. Original patch for list comprehensions by Neal Norwitz.
+
+- Issue #2467: gc.DEBUG_STATS reported invalid elapsed times. Also, always
+ print elapsed times, not only when some objects are uncollectable /
+ unreachable. Original patch by Neil Schemenauer.
+
+- Issue #3439: Add a bit_length method to int.
+
+- Issue #2173: When getting device encoding, check that return value of
+ nl_langinfo is not the empty string. This was causing silent build
+ failures on OS X.
+
+- Issue #4597: Fixed several opcodes that weren't always propagating
+ exceptions.
+
+- Issue #4589: Fixed exception handling when the __exit__ function of a
+ context manager returns a value that cannot be converted to a bool.
+
+- Issue #4445: Replace "sizeof(PyBytesObject)" with
+ "offsetof(PyBytesObject, ob_sval) + 1" when allocating memory for
+ bytes instances. On a typical machine this saves 3 bytes of memory
+ (on average) per allocation of a bytes instance.
+
+- Issue #4533: File read operation was dreadfully slow due to a slowly
+ growing read buffer. Fixed by using the same growth rate algorithm as
+ Python 2.x.
+
+- Issue #4509: Various issues surrounding resize of bytearray objects to
+ which there are buffer exports (e.g. memoryview instances).
+
+- Issue #4233: Changed semantic of ``_fileio.FileIO``'s ``close()``
+ method on file objects with closefd=False. The file descriptor is still
+ kept open but the file object behaves like a closed file. The ``FileIO``
+ object also got a new readonly attribute ``closefd``.
+
+- Issue #4569: Interpreter crash when mutating a memoryview with an item size
+ larger than 1.
+
+- Issue #4748: Lambda generators no longer return a value.
+
+- The re.sub(), re.subn() and re.split() functions now accept a flags parameter.
+
+- Issue #5108: Handle %s like %S, %R and %A in PyUnicode_FromFormatV(): Call
+ PyUnicode_DecodeUTF8() once, remember the result and output it in a second
+ step. This avoids problems with counting UTF-8 bytes that ignores the effect
+ of using the replace error handler in PyUnicode_DecodeUTF8().
+
+Library
+-------
+
+- Issue #7071: byte-compilation in Distutils is now done with respect to
+ sys.dont_write_bytecode.
+
+- Issue #7066: archive_util.make_archive now restores the cwd if an error is
+ raised. Initial patch by Ezio Melotti.
+
+- Issue #6516: Added owner/group support when creating tar archives in
+ Distutils.
+
+- Issue #6954: Fixed crash when using DISTUTILS_DEBUG flag in Distutils.
+
+- Issue #6163: Fixed HP-UX runtime library dir options in
+ distutils.unixcompiler. Initial patch by Sridhar Ratnakumar and
+ Michael Haubenwallner.
+
+- Issue #6693: New functions in site.py to get user/global site packages paths.
+
+- Issue #6511: ZipFile now raises BadZipfile (instead of an IOError) when
+ opening an empty or very small file.
+
+- Issue #6545: Removed assert statements in distutils.Extension, so the
+ behavior is similar when used with -O.
+
+- unittest has been split up into a package. All old names should still work.
+
+- Issue #6466: now distutils.cygwinccompiler and distutils.emxccompiler
+ uses the same refactored function to get gcc/ld/dllwrap versions numbers.
+ It's `distutils.util.get_compiler_versions`. Added deprecation warnings
+ for the obsolete get_versions() functions.
+
+- Issue #6433: fixed issues with multiprocessing.pool.map hanging on empty list
+
+- Issue #6314: logging: Extra checks on the "level" argument in more places.
+
+- Issue #2622: Fixed an ImportError when importing email.message from a
+ standalone application built with py2exe or py2app.
+
+- Issue #6455: Fixed test_build_ext under win32.
+
+- Issue #6377: Enabled the compiler option, and deprecate its usage as an
+ attribute.
+
+- Issue #6413: Fixed the log level in distutils.dist for announce.
+
+- Issue #6403: Fixed package path usage in build_ext.
+
+- Issues #5155, 5313, 5331: multiprocessing.Process._bootstrap was
+ unconditionally calling "os.close(sys.stdin.fileno())" resulting in file
+ descriptor errors
+
+- Issue #6365: Distutils build_ext inplace mode was copying the compiled
+ extension in a subdirectory if the extension name had dots.
+
+- Issue #6164: Added an AIX specific linker argument in Distutils
+ unixcompiler. Original patch by Sridhar Ratnakumar.
+
+- Issue #6286: Now Distutils upload command is based on urllib2 instead of
+ httplib, allowing the usage of http_proxy.
+
+- Issue #6287: Added the license field in Distutils documentation.
+
+- Issue #6263: Fixed syntax error in distutils.cygwincompiler.
+
+- Issue #5201: distutils.sysconfig.parse_makefile() now understands `$$`
+ in Makefiles. This prevents compile errors when using syntax like:
+ `LDFLAGS='-rpath=\$$LIB:/some/other/path'`. Patch by Floris Bruynooghe.
+
+- Issue #6131: test_modulefinder leaked when run after test_distutils.
+ Patch by Hirokazu Yamamoto.
+
+- Issue #6048: Now Distutils uses the tarfile module in archive_util.
+
+- Issue #6062: In distutils, fixed the package option of build_ext. Feedback
+ and tests on pywin32 by Tim Golden.
+
+- Issue #6053: Fixed distutils tests on win32. patch by Hirokazu Yamamoto.
+
+- Issue #6046: Fixed the library extension when distutils build_ext is used
+ inplace. Initial patch by Roumen Petrov.
+
+- Issue #6041: Now distutils `sdist` and `register` commands use `check` as a
+ subcommand.
+
+- Issue #6022: a test file was created in the current working directory by
+ test_get_outputs in Distutils.
+
+- Issue #5977: distutils build_ext.get_outputs was not taking into account the
+ inplace option. Initial patch by kxroberto.
+
+- Issue #5984: distutils.command.build_ext.check_extensions_list checks were broken
+ for old-style extensions.
+
+- Issue #5976: Fixed Distutils test_check_environ.
+
+- Issue #5941: Distutils build_clib command was not working anymore because
+ of an incomplete costumization of the archiver command. Added ARFLAGS in the
+ Makefile besides AR and make Distutils use it. Original patch by David
+ Cournapeau.
+
+- Issue #2245: aifc now skips chunk types it doesn't recognize, per spec.
+
+- Issue #5874: distutils.tests.test_config_cmd is not locale-sensitive
+ anymore.
+
+- Issue #5810: Fixed Distutils test_build_scripts so it uses
+ sysconfig.get_config_vars.
+
+- Issue #4951: Fixed failure in test_httpservers.
+
+- Issue #5795: Fixed test_distutils failure on Debian ppc.
+
+- Issue #5607: fixed Distutils test_get_platform for Mac OS X fat binaries.
+
+- Issue #5741: don't disallow "%%" (which is an escape for "%") when setting
+ a value in SafeConfigParser.
+
+- Issue #5732: added a new command in Distutils: check.
+
+- Issue #5731: Distutils bdist_wininst no longer worked on non-Windows
+ platforms. Initial patch by Paul Moore.
+
+- Issue #5095: Added bdist_msi to the list of bdist supported formats.
+ Initial fix by Steven Bethard.
+
+- Issue #1491431: Fixed distutils.filelist.glob_to_re for edge cases.
+ Initial fix by Wayne Davison.
+
+- Issue #5694: removed spurious test output in Distutils (test_clean).
+
+- Issue #1326077: fix the formatting of SyntaxErrors by the traceback module.
+
+- Issue #1665206 (partially): Move imports in cgitb to the top of the module
+ instead of performing them in functions. Helps prevent import deadlocking in
+ threads.
+
+- Issue #2522: locale.format now checks its first argument to ensure it has
+ been passed only one pattern, avoiding mysterious errors where it appeared
+ that it was failing to do localization.
+
+- Issue #5583: Added optional Extensions in Distutils. Initial patch by Georg
+ Brandl.
+
+- Issue #1222: locale.format() bug when the thousands separator is a space
+ character.
+
+- Issue #5472: Fixed distutils.test_util tear down. Original patch by
+ Tim Golden.
+
+- collections.deque() objects now have a read-only attribute called maxlen.
+
+- Issue #2638: Show a window constructed with tkSimpleDialog.Dialog only after
+ it is has been populated and properly configured in order to prevent
+ window flashing.
+
+- Issue #4792: Prevent a segfault in _tkinter by using the
+ guaranteed to be safe interp argument given to the PythonCmd in place of
+ the Tcl interpreter taken from a PythonCmd_ClientData.
+
+- Issue #5193: Guarantee that tkinter.Text.search returns a string.
+
+- Issue #5394: removed > 2.3 syntax from distutils.msvc9compiler.
+ Original patch by Akira Kitada.
+
+- Issue #5334: array.fromfile() failed to insert values when EOFError was raised.
+
+- Issue #5385: Fixed mmap crash after resize failure on windows.
+
+- Issue #5179: Fixed subprocess handle leak on failure on windows.
+
+- PEP 372: Added collections.OrderedDict().
+
+- The _asdict() for method for namedtuples now returns an OrderedDict().
+
+- configparser now defaults to using an ordered dictionary.
+
+- Issue #5401: Fixed a performance problem in mimetypes when ``from mimetypes
+ import guess_extension`` was used.
+
+- Issue #1733986: Fixed mmap crash in accessing elements of second map object
+ with same tagname but larger size than first map. (Windows)
+
+- Issue #5386: mmap.write_byte didn't check map size, so it could cause buffer
+ overrun.
+
+- Issue #1533164: Installed but not listed ``*.pyo`` was breaking Distutils
+ bdist_rpm command.
+
+- Issue #5378: added --quiet option to Distutils bdist_rpm command.
+
+- Issue #5052: make Distutils compatible with 2.3 again.
+
+- Issue #5316: Fixed buildbot failures introduced by multiple inheritance
+ in Distutils tests.
+
+- Issue #5287: Add exception handling around findCaller() call to help out
+ IronPython.
+
+- Issue #5282: Fixed mmap resize on 32bit windows and unix. When offset > 0,
+ The file was resized to wrong size.
+
+- Issue #5292: Fixed mmap crash on its boundary access m[len(m)].
+
+- Issue #2279: distutils.sdist.add_defaults now add files
+ from the package_data and the data_files metadata.
+
+- Issue #5257: refactored all tests in distutils, so they use
+ support.TempdirManager, to avoid writing in the tests directory.
+
+- Issue #4524: distutils build_script command failed with --with-suffix=3.
+ Initial patch by Amaury Forgeot d'Arc.
+
+- Issue #2461: added tests for distutils.util
+
+- Issue #4998: The memory saving effect of __slots__ had been lost on Fractions
+ which inherited from numbers.py which did not have __slots__ defined. The
+ numbers hierarchy now has its own __slots__ declarations.
+
+- Issue #4631: Fix urlopen() result when an HTTP response uses chunked
+ encoding.
+
+- Issue #5203: Fixed ctypes segfaults when passing a unicode string to a
+ function without argtypes (only occurs if HAVE_USABLE_WCHAR_T is false).
+
+- Issue #3386: distutils.sysconfig.get_python_lib prefix argument was ignored
+ under NT and OS2. Patch by Philip Jenvey.
+
+- Issue #5128: Make compileall properly inspect bytecode to determine if needs
+ to be recreated. This avoids a timing hole thanks to the old reliance on the
+ ctime of the files involved.
+
+- Issue #5122: Synchronize tk load failure check to prevent a potential
+ deadlock.
+
+- Issue #1818: collections.namedtuple() now supports a keyword argument
+ 'rename' which lets invalid fieldnames be automatically converted to
+ positional names in the form, _1, _2, ...
+
+- Issue #4890: Handle empty text search pattern in Tkinter.Text.search.
+
+- Issue #4512 (part 2): Promote ``ZipImporter._get_filename()`` to be a
+ public documented method ``ZipImporter.get_filename()``.
+
+- Issue #4195: The ``runpy`` module (and the ``-m`` switch) now support
+ the execution of packages by looking for and executing a ``__main__``
+ submodule when a package name is supplied. Initial patch by Andi
+ Vajda.
+
+- Issue #1731706: Call Tcl_ConditionFinalize for Tcl_Conditions that will
+ not be used again (this requires Tcl/Tk 8.3.1), also fix a memory leak in
+ Tkapp_Call when calling from a thread different than the one that created
+ the Tcl interpreter. Patch by Robert Hancock.
+
+- Issue #4285: Change sys.version_info to be a named tuple. Patch by
+ Ross Light.
+
+- Issue #1520877: Now distutils.sysconfig reads $AR from the
+ environment/Makefile. Patch by Douglas Greiman.
+
+- Issue #1276768: The verbose option was not used in the code of
+ distutils.file_util and distutils.dir_util.
+
+- Issue #5132: Fixed trouble building extensions under Solaris with
+ --enabled-shared activated. Initial patch by Dave Peterson.
+
+- Issue #1581476: Always use the Tcl global namespace when calling into Tcl.
+
+- The shelve module now defaults to pickle protocol 3.
+
+- Fix a bug in the trace module where a bytes object from co_lnotab had its
+ items being passed through ord().
+
+- Issue #2047: shutil.move() could believe that its destination path was
+ inside its source path if it began with the same letters (e.g. "src" vs.
+ "src.new").
+
+- Added the ttk module. See issue #2983: Ttk support for Tkinter.
+
+- Removed isSequenceType(), isMappingType, and isNumberType() from the
+ operator module; use the abstract base classes instead. Also removed
+ the repeat() function; use mul() instead.
+
+- Issue #5021: doctest.testfile() did not create __name__ and
+ collections.namedtuple() relied on __name__ being defined.
+
+- Backport importlib from Python 3.1. Only the import_module() function has
+ been backported to help facilitate transitions from 2.7 to 3.1.
+
+- Issue #1885: distutils. When running sdist with --formats=tar,gztar
+ the tar file was overriden by the gztar one.
+
+- Issue #4863: distutils.mwerkscompiler has been removed.
+
+- Added a new itertools functions: combinations_with_replacement()
+ and compress().
+
+- Issue #5032: added a step argument to itertools.count() and
+ allowed non-integer arguments.
+
+- Fix and properly document the multiprocessing module's logging
+ support, expose the internal levels and provide proper usage
+ examples.
+
+- Issue #1672332: fix unpickling of subnormal floats, which was
+ producing a ValueError on some platforms.
+
+- Issue #3881: Help Tcl to load even when started through the
+ unreadable local symlink to "Program Files" on Vista.
+
+- Issue #4710: Extract directories properly in the zipfile module;
+ allow adding directories to a zipfile.
+
+- Issue #3807: _multiprocessing build fails when configure is passed
+ --without-threads argument. When this occurs, _multiprocessing will
+ be disabled, and not compiled.
+
+- Issue #5008: When a file is opened in append mode with the new IO library,
+ do an explicit seek to the end of file (so that e.g. tell() returns the
+ file size rather than 0). This is consistent with the behaviour of the
+ traditional 2.x file object.
+
+- Issue #5013: Fixed a bug in FileHandler which occurred when the delay
+ parameter was set.
+
+- Issue #4842: Always append a trailing 'L' when pickling longs using
+ pickle protocol 0. When reading, the 'L' is optional.
+
+- Add the importlib package.
+
+- Issue #4301: Patch the logging module to add processName support, remove
+ _check_logger_class from multiprocessing.
+
+- Issue #3325: Remove python2.x try: except: imports for old cPickle from
+ multiprocessing.
+
+- Issue #4959: inspect.formatargspec now works for keyword only arguments
+ without defaults.
+
+- Issue #3321: ``_multiprocessing.Connection()`` doesn't check handle; added checks
+ for Unix machines for negative handles and large int handles. Without this check
+ it is possible to segfault the interpreter.
+
+- Issue #4449: AssertionError in mp_benchmarks.py, caused by an underlying issue
+ in sharedctypes.py.
+
+- Issue #1225107: inspect.isclass() returned True for instances with a custom
+ __getattr__.
+
+- Issue #3826 and #4791: The socket module now closes the underlying socket
+ appropriately when it is being used via socket.makefile() objects
+ rather than delaying the close by waiting for garbage collection to do it.
+
+- Issue #1696199: Add collections.Counter() for rapid and convenient
+ counting.
+
+- Issue #3860: GzipFile and BZ2File now support the context manager protocol.
+
+- Issue #4867: Fixed a crash in ctypes when passing a string to a
+ function without defining argtypes.
+
+- Issue #4272: Add an optional argument to the GzipFile constructor to override
+ the timestamp in the gzip stream. The default value remains the current time.
+ The information can be used by e.g. gunzip when decompressing. Patch by
+ Jacques Frechet.
+
+- Restore Python 2.3 compatibility for decimal.py.
+
+- Issue #3638: Remove functions from _tkinter module level that depend on
+ TkappObject to work with multiple threads.
+
+- Issue #4718: Adapt the wsgiref package so that it actually works with
+ Python 3.x, in accordance with the `official amendments of the spec
+ <http://www.wsgi.org/wsgi/Amendments_1.0>`_.
+
+- Issue #4796: Added Decimal.from_float() and Context.create_decimal_from_float()
+ to the decimal module.
+
+- Fractions.from_float() no longer loses precision for integers too big to
+ cast as floats.
+
+- Issue #4812: add missing underscore prefix to some internal-use-only
+ constants in the decimal module. (Dec_0 becomes _Dec_0, etc.)
+
+- Issue #4790: The nsmallest() and nlargest() functions in the heapq module
+ did unnecessary work in the common case where no key function was specified.
+
+- Issue #4795: inspect.isgeneratorfunction() returns False instead of None when
+ the function is not a generator.
+
+- Issue #4702: Throwing a DistutilsPlatformError instead of IOError in case
+ no MSVC compiler is found under Windows. Original patch by Philip Jenvey.
+
+- Issue #4646: distutils was choking on empty options arg in the setup
+ function. Original patch by Thomas Heller.
+
+- Issue #3767: Convert Tk object to string in tkColorChooser.
+
+- Issue #3248: Allow placing ScrolledText in a PanedWindow.
+
+- Issue #4444: Allow assertRaises() to be used as a context handler, so that
+ the code under test can be written inline if more practical.
+
+- Issue #4739: Add pydoc help topics for symbols, so that e.g. help('@')
+ works as expected in the interactive environment.
+
+- Issue #4756: zipfile.is_zipfile() now supports file-like objects. Patch by
+ Gabriel Genellina.
+
+- Issue #4574: reading an UTF16-encoded text file crashes if \r on 64-char
+ boundary.
+
+- Issue #4223: inspect.getsource() will now correctly display source code
+ for packages loaded via zipimport (or any other conformant PEP 302
+ loader). Original patch by Alexander Belopolsky.
+
+- Issue #4201: pdb can now access and display source code loaded via
+ zipimport (or any other conformant PEP 302 loader). Original patch by
+ Alexander Belopolsky.
+
+- Issue #4197: doctests in modules loaded via zipimport (or any other PEP
+ 302 conformant loader) will now work correctly in most cases (they
+ are still subject to the constraints that exist for all code running
+ from inside a module loaded via a PEP 302 loader and attempting to
+ perform IO operations based on __file__). Original patch by
+ Alexander Belopolsky.
+
+- Issues #4082 and #4512: Add runpy support to zipimport in a manner that
+ allows backporting to maintenance branches. Original patch by
+ Alexander Belopolsky.
+
+- Issue #4163: textwrap module: allow word splitting on a hyphen preceded by
+ a non-ASCII letter.
+
+- Issue #4616: TarFile.utime(): Restore directory times on Windows.
+
+- Issue #4021: tokenize.detect_encoding() now raises a SyntaxError when the
+ codec cannot be found. This is for compatibility with the builtin behavior.
+
+- Issue #4084: Fix max, min, max_mag and min_mag Decimal methods to
+ give correct results in the case where one argument is a quiet NaN
+ and the other is a finite number that requires rounding.
+
+- Issue #4483: _dbm module now builds on systems with gdbm & gdbm_compat
+ libs.
+
+- Added the subprocess.check_call_output() convenience function to get output
+ from a subprocess on success or raise an exception on error.
+
+- Issue #1055234: cgi.parse_header(): Fixed parsing of header parameters to
+ support unusual filenames (such as those containing semi-colons) in
+ Content-Disposition headers.
+
+- Issue #4384: Added logging integration with warnings module using
+ captureWarnings(). This change includes a NullHandler which does nothing;
+ it will be of use to library developers who want to avoid the "No handlers
+ could be found for logger XXX" message which can appear if the library user
+ doesn't configure logging.
+
+- Issue #3741: DISTUTILS_USE_SDK set causes msvc9compiler.py to raise an
+ exception.
+
+- Issue #4529: fix the parser module's validation of try-except-finally
+ statements.
+
+- Issue #4458: getopt.gnu_getopt() now recognizes a single "-" as an argument,
+ not a malformed option.
+
+- Added the subprocess.check_output() convenience function to get output
+ from a subprocess on success or raise an exception on error.
+
+- Issue #4542: On Windows, binascii.crc32 still accepted str as binary input;
+ the corresponding tests now pass.
+
+- Issue #4537: webbrowser.UnixBrowser would fail to open the browser because
+ it was calling the wrong open() function.
+
+- Issue #1055234: cgi.parse_header(): Fixed parsing of header parameters to
+ support unusual filenames (such as those containing semi-colons) in
+ Content-Disposition headers.
+
+- Issue #4861: ctypes.util.find_library(): Robustify. Fix library detection on
+ biarch systems. Try to rely on ldconfig only, without using objdump and gcc.
+
+- Issue #5104: The socket module now raises OverflowError when 16-bit port and
+ protocol numbers are supplied outside the allowed 0-65536 range on bind()
+ and getservbyport().
+
+- Windows locale mapping updated to Vista.
+
+Tools/Demos
+-----------
+
+- Issue #4704: remove use of cmp() in pybench, bump its version number to 2.1,
+ and make it 2.6-compatible.
+
+- Ttk demos added in Demo/tkinter/ttk/
+
+- Issue #4677: add two list comprehension tests to pybench.
+
+
+Build
+-----
+
+- Issue #6094: Build correctly with Subversion 1.7.
+
+- Issue #5847: Remove -n switch on "Edit with IDLE" menu item.
+
+- Issue #5726: Make Modules/ld_so_aix return the actual exit code of the
+ linker, rather than always exit successfully. Patch by Floris Bruynooghe.
+
+- Issue #4587: Add configure option --with-dbmliborder=db1:db2:... to specify
+ the order that backends for the dbm extension are checked.
+
+- Link the shared python library with $(MODLIBS).
+
+- Issue #5134: Silence compiler warnings when compiling sqlite with VC++.
+
+- Issue #4494: Fix build with Py_NO_ENABLE_SHARED on Windows.
+
+- Issue #4895: Use _strdup on Windows CE.
+
+- Issue #4472: "configure --enable-shared" now works on OSX
+
+- Issues #4728 and #4060: WORDS_BIGEDIAN is now correct in Universal builds.
+
+- Issue #4389: Add icon to the uninstall entry in "add-and-remove-programs".
+
+- Issue #4289: Remove Cancel button from AdvancedDlg.
+
+- Issue #1656675: Register a drop handler for .py* files on Windows.
+
+- Issue #4120: Exclude manifest from extension modules in VS2008.
+
+- Issue #4091: Install pythonxy.dll in system32 again.
+
+- Issue #4018: Disable "for me" installations on Vista.
+
+- Issue #3758: Add ``patchcheck`` build target to .PHONY.
+
+- Issue #4204: Fixed module build errors on FreeBSD 4.
+
+
+C-API
+-----
+
+- Issue #6624: yArg_ParseTuple with "s" format when parsing argument with
+ NUL: Bogus TypeError detail string.
+
+- Issue #5175: PyLong_AsUnsignedLongLong now raises OverflowError
+ for negative arguments. Previously, it raised TypeError.
+
+- Issue #4720: The format for PyArg_ParseTupleAndKeywords can begin with '|'.
+
+- Issue #3632: from the gdb debugger, the 'pyo' macro can now be called when
+ the GIL is released, or owned by another thread.
+
+- Issue #4122: On Windows, fix a compilation error when using the
+ Py_UNICODE_ISSPACE macro in an extension module.
+
+
+Extension Modules
+-----------------
+
+- Issue #3745: Fix hashlib to always reject unicode and non buffer-api
+ supporting objects as input no matter how it was compiled (built in
+ implementations or external openssl library).
+
+- Issue #4397: Fix occasional test_socket failure on OS X.
+
+- Issue #4279: Fix build of parsermodule under Cygwin.
+
+- Issue #4751: hashlib now releases the GIL when hashing large buffers
+ (with a hardwired threshold of 2048 bytes), allowing better parallelization
+ on multi-CPU systems. Contributed by Lukas Lueg (ebfe) and Victor Stinner.
+
+- Issue #4051: Prevent conflict of UNICODE macros in cPickle.
+
+- Issue #4738: Each zlib object now has a separate lock, allowing to compress
+ or decompress several streams at once on multi-CPU systems. Also, the GIL
+ is now released when computing the CRC of a large buffer. Patch by ebfe.
+
+- Issue #4228: Pack negative values the same way as 2.4 in struct's L format.
+
+- Issue #1040026: Fix os.times result on systems where HZ is incorrect.
+
+- Issues #3167, #3682: Fix test_math failures for log, log10 on Solaris,
+ OpenBSD.
+
+- Issue #4583: array.array would not always prohibit resizing when a buffer
+ has been exported, resulting in an interpreter crash when accessing the
+ buffer.
+
+
+- Issue #5228: Make functools.partial objects can now be pickled.
+
+Tests
+-----
+
+- Issue #6152: New option '-j'/'--multiprocess' for regrtest allows running
+ regression tests in parallel, shortening the total runtime.
+
+- Issue #5450: Moved tests involving loading tk from Lib/test/test_tcl to
+ Lib/tkinter/test/test_tkinter/test_loadtk. With this, these tests demonstrate
+ the same behaviour as test_ttkguionly (and now also test_tk) which is to
+ skip the tests if DISPLAY is defined but can't be used.
+
+- regrtest no longer treats ImportError as equivalent to SkipTest. Imports
+ that should cause a test to be skipped are now done using import_module
+ from test support, which does the conversion.
+
+- Issue #5083: New 'gui' resource for regrtest.
+
+
+Docs
+----
+
+
What's New in Python 3.0 final
==============================
diff --git a/Misc/NEWS b/Misc/NEWS
--- a/Misc/NEWS
+++ b/Misc/NEWS
@@ -5,14 +5,147 @@
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
-----------------
+- Issue #14783: Improve int() docstring and switch docstrings for str(),
+ range(), and slice() to use multi-line signatures.
+
+- Issue #15379: Fix passing of non-BMP characters as integers for the charmap
+ decoder (already working as unicode strings). Patch by Serhiy Storchaka.
+
+- Issue #15144: Fix possible integer overflow when handling pointers as integer
+ values, by using `Py_uintptr_t` instead of `size_t`. Patch by Serhiy
+ Storchaka.
+
+- Issue #15965: Explicitly cast `AT_FDCWD` as (int). Required on Solaris 10
+ (which defines `AT_FDCWD` as ``0xffd19553``), harmless on other platforms.
+
+- Issue #15839: Convert SystemErrors in `super()` to RuntimeErrors.
+
+- Issue #15846: Fix SystemError which happened when using `ast.parse()` in an
+ exception handler on code with syntax errors.
+
+- Issue #15801: Make sure mappings passed to '%' formatting are actually
+ subscriptable.
+
+
Library
-------
+- Issue #16169: Fix ctypes.WinError()'s confusion between errno and winerror.
+
+- Issue #16089: Allow ElementTree.TreeBuilder to work again with a non-Element
+ element_factory (fixes a regression in SimpleTAL).
+
+- Issue #16034: Fix performance regressions in the new `bz2.BZ2File`
+ implementation. Initial patch by Serhiy Storchaka.
+
+- Issue #16112: platform.architecture does not correctly escape argument to
+ /usr/bin/file. Patch by David Benjamin.
+
+- Issue #15756: `subprocess.poll()` now properly handles `errno.ECHILD` to
+ return a returncode of 0 when the child has already exited or cannot be waited
+ on.
+
+- Issue #15323: Improve failure message of `Mock.assert_called_once_with()`.
+
+- Issue #16064: ``unittest -m`` claims executable is "python", not "python3".
+
+- Issue #12376: Pass on parameters in `TextTestResult.__init__()` super call.
+
+- Issue #15222: Insert blank line after each message in mbox mailboxes.
+
+- Issue #16013: Fix `csv.Reader` parsing issue with ending quote characters.
+ Patch by Serhiy Storchaka.
+
+- Issue #15421: Fix an OverflowError in `Calendar.itermonthdates()` after
+ `datetime.MAXYEAR`. Patch by Cédric Krier.
+
+- Issue #15970: `xml.etree.ElementTree` now serializes correctly the empty HTML
+ elements 'meta' and 'param'.
+
+- Issue #15842: The `SocketIO.{readable,writable,seekable}` methods now raise
+ ValueError when the file-like object is closed. Patch by Alessandro Moura.
+
+- Issue #15876: Fix a refleak in the `curses` module: window.encoding.
+
+- Issue #15881: Fix `atexit` hook in `multiprocessing`. Original patch by Chris
+ McDonough.
+
+- Issue #15841: The readable(), writable() and seekable() methods of
+ `io.BytesIO` and `io.StringIO` objects now raise ValueError when the object
+ has been closed. Patch by Alessandro Moura.
+
+- Issue #16126: PyErr_Format format mismatch in _testcapimodule.c.
+ Patch by Serhiy Storchaka.
+
+- Issue #15447: Use `subprocess.DEVNULL` in webbrowser, instead of opening
+ `os.devnull` explicitly and leaving it open.
+
+- Issue #15509: `webbrowser.UnixBrowser` no longer passes empty arguments to
+ Popen when ``%action`` substitutions produce empty strings.
+
+- Issue #12776, issue #11839: Call `argparse` type function (specified by
+ add_argument) only once. Before, the type function was called twice in the
+ case where the default was specified and the argument was given as well. This
+ was especially problematic for the FileType type, as a default file would
+ always be opened, even if a file argument was specified on the command line.
+
+- Issue #15906: Fix a regression in `argparse` caused by the preceding change,
+ when ``action='append'``, ``type='str'`` and ``default=[]``.
+
+Tests
+-----
+
+- Issue #16115: Add some tests for the executable argument to
+ subprocess.Popen(). Initial patch by Kushal Das.
+
+- Issue #15304: Fix warning message when `os.chdir()` fails inside
+ `test.support.temp_cwd()`. Patch by Chris Jerdonek.
+
+- Issue #15802: Fix test logic in `TestMaildir.test_create_tmp()`. Patch by
+ Serhiy Storchaka.
+
+- Issue #15557: Add a test suite for the `webbrowser` module, thanks to Anton
+ Barkovsky.
+
+Build
+-----
+
+- Issue #15923: Fix a mistake in ``asdl_c.py`` that resulted in a TypeError
+ after 2801bf875a24 (see #15801).
+
+- Issue #15819: Make sure we can build Python out-of-tree from a readonly source
+ directory. (Somewhat related to issue #9860.)
+
+Documentation
+-------------
+
+- Issue #16115: Improve subprocess.Popen() documentation around args, shell,
+ and executable arguments.
+
+- Issue #15533: Clarify docs and add tests for `subprocess.Popen()`'s cwd
+ argument.
+
+- Issue #15979: Improve timeit documentation.
+
+- Issue #16036: Improve documentation of built-in `int()`'s signature and
+ arguments.
+
+- Issue #15935: Clarification of `argparse` docs, re: add_argument() type and
+ default arguments. Patch contributed by Chris Jerdonek.
+
+- Issue #11964: Document a change in v3.2 to the behavior of the indent
+ parameter of json encoding operations.
+
+Tools/Demos
+-----------
+
What's New in Python 3.3.0?
===========================
@@ -24,13 +157,13 @@
- Issue #16046: Fix loading sourceless legacy .pyo files.
-- Issue #16060: Fix refcounting bug when __trunc__ returns an object
- whose __int__ gives a non-integer. Patch by Serhiy Storchaka.
+- Issue #16060: Fix refcounting bug when `__trunc__()` returns an object whose
+ `__int__()` gives a non-integer. Patch by Serhiy Storchaka.
Extension Modules
-----------------
-- Issue #16012: Fix a regression in pyexpat. The parser's UseForeignDTD()
+- Issue #16012: Fix a regression in pyexpat. The parser's `UseForeignDTD()`
method doesn't require an argument again.
@@ -42,26 +175,26 @@
Core and Builtins
-----------------
-- Issue #15900: Fix reference leak in PyUnicode_TranslateCharmap().
+- Issue #15900: Fix reference leak in `PyUnicode_TranslateCharmap()`.
- Issue #15926: Fix crash after multiple reinitializations of the interpreter.
- Issue #15895: Fix FILE pointer leak in one error branch of
- PyRun_SimpleFileExFlags() when filename points to a pyc/pyo file, closeit
- is false an and set_main_loader() fails.
+ `PyRun_SimpleFileExFlags()` when filename points to a pyc/pyo file, closeit is
+ false an and set_main_loader() fails.
- Fixes for a few crash and memory leak regressions found by Coverity.
Library
-------
-- Issue #15882: Change _decimal to accept any coefficient tuple when
- constructing infinities. This is done for backwards compatibility
- with decimal.py: Infinity coefficients are undefined in _decimal
- (in accordance with the specification).
-
-- Issue #15925: Fix a regression in email.util where the parsedate() and
- parsedate_tz() functions did not return None anymore when the argument could
+- Issue #15882: Change `_decimal` to accept any coefficient tuple when
+ constructing infinities. This is done for backwards compatibility with
+ decimal.py: Infinity coefficients are undefined in _decimal (in accordance
+ with the specification).
+
+- Issue #15925: Fix a regression in `email.util` where the `parsedate()` and
+ `parsedate_tz()` functions did not return None anymore when the argument could
not be parsed.
Extension Modules
@@ -73,7 +206,7 @@
- Issue #15977: Fix memory leak in Modules/_ssl.c when the function
_set_npn_protocols() is called multiple times, thanks to Daniel Sommermann.
-- Issue #15969: faulthandler module: rename dump_tracebacks_later() to
+- Issue #15969: `faulthandler` module: rename dump_tracebacks_later() to
dump_traceback_later() and cancel_dump_tracebacks_later() to
cancel_dump_traceback_later().
@@ -89,35 +222,34 @@
-----------------
- Issue #13992: The trashcan mechanism is now thread-safe. This eliminates
- sporadic crashes in multi-thread programs when several long deallocator
- chains ran concurrently and involved subclasses of built-in container
- types.
-
-- Issue #15784: Modify OSError.__str__() to better distinguish between
- errno error numbers and Windows error numbers.
+ sporadic crashes in multi-thread programs when several long deallocator chains
+ ran concurrently and involved subclasses of built-in container types.
+
+- Issue #15784: Modify `OSError`.__str__() to better distinguish between errno
+ error numbers and Windows error numbers.
- Issue #15781: Fix two small race conditions in import's module locking.
Library
-------
-- Issue #15847: Fix a regression in argparse, which did not accept tuples
- as argument lists anymore.
-
-- Issue #15828: Restore support for C extensions in imp.load_module().
-
-- Issue #15340: Fix importing the random module when /dev/urandom cannot
- be opened. This was a regression caused by the hash randomization patch.
-
-- Issue #10650: Deprecate the watchexp parameter of the Decimal.quantize()
+- Issue #15847: Fix a regression in argparse, which did not accept tuples as
+ argument lists anymore.
+
+- Issue #15828: Restore support for C extensions in `imp.load_module()`.
+
+- Issue #15340: Fix importing the random module when ``/dev/urandom`` cannot be
+ opened. This was a regression caused by the hash randomization patch.
+
+- Issue #10650: Deprecate the watchexp parameter of the `Decimal.quantize()`
method.
-- Issue #15785: Modify window.get_wch() API of the curses module: return
- a character for most keys, and an integer for special keys, instead of
- always returning an integer. So it is now possible to distinguish special
- keys like keypad keys.
-
-- Issue #14223: Fix window.addch() of the curses module for special characters
+- Issue #15785: Modify `window.get_wch()` API of the curses module: return a
+ character for most keys, and an integer for special keys, instead of always
+ returning an integer. So it is now possible to distinguish special keys like
+ keypad keys.
+
+- Issue #14223: Fix `window.addch()` of the curses module for special characters
like curses.ACS_HLINE: the Python function addch(int) and addch(bytes) is now
calling the C function waddch()/mvwaddch() (as it was done in Python 3.2),
instead of wadd_wch()/mvwadd_wch(). The Python function addch(str) is still
@@ -133,10 +265,10 @@
Documentation
-------------
-- Issue #15814: The memoryview enhancements in 3.3.0 accidentally permitted
- the hashing of multi-dimensional memorviews and memoryviews with multi-byte
- item formats. The intended restrictions have now been documented - they
- will be correctly enforced in 3.3.1
+- Issue #15814: The memoryview enhancements in 3.3.0 accidentally permitted the
+ hashing of multi-dimensional memorviews and memoryviews with multi-byte item
+ formats. The intended restrictions have now been documented - they will be
+ correctly enforced in 3.3.1.
What's New in Python 3.3.0 Release Candidate 1?
@@ -150,79 +282,78 @@
- Issue #15573: memoryview comparisons are now performed by value with full
support for any valid struct module format definition.
-- Issue #15316: When an item in the fromlist for __import__ doesn't exist,
+- Issue #15316: When an item in the fromlist for `__import__()` doesn't exist,
don't raise an error, but if an exception is raised as part of an import do
let that propagate.
-- Issue #15778: ensure that str(ImportError(msg)) returns a str
- even when msg isn't a str.
-
-- Issue #2051: Source file permission bits are once again correctly
- copied to the cached bytecode file. (The migration to importlib
- reintroduced this problem because these was no regression test. A test
- has been added as part of this patch)
-
-- Issue #15761: Fix crash when PYTHONEXECUTABLE is set on Mac OS X.
-
-- Issue #15726: Fix incorrect bounds checking in PyState_FindModule.
- Patch by Robin Schreiber.
-
-- Issue #15604: Update uses of PyObject_IsTrue() to check for and handle
+- Issue #15778: Ensure that ``str(ImportError(msg))`` returns a str even when
+ msg isn't a str.
+
+- Issue #2051: Source file permission bits are once again correctly copied to
+ the cached bytecode file. (The migration to importlib reintroduced this
+ problem because these was no regression test. A test has been added as part of
+ this patch)
+
+- Issue #15761: Fix crash when ``PYTHONEXECUTABLE`` is set on Mac OS X.
+
+- Issue #15726: Fix incorrect bounds checking in PyState_FindModule. Patch by
+ Robin Schreiber.
+
+- Issue #15604: Update uses of `PyObject_IsTrue()` to check for and handle
errors correctly. Patch by Serhiy Storchaka.
-- Issue #14846: importlib.FileFinder now handles the case where the
- directory being searched is removed after a previous import attempt
+- Issue #14846: `importlib.FileFinder` now handles the case where the directory
+ being searched is removed after a previous import attempt.
Library
-------
-- Issue #13370: Ensure that ctypes works on Mac OS X when Python is
- compiled using the clang compiler
-
-- Issue #13072: The array module's 'u' format code is now deprecated and
- will be removed in Python 4.0.
+- Issue #13370: Ensure that ctypes works on Mac OS X when Python is compiled
+ using the clang compiler.
+
+- Issue #13072: The array module's 'u' format code is now deprecated and will be
+ removed in Python 4.0.
- Issue #15544: Fix Decimal.__float__ to work with payload-carrying NaNs.
- Issue #15776: Allow pyvenv to work in existing directory with --clean.
-- Issue #15249: BytesGenerator now correctly mangles From lines (when
+- Issue #15249: email's BytesGenerator now correctly mangles From lines (when
requested) even if the body contains undecodable bytes.
- Issue #15777: Fix a refleak in _posixsubprocess.
-- Issue ##665194: Update email.utils.localtime to use datetime.astimezone and
+- Issue ##665194: Update `email.utils.localtime` to use datetime.astimezone and
correctly handle historic changes in UTC offsets.
- Issue #15199: Fix JavaScript's default MIME type to application/javascript.
Patch by Bohuslav Kabrda.
-- Issue #12643: code.InteractiveConsole now respects sys.excepthook when
- displaying exceptions (Patch by Aaron Iles)
-
-- Issue #13579: string.Formatter now understands the 'a' conversion specifier.
-
-- Issue #15595: Fix subprocess.Popen(universal_newlines=True)
- for certain locales (utf-16 and utf-32 family). Patch by Chris Jerdonek.
+- Issue #12643: `code.InteractiveConsole` now respects `sys.excepthook` when
+ displaying exceptions. Patch by Aaron Iles.
+
+- Issue #13579: `string.Formatter` now understands the 'a' conversion specifier.
+
+- Issue #15595: Fix ``subprocess.Popen(universal_newlines=True)`` for certain
+ locales (utf-16 and utf-32 family). Patch by Chris Jerdonek.
- Issue #15477: In cmath and math modules, add workaround for platforms whose
system-supplied log1p function doesn't respect signs of zeros.
-- Issue #15715: importlib.__import__() will silence an ImportError when the use
- of fromlist leads to a failed import.
-
-- Issue #14669: Fix pickling of connections and sockets on MacOSX
- by sending/receiving an acknowledgment after file descriptor transfer.
- TestPicklingConnection has been reenabled for MacOSX.
+- Issue #15715: `importlib.__import__()` will silence an ImportError when the
+ use of fromlist leads to a failed import.
+
+- Issue #14669: Fix pickling of connections and sockets on Mac OS X by
+ sending/receiving an acknowledgment after file descriptor transfer.
+ TestPicklingConnection has been reenabled for Mac OS X.
- Issue #11062: Fix adding a message from file to Babyl mailbox.
-- Issue #15646: Prevent equivalent of a fork bomb when using
- multiprocessing on Windows without the "if __name__ == '__main__'"
- idiom.
-
-- Issue #15678: Fix IDLE menus when started from OS X command line
- (3.3.0b2 regression).
+- Issue #15646: Prevent equivalent of a fork bomb when using `multiprocessing`
+ on Windows without the ``if __name__ == '__main__'`` idiom.
+
+- Issue #15678: Fix IDLE menus when started from OS X command line (3.3.0b2
+ regression).
C API
-----
@@ -236,44 +367,42 @@
Documentation
-------------
-- Issue #14674: Add a discussion of the json module's standard compliance.
+- Issue #14674: Add a discussion of the `json` module's standard compliance.
Patch by Chris Rebert.
- Create a 'Concurrent Execution' section in the docs, and split up the
'Optional Operating System Services' section to use a more user-centric
- classification scheme (splitting them across the new CE section, IPC and
- text processing). Operating system limitatons can be reflected with
- the Sphinx :platform: tag, it doesn't make sense as part of the Table of
- Contents.
-
-- Issue #4966: Bring the sequence docs up to date for the Py3k transition
- and the many language enhancements since they were original written
+ classification scheme (splitting them across the new CE section, IPC and text
+ processing). Operating system limitatons can be reflected with the Sphinx
+ ``:platform:`` tag, it doesn't make sense as part of the Table of Contents.
+
+- Issue #4966: Bring the sequence docs up to date for the Py3k transition and
+ the many language enhancements since they were original written.
- The "path importer" misnomer has been replaced with Eric Snow's
- more-awkward-but-at-least-not-wrong suggestion of "path based finder" in
- the import system reference docs
-
-- Issue #15640: Document importlib.abc.Finder as deprecated.
-
-- Issue #15630: Add an example for "continue" stmt in the tutorial. Patch by
+ more-awkward-but-at-least-not-wrong suggestion of "path based finder" in the
+ import system reference docs.
+
+- Issue #15640: Document `importlib.abc.Finder` as deprecated.
+
+- Issue #15630: Add an example for "continue" stmt in the tutorial. Patch by
Daniel Ellis.
Tests
-----
- Issue #15747: ZFS always returns EOPNOTSUPP when attempting to set the
- UF_IMMUTABLE flag (via either chflags or lchflags); refactor affected
- tests in test_posix.py to account for this.
-
-- Issue #15285: Refactor the approach for testing connect timeouts using
- two external hosts that have been configured specifically for this type
- of test.
-
-- Issue #15743: Remove the deprecated method usage in urllib tests. Patch by
+ UF_IMMUTABLE flag (via either chflags or lchflags); refactor affected tests in
+ test_posix.py to account for this.
+
+- Issue #15285: Refactor the approach for testing connect timeouts using two
+ external hosts that have been configured specifically for this type of test.
+
+- Issue #15743: Remove the deprecated method usage in `urllib` tests. Patch by
Jeff Knupp.
-- Issue #15615: Add some tests for the json module's handling of invalid
- input data. Patch by Kushal Das.
+- Issue #15615: Add some tests for the `json` module's handling of invalid input
+ data. Patch by Kushal Das.
Build
-----
@@ -282,11 +411,11 @@
- Pick up 32-bit launcher from PGO directory on 64-bit PGO build.
-- Drop PC\python_nt.h as it's not used. Add input dependency on custom
+- Drop ``PC\python_nt.h`` as it's not used. Add input dependency on custom
build step.
-- Issue #15511: Drop explicit dependency on pythonxy.lib from _decimal
- amd64 configuration.
+- Issue #15511: Drop explicit dependency on pythonxy.lib from _decimal amd64
+ configuration.
- Add missing PGI/PGO configurations for pywlauncher.
@@ -301,15 +430,15 @@
Core and Builtins
-----------------
-- Issue #15568: Fix the return value of "yield from" when StopIteration is
+- Issue #15568: Fix the return value of ``yield from`` when StopIteration is
raised by a custom iterator.
-- Issue #13119: sys.stdout and sys.stderr are now using "\r\n" newline on
+- Issue #13119: `sys.stdout` and `sys.stderr` are now using "\r\n" newline on
Windows, as Python 2.
- Issue #15534: Fix the fast-search function for non-ASCII Unicode strings.
-- Issue #15508: Fix the docstring for __import__ to have the proper default
+- Issue #15508: Fix the docstring for `__import__()` to have the proper default
value of 0 for 'level' and to not mention negative levels since they are not
supported.
@@ -322,17 +451,17 @@
byte code files) equal between 32-bit and 64-bit systems.
- Issue #1692335: Move initial exception args assignment to
- "BaseException.__new__" to help pickling of naive subclasses.
-
-- Issue #12834: Fix PyBuffer_ToContiguous() for non-contiguous arrays.
-
-- Issue #15456: Fix code __sizeof__ after #12399 change. Patch by Serhiy
+ `BaseException.__new__()` to help pickling of naive subclasses.
+
+- Issue #12834: Fix `PyBuffer_ToContiguous()` for non-contiguous arrays.
+
+- Issue #15456: Fix code `__sizeof__()` after #12399 change. Patch by Serhiy
Storchaka.
- Issue #15404: Refleak in PyMethodObject repr.
-- Issue #15394: An issue in PyModule_Create that caused references to be leaked
- on some error paths has been fixed. Patch by Julia Lawall.
+- Issue #15394: An issue in `PyModule_Create()` that caused references to be
+ leaked on some error paths has been fixed. Patch by Julia Lawall.
- Issue #15368: An issue that caused bytecode generation to be non-deterministic
has been fixed.
@@ -340,7 +469,7 @@
- Issue #15202: Consistently use the name "follow_symlinks" for new parameters
in os and shutil functions.
-- Issue #15314: __main__.__loader__ is now set correctly during interpreter
+- Issue #15314: ``__main__.__loader__`` is now set correctly during interpreter
startup.
- Issue #15111: When a module imported using 'from import' has an ImportError
@@ -358,10 +487,13 @@
- Issue #15020: The program name used to search for Python's path is now
"python3" under Unix, not "python".
+- Issue #15897: zipimport.c doesn't check return value of fseek().
+ Patch by Felipe Cruz.
+
- Issue #15033: Fix the exit status bug when modules invoked using -m swith,
return the proper failure return value (1). Patch contributed by Jeff Knupp.
-- Issue #15229: An OSError subclass whose __init__ doesn't call back
+- Issue #15229: An `OSError` subclass whose __init__ doesn't call back
OSError.__init__ could produce incomplete instances, leading to crashes when
calling str() on them.
@@ -371,41 +503,41 @@
Library
-------
-- Issue #15424: Add a __sizeof__ implementation for array objects. Patch by
+- Issue #15424: Add a `__sizeof__()` implementation for array objects. Patch by
Ludwig Hähne.
- Issue #15576: Allow extension modules to act as a package's __init__ module.
-- Issue #15502: Have importlib.invalidate_caches() work on sys.meta_path instead
- of sys.path_importer_cache.
+- Issue #15502: Have `importlib.invalidate_caches()` work on `sys.meta_path`
+ instead of `sys.path_importer_cache`.
- Issue #15163: Pydoc shouldn't list __loader__ as module data.
- Issue #15471: Do not use mutable objects as defaults for
- importlib.__import__().
+ `importlib.__import__()`.
- Issue #15559: To avoid a problematic failure mode when passed to the bytes
- constructor, objects in the ipaddress module no longer implement __index__
- (they still implement __int__ as appropriate)
+ constructor, objects in the ipaddress module no longer implement `__index__()`
+ (they still implement `__int__()` as appropriate).
- Issue #15546: Fix handling of pathological input data in the peek() and
read1() methods of the BZ2File, GzipFile and LZMAFile classes.
- Issue #13052: Fix IDLE crashing when replace string in Search/Replace dialog
- ended with '\'. Patch by Roger Serwy.
-
-- Issue #12655: Instead of requiring a custom type, os.sched_getaffinity and
- os.sched_setaffinity now use regular sets of integers to represent the CPUs a
- process is restricted to.
-
-- Issue #15538: Fix compilation of the getnameinfo() / getaddrinfo() emulation
- code. Patch by Philipp Hagemeister.
+ ended with ``\``. Patch by Roger Serwy.
+
+- Issue #12655: Instead of requiring a custom type, `os.sched_getaffinity()` and
+ `os.sched_setaffinity()` now use regular sets of integers to represent the
+ CPUs a process is restricted to.
+
+- Issue #15538: Fix compilation of the `socket.getnameinfo()` /
+ `socket.getaddrinfo()` emulation code. Patch by Philipp Hagemeister.
- Issue #15519: Properly expose WindowsRegistryFinder in importlib (and use the
- correct term for it). Original patch by Eric Snow.
+ correct term for it). Original patch by Eric Snow.
- Issue #15502: Bring the importlib ABCs into line with the current state of the
- import protocols given PEP 420. Original patch by Eric Snow.
+ import protocols given PEP 420. Original patch by Eric Snow.
- Issue #15499: Launching a webbrowser in Unix used to sleep for a few seconds.
Original patch by Anton Barkovsky.
@@ -413,37 +545,38 @@
- Issue #15463: The faulthandler module truncates strings to 500 characters,
instead of 100, to be able to display long file paths.
-- Issue #6056: Make multiprocessing use setblocking(True) on the sockets it
+- Issue #6056: Make `multiprocessing` use setblocking(True) on the sockets it
uses. Original patch by J Derek Wilson.
- Issue #15364: Fix sysconfig.get_config_var('srcdir') to be an absolute path.
- Issue #15041: Update "see also" list in tkinter documentation.
-- Issue #15413: os.times() had disappeared under Windows.
-
-- Issue #15402: An issue in the struct module that caused sys.getsizeof to
+- Issue #15413: `os.times()` had disappeared under Windows.
+
+- Issue #15402: An issue in the struct module that caused `sys.getsizeof()` to
return incorrect results for struct.Struct instances has been fixed. Initial
patch by Serhiy Storchaka.
-- Issue #15232: When mangle_from is True, email.Generator now correctly mangles
- lines that start with 'From ' that occur in a MIME preamble or epilogue.
+- Issue #15232: When mangle_from is True, `email.Generator` now correctly
+ mangles lines that start with 'From ' that occur in a MIME preamble or
+ epilogue.
- Issue #15094: Incorrectly placed #endif in _tkinter.c. Patch by Serhiy
Storchaka.
-- Issue #13922: argparse no longer incorrectly strips '--'s that appear after
+- Issue #13922: `argparse` no longer incorrectly strips '--'s that appear after
the first one.
-- Issue #12353: argparse now correctly handles null argument values.
+- Issue #12353: `argparse` now correctly handles null argument values.
- Issue #10017, issue #14998: Fix TypeError using pprint on dictionaries with
user-defined types as keys or other unorderable keys.
-- Issue #15397: inspect.getmodulename() is now based directly on importlib via a
- new importlib.machinery.all_suffixes() API.
-
-- Issue #14635: telnetlib will use poll() rather than select() when possible to
+- Issue #15397: `inspect.getmodulename()` is now based directly on importlib via
+ a new `importlib.machinery.all_suffixes()` API.
+
+- Issue #14635: `telnetlib` will use poll() rather than select() when possible to
avoid failing due to the select() file descriptor limit.
- Issue #15180: Clarify posixpath.join() error message when mixing str & bytes.
@@ -460,7 +593,7 @@
- Issue #15233: Python now guarantees that callables registered with the atexit
module will be called in a deterministic order.
-- Issue #15238: shutil.copystat now copies Linux "extended attributes".
+- Issue #15238: `shutil.copystat()` now copies Linux "extended attributes".
- Issue #15230: runpy.run_path now correctly sets __package__ as described in
the documentation.
@@ -470,42 +603,42 @@
- Issue #15294: Fix a regression in pkgutil.extend_path()'s handling of nested
namespace packages.
-- Issue #15056: imp.cache_from_source() and source_from_cache() raise
- NotImplementedError when sys.implementation.cache_tag is set to None.
-
-- Issue #15256: Grammatical mistake in exception raised by imp.find_module().
-
-- Issue #5931: wsgiref environ variable SERVER_SOFTWARE will specify an
+- Issue #15056: `imp.cache_from_source()` and `imp.source_from_cache()` raise
+ NotImplementedError when `sys.implementation.cache_tag` is set to None.
+
+- Issue #15256: Grammatical mistake in exception raised by `imp.find_module()`.
+
+- Issue #5931: `wsgiref` environ variable SERVER_SOFTWARE will specify an
implementation specific term like CPython, Jython instead of generic "Python".
- Issue #13248: Remove obsolete argument "max_buffer_size" of BufferedWriter and
BufferedRWPair, from the io module.
-- Issue #13248: Remove obsolete argument "version" of argparse.ArgumentParser.
+- Issue #13248: Remove obsolete argument "version" of `argparse.ArgumentParser`.
- Issue #14814: Implement more consistent ordering and sorting behaviour for
ipaddress objects.
-- Issue #14814: ipaddress network objects correctly return NotImplemented when
+- Issue #14814: `ipaddress` network objects correctly return NotImplemented when
compared to arbitrary objects instead of raising TypeError.
- Issue #14990: Correctly fail with SyntaxError on invalid encoding declaration.
-- Issue #14814: ipaddress now provides more informative error messages when
+- Issue #14814: `ipaddress` now provides more informative error messages when
constructing instances directly (changes permitted during beta due to
provisional API status).
-- Issue #15247: FileIO now raises an error when given a file descriptor pointing
- to a directory.
+- Issue #15247: `io.FileIO` now raises an error when given a file descriptor
+ pointing to a directory.
- Issue #15261: Stop os.stat(fd) crashing on Windows when fd not open.
-- Issue #15166: Implement imp.get_tag() using sys.implementation.cache_tag.
-
-- Issue #15210: Catch KeyError when importlib.__init__ can't find
+- Issue #15166: Implement `imp.get_tag()` using `sys.implementation.cache_tag`.
+
+- Issue #15210: Catch KeyError when `importlib.__init__()` can't find
_frozen_importlib in sys.modules, not ImportError.
-- Issue #15030: importlib.abc.PyPycLoader now supports the new source size
+- Issue #15030: `importlib.abc.PyPycLoader` now supports the new source size
header field in .pyc files.
- Issue #5346: Preserve permissions of mbox, MMDF and Babyl mailbox files on
@@ -518,7 +651,7 @@
renamed over the old file when flush() is called on an mbox, MMDF or Babyl
mailbox.
-- Issue 10924: Fixed crypt.mksalt() to use a RNG that is suitable for
+- Issue 10924: Fixed `crypt.mksalt()` to use a RNG that is suitable for
cryptographic purpose.
- Issue #15184: Ensure consistent results of OS X configuration tailoring for
@@ -529,10 +662,10 @@
C API
-----
-- Issue #15610: PyImport_ImportModuleEx() now uses a 'level' of 0 instead of -1.
-
-- Issues #15169, #14599: Strip out the C implementation of
- imp.source_from_cache() used by PyImport_ExecCodeModuleWithPathnames() and
+- Issue #15610: `PyImport_ImportModuleEx()` now uses a 'level' of 0 instead of -1.
+
+- Issue #15169, issue #14599: Strip out the C implementation of
+ `imp.source_from_cache()` used by PyImport_ExecCodeModuleWithPathnames() and
used the Python code instead. Leads to PyImport_ExecCodeModuleObject() to not
try to infer the source path from the bytecode path as
PyImport_ExecCodeModuleWithPathnames() does.
@@ -540,8 +673,8 @@
Extension Modules
-----------------
-- Issue #6493: An issue in ctypes on Windows that caused structure bitfields
- of type ctypes.c_uint32 and width 32 to incorrectly be set has been fixed.
+- Issue #6493: An issue in ctypes on Windows that caused structure bitfields of
+ type `ctypes.c_uint32` and width 32 to incorrectly be set has been fixed.
- Issue #15194: Update libffi to the 3.0.11 release.
@@ -556,15 +689,16 @@
- Issue #12605: The gdb hooks for debugging CPython (within Tools/gdb) have been
enhanced to show information on more C frames relevant to CPython within the
"py-bt" and "py-bt-full" commands:
- * C frames that are waiting on the GIL
- * C frames that are garbage-collecting
- * C frames that are due to the invocation of a PyCFunction
+
+ * C frames that are waiting on the GIL
+ * C frames that are garbage-collecting
+ * C frames that are due to the invocation of a PyCFunction
Documentation
-------------
-- Issue #15444: Use proper spelling for non-ASCII contributor names. Patch
- by Serhiy Storchaka.
+- Issue #15444: Use proper spelling for non-ASCII contributor names. Patch by
+ Serhiy Storchaka.
- Issue #15295: Reorganize and rewrite the documentation on the import system.
@@ -579,25 +713,25 @@
"changed" since they will no longer work with modules directly imported by
import itself.
-- Issue #13557: Clarify effect of giving two different namespaces to exec or
- execfile().
-
-- Issue #15250: Document that filecmp.dircmp compares files shallowly. Patch
+- Issue #13557: Clarify effect of giving two different namespaces to `exec()` or
+ `execfile()`.
+
+- Issue #15250: Document that `filecmp.dircmp()` compares files shallowly. Patch
contributed by Chris Jerdonek.
Tests
-----
-- Issue #15467: Move helpers for __sizeof__ tests into test_support. Patch by
- Serhiy Storchaka.
+- Issue #15467: Move helpers for `__sizeof__()` tests into test_support. Patch
+ by Serhiy Storchaka.
- Issue #15320: Make iterating the list of tests thread-safe when running tests
in multiprocess mode. Patch by Chris Jerdonek.
-- Issue #15168: Move importlib.test to test.test_importlib.
+- Issue #15168: Move `importlib.test` to `test.test_importlib`.
- Issue #15091: Reactivate a test on UNIX which was failing thanks to a
- forgotten importlib.invalidate_caches() call.
+ forgotten `importlib.invalidate_caches()` call.
- Issue #15230: Adopted a more systematic approach in the runpy tests.
@@ -1943,6 +2077,10 @@
- PEP 3151 / issue #12555: reworking the OS and IO exception hierarchy.
+- Issue #13560: Add PyUnicode_DecodeLocale(), PyUnicode_DecodeLocaleAndSize()
+ and PyUnicode_EncodeLocale() functions to the C API to decode/encode from/to
+ the current locale encoding.
+
- Add internal API for static strings (_Py_identifier et al.).
- Issue #13063: the Windows error ERROR_NO_DATA (numbered 232 and described
@@ -2357,11 +2495,6 @@
make sure two listeners can't bind to the same socket/pipe (or any existing
socket/pipe).
-- Issue #9021: Add an introduction to the copy module documentation.
-
-- Issue #6005: Examples in the socket library documentation use sendall, where
- relevant, instead send method.
-
- Issue #10811: Fix recursive usage of cursors. Instead of crashing,
raise a ProgrammingError now.
@@ -2470,8 +2603,6 @@
- Add a flags parameter to select.epoll.
-- Issue #12798: Updated the mimetypes documentation.
-
- Issue #13626: Add support for SSL Diffie-Hellman key exchange, through the
SSLContext.load_dh_params() method and the ssl.OP_SINGLE_DH_USE option.
@@ -2516,10 +2647,6 @@
- Issue #13560: os.strerror() now uses the current locale encoding instead of
UTF-8.
-- Issue #13560: Add PyUnicode_DecodeLocale(), PyUnicode_DecodeLocaleAndSize()
- and PyUnicode_EncodeLocale() functions to the C API to decode/encode from/to
- the current locale encoding.
-
- Issue #8373: The filesystem path of AF_UNIX sockets now uses the filesystem
encoding and the surrogateescape error handler, rather than UTF-8. Patch
by David Watson.
@@ -2704,7 +2831,7 @@
- Issue #8540: Remove deprecated Context._clamp attribute in Decimal module.
-- Issue #13235: Added PendingDeprecationWarning to warn() method and function.
+- Issue #13235: Added DeprecationWarning to logging.warn() method and function.
- Issue #9168: now smtpd is able to bind privileged port.
@@ -2725,12 +2852,12 @@
in order to display the prompt correctly.
- Issue #12454: The mailbox module is now using ASCII, instead of the locale
- encoding, to read and write MH mailboxes (.mh_sequences files).
+ encoding, to read and write .mh_sequences files.
- Issue #13194: zlib.compressobj().copy() and zlib.decompressobj().copy() are
now available on Windows.
-- issue #1673007: urllib2 to support HEAD request via new method argument.
+- Issue #1673007: urllib.request now supports HEAD request via new method argument.
Patch contributions by David Stanek, Patrick Westerhoff and Ezio Melotti.
- Issue #12386: packaging does not fail anymore when writing the RESOURCES
@@ -2771,8 +2898,6 @@
metaclass is registered with copyreg. Patch by Nicolas M. Thiéry and Craig
Citro.
-- Issue #4147: minidom's toprettyxml no longer adds whitespace to text nodes.
-
- Issue #13034: When decoding some SSL certificates, the subjectAltName
extension could be unreported.
@@ -2882,8 +3007,9 @@
- Issue #12540: Prevent zombie IDLE processes on Windows due to changes
in os.kill().
-- Add support for unary plus and unary minus to collections.Counter().
- Issue #13121: Also add support for inplace math operators.
+- Issue #13121: add support for inplace math operators to collections.Counter.
+
+- Add support for unary plus and unary minus to collections.Counter.
- Issue #12683: urlparse updated to include svn as schemes that uses relative
paths. (svn from 1.5 onwards support relative path).
@@ -2908,11 +3034,11 @@
- Issue #8887: "pydoc somebuiltin.somemethod" (or help('somebuiltin.somemethod')
in Python code) now finds the doc of the method.
-- Issue #10968: Remove indirection in threading. The public names (Thread,
+- Issue #10968: Remove indirection in threading. The public names (Event,
Condition, etc.) used to be factory functions returning instances of hidden
- classes (_Thread, _Condition, etc.), because (if Guido recalls correctly) this
- code pre-dates the ability to subclass extension types. It is now possible to
- inherit from Thread and other classes, without having to import the private
+ classes (_Event, _Condition, etc.), because (if Guido recalls correctly) this
+ code pre-dates the ability to subclass extension types. It is now possible
+ to inherit from these classes, without having to import the private
underscored names like multiprocessing did.
- Issue #9723: Add shlex.quote functions, to escape filenames and command
@@ -3036,7 +3162,7 @@
- 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.
@@ -3189,7 +3315,7 @@
if the file is closed.
- Issue #11109: New service_action method for BaseServer, used by ForkingMixin
- class for cleanup. Initial Patch by Justin Wark.
+ class for cleanup. Initial Patch by Justin Warkentin.
- Issue #12045: Avoid duplicate execution of command in
ctypes.util._get_soname(). Patch by Sijin Joseph.
@@ -3274,9 +3400,9 @@
- Issue #12011: signal.signal() and signal.siginterrupt() raise an OSError,
instead of a RuntimeError: OSError has an errno attribute.
-- Issue #3709: a flush_headers method to BaseHTTPRequestHandler which manages
- the sending of headers to output stream and flushing the internal headers
- buffer. Patch contribution by Andrew Schaaf
+- Issue #3709: add a flush_headers method to BaseHTTPRequestHandler, which
+ manages the sending of headers to output stream and flushing the internal
+ headers buffer. Patch contribution by Andrew Schaaf
- Issue #11743: Rewrite multiprocessing connection classes in pure Python.
@@ -3578,7 +3704,7 @@
not installed. Instead, the zipfile.ZIP_STORED compression is used to create
the ZipFile. Patch by Natalia B. Bidart.
-- Issue #11289: `smtp.SMTP` class becomes a context manager so it can be used
+- Issue #11289: `smtp.SMTP` class is now a context manager so it can be used
in a `with` statement. Contributed by Giampaolo Rodola.
- Issue #11554: Fixed support for Japanese codecs; previously the body output
@@ -3590,7 +3716,7 @@
- Issue #11407: `TestCase.run` returns the result object used or created.
Contributed by Janathan Hartley.
-- Issue #11500: Fixed a bug in the os x proxy bypass code for fully qualified
+- Issue #11500: Fixed a bug in the OS X proxy bypass code for fully qualified
IP addresses in the proxy exception list.
- Issue #11491: dbm.error is no longer raised when dbm.open is called with
@@ -3747,7 +3873,7 @@
functions (BSD and OS X). Also add new stat file flags for OS X
(UF_HIDDEN and UF_COMPRESSED).
-- Issue #10645: Installing Python does no longer create a
+- Issue #10645: Installing Python no longer creates a
Python-X.Y.Z-pyX.Y.egg-info file in the lib-dynload directory.
- Do not accidentally include the directory containing sqlite.h twice when
@@ -4088,6 +4214,9 @@
Documentation
-------------
+- Issue #13498: Clarify docs of os.makedirs()'s exist_ok argument. Done with
+ great native-speaker help from R. David Murray.
+
- Issues #13491 and #13995: Fix many errors in sqlite3 documentation.
Initial patch for #13491 by Johannes Vogel.
@@ -4095,6 +4224,13 @@
- Issue #13883: PYTHONCASEOK also works on OS X.
+- Issue #9021: Add an introduction to the copy module documentation.
+
+- Issue #6005: Examples in the socket library documentation use sendall, where
+ relevant, instead send method.
+
+- Issue #12798: Updated the mimetypes documentation.
+
- Issue #12949: Document the kwonlyargcount argument for the PyCode_New
C API function.
@@ -4109,5401 +4245,4 @@
- Issue #11818: Fix tempfile examples for Python 3.
-What's New in Python 3.2?
-=========================
-
-*Release date: 20-Feb-2011*
-
-Core and Builtins
------------------
-
-- Issue #11249: Fix potential crashes when using the limited API.
-
-Build
------
-
-- Issue #11222: Fix non-framework shared library build on Mac OS X.
-
-- Issue #11184: Fix large-file support on AIX.
-
-- Issue #941346: Fix broken shared library build on AIX.
-
-Documentation
--------------
-
-- Issue #10709: Add updated AIX notes in Misc/README.AIX.
-
-
-What's New in Python 3.2 Release Candidate 3?
-=============================================
-
-*Release date: 13-Feb-2011*
-
-Core and Builtins
------------------
-
-- Issue #11134: Add missing fields to typeslots.h.
-
-- Issue #11135: Remove redundant doc field from PyType_Spec.
-
-- Issue #11067: Add PyType_GetFlags, to support PyUnicode_Check in the limited
- ABI.
-
-- Issue #11118: Fix bogus export of None in python3.dll.
-
-Library
--------
-
-- Issue #11116: any error during addition of a message to a mailbox now causes a
- rollback, instead of leaving the mailbox partially modified.
-
-- Issue #11132: Fix passing of "optimize" parameter when recursing in
- compileall.compile_dir().
-
-- Issue #11110: Fix a potential decref of a NULL in sqlite3.
-
-- Issue #8275: Fix passing of callback arguments with ctypes under Win64. Patch
- by Stan Mihai.
-
-Build
------
-
-- Issue #11079: The /Applications/Python x.x folder created by the Mac OS X
- installers now includes a link to the installed documentation and no longer
- includes an Extras directory. The Tools directory is now installed in the
- framework under share/doc.
-
-- Issue #11121: Fix building with --enable-shared.
-
-Tests
------
-
-- Issue #10971: test_zipimport_support is once again compatible with the refleak
- hunter feature of test.regrtest.
-
-
-What's New in Python 3.2 Release Candidate 2?
-=============================================
-
-*Release date: 30-Jan-2011*
-
-Core and Builtins
------------------
-
-- Issue #10451: memoryview objects could allow to mutate a readable buffer.
- Initial patch by Ross Lagerwall.
-
-Library
--------
-
-- Issue #9124: mailbox now accepts binary input and reads and writes mailbox
- files in binary mode, using the email package's binary support to parse
- arbitrary email messages. StringIO and text file input is deprecated,
- and string input fails early if non-ASCII characters are used, where
- previously it would fail when the email was processed in a later step.
-
-- Issue #10845: Mitigate the incompatibility between the multiprocessing
- module on Windows and the use of package, zipfile or directory execution
- by special casing main modules that actually *are* called __main__.py.
-
-- Issue #11045: Protect logging call against None argument.
-
-- Issue #11052: Correct IDLE menu accelerators on Mac OS X for Save
- commands.
-
-- Issue #11053: Fix IDLE "Syntax Error" windows to behave as in 2.x,
- preventing a confusing hung appearance on OS X with the windows
- obscured.
-
-- Issue #10940: Workaround an IDLE hang on Mac OS X 10.6 when using the
- menu accelerators for Open Module, Go to Line, and New Indent Width.
- The accelerators still work but no longer appear in the menu items.
-
-- Issue #10989: Fix a crash on SSLContext.load_verify_locations(None, True).
-
-- Issue #11020: Command-line pyclbr was broken because of missing 2-to-3
- conversion.
-
-- Issue #11019: Fixed BytesGenerator so that it correctly handles a Message
- with a None body.
-
-- Issue #11014: Make 'filter' argument in tarfile.Tarfile.add() into a
- keyword-only argument. The preceding positional argument was deprecated,
- so it made no sense to add filter as a positional argument.
-
-- Issue #11004: Repaired edge case in deque.count().
-
-- Issue #10974: IDLE no longer crashes if its recent files list includes files
- with non-ASCII characters in their path names.
-
-- Have hashlib.algorithms_available and hashlib.algorithms_guaranteed both
- return sets instead of one returning a tuple and the other a frozenset.
-
-- Issue #10987: Fix the recursion limit handling in the _pickle module.
-
-- Issue #10983: Fix several bugs making tunnel requests in http.client.
-
-- Issue #10955: zipimport uses ASCII encoding instead of cp437 to decode
- filenames, at bootstrap, if the codec registry is not ready yet. It is still
- possible to have non-ASCII filenames using the Unicode flag (UTF-8 encoding)
- for all file entries in the ZIP file.
-
-- Issue #10949: Improved robustness of rotating file handlers.
-
-- Issue #10955: Fix a potential crash when trying to mmap() a file past its
- length. Initial patch by Ross Lagerwall.
-
-- Issue #10898: Allow compiling the posix module when the C library defines
- a symbol named FSTAT.
-
-- Issue #10980: the HTTP server now encodes headers with iso-8859-1 (latin1)
- encoding. This is the preferred encoding of PEP 3333 and the base encoding
- of HTTP 1.1.
-
-- To match the behaviour of HTTP server, the HTTP client library now also
- encodes headers with iso-8859-1 (latin1) encoding. It was already doing
- that for incoming headers which makes this behaviour now consistent in
- both incoming and outgoing direction.
-
-- Issue #9509: argparse now properly handles IOErrors raised by
- argparse.FileType.
-
-- Issue #10961: The new pydoc server now better handles exceptions raised
- during request handling.
-
-- Issue #10680: Fix mutually exclusive arguments for argument groups in
- argparse.
-
-Build
------
-
-- Issue #11054: Allow Mac OS X installer builds to again work on 10.5 with
- the system-provided Python.
-
-
-What's New in Python 3.2 Release Candidate 1
-============================================
-
-*Release date: 16-Jan-2011*
-
-Core and Builtins
------------------
-
-- Issue #10889: range indexing and slicing now works correctly on ranges with
- a length that exceeds sys.maxsize.
-
-- Issue #10892: Don't segfault when trying to delete __abstractmethods__ from a
- class.
-
-- Issue #8020: Avoid a crash where the small objects allocator would read
- non-Python managed memory while it is being modified by another thread. Patch
- by Matt Bandy.
-
-- Issue #10841: On Windows, set the binary mode on stdin, stdout, stderr and all
- io.FileIO objects (to not translate newlines, \r\n <=> \n). The Python parser
- translates newlines (\r\n => \n).
-
-- Remove buffer API from stable ABI for now, see #10181.
-
-- Issue #8651: PyArg_Parse*() functions raise an OverflowError if the file
- doesn't have PY_SSIZE_T_CLEAN define and the size doesn't fit in an int
- (length bigger than 2^31-1 bytes).
-
-- Issue #9015, #9611: FileIO.readinto(), FileIO.write(), os.write() and
- stdprinter.write() clamp the length to INT_MAX on Windows.
-
-- Issue #8278: On Windows and with a NTFS filesystem, os.stat() and os.utime()
- can now handle dates after 2038.
-
-- Issue #10780: PyErr_SetFromWindowsErrWithFilename() and
- PyErr_SetExcFromWindowsErrWithFilename() decode the filename from the
- filesystem encoding instead of UTF-8.
-
-- Issue #10779: PyErr_WarnExplicit() decodes the filename from the filesystem
- encoding instead of UTF-8.
-
-- Add sys.flags attribute for the new -q command-line option.
-
-- Issue #11506: Trying to assign to a bytes literal should result in a
- SyntaxError.
-
-Library
--------
-
-- Issue #10916: mmap should not segfault when a file is mapped using 0 as length
- and a non-zero offset, and an attempt to read past the end of file is made
- (IndexError is raised instead). Patch by Ross Lagerwall.
-
-- Issue #10154, #10090: change the normalization of UTF-8 to "UTF-8" instead
- of "UTF8" in the locale module as the latter is not supported MacOSX and OpenBSD.
-
-- Issue #10907: Warn OS X 10.6 IDLE users to use ActiveState Tcl/Tk 8.5, rather
- than the currently problematic Apple-supplied one, when running with the
- 64-/32-bit installer variant.
-
-- Issue #4953: cgi.FieldStorage and cgi.parse() parse the request as bytes, not
- as unicode, and accept binary files. Add encoding and errors attributes to
- cgi.FieldStorage. Patch written by Pierre Quentel (with many inputs by Glenn
- Linderman).
-
-- Add encoding and errors arguments to urllib.parse_qs() and urllib.parse_qsl().
-
-- Issue #10899: No function type annotations in the standard library. Removed
- function type annotations from _pyio.py.
-
-- Issue #10875: Update Regular Expression HOWTO; patch by 'SilentGhost'.
-
-- Issue #10872: The repr() of TextIOWrapper objects now includes the mode
- if available.
-
-- Issue #10869: Fixed bug where ast.increment_lineno modified the root node
- twice.
-
-- Issue #5871: email.header.Header.encode now raises an error if any
- continuation line in the formatted value has no leading white space and looks
- like a header. Since Generator uses Header to format all headers, this check
- is made for all headers in any serialized message at serialization time. This
- provides protection against header injection attacks.
-
-- Issue #10859: Make ``contextlib.GeneratorContextManager`` officially
- private by renaming it to ``_GeneratorContextManager``.
-
-- Issue #10042: Fixed the total_ordering decorator to handle cross-type
- comparisons that could lead to infinite recursion.
-
-- Issue #10686: the email package now :rfc:`2047`\ -encodes headers with
- non-ASCII bytes (parsed by a BytesParser) when doing conversion to 7bit-clean
- presentation, instead of replacing them with ?s.
-
-- email.header.Header was incorrectly encoding folding whitespace when
- rfc2047-encoding header values with embedded newlines, leaving them without
- folding whitespace. It now uses the continuation_ws, as it does for
- continuation lines that it creates itself.
-
-- Issue #1777412, #10827: Changed the rules for 2-digit years. The
- time.asctime(), time.ctime() and time.strftime() functions will now format
- any year when ``time.accept2dyear`` is False and will accept years >= 1000
- otherwise. ``time.mktime`` and ``time.strftime`` now accept full range
- supported by the OS. With Visual Studio or on Solaris, the year is limited to
- the range [1; 9999]. Conversion of 2-digit years to 4-digit is deprecated.
-
-- Issue #7858: Raise an error properly when os.utime() fails under Windows
- on an existing file.
-
-- Issue #3839: wsgiref should not override a Content-Length header set by
- the application. Initial patch by Clovis Fabricio.
-
-- Issue #10492: bdb.Bdb.run() only traces the execution of the code, not the
- compilation (if the input is a string).
-
-- Issue #7995: When calling accept() on a socket with a timeout, the returned
- socket is now always blocking, regardless of the operating system.
-
-- Issue #10756: atexit normalizes the exception before displaying it. Patch by
- Andreas Stührk.
-
-- Issue #10790: email.header.Header.append's charset logic now works correctly
- for charsets whose output codec is different from its input codec.
-
-- Issue #10819: SocketIO.name property returns -1 when its closed, instead of
- raising a ValueError, to fix repr().
-
-- Issue #8650: zlib.compress() and zlib.decompress() raise an OverflowError if
- the input buffer length doesn't fit into an unsigned int (length bigger than
- 2^32-1 bytes).
-
-- Issue #6643: Reinitialize locks held within the threading module after fork to
- avoid a potential rare deadlock or crash on some platforms.
-
-- Issue #10806, issue #9905: Fix subprocess pipes when some of the standard file
- descriptors (0, 1, 2) are closed in the parent process. Initial patch by Ross
- Lagerwall.
-
-- `unittest.TestCase` can be instantiated without a method name; for simpler
- exploration from the interactive interpreter.
-
-- Issue #10798: Reject supporting concurrent.futures if the system has too
- few POSIX semaphores.
-
-- Issue #10807: Remove base64, bz2, hex, quopri, rot13, uu and zlib codecs from
- the codec aliases. They are still accessible via codecs.lookup().
-
-- Issue #10801: In zipfile, support different encodings for the header and the
- filenames.
-
-- Issue #6285: IDLE no longer crashes on missing help file; patch by Scott
- David Daniels.
-
-- Fix collections.OrderedDict.setdefault() so that it works in subclasses that
- define __missing__().
-
-- Issue #10786: unittest.TextTestRunner default stream no longer bound at import
- time. `sys.stderr` now looked up at instantiation time. Fix contributed by
- Mark Roddy.
-
-- Issue #10753: Characters ';', '=' and ',' in the PATH_INFO environment variable
- won't be quoted when the URI is constructed by the wsgiref.util's request_uri
- method. According to RFC 3986, these characters can be a part of params in
- PATH component of URI and need not be quoted.
-
-- Issue #10738: Fix webbrowser.Opera.raise_opts.
-
-- Issue #9824: SimpleCookie now encodes , and ; in values to cater to how
- browsers actually parse cookies.
-
-- Issue #9333: os.symlink now available regardless of user privileges. The
- function now raises OSError on Windows >=6.0 when the user is unable to create
- symbolic links. XP and 2003 still raise NotImplementedError.
-
-- Issue #10783: struct.pack() no longer implicitly encodes unicode to UTF-8.
-
-- Issue #10730: Add SVG mime types to mimetypes module.
-
-- Issue #10768: Make the Tkinter ScrolledText widget work again.
-
-- Issue #10777: Fix "dictionary changed size during iteration" bug in
- ElementTree register_namespace().
-
-- Issue #10626: test_logging now preserves logger disabled states.
-
-- Issue #10774: test_logging now removes temp files created during tests.
-
-- Issue #5258/#10642: if site.py encounters a .pth file that generates an error,
- it now prints the filename, line number, and traceback to stderr and skips
- the rest of that individual file, instead of stopping processing entirely.
-
-- Issue #10763: subprocess.communicate() closes stdout and stderr if both are
- pipes (bug specific to Windows).
-
-- Issue #1693546: fix email.message RFC 2231 parameter encoding to be in better
- compliance (no "s around encoded values).
-
-- Improved the diff message in the unittest module's assertCountEqual().
-
-- Issue #1155362: email.utils.parsedate_tz now handles a missing space before
- the '-' of a timezone field as well as before a '+'.
-
-- Issue #4871: The zipfile module now gives a more useful error message if
- an attempt is made to use a string to specify the archive password.
-
-- Issue #10750: The ``raw`` attribute of buffered IO objects is now read-only.
-
-- Deprecated assertDictContainsSubset() in the unittest module.
-
-C-API
------
-
-- PyObject_CallMethod now passes along any underlying AttributeError from
- PyObject_GetAttr, instead of replacing it with something less informative
-
-- Issue #10913: Deprecate misleading functions PyEval_AcquireLock() and
- PyEval_ReleaseLock(). The thread-state aware APIs should be used instead.
-
-- Issue #10333: Remove ancient GC API, which has been deprecated since Python
- 2.2.
-
-Build
------
-
-- Issue #10843: Update third-party library versions used in OS X 32-bit
- installer builds: bzip2 1.0.6, readline 6.1.2, SQLite 3.7.4 (with FTS3/FTS4
- and RTREE enabled), and ncursesw 5.5 (wide-char support enabled).
-
-- Issue #10820: Fix OS X framework installs to support version-specific
- scripts (#10679).
-
-- Issue #7716: Under Solaris, don't assume existence of /usr/xpg4/bin/grep in
- the configure script but use $GREP instead. Patch by Fabian Groffen.
-
-- Issue #10475: Don't hardcode compilers for LDSHARED/LDCXXSHARED on NetBSD
- and DragonFly BSD. Patch by Nicolas Joly.
-
-- Issue #10679: The "idle", "pydoc" and "2to3" scripts are now installed with
- a version-specific suffix on "make altinstall".
-
-- Issue #10655: Fix the build on PowerPC on Linux with GCC when building with
- timestamp profiling (--with-tsc): the preprocessor test for the PowerPC
- support now looks for "__powerpc__" as well as "__ppc__": the latter seems to
- only be present on OS X; the former is the correct one for Linux with GCC.
-
-- Issue #1099: Fix the build on MacOSX when building a framework with pydebug
- using GCC 4.0.
-
-Tools/Demos
------------
-
-- Issue #10843: Install the Tools directory on OS X in the applications Extras
- (/Applications/Python 3.n/Extras/) where the Demo directory had previous been
- installed.
-
-- Issue #7962: The Demo directory is gone. Most of the old and unmaintained
- demos have been removed, others integrated in documentation or a new
- Tools/demo subdirectory.
-
-- Issue #10502: Addition of the unittestgui tool. Originally by Steve Purcell.
- Updated for test discovery by Mark Roddy and Python 3 compatibility by Brian
- Curtin.
-
-Tests
------
-
-- Issue #11910: Fix test_heapq to skip the C tests when _heapq is missing.
-
-- Fix test_startfile to wait for child process to terminate before finishing.
-
-- Issue #10822: Fix test_posix:test_getgroups failure under Solaris. Patch
- by Ross Lagerwall.
-
-- Make the --coverage flag work for test.regrtest.
-
-- Issue #1677694: Refactor and improve test_timeout. Original patch by
- Björn Lindqvist.
-
-- Issue #5485: Add tests for the UseForeignDTD method of expat parser objects.
- Patch by Jean-Paul Calderone and Sandro Tosi.
-
-- Issue #6293: Have regrtest.py echo back sys.flags. This is done by default in
- whole runs and enabled selectively using ``--header`` when running an explicit
- list of tests. Original patch by Collin Winter.
-
-
-What's New in Python 3.2 Beta 2?
-================================
-
-*Release date: 19-Dec-2010*
-
-Core and Builtins
------------------
-
-- Issue #8844: Regular and recursive lock acquisitions can now be interrupted
- by signals on platforms using pthreads. Patch by Reid Kleckner.
-
-- Issue #4236: PyModule_Create2 now checks the import machinery directly
- rather than the Py_IsInitialized flag, avoiding a Fatal Python
- error in certain circumstances when an import is done in __del__.
-
-- Issue #5587: add a repr to dict_proxy objects. Patch by David Stanek and
- Daniel Urban.
-
-Library
--------
-
-- Issue #3243: Support iterable bodies in httplib. Patch Contributions by
- Xuanji Li and Chris AtLee.
-
-- Issue #10611: SystemExit exception will no longer kill a unittest run.
-
-- Issue #9857: It is now possible to skip a test in a setUp, tearDown or clean
- up function.
-
-- Issue #10573: use actual/expected consistently in unittest methods.
- The order of the args of assertCountEqual is also changed.
-
-- Issue #9286: email.utils.parseaddr no longer concatenates blank-separated
- words in the local part of email addresses, thereby preserving the input.
-
-- Issue #6791: Limit header line length (to 65535 bytes) in http.client
- and http.server, to avoid denial of services from the other party.
-
-- Issue #10404: Use ctl-button-1 on OSX for the context menu in Idle.
-
-- Issue #9907: Fix tab handling on OSX when using editline by calling
- rl_initialize first, then setting our custom defaults, then reading .editrc.
-
-- Issue #4188: Avoid creating dummy thread objects when logging operations
- from the threading module (with the internal verbose flag activated).
-
-- Issue #10711: Remove HTTP 0.9 support from http.client. The ``strict``
- parameter to HTTPConnection and friends is deprecated.
-
-- Issue #9721: Fix the behavior of urljoin when the relative url starts with a
- ';' character. Patch by Wes Chow.
-
-- Issue #10714: Limit length of incoming request in http.server to 65536 bytes
- for security reasons. Initial patch by Ross Lagerwall.
-
-- Issue #9558: Fix distutils.command.build_ext with VS 8.0.
-
-- Issue #10667: Fast path for collections.Counter().
-
-- Issue #10695: passing the port as a string value to telnetlib no longer
- causes debug mode to fail.
-
-- Issue #1078919: add_header now automatically RFC2231 encodes parameters
- that contain non-ascii values.
-
-- Issue #10188 (partial resolution): tempfile.TemporaryDirectory emits
- a warning on sys.stderr rather than throwing a misleading exception
- if cleanup fails due to nulling out of modules during shutdown.
- Also avoids an AttributeError when mkdtemp call fails and issues
- a ResourceWarning on implicit cleanup via __del__.
-
-- Issue #10107: Warn about unsaved files in IDLE on OSX.
-
-- Issue #7213: subprocess.Popen's default for close_fds has been changed.
- It is now True in most cases other than on Windows when input, output or
- error handles are provided.
-
-- Issue #6559: subprocess.Popen has a new pass_fds parameter (actually
- added in 3.2beta1) to allow specifying a specific list of file descriptors
- to keep open in the child process.
-
-- Issue #1731717: Fixed the problem where subprocess.wait() could cause an
- OSError exception when The OS had been told to ignore SIGCLD in our process
- or otherwise not wait for exiting child processes.
-
-Tests
------
-
-- Issue #775964: test_grp now skips YP/NIS entries instead of failing when
- encountering them.
-
-Tools/Demos
------------
-
-- Issue #6075: IDLE on Mac OS X now works with both Carbon AquaTk and
- Cocoa AquaTk.
-
-- Issue #10710: ``Misc/setuid-prog.c`` is removed from the source tree.
-
-- Issue #10706: Remove outdated script runtests.sh. Either ``make test``
- or ``python -m test`` should be used instead.
-
-Build
------
-
-- The Windows build now uses Tcl/Tk 8.5.9 and sqlite3 3.7.4.
-
-- Issue #9234: argparse supports alias names for subparsers.
-
-
-What's New in Python 3.2 Beta 1?
-================================
-
-*Release date: 05-Dec-2010*
-
-Core and Builtins
------------------
-
-- Issue #10630: Return dict views from the dict proxy keys()/values()/items()
- methods.
-
-- Issue #10596: Fix float.__mod__ to have the same behaviour as float.__divmod__
- with respect to signed zeros. -4.0 % 4.0 should be 0.0, not -0.0.
-
-- Issue #1772833: Add the -q command-line option to suppress copyright and
- version output in interactive mode.
-
-- Provide an *optimize* parameter in the built-in compile() function.
-
-- Fixed several corner case issues on Windows in os.stat/os.lstat related to
- reparse points.
-
-- PEP 384 (Defining a Stable ABI) is implemented.
-
-- Issue #2690: Range objects support negative indices and slicing.
-
-- Issue #9915: Speed up sorting with a key.
-
-- Issue #8685: Speed up set difference ``a - b`` when source set ``a`` is much
- larger than operand ``b``. Patch by Andrew Bennetts.
-
-- Issue #10518: Bring back the callable() builtin.
-
-- Issue #7094: Added alternate formatting (specified by '#') to ``__format__``
- method of float, complex, and Decimal. This allows more precise control over
- when decimal points are displayed.
-
-- Issue #10474: range.count() should return integers.
-
-- Issue #1574217: isinstance now catches only AttributeError, rather than
- masking all errors.
-
-Library
--------
-
-- logging: added "handler of last resort". See http://bit.ly/last-resort-handler
-
-- test.support: Added TestHandler and Matcher classes for better support of
- assertions about logging.
-
-- Issue #4391: Use proper plural forms in argparse.
-
-- Issue #10601: sys.displayhook uses 'backslashreplace' error handler on
- UnicodeEncodeError.
-
-- Add the "display" and "undisplay" pdb commands.
-
-- Issue #7245: Add a SIGINT handler in pdb that allows to break a program again
- after a "continue" command.
-
-- Add the "interact" pdb command.
-
-- Issue #7905: Actually respect the keyencoding parameter to shelve.Shelf.
-
-- Issue #1569291: Speed up array.repeat().
-
-- Provide an interface to set the optimization level of compilation in
- py_compile, compileall and zipfile.PyZipFile.
-
-- Issue #7904: Changes to urllib.parse.urlsplit to handle schemes as defined by
- RFC3986. Anything before :// is considered a scheme and is followed by an
- authority (or netloc) and by '/' led path, which is optional.
-
-- Issue #6045: dbm.gnu databases now support get() and setdefault() methods.
-
-- Issue #10620: `python -m unittest` can accept file paths instead of module
- names for running specific tests.
-
-- Issue #9424: Deprecate the `unittest.TestCase` methods `assertEquals`,
- `assertNotEquals`, `assertAlmostEquals`, `assertNotAlmostEquals` and `assert_`
- and replace them with the correct methods in the Python test suite.
-
-- Issue #10272: The ssl module now raises socket.timeout instead of a generic
- SSLError on socket timeouts.
-
-- Issue #10528: Allow translators to reorder placeholders in localizable
- messages from argparse.
-
-- Issue #10497: Fix incorrect use of gettext in argparse.
-
-- Issue #10478: Reentrant calls inside buffered IO objects (for example by
- way of a signal handler) now raise a RuntimeError instead of freezing the
- current process.
-
-- logging: Added getLogRecordFactory/setLogRecordFactory with docs and tests.
-
-- Issue #10549: Fix pydoc traceback when text-documenting certain classes.
-
-- Issue #2001: New HTML server with enhanced Web page features. Patch by Ron
- Adam.
-
-- Issue #10360: In WeakSet, do not raise TypeErrors when testing for membership
- of non-weakrefable objects.
-
-- Issue #940286: pydoc.Helper.help() ignores input/output init parameters.
-
-- Issue #1745035: Add a command size and data size limit to smtpd.py, to prevent
- DoS attacks. Patch by Savio Sena.
-
-- Issue #4925: Add filename to error message when executable can't be found in
- subprocess.
-
-- Issue #10391: Don't dereference invalid memory in error messages in the ast
- module.
-
-- Issue #10027: st_nlink was not being set on Windows calls to os.stat or
- os.lstat. Patch by Hirokazu Yamamoto.
-
-- Issue #9333: Expose os.symlink only when the SeCreateSymbolicLinkPrivilege is
- held by the user's account, i.e., when the function can actually be used.
-
-- Issue #8879: Add os.link support for Windows.
-
-- Issue #7911: ``unittest.TestCase.longMessage`` defaults to True for improved
- failure messages by default. Patch by Mark Roddy.
-
-- Issue #1486713: HTMLParser now has an optional tolerant mode where it tries to
- guess at the correct parsing of invalid html.
-
-- Issue #10554: Add context manager support to subprocess.Popen objects.
-
-- Issue #8989: email.utils.make_msgid now has a domain parameter that can
- override the domain name used in the generated msgid.
-
-- Issue #9299: Add exist_ok parameter to os.makedirs to suppress the 'File
- exists' exception when a target directory already exists with the specified
- mode. Patch by Ray Allen.
-
-- Issue #9573: os.fork() now works correctly when triggered as a side effect of
- a module import.
-
-- Issue #10464: netrc now correctly handles lines with embedded '#' characters.
-
-- Added itertools.accumulate().
-
-- Issue #4113: Added custom ``__repr__`` method to ``functools.partial``.
- Original patch by Daniel Urban.
-
-- Issue #10273: Rename `assertRegexpMatches` and `assertRaisesRegexp` to
- `assertRegex` and `assertRaisesRegex`.
-
-- Issue #10535: Enable silenced warnings in unittest by default.
-
-- Issue #9873: The URL parsing functions in urllib.parse now accept ASCII byte
- sequences as input in addition to character strings.
-
-- Issue #10586: The statistics API for the new functools.lru_cache has been
- changed to a single cache_info() method returning a named tuple.
-
-- Issue #10323: itertools.islice() now consumes the minimum number of inputs
- before stopping. Formerly, the final state of the underlying iterator was
- undefined.
-
-- Issue #10565: The collections.Iterator ABC now checks for both __iter__ and
- __next__.
-
-- Issue #10242: Fixed implementation of unittest.ItemsEqual and gave it a new
- more informative name, unittest.CountEqual.
-
-- Issue #10561: In pdb, clear the breakpoints by the breakpoint number.
-
-- Issue #2986: difflib.SequenceMatcher gets a new parameter, autojunk, which can
- be set to False to turn off the previously undocumented 'popularity'
- heuristic. Patch by Terry Reedy and Eli Bendersky.
-
-- Issue #10534: in difflib, expose bjunk and bpopular sets; deprecate
- undocumented and now redundant isbjunk and isbpopular methods.
-
-- Issue #9846: zipfile is now correctly closing underlying file objects.
-
-- Issue #10459: Update CJK character names to Unicode 6.0.
-
-- Issue #4493: urllib.request adds '/' in front of path components which does not
- start with '/. Common behavior exhibited by browsers and other clients.
-
-- Issue #6378: idle.bat now runs with the appropriate Python version rather than
- the system default. Patch by Sridhar Ratnakumar.
-
-- Issue #10470: 'python -m unittest' will now run test discovery by default,
- when no extra arguments have been provided.
-
-- Issue #3709: BaseHTTPRequestHandler will buffer the headers and write to
- output stream only when end_headers is invoked. This is a speedup and an
- internal optimization. Patch by endian.
-
-- Issue #10220: Added inspect.getgeneratorstate. Initial patch by Rodolpho
- Eckhardt.
-
-- Issue #10453: compileall now uses argparse instead of getopt, and thus
- provides clean output when called with '-h'.
-
-- Issue #8078: Add constants for higher baud rates in the termios module. Patch
- by Rodolpho Eckhardt.
-
-- Issue #10407: Fix two NameErrors in distutils.
-
-- Issue #10371: Deprecated undocumented functions in the trace module.
-
-- Issue #10467: Fix BytesIO.readinto() after seeking into a position after the
- end of the file.
-
-- configparser: 100% test coverage.
-
-- Issue #10499: configparser supports pluggable interpolation handlers. The
- default classic interpolation handler is called BasicInterpolation. Another
- interpolation handler added (ExtendedInterpolation) which supports the syntax
- used by zc.buildout (e.g. interpolation between sections).
-
-- configparser: the SafeConfigParser class has been renamed to ConfigParser.
- The legacy ConfigParser class has been removed but its interpolation mechanism
- is still available as LegacyInterpolation.
-
-- configparser: Usage of RawConfigParser is now discouraged for new projects
- in favor of ConfigParser(interpolation=None).
-
-- Issue #1682942: configparser supports alternative option/value delimiters.
-
-- Issue #5412: configparser supports mapping protocol access.
-
-- Issue #9411: configparser supports specifying encoding for read operations.
-
-- Issue #9421: configparser's getint(), getfloat() and getboolean() methods
- accept vars and default arguments just like get() does.
-
-- Issue #9452: configparser supports reading from strings and dictionaries
- (thanks to the mapping protocol API, the latter can be used to copy data
- between parsers).
-
-- configparser: accepted INI file structure is now customizable, including
- comment prefixes, name of the DEFAULT section, empty lines in multiline
- values, and indentation.
-
-- Issue #10326: unittest.TestCase instances can be pickled.
-
-- Issue #9926: Wrapped TestSuite subclass does not get __call__ executed.
-
-- Issue #9920: Skip tests for cmath.atan and cmath.atanh applied to complex
- zeros on systems where the log1p function fails to respect the sign of zero.
- This fixes a test failure on AIX.
-
-- Issue #9732: Addition of getattr_static to the inspect module.
-
-- Issue #10446: Module documentation generated by pydoc now links to a
- version-specific online reference manual.
-
-- Make the 'No module named' exception message from importlib consistent.
-
-- Issue #10443: Add the SSLContext.set_default_verify_paths() method.
-
-- Issue #10440: Support RUSAGE_THREAD as a constant in the resource module.
- Patch by Robert Collins.
-
-- Issue #10429: IMAP.starttls() stored the capabilities as bytes objects, rather
- than strings.
-
-C-API
------
-
-- Issue #10557: Added a new API function, PyUnicode_TransformDecimalToASCII(),
- which transforms non-ASCII decimal digits in a Unicode string to their ASCII
- equivalents.
-
-- Issue #9518: Extend the PyModuleDef_HEAD_INIT macro to explicitly
- zero-initialize all fields, fixing compiler warnings seen when building
- extension modules with gcc with "-Wmissing-field-initializers" (implied by
- "-W").
-
-- Issue #10255: Fix reference leak in Py_InitializeEx(). Patch by Neil
- Schemenauer.
-
-- structseq.h is now included in Python.h.
-
-- Loosen PyArg_ValidateKeywordArguments to allow dict subclasses.
-
-Tests
------
-
-- regrtest.py once again ensures the test directory is removed from sys.path
- when it is invoked directly as the __main__ module.
-
-- `python -m test` can be used to run the test suite as well as `python -m
- test.regrtest`.
-
-- Do not fail test_socket when the IP address of the local hostname cannot be
- looked up.
-
-- Issue #8886: Use context managers throughout test_zipfile. Patch by Eric
- Carstensen.
-
-Build
------
-
-- Issue #10325: Fix two issues in the fallback definitions for PY_ULLONG_MAX and
- PY_LLONG_MAX that made them unsuitable for use in preprocessor conditionals.
-
-Documentation
--------------
-
-- Issue #10299: List the built-in functions in a table in functions.rst.
-
-
-What's New in Python 3.2 Alpha 4?
-=================================
-
-*Release date: 13-Nov-2010*
-
-Core and Builtins
------------------
-
-- Issue #10372: Import the warnings module only after the IO library is
- initialized, so as to avoid bootstrap issues with the '-W' option.
-
-- Issue #10293: Remove obsolete field in the PyMemoryView structure, unused
- undocumented value PyBUF_SHADOW, and strangely-looking code in
- PyMemoryView_GetContiguous.
-
-- Issue #6081: Add str.format_map(), similar to ``str.format(**mapping)``.
-
-- If FileIO.__init__ fails, close the file descriptor.
-
-- Issue #10221: dict.pop(k) now has a key error message that includes the
- missing key (same message d[k] returns for missing keys).
-
-- Issue #5437: A preallocated MemoryError instance should not keep traceback
- data (including local variables caught in the stack trace) alive infinitely.
-
-- Issue #10186: Fix the SyntaxError caret when the offset is equal to the length
- of the offending line.
-
-- Issue #10089: Add support for arbitrary -X options on the command line. They
- can be retrieved through a new attribute ``sys._xoptions``.
-
-- Issue #4388: On Mac OS X, decode command line arguments from UTF-8, instead of
- the locale encoding. If the LANG (and LC_ALL and LC_CTYPE) environment
- variable is not set, the locale encoding is ISO-8859-1, whereas most programs
- (including Python) expect UTF-8. Python already uses UTF-8 for the filesystem
- encoding and to encode command line arguments on this OS.
-
-- Issue #9713, #10114: Parser functions (e.g. PyParser_ASTFromFile) expect
- filenames encoded to the filesystem encoding with the surrogateescape error
- handler (to support undecodable bytes), instead of UTF-8 in strict mode.
-
-- Issue #9997: Don't let the name "top" have special significance in scope
- resolution.
-
-- Issue #9862: Compensate for broken PIPE_BUF in AIX by hard coding its value as
- the default 512 when compiling on AIX.
-
-- Use locale encoding instead of UTF-8 to encode and decode filenames if
- Py_FileSystemDefaultEncoding is not set.
-
-- Issue #10095: fp_setreadl() doesn't reopen the file, instead reuse the file
- descriptor.
-
-- Issue #9418: Moved private string methods ``_formatter_parser`` and
- ``_formatter_field_name_split`` into a new ``_string`` module.
-
-- Issue #9992: Remove PYTHONFSENCODING environment variable.
-
-Library
--------
-
-- Issue #12943: python -m tokenize support has been added to tokenize.
-
-- Issue #10465: fix broken delegating of attributes by gzip._PaddedFile.
-
-- Issue #10356: Decimal.__hash__(-1) should return -2.
-
-- Issue #1553375: logging: Added stack_info kwarg to display stack information.
-
-- Issue #5111: IPv6 Host in the Header is wrapped inside [ ]. Patch by Chandru.
-
-- Fix Fraction.__hash__ so that Fraction.__hash__(-1) is -2. (See also issue
- #10356.)
-
-- Issue #4471: Add the IMAP.starttls() method to enable encryption on standard
- IMAP4 connections. Original patch by Lorenzo M. Catucci.
-
-- Issue #1466065: Add 'validate' option to base64.b64decode to raise an error if
- there are non-base64 alphabet characters in the input.
-
-- Issue #10386: Add __all__ to token module; this simplifies importing in
- tokenize module and prevents leaking of private names through ``import *``.
-
-- Issue #4471: Properly shutdown socket in IMAP.shutdown(). Patch by Lorenzo
- M. Catucci.
-
-- Fix IMAP.login() to work properly.
-
-- Issue #9244: multiprocessing pool worker processes could terminate
- unexpectedly if the return value of a task could not be pickled. Only the
- ``repr`` of such errors are now sent back, wrapped in an
- ``MaybeEncodingError`` exception.
-
-- Issue #9244: The ``apply_async()`` and ``map_async()`` methods of
- ``multiprocessing.Pool`` now accepts a ``error_callback`` argument. This can
- be a callback with the signature ``callback(exc)``, which will be called if
- the target raises an exception.
-
-- Issue #10022: The dictionary returned by the ``getpeercert()`` method of SSL
- sockets now has additional items such as ``issuer`` and ``notBefore``.
-
-- ``usenetrc`` is now false by default for NNTP objects.
-
-- Issue #1926: Add support for NNTP over SSL on port 563, as well as STARTTLS.
- Patch by Andrew Vant.
-
-- Issue #10335: Add tokenize.open(), detect the file encoding using
- tokenize.detect_encoding() and open it in read only mode.
-
-- Issue #10321: Add support for binary data to smtplib.SMTP.sendmail, and a new
- method send_message to send an email.message.Message object.
-
-- Issue #6011: sysconfig and distutils.sysconfig use the surrogateescape error
- handler to parse the Makefile file. Avoid a UnicodeDecodeError if the source
- code directory name contains a non-ASCII character and the locale encoding is
- ASCII.
-
-- Issue #10329: The trace module writes reports using the input Python script
- encoding, instead of the locale encoding. Patch written by Alexander
- Belopolsky.
-
-- Issue #10126: Fix distutils' test_build when Python was built with
- --enable-shared.
-
-- Issue #9281: Prevent race condition with mkdir in distutils. Patch by
- Arfrever.
-
-- Issue #10229: Fix caching error in gettext.
-
-- Issue #10252: Close file objects in a timely manner in distutils code and
- tests. Patch by Brian Brazil, completed by Éric Araujo.
-
-- Issue #10180: Pickling file objects is now explicitly forbidden, since
- unpickling them produced nonsensical results.
-
-- Issue #10311: The signal module now restores errno before returning from its
- low-level signal handler. Patch by Hallvard B Furuseth.
-
-- Issue #10282: Add a ``nntp_implementation`` attribute to NNTP objects.
-
-- Issue #10283: Add a ``group_pattern`` argument to NNTP.list().
-
-- Issue #10155: Add IISCGIHandler to wsgiref.handlers to support IIS CGI
- environment better, and to correct unicode environment values for WSGI 1.0.1.
-
-- Issue #10281: nntplib now returns None for absent fields in the OVER/XOVER
- response, instead of raising an exception.
-
-- wsgiref now implements and validates PEP 3333, rather than an experimental
- extension of PEP 333. (Note: earlier versions of Python 3.x may have
- incorrectly validated some non-compliant applications as WSGI compliant; if
- your app validates with Python <3.2b1+, but not on this version, it is likely
- the case that your app was not compliant.)
-
-- Issue #10280: NNTP.nntp_version should reflect the highest version advertised
- by the server.
-
-- Issue #10184: Touch directories only once when extracting a tarfile.
-
-- Issue #10199: New package, ``turtledemo`` now contains selected demo scripts
- that were formerly found under Demo/turtle.
-
-- Issue #10265: Close file objects explicitly in sunau. Patch by Brian Brazil.
-
-- Issue #10266: uu.decode didn't close in_file explicitly when it was given as a
- filename. Patch by Brian Brazil.
-
-- Issue #10110: Queue objects didn't recognize full queues when the maxsize
- parameter had been reduced.
-
-- Issue #10160: Speed up operator.attrgetter. Patch by Christos Georgiou.
-
-- logging: Added style option to basicConfig() to allow %, {} or $-formatting.
-
-- Issue #5729: json.dumps() now supports using a string such as '\t' for
- pretty-printing multilevel objects.
-
-- Issue #10253: FileIO leaks a file descriptor when trying to open a file for
- append that isn't seekable. Patch by Brian Brazil.
-
-- Support context manager protocol for file-like objects returned by mailbox
- ``get_file()`` methods.
-
-- Issue #10246: uu.encode didn't close file objects explicitly when filenames
- were given to it. Patch by Brian Brazil.
-
-- Issue #10198: fix duplicate header written to wave files when writeframes() is
- called without data.
-
-- Close file objects in modulefinder in a timely manner.
-
-- Close a io.TextIOWrapper object in email.parser in a timely manner.
-
-- Close a file object in distutils.sysconfig in a timely manner.
-
-- Close a file object in pkgutil in a timely manner.
-
-- Issue #10233: Close file objects in a timely manner in the tarfile module and
- its test suite.
-
-- Issue #10093: ResourceWarnings are now issued when files and sockets are
- deallocated without explicit closing. These warnings are silenced by default,
- except in pydebug mode.
-
-- tarfile.py: Add support for all missing variants of the GNU sparse extensions
- and create files with holes when extracting sparse members.
-
-- Issue #10218: Return timeout status from ``Condition.wait`` in threading.
-
-- Issue #7351: Add ``zipfile.BadZipFile`` spelling of the exception name and
- deprecate the old name ``zipfile.BadZipfile``.
-
-- Issue #5027: The standard ``xml`` namespace is now understood by
- xml.sax.saxutils.XMLGenerator as being bound to
- http://www.w3.org/XML/1998/namespace. Patch by Troy J. Farrell.
-
-- Issue #5975: Add csv.unix_dialect class.
-
-- Issue #7761: telnetlib.interact failures on Windows fixed.
-
-- logging: Added style option to Formatter to allow %, {} or $-formatting.
-
-- Issue #5178: Added tempfile.TemporaryDirectory class that can be used as a
- context manager.
-
-- Issue #1349106: Generator (and BytesGenerator) flatten method and Header
- encode method now support a 'linesep' argument.
-
-- Issue #5639: Add a *server_hostname* argument to ``SSLContext.wrap_socket`` in
- order to support the TLS SNI extension. ``HTTPSConnection`` and ``urlopen()``
- also use this argument, so that HTTPS virtual hosts are now supported.
-
-- Issue #10166: Avoid recursion in pstats Stats.add() for many stats items.
-
-- Issue #10163: Skip unreadable registry keys during mimetypes initialization.
-
-- logging: Made StreamHandler terminator configurable.
-
-- logging: Allowed filters to be just callables.
-
-- logging: Added tests for _logRecordClass changes.
-
-- Issue #10092: Properly reset locale in calendar.Locale*Calendar classes.
-
-- logging: Added _logRecordClass, getLogRecordClass, setLogRecordClass to
- increase flexibility of LogRecord creation.
-
-- Issue #5117: Case normalization was needed on ntpath.relpath(). Also fixed
- root directory issue on posixpath.relpath(). (Ported working fixes from
- ntpath.)
-
-- Issue #1343: xml.sax.saxutils.XMLGenerator now has an option
- short_empty_elements to direct it to use self-closing tags when appropriate.
-
-- Issue #9807 (part 1): Expose the ABI flags in sys.abiflags. Add --abiflags
- switch to python-config for command line access.
-
-- Issue #6098: Don't claim DOM level 3 conformance in minidom.
-
-- Issue #5762: Fix AttributeError raised by ``xml.dom.minidom`` when an empty
- XML namespace attribute is encountered.
-
-- Issue #2830: Add the ``html.escape()`` function, which quotes all problematic
- characters by default. Deprecate ``cgi.escape()``.
-
-- Issue #9409: Fix the regex to match all kind of filenames, for interactive
- debugging in doctests.
-
-- Issue #9183: ``datetime.timezone(datetime.timedelta(0))`` will now return the
- same instance as ``datetime.timezone.utc``.
-
-- Issue #7523: Add SOCK_CLOEXEC and SOCK_NONBLOCK to the socket module, where
- supported by the system. Patch by Nikita Vetoshkin.
-
-- Issue #10063: file:// scheme will stop accessing remote hosts via ftp
- protocol. file:// urls had fallback to access remote hosts via ftp. This was
- not correct, change is made to raise a URLError when a remote host is tried to
- access via file:// scheme.
-
-- Issue #1710703: Write structures for an empty ZIP archive when a ZipFile is
- created in modes 'a' or 'w' and then closed without adding any files. Raise
- BadZipfile (rather than IOError) when opening small non-ZIP files.
-
-- Issue #10041: The signature of optional arguments in socket.makefile() didn't
- match that of io.open(), and they also didn't get forwarded properly to
- TextIOWrapper in text mode. Patch by Kai Zhu.
-
-- Issue #9003: http.client.HTTPSConnection, urllib.request.HTTPSHandler and
- urllib.request.urlopen now take optional arguments to allow for server
- certificate checking, as recommended in public uses of HTTPS.
-
-- Issue #6612: Fix site and sysconfig to catch os.getcwd() error, eg. if the
- current directory was deleted. Patch written by W. Trevor King.
-
-- Issue #3873: Speed up unpickling from file objects that have a peek() method.
-
-- Issue #10075: Add a session_stats() method to SSLContext objects.
-
-- Issue #9948: Fixed problem of losing filename case information.
-
-Extension Modules
------------------
-
-- Issue #5109: array.array constructor will now use fast code when
- initial data is provided in an array object with correct type.
-
-- Issue #6317: Now winsound.PlaySound only accepts unicode.
-
-- Issue #6317: Now winsound.PlaySound can accept non ascii filename.
-
-- Issue #9377: Use Unicode API for gethostname on Windows.
-
-- Issue #10143: Update "os.pathconf" values.
-
-- Issue #6518: Support context manager protcol for ossaudiodev types.
-
-- Issue #678250: Make mmap flush a noop on ACCESS_READ and ACCESS_COPY.
-
-- Issue #9054: Fix a crash occurring when using the pyexpat module with expat
- version 2.0.1.
-
-- Issue #5355: Provide mappings from Expat error numbers to string descriptions
- and backwards, in order to actually make it possible to analyze error codes
- provided by ExpatError.
-
-- The Unicode database was updated to 6.0.0.
-
-C-API
------
-
-- Issue #10288: The deprecated family of "char"-handling macros
- (ISLOWER()/ISUPPER()/etc) have now been removed: use Py_ISLOWER() etc instead.
-
-- Issue #9778: Hash values are now always the size of pointers. A new Py_hash_t
- type has been introduced.
-
-Tools/Demos
------------
-
-- Issue #10117: Tools/scripts/reindent.py now accepts source files that use
- encoding other than ASCII or UTF-8. Source encoding is preserved when
- reindented code is written to a file.
-
-- Issue #7287: Demo/imputil/knee.py was removed.
-
-Tests
------
-
-- Issue #3699: Fix test_bigaddrspace and extend it to test bytestrings as well
- as unicode strings. Initial patch by Sandro Tosi.
-
-- Issue #10294: Remove dead code form test_unicode_file.
-
-- Issue #10123: Don't use non-ascii filenames in test_doctest tests. Add a new
- test specific to unicode (non-ascii name and filename).
-
-Build
------
-
-- Issue #10268: Add a --enable-loadable-sqlite-extensions option to configure.
-
-- Issue #8852: Allow the socket module to build on OpenSolaris.
-
-- Drop -OPT:Olimit compiler option.
-
-- Issue #10094: Use versioned .so files on GNU/kfreeBSD and the GNU Hurd.
-
-- Accept Oracle Berkeley DB 5.0 and 5.1 as backend for the dbm extension.
-
-- Issue #7473: avoid link errors when building a framework with a different set
- of architectures than the one that is currently installed.
-
-
-What's New in Python 3.2 Alpha 3?
-=================================
-
-*Release date: 09-Oct-2010*
-
-Core and Builtins
------------------
-
-- Issue #10068: Global objects which have reference cycles with their module's
- dict are now cleared again. This causes issue #7140 to appear again.
-
-- Issue #9738: Document PyErr_SetString() and PyErr_SetFromErrnoWithFilename()
- encodings.
-
-- ast.literal_eval() can now handle negative numbers. It is also a little more
- liberal in what it accepts without compromising the safety of the evaluation.
- For example, 3j+4 and 3+4+5 are both accepted.
-
-- Issue #10006: type.__abstractmethods__ now raises an AttributeError. As a
- result metaclasses can now be ABCs (see #9533).
-
-- Issue #8670: ctypes.c_wchar supports non-BMP characters with 32 bits wchar_t.
-
-- Issue #8670: PyUnicode_AsWideChar() and PyUnicode_AsWideCharString() replace
- UTF-16 surrogate pairs by single non-BMP characters for 16 bits Py_UNICODE and
- 32 bits wchar_t (eg. Linux in narrow build).
-
-- Issue #10003: Allow handling of SIGBREAK on Windows. Fixes a regression
- introduced by issue #9324.
-
-- Issue #9979: Create function PyUnicode_AsWideCharString().
-
-- Issue #7397: Mention that importlib.import_module() is probably what someone
- really wants to be using in __import__'s docstring.
-
-- Issue #8521: Allow CreateKeyEx, OpenKeyEx, and DeleteKeyEx functions of winreg
- to use named arguments.
-
-- Issue #9930: Remove bogus subtype check that was causing (e.g.)
- float.__rdiv__(2.0, 3) to return NotImplemented instead of the expected 1.5.
-
-- Issue #9808: Implement os.getlogin for Windows. Patch by Jon Anglin.
-
-- Issue #9901: Destroying the GIL in Py_Finalize() can fail if some other
- threads are still running. Instead, reinitialize the GIL on a second call to
- Py_Initialize().
-
-- All SyntaxErrors now have a column offset and therefore a caret when the error
- is printed.
-
-- Issue #9252: PyImport_Import no longer uses a fromlist hack to return the
- module that was imported, but instead gets the module from sys.modules.
-
-- Issue #9213: The range type_items now provides index() and count() methods, to
- conform to the Sequence ABC. Patch by Daniel Urban and Daniel Stutzbach.
-
-- Issue #7994: Issue a PendingDeprecationWarning if object.__format__ is called
- with a non-empty format string. This is an effort to future-proof user
- code. If a derived class does not currently implement __format__ but later
- adds its own __format__, it would most likely break user code that had
- supplied a format string. This will be changed to a DeprecationWaring in
- Python 3.3 and it will be an error in Python 3.4.
-
-- Issue #9828: Destroy the GIL in Py_Finalize(), so that it gets properly
- re-created on a subsequent call to Py_Initialize(). The problem (a crash)
- wouldn't appear in 3.1 or 2.7 where the GIL's structure is more trivial.
-
-- Issue #9210: Configure option --with-wctype-functions was removed. Using the
- functions from the libc caused the methods .upper() and lower() to become
- locale aware and created subtly wrong results.
-
-- Issue #9738: PyUnicode_FromFormat() and PyErr_Format() raise an error on a
- non-ASCII byte in the format string.
-
-- Issue #4617: Previously it was illegal to delete a name from the local
- namespace if it occurs as a free variable in a nested block. This limitation
- of the compiler has been lifted, and a new opcode introduced (DELETE_DEREF).
-
-- Issue #9804: ascii() now always represents unicode surrogate pairs as a single
- ``\UXXXXXXXX``, regardless of whether the character is printable or not.
- Also, the "backslashreplace" error handler now joins surrogate pairs into a
- single character on UCS-2 builds.
-
-- Issue #9757: memoryview objects get a release() method to release the
- underlying buffer (previously this was only done when deallocating the
- memoryview), and gain support for the context management protocol.
-
-- Issue #9797: pystate.c wrongly assumed that zero couldn't be a valid
- thread-local storage key.
-
-Library
--------
-
-- Issue #2236: distutils' mkpath ignored the mode parameter.
-
-- Fix typo in one sdist option (medata-check).
-
-- Issue #9199: Fix incorrect use of distutils.cmd.Command.announce.
-
-- Issue #1718574: Fix options that were supposed to accept arguments but did
- not in build_clib.
-
-- Issue #9437: Fix building C extensions with non-default LDFLAGS.
-
-- Issue #4661: email can now parse bytes input and generate either converted
- 7bit output or bytes output. Email version bumped to 5.1.0.
-
-- Issue #1589: Add ssl.match_hostname(), to help implement server identity
- verification for higher-level protocols.
-
-- Issue #9759: GzipFile now raises ValueError when an operation is attempted
- after the file is closed. Patch by Jeffrey Finkelstein.
-
-- Issue #9042: Fix interaction of custom translation classes and caching in
- gettext.
-
-- Issue #6706: asyncore.dispatcher now provides a handle_accepted() method
- returning a (sock, addr) pair which is called when a connection has been
- established with a new remote endpoint. This is supposed to be used as a
- replacement for old handle_accept() and avoids the user to call accept()
- directly.
-
-- Issue #9065: tarfile no longer uses "root" as the default for the uname and
- gname field.
-
-- Issue #8980: Fixed a failure in distutils.command check that was shadowed by
- an environment that does not have docutils. Patch by Arfrever.
-
-- Issue #1050268: parseaddr now correctly quotes double quote and backslash
- characters that appear inside quoted strings in email addresses.
-
-- Issue #10004: quoprimime no longer generates a traceback when confronted with
- invalid characters after '=' in a Q-encoded word.
-
-- Issue #1491: BaseHTTPServer nows send a ``100 Continue`` response before
- sending a 200 OK for the Expect: 100-continue request header.
-
-- Issue #9360: Cleanup and improvements to the nntplib module. The API now
- conforms to the philosophy of bytes and unicode separation in Python 3. A
- test suite has also been added.
-
-- Issue #9962: GzipFile now has the peek() method.
-
-- Issue #9090: When a socket with a timeout fails with EWOULDBLOCK or EAGAIN,
- retry the select() loop instead of bailing out. This is because select() can
- incorrectly report a socket as ready for reading (for example, if it received
- some data with an invalid checksum).
-
-- Issue #3612: Added new types to ctypes.wintypes. (CHAR and pointers)
-
-- Issue #9950: Fix socket.sendall() crash or misbehaviour when a signal is
- received. Now sendall() properly calls signal handlers if necessary, and
- retries sending if these returned successfully, including on sockets with a
- timeout.
-
-- Issue #9947: logging: Fixed locking bug in stopListening.
-
-- Issue #9945: logging: Fixed locking bugs in addHandler/removeHandler.
-
-- Issue #9936: Fixed executable lines' search in the trace module.
-
-- Issue #9790: Rework imports necessary for samefile and sameopenfile
- in ntpath.
-
-- Issue #9928: Properly initialize the types exported by the bz2 module.
-
-- Issue #1675951: Allow GzipFile to work with unseekable file objects. Patch by
- Florian Festi.
-
-- Logging: Added QueueListener class to facilitate logging usage for
- performance-critical threads.
-
-- Issue #9916: Add some missing errno symbols.
-
-- Issue #9877: Expose sysconfig.get_makefile_filename()
-
-- logging: Added hasHandlers() method to Logger and LoggerAdapter.
-
-- Issue #9908: Fix os.stat() on bytes paths under Windows 7.
-
-- Issue #2643: msync() is not called anymore when deallocating an open mmap
- object, only munmap().
-
-- logging: Changed LoggerAdapter implementation internally, to make it easier to
- subclass in a useful way.
-
-- logging: hasHandlers method was added to Logger, and isEnabledFor,
- getEffectiveLevel, hasHandlers and setLevel were added to LoggerAdapter.
- LoggerAdapter was introduced into the unit tests for logging.
-
-- Issue #1686: Fix string.Template when overriding the pattern attribute.
-
-- Issue #9854: SocketIO objects now observe the RawIOBase interface in
- non-blocking mode: they return None when an operation would block (instead of
- raising an exception).
-
-- Issue #1730136: Fix the comparison between a tk.font.Font and an object of
- another kind.
-
-- Issue #9441: logging has better coverage for rotating file handlers.
-
-- Issue #9865: collections.OrderedDict now has a __sizeof__ method.
-
-- Issue #9854: The default read() implementation in io.RawIOBase now handles
- non-blocking readinto() returning None correctly.
-
-- Issue #1552: socket.socketpair() now returns regular socket.socket objects
- supporting the whole socket API (rather than the "raw" _socket.socket
- objects).
-
-- Issue #9853: Fix the signature of SSLSocket.recvfrom() and SSLSocket.sendto()
- to match the corresponding socket methods.
-
-- Issue #9840: Added a decorator to reprlib for wrapping __repr__ methods to make
- them handle recursive calls within the same thread.
-
-- logging: Enhanced HTTPHandler with secure and credentials initializers.
-
-- Issue #767645: Set os.path.supports_unicode_filenames to True on Mac OS X.
-
-- Issue #9837: The read() method of ZipExtFile objects (as returned by
- ZipFile.open()) could return more bytes than requested.
-
-- Issue #9826: OrderedDict.__repr__ can now handle self-referential values:
- d['x'] = d.
-
-- Issue #9825: Using __del__ in the definition of collections.OrderedDict made
- it possible for the user to create self-referencing ordered dictionaries which
- become permanently uncollectable GC garbage. Reinstated the Python 3.1
- approach of using weakref proxies so that reference cycles never get created
- in the first place.
-
-- Issue #9579, #9580: Fix os.confstr() for value longer than 255 bytes and
- encode the value with filesystem encoding and surrogateescape (instead of
- utf-8 in strict mode) . Patch written by David Watson.
-
-- Issue #9632: Remove sys.setfilesystemencoding() function: use PYTHONFSENCODING
- environment variable to set the filesystem encoding at Python startup.
- sys.setfilesystemencoding() creates inconsistencies because it is unable to
- reencode all filenames in all objects.
-
-- Issue #9410: Various optimizations to the pickle module, leading to speedups
- up to 4x (depending on the benchmark). Mostly ported from Unladen Swallow;
- initial patch by Alexandre Vassalotti.
-
-- The pprint module now supports printing OrderedDicts in their given order
- (formerly, it would sort the keys).
-
-- Logging: Added QueueHandler class to facilitate logging usage with
- multiprocessing.
-
-- Issue #9707: Rewritten reference implementation of threading.local which is
- friendlier towards reference cycles. This change is not normally visible
- since an optimized C implementation (_thread._local) is used instead.
-
-- Issue #6394: os.getppid() is now supported on Windows. Note that it will
- still return the id of the parent process after it has exited. This process
- id may even have been reused by another unrelated process.
-
-- Issue #9792: In case of connection failure, socket.create_connection() would
- swallow the exception and raise a new one, making it impossible to fetch the
- original errno, or to filter timeout errors. Now the original error is
- re-raised.
-
-- Issue #9758: When fcntl.ioctl() was called with mutable_flag set to True, and
- the passed buffer was exactly 1024 bytes long, the buffer wouldn't be updated
- back after the system call. Original patch by Brian Brazil.
-
-- Updates to the random module:
-
- * Document which parts of the module are guaranteed to stay the same across
- versions and which parts are subject to change.
-
- * Update the seed() method to use all of the bits in a string instead of just
- the hash value. This makes better use of the seed value and assures the
- seeding is platform independent. Issue #7889.
-
- * Improved the random()-->integer algorithm used in choice(), shuffle(),
- sample(), randrange(), and randint(). Formerly, it used int(n*random())
- which has a slight bias whenever n is not a power of two. Issue #9025.
-
- * Improved documentation of arguments to randrange(). Issue #9379.
-
-- collections.OrderedDict now supports a new method for repositioning keys to
- either end.
-
-- Issue #9754: Similarly to assertRaises and assertRaisesRegexp, unittest test
- cases now also have assertWarns and assertWarnsRegexp methods to check that a
- given warning type was triggered by the code under test.
-
-- Issue #5506: BytesIO objects now have a getbuffer() method exporting a view of
- their contents without duplicating them. The view is both readable and
- writable.
-
-- Issue #7566: Implement os.path.sameopenfile for Windows.
-
-- Issue #9293: I/O streams now raise ``io.UnsupportedOperation`` when an
- unsupported operation is attempted (for example, writing to a file open only
- for reading).
-
-- hashlib has two new constant attributes: algorithms_guaranteed and
- algorithms_avaiable that respectively list the names of hash algorithms
- guaranteed to exist in all Python implementations and the names of hash
- algorithms available in the current process.
-
-- A new package ``concurrent.futures`` as defined by PEP 3148.
-
-C-API
------
-
-- Add PyErr_SyntaxLocationEx, which supports passing a column offset.
-
-- Issue #9834: Don't segfault in PySequence_GetSlice, PySequence_SetSlice, or
- PySequence_DelSlice when the object doesn't have any mapping operations
- defined.
-
-Tools/Demos
------------
-
-- Issue #9188: The gdb extension now handles correctly narrow (UCS2) as well as
- wide (UCS4) unicode builds for both the host interpreter (embedded inside gdb)
- and the interpreter under test.
-
-Tests
------
-
-- Issue #9308: Added tests for importing encoded modules that do not
- depend on specific stdlib modules being encoded in a certain way.
-
-- Issue #1051: Add a script (Lib/test/make_ssl_certs.py) to generate the custom
- certificate and private key files used by SSL-related certs.
-
-- Issue #9978: Wait until subprocess completes initialization. (Win32KillTests
- in test_os)
-
-- Issue #7110: regrtest now sends test failure reports and single-failure
- tracebacks to stderr rather than stdout.
-
-- Issue #9628: fix runtests.sh -x option so more than one test can be excluded.
-
-- Issue #9899: Fix test_tkinter.test_font on various platforms. Patch by Ned
- Deily.
-
-- Issue #9894: Do not hardcode ENOENT in test_subprocess.
-
-- Issue #9315: Added tests for the trace module. Patch by Eli Bendersky.
-
-- Issue #9323: Make test.regrtest.__file__ absolute, this was not always the
- case when running profile or trace, for example.
-
-- Issue #9568: Fix test_urllib2_localnet on OS X 10.3.
-
-Build
------
-
-- Issue #10062: Allow building on platforms which do not have sem_timedwait.
-
-- Issue #10054: Some platforms provide uintptr_t in inttypes.h. Patch by Akira
- Kitada.
-
-- Issue #10055: Make json C89-compliant in UCS4 mode.
-
-- Issue #9552: Avoid unnecessary rebuild of OpenSSL. (Windows)
-
-- Issue #1633863: Don't ignore $CC under AIX.
-
-- Issue #9810: Compile bzip2 source files in Python's project file directly. It
- used to be built with bzip2's makefile.
-
-- Issue #9848: Stopping trying to build _weakref in setup.py as it is a built-in
- module.
-
-- Issue #9806: python-config now has an ``--extension-suffix`` option that
- outputs the suffix for dynamic libraries including the ABI version name
- defined by PEP 3149.
-
-- Issue #941346: Improve the build process under AIX and allow Python to be
- built as a shared library. Patch by Sébastien Sablé.
-
-- Issue #4026: Make the fcntl extension build under AIX. Patch by Sébastien
- Sablé.
-
-- Issue #9701: The MacOSX installer can patch the shell profile to ensure that
- the "bin" directory inside the framework is on the shell's search path. This
- feature now also supports the ZSH shell.
-
-
-What's New in Python 3.2 Alpha 2?
-=================================
-
-*Release date: 05-Sep-2010*
-
-Core and Builtins
------------------
-
-- Issue #9225: Remove the ROT_FOUR and DUP_TOPX opcode, the latter replaced by
- the new (and simpler) DUP_TOP_TWO. Performance isn't changed, but our
- bytecode is a bit simplified. Patch by Demur Rumed.
-
-- Issue #9766: Rename poorly named variables exposed by _warnings to prevent
- confusion with the proper variables names from 'warnings' itself.
-
-- Issue #9212: dict_keys and dict_items now provide the isdisjoint() method, to
- conform to the Set ABC. Patch by Daniel Urban.
-
-- Issue #9737: Fix a crash when trying to delete a slice or an item from a
- memoryview object.
-
-- Issue #9549: sys.setdefaultencoding() and PyUnicode_SetDefaultEncoding() are
- now removed, since their effect was inexistent in 3.x (the default encoding is
- hardcoded to utf-8 and cannot be changed).
-
-- Issue #7415: PyUnicode_FromEncodedObject() now uses the new buffer API
- properly. Patch by Stefan Behnel.
-
-- Issue #5553: The Py_LOCAL_INLINE macro now results in inlining on most
- platforms. Previously, it inlined only when using Microsoft Visual C.
-
-- Issue #9712: Fix tokenize on identifiers that start with non-ascii names.
-
-- Issue #9688: __basicsize__ and __itemsize__ must be accessed as Py_ssize_t.
-
-- Issue #9684: Added a definition for SIZEOF_WCHAR_T to PC/pyconfig.h, to match
- the pyconfig.h generated by configure on other systems.
-
-- Issue #9666: Only catch AttributeError in hasattr(). All other exceptions that
- occur during attribute lookup are now propagated to the caller.
-
-- Issue #8622: Add PYTHONFSENCODING environment variable to override the
- filesystem encoding.
-
-- Issue #5127: The C functions that access the Unicode Database now accept and
- return characters from the full Unicode range, even on narrow unicode builds
- (Py_UNICODE_TOLOWER, Py_UNICODE_ISDECIMAL, and others). A visible difference
- in Python is that unicodedata.numeric() now returns the correct value for
- large code points, and repr() may consider more characters as printable.
-
-- Issue #9425: Create PyModule_GetFilenameObject() function to get the filename
- as a unicode object, instead of a byte string. Function needed to support
- unencodable filenames. Deprecate PyModule_GetFilename() in favor on the new
- function.
-
-- Issue #8063: Call _PyGILState_Init() earlier in Py_InitializeEx().
-
-- Issue #9612: The set object is now 64-bit clean under Windows.
-
-- Issue #8202: sys.argv[0] is now set to '-m' instead of '-c' when searching for
- the module file to be executed with the -m command line option.
-
-- Issue #9599: Create PySys_FormatStdout() and PySys_FormatStderr() functions to
- write a message formatted by PyUnicode_FromFormatV() to sys.stdout and
- sys.stderr.
-
-- Issue #9542: Create PyUnicode_FSDecoder() function, a ParseTuple converter:
- decode bytes objects to unicode using PyUnicode_DecodeFSDefaultAndSize(); str
- objects are output as-is.
-
-- Issue #9203: Computed gotos are now enabled by default on supported compilers
- (which are detected by the configure script). They can still be disable
- selectively by specifying --without-computed-gotos.
-
-- Issue #9425: Create PyErr_WarnFormat() function, similar to PyErr_WarnEx() but
- use PyUnicode_FromFormatV() to format the warning message.
-
-- Issue #8530: Prevent stringlib fastsearch from reading beyond the front of an
- array.
-
-- Issue #5319: Print an error if flushing stdout fails at interpreter shutdown.
-
-- Issue #9337: The str() of a float or complex number is now identical to its
- repr().
-
-- Issue #9416: Fix some issues with complex formatting where the output with no
- type specifier failed to match the str output:
-
- - format(complex(-0.0, 2.0), '-') omitted the real part from the output,
- - format(complex(0.0, 2.0), '-') included a sign and parentheses.
-
-Extension Modules
------------------
-
-- Issue #8013: time.asctime and time.ctime no longer call system
- asctime and ctime functions. The year range for time.asctime is now
- 1900 through maxint. The range for time.ctime is the same as for
- time.localtime. The string produced by these functions is longer
- than 24 characters when year is greater than 9999.
-
-- Issue #6608: time.asctime is now checking struct tm fields its input
- before passing it to the system asctime. Patch by MunSic Jeong.
-
-- Issue #8734: Avoid crash in msvcrt.get_osfhandle() when an invalid file
- descriptor is provided. Patch by Pascal Chambon.
-
-- Issue #7736: Release the GIL around calls to opendir() and closedir() in the
- posix module. Patch by Marcin Bachry.
-
-- Issue #4835: make PyLong_FromSocket_t() and PyLong_AsSocket_t() private to the
- socket module, and fix the width of socket descriptors to be correctly
- detected under 64-bit Windows.
-
-- Issue #1027206: Support IDNA in gethostbyname, gethostbyname_ex, getaddrinfo
- and gethostbyaddr. getnameinfo is now restricted to numeric addresses as
- input.
-
-- Issue #9214: Set operations on a KeysView or ItemsView in collections now
- correctly return a set. Patch by Eli Bendersky.
-
-- Issue #5737: Add Solaris-specific mnemonics in the errno module. Patch by
- Matthew Ahrens.
-
-- Restore GIL in nis_cat in case of error. Decode NIS data to fs encoding, using
- the surrogate error handler.
-
-- Issue #665761: ``functools.reduce()`` will no longer mask exceptions other
- than ``TypeError`` raised by the iterator argument.
-
-- Issue #9570: Use PEP 383 decoding in os.mknod and os.mkfifo.
-
-- Issue #6915: Under Windows, os.listdir() didn't release the Global Interpreter
- Lock around all system calls. Original patch by Ryan Kelly.
-
-- Issue #8524: Add a detach() method to socket objects, so as to put the socket
- into the closed state without closing the underlying file descriptor.
-
-- Issue #477863: Emit a ResourceWarning at shutdown if gc.garbage is not empty.
-
-- Issue #6869: Fix a refcount problem in the _ctypes extension.
-
-- Issue #5504: ctypes should now work with systems where mmap can't be
- PROT_WRITE and PROT_EXEC.
-
-- Issue #9507: Named tuple repr will now automatically display the right name in
- a tuple subclass.
-
-- Issue #9324: Add parameter validation to signal.signal on Windows in order to
- prevent crashes.
-
-- Issue #9526: Remove some outdated (int) casts that were preventing the array
- module from working correctly with arrays of more than 2**31 elements.
-
-- Fix memory leak in ssl._ssl._test_decode_cert.
-
-- Issue #8065: Fix memory leak in readline module (from failure to free the
- result of history_get_history_state()).
-
-- Issue #9450: Fix memory leak in readline.replace_history_item and
- readline.remove_history_item for readline version >= 5.0.
-
-- Issue #8105: Validate file descriptor passed to mmap.mmap on Windows.
-
-- Issue #8046: Add context manager protocol support and .closed property to mmap
- objects.
-
-Library
--------
-
-- Issue #7451: Improve decoding performance of JSON objects, and reduce the
- memory consumption of said decoded objects when they use the same strings as
- keys.
-
-- Issue #1100562: Fix deep-copying of objects derived from the list and dict
- types. Patch by Michele Orrù and Björn Lindqvist.
-
-- Issue #9753: Fixed socket.dup, which did not always work correctly on Windows.
-
-- Issue #9421: Made the get<type> methods consistently accept the vars and
- default arguments on all parser classes.
-
-- Issue #7005: Fixed output of None values for RawConfigParser.write and
- ConfigParser.write.
-
-- Issue #8990: array.fromstring() and array.tostring() get renamed to
- frombytes() and tobytes(), respectively, to avoid confusion. Furthermore,
- array.frombytes(), array.extend() as well as the array.array() constructor now
- accept bytearray objects. Patch by Thomas Jollans.
-
-- Issue #808164: Fixed socket.close to avoid references to globals, to avoid
- issues when socket.close is called from a __del__ method.
-
-- Issue #9706: ssl module provides a better error handling in various
- circumstances.
-
-- Issue #1868: Eliminate subtle timing issues in thread-local objects by getting
- rid of the cached copy of thread-local attribute dictionary.
-
-- Issue #1512791: In setframerate() in the wave module, non-integral frame rates
- are rounded to the nearest integer.
-
-- Issue #8797: urllib2 does a retry for Basic Authentication failure instead of
- falling into recursion.
-
-- Issue #1194222: email.utils.parsedate now returns RFC2822 compliant four
- character years even if the message contains RFC822 two character years.
-
-- Issue #8750: Fixed MutableSet's methods to correctly handle reflexive
- operations on its self, namely x -= x and x ^= x.
-
-- Issue #9129: smtpd.py is vulnerable to DoS attacks deriving from missing error
- handling when accepting a new connection.
-
-- Issue #9601: ftplib now provides a workaround for non-compliant
- implementations such as IIS shipped with Windows server 2003 returning invalid
- response codes for MKD and PWD commands.
-
-- Issue #658749: asyncore's connect() method now correctly interprets winsock
- errors.
-
-- Issue #9501: Fixed logging regressions in cleanup code.
-
-- Fix functools.total_ordering() to skip methods inherited from object.
-
-- Issue #9572: Importlib should not raise an exception if a directory it thought
- it needed to create was done concurrently by another process.
-
-- Issue #9617: Signals received during a low-level write operation aren't
- ignored by the buffered IO layer anymore.
-
-- Issue #843590: Make "macintosh" an alias to the "mac_roman" encoding.
-
-- Create os.fsdecode(): decode from the filesystem encoding with surrogateescape
- error handler, or strict error handler on Windows.
-
-- Issue #3488: Provide convenient shorthand functions ``gzip.compress`` and
- ``gzip.decompress``. Original patch by Anand B. Pillai.
-
-- Issue #8807: poplib.POP3_SSL class now accepts a context parameter, which is a
- ssl.SSLContext object allowing bundling SSL configuration options,
- certificates and private keys into a single (potentially long-lived)
- structure.
-
-- Issue #8866: parameters passed to socket.getaddrinfo can now be specified as
- single keyword arguments.
-
-- Address XXX comment in dis.py by having inspect.py prefer to reuse the dis.py
- compiler flag values over defining its own.
-
-- Issue #9147: Added dis.code_info() which is similar to show_code() but returns
- formatted code information in a string rather than displaying on screen.
-
-- Issue #9567: functools.update_wrapper now adds a __wrapped__ attribute
- pointing to the original callable.
-
-- Issue #3445: functools.update_wrapper now tolerates missing attributes on
- wrapped callables.
-
-- Issue #5867: Add abc.abstractclassmethod and abc.abstractstaticmethod.
-
-- Issue #9605: posix.getlogin() decodes the username with file filesystem
- encoding and surrogateescape error handler. Patch written by David Watson.
-
-- Issue #9604: posix.initgroups() encodes the username using the fileystem
- encoding and surrogateescape error handler. Patch written by David Watson.
-
-- Issue #9603: posix.ttyname() and posix.ctermid() decode the terminal name
- using the filesystem encoding and surrogateescape error handler. Patch written
- by David Watson.
-
-- Issue #7647: The posix module now has the ST_RDONLY and ST_NOSUID constants,
- for use with the statvfs() function. Patch by Adam Jackson.
-
-- Issue #8688: MANIFEST files created by distutils now include a magic comment
- indicating they are generated. Manually maintained MANIFESTs without this
- marker will not be overwritten or removed.
-
-- Issue #7467: when reading a file from a ZIP archive, its CRC is checked and a
- BadZipfile error is raised if it doesn't match (as used to be the case in
- Python 2.5 and earlier).
-
-- Issue #9550: a BufferedReader could issue an additional read when the original
- read request had been satisfied, which could block indefinitely when the
- underlying raw IO channel was e.g. a socket. Report and original patch by
- Jason V. Miller.
-
-- Issue #3757: thread-local objects now support cyclic garbage collection.
- Thread-local objects involved in reference cycles will be deallocated timely
- by the cyclic GC, even if the underlying thread is still running.
-
-- Issue #9452: Add read_file, read_string, and read_dict to the configparser
- API; new source attribute to exceptions.
-
-- Issue #6231: Fix xml.etree.ElementInclude to include the tail of the current
- node.
-
-- Issue #8047: Fix the xml.etree serializer to return bytes by default. Use
- ``encoding="unicode"`` to generate a Unicode string.
-
-- Issue #8280: urllib2's Request method will remove fragments in the url. This
- is how it is supposed to work, wget and curl do the same. Previous behavior
- was wrong.
-
-- Issue #6683: For SMTP logins we now try all authentication methods advertised
- by the server. Many servers are buggy and advertise authentication methods
- they do not support in reality.
-
-- Issue #8814: function annotations (the ``__annotations__`` attribute) are now
- included in the set of attributes copied by default by functools.wraps and
- functools.update_wrapper. Patch by Terrence Cole.
-
-- Issue #2944: asyncore doesn't handle connection refused correctly.
-
-- Issue #4184: Private attributes on smtpd.SMTPChannel made public and deprecate
- the private attributes. Add tests for smtpd module.
-
-- Issue #3196: email header decoding is now forgiving if an RFC2047 encoded word
- encoded in base64 is lacking padding.
-
-- Issue #9444: Argparse now uses the first element of prefix_chars as the option
- character for the added 'h/help' option if prefix_chars does not contain a
- '-', instead of raising an error.
-
-- Issue #7372: Fix pstats regression when stripping paths from profile data
- generated with the profile module.
-
-- Issue #9428: Fix running scripts with the profile/cProfile modules from the
- command line.
-
-- Issue #7781: Fix restricting stats by entry counts in the pstats interactive
- browser.
-
-- Issue #9209: Do not crash in the pstats interactive browser on invalid regular
- expressions.
-
-- Update collections.OrderedDict to match the implementation in Py2.7 (based on
- lists instead of weakly referenced Link objects).
-
-- Issue #8397: Raise an error when attempting to mix iteration and regular reads
- on a BZ2File object, rather than returning incorrect results.
-
-- Issue #9448: Fix a leak of OS resources (mutexes or semaphores) when
- re-initializing a buffered IO object by calling its ``__init__`` method.
-
-- Issue #1713: Fix os.path.ismount(), which returned true for symbolic links
- across devices.
-
-- Issue #8826: Properly load old-style "expires" attribute in http.cookies.
-
-- Issue #1690103: Fix initial namespace for code run with trace.main().
-
-- Issue #7395: Fix tracebacks in pstats interactive browser.
-
-- Issue #8230: Fix Lib/test/sortperf.py.
-
-- Issue #8620: when a cmd.Cmd() is fed input that reaches EOF without a final
- newline, it no longer truncates the last character of the last command line.
-
-- Issue #5146: Handle UID THREAD command correctly in imaplib.
-
-- Issue #5147: Fix the header generated for cookie files written by
- http.cookiejar.MozillaCookieJar.
-
-- Issue #8198: In pydoc, output all help text to the correct stream when
- sys.stdout is reassigned.
-
-- Issue #7909: Do not touch paths with the special prefixes ``\\.\`` or ``\\?\``
- in ntpath.normpath().
-
-- Issue #1286: Allow using fileinput.FileInput as a context manager.
-
-- Add lru_cache() decorator to the functools module.
-
-Tools/Demos
------------
-
-- Fix ``Tools/scripts/checkpyc.py`` after PEP 3147.
-
-- Issue #8867: Fix ``Tools/scripts/serve.py`` to work with files containing
- non-ASCII content.
-
-Tests
------
-
-- Issue #9601: Provide a test case for ftplib.parse257.
-
-- Issue #8857: Provide a test case for socket.getaddrinfo.
-
-- Issue #7564: Skip test_ioctl if another process is attached to /dev/tty.
-
-- Issue #8433: Fix test_curses failure with newer versions of ncurses.
-
-- Issue #9496: Provide a test suite for the rlcompleter module. Patch by
- Michele Orrù.
-
-- Issue #8687: provide a test suite for sched.py module.
-
-Build
------
-
-- Issue #1303434: Generate ZIP file containing all PDBs.
-
-- Issue #9193: PEP 3149 is accepted.
-
-- Issue #3101: Helper functions _add_one_to_index_C() and _add_one_to_index_F()
- become _Py_add_one_to_index_C() and _Py_add_one_to_index_F(), respectively.
-
-- Issue #9700: define HAVE_BROKEN_POSIX_SEMAPHORES under AIX 6.x. Patch by
- Sébastien Sablé.
-
-- Don't run pgen twice when using make -j.
-
-
-What's New in Python 3.2 Alpha 1?
-=================================
-
-*Release date: 01-Aug-2010*
-
-Core and Builtins
------------------
-
-- Issue #8991: convertbuffer() rejects discontigious buffers.
-
-- Issue #7616: Fix copying of overlapping memoryview slices with the Intel
- compiler.
-
-- Issue #8413: structsequence now subclasses tuple.
-
-- Issue #8271: during the decoding of an invalid UTF-8 byte sequence, only the
- start byte and the continuation byte(s) are now considered invalid, instead of
- the number of bytes specified by the start byte. E.g.:
- '\xf1\x80AB'.decode('utf-8', 'replace') now returns u'\ufffdAB' and replaces
- with U+FFFD only the start byte ('\xf1') and the continuation byte ('\x80')
- even if '\xf1' is the start byte of a 4-bytes sequence. Previous versions
- returned a single u'\ufffd'.
-
-- Issue #9011: A negated imaginary literal (e.g., "-7j") now has real part -0.0
- rather than 0.0. So "-7j" is now exactly equivalent to "-(7j)".
-
-- Be more specific in error messages about positional arguments.
-
-- Issue #8949: "z" format of PyArg_Parse*() functions doesn't accept bytes
- objects, as described in the documentation.
-
-- Issue #6543: Write the traceback in the terminal encoding instead of utf-8.
- Fix the encoding of the modules filename. Patch written by Amaury Forgeot
- d'Arc.
-
-- Issue #9011: Remove buggy and unnecessary (in 3.x) ST->AST compilation code
- dealing with unary minus applied to a constant. The removed code was mutating
- the ST, causing a second compilation to fail.
-
-- Issue #850997: mbcs encoding (Windows only) handles errors argument: strict
- mode raises unicode errors. The encoder only supports "strict" and "replace"
- error handlers, the decoder only supports "strict" and "ignore" error
- handlers. Patch written by Mark Hammond.
-
-- Issue #8850: Remove "w" and "w#" formats from PyArg_Parse*() functions, use
- "w*" format instead. Add tests for "w*" format.
-
-- Issue #8592: PyArg_Parse*() functions raise a TypeError for "y", "u" and "Z"
- formats if the string contains a null byte/character. Write unit tests for
- string formats.
-
-- Issue #7490: To facilitate sharing of doctests between 2.x and 3.x test
- suites, the IGNORE_EXCEPTION_DETAIL directive now also ignores the module
- location of the raised exception.
-
-- Issue #8969: On Windows, use mbcs codec in strict mode to encode and decode
- filenames and enable os.fsencode().
-
-- Issue #9058: Remove assertions about INT_MAX in UnicodeDecodeError.
-
-- Issue #8941: Decoding big endian UTF-32 data in UCS-2 builds could crash the
- interpreter with characters outside the Basic Multilingual Plane (higher than
- 0x10000).
-
-- Issue #8950: (See also issue #5080). Py_ArgParse*() functions now raise
- TypeError instead of giving a DeprecationWarning when a float is parsed using
- the 'L' code (for long long). (All other integer codes already raise
- TypeError in this case.)
-
-- Issue #8922: Normalize the encoding name in PyUnicode_AsEncodedString() to
- enable shortcuts for upper case encoding name. Add also a shortcut for
- "iso-8859-1" in PyUnicode_AsEncodedString() and PyUnicode_Decode().
-
-- Issue #8838: Remove codecs.charbuffer_encode() function. The buffer protocol
- doesn't support "char buffer" anymore in Python 3.
-
-- Issue #8339: Remove "t#" format of PyArg_Parse*() functions, use "s#" or "s*"
- instead. codecs.charbuffer_encode() now accepts modifiable buffer objects
- like bytearray.
-
-- Issue #8837: Remove "O?" format of PyArg_Parse*() functions. The format is no
- used anymore and it was never documented.
-
-- In str.format(), raise a ValueError when indexes to arguments are too large.
-
-- Issue #2844: Make int('42', n) consistently raise ValueError for invalid
- integers n (including n = -909).
-
-- Issue #8188: Introduce a new scheme for computing hashes of numbers (instances
- of int, float, complex, decimal.Decimal and fractions.Fraction) that makes it
- easy to maintain the invariant that hash(x) == hash(y) whenever x and y have
- equal value.
-
-- Issue #8748: Fix two issues with comparisons between complex and integer
- objects. (1) The comparison could incorrectly return True in some cases
- (2**53+1 == complex(2**53) == 2**53), breaking transitivity of equality.
- (2) The comparison raised an OverflowError for large integers, leading to
- unpredictable exceptions when combining integers and complex objects in sets
- or dicts.
-
-- Issue #8766: Initialize _warnings module before importing the first module.
- Fix a crash if an empty directory called "encodings" exists in sys.path.
-
-- Issue #8589: Decode PYTHONWARNINGS environment variable with the file system
- encoding and surrogateescape error handler instead of the locale encoding to
- be consistent with os.environ. Add PySys_AddWarnOptionUnicode() function.
-
-- PyObject_Dump() encodes unicode objects to utf8 with backslashreplace (instead
- of strict) error handler to escape surrogates.
-
-- Issue #8715: Create PyUnicode_EncodeFSDefault() function: Encode a Unicode
- object to Py_FileSystemDefaultEncoding with the "surrogateescape" error
- handler, and return bytes. If Py_FileSystemDefaultEncoding is not set, fall
- back to UTF-8.
-
-- Enable shortcuts for common encodings in PyUnicode_AsEncodedString() for any
- error handler, not only the default error handler (strict).
-
-- Issue #8610: Load file system codec at startup, and display a fatal error on
- failure. Set the file system encoding to utf-8 (instead of None) if getting
- the locale encoding failed, or if nl_langinfo(CODESET) function is missing.
-
-- PyFile_FromFd() uses PyUnicode_DecodeFSDefault() instead of
- PyUnicode_FromString() to support surrogates in the filename and use the right
- encoding.
-
-- Issue #7507: Quote "!" in pipes.quote(); it is special to some shells.
-
-- PyUnicode_DecodeFSDefaultAndSize() uses surrogateescape error handler.
-
-- Issue #8419: Prevent the dict constructor from accepting non-string keyword
- arguments.
-
-- Issue #8124: PySys_WriteStdout() and PySys_WriteStderr() don't execute
- indirectly Python signal handlers anymore because mywrite() ignores exceptions
- (KeyboardInterrupt).
-
-- Issue #8092: Fix PyUnicode_EncodeUTF8() to support error handler producing
- unicode string (eg. backslashreplace).
-
-- Issue #8485: PyUnicode_FSConverter() doesn't accept byteearray objects
- anymore, you have to convert your bytearray filenames to bytes.
-
-- Issue #7332: Remove the 16KB stack-based buffer in
- PyMarshal_ReadLastObjectFromFile, which doesn't bring any noticeable benefit
- compared to the dynamic memory allocation fallback. Patch by Charles-François
- Natali.
-
-- Issue #8417: Raise an OverflowError when an integer larger than sys.maxsize is
- passed to bytes or bytearray.
-
-- Issue #7301: Add environment variable $PYTHONWARNINGS.
-
-- Issue #8329: Don't return the same lists from select.select when no fds are
- changed.
-
-- Issue #8259: 1L << (2**31) no longer produces an 'outrageous shift error' on
- 64-bit machines. The shift count for either left or right shift is permitted
- to be up to sys.maxsize.
-
-- Ensure that tokenization of identifiers is not affected by locale.
-
-- Issue #1222585: Added LDCXXSHARED for C++ support. Patch by Arfrever.
-
-- Raise a TypeError when trying to delete a T_STRING_INPLACE struct member.
-
-- Issue #8211: Save/restore CFLAGS around AC_PROG_CC in configure.in, in case it
- is set.
-
-- Issue #8226: sys.setfilesystemencoding() raises a LookupError if the encoding
- is unknown.
-
-- Issue #1583863: A str subclass can now override the __str__ method.
-
-- Issue #8014: Setting a T_UINT or T_PYSSIZET attribute of an object with
- PyMemberDefs could produce an internal error; raise TypeError instead.
-
-- Issue #7845: Rich comparison methods on the complex type now return
- NotImplemented rather than raising a TypeError when comparing with an
- incompatible type; this allows user-defined classes to implement their own
- comparisons with complex.
-
-- Issue #3137: Don't ignore errors at startup, especially a keyboard interrupt
- (SIGINT). If an error occurs while importing the site module, the error is
- printed and Python exits. Initialize the GIL before importing the site module.
-
-- Issue #7173: Generator finalization could invalidate sys.exc_info().
-
-- Issue #7544: Preallocate thread memory before creating the thread to avoid a
- fatal error in low memory condition.
-
-- Issue #7820: The parser tokenizer restores all bytes in the right if the BOM
- check fails.
-
-- Handle errors from looking up __prepare__ correctly.
-
-- Issue #5939: Add additional runtime checking to ensure a valid capsule in
- Modules/_ctypes/callproc.c.
-
-- Issue #7309: Fix unchecked attribute access when converting
- UnicodeEncodeError, UnicodeDecodeError, and UnicodeTranslateError to strings.
-
-- Issue #6902: Fix problem with built-in types format incorrectly with 0
- padding.
-
-- Issue #7988: Fix default alignment to be right aligned for complex.__format__.
- Now it matches other numeric types.
-
-- Issue #5988: Remove deprecated functions PyOS_ascii_formatd,
- PyOS_ascii_strtod, and PyOS_ascii_atof. Use PyOS_double_to_string and
- PyOS_string_to_double instead. See issue #5835 for the original deprecations.
-
-- Issue #7385: Fix a crash in `MemoryView_FromObject` when `PyObject_GetBuffer`
- fails. Patch by Florent Xicluna.
-
-- Issue #7788: Fix an interpreter crash produced by deleting a list slice with
- very large step value.
-
-- Issue #7766: Change sys.getwindowsversion() return value to a named tuple and
- add the additional members returned in an OSVERSIONINFOEX structure. The new
- members are service_pack_major, service_pack_minor, suite_mask, and
- product_type.
-
-- Issue #7561: Operations on empty bytearrays (such as `int(bytearray())`) could
- crash in many places because of the PyByteArray_AS_STRING() macro returning
- NULL. The macro now returns a statically allocated empty string instead.
-
-- Issue #6690: Optimize the bytecode for expressions such as `x in {1, 2, 3}`,
- where the right hand operand is a set of constants, by turning the set into a
- frozenset and pre-building it as a constant. The comparison operation is made
- against the constant instead of building a new set each time it is executed (a
- similar optimization already existed which turned a list of constants into a
- pre-built tuple). Patch and additional tests by Dave Malcolm.
-
-- Issue #7622: Improve the split(), rsplit(), splitlines() and replace() methods
- of bytes, bytearray and unicode objects by using a common implementation based
- on stringlib's fast search. Patch by Florent Xicluna.
-
-- Issue #7632: Fix various str -> float conversion bugs present in 2.7 alpha 2,
- including: (1) a serious 'wrong output' bug that could occur for long (> 40
- digit) input strings, (2) a crash in dtoa.c that occurred in debug builds when
- parsing certain long numeric strings corresponding to subnormal values, (3) a
- memory leak for some values large enough to cause overflow, and (4) a number
- of flaws that could lead to incorrectly rounded results.
-
-- The __complex__ method is now looked up on the class of instances to make it
- consistent with other special methods.
-
-- Issue #7462: Implement the stringlib fast search algorithm for the `rfind`,
- `rindex`, `rsplit` and `rpartition` methods. Patch by Florent Xicluna.
-
-- Issue #7604: Deleting an unset slotted attribute did not raise an
- AttributeError.
-
-- Issue #7534: Fix handling of IEEE specials (infinities, nans, negative zero)
- in ** operator. The behaviour now conforms to that described in C99 Annex F.
-
-- Issue #1811: improve accuracy and cross-platform consistency for true division
- of integers: the result of a/b is now correctly rounded for ints a and b (at
- least on IEEE 754 platforms), and in particular does not depend on the
- internal representation of an int.
-
-- Issue #6834: replace the implementation for the 'python' and 'pythonw'
- executables on OSX.
-
- These executables now work properly with the arch(1) command: ``arch -ppc
- python`` will start a universal binary version of python in PPC mode (unlike
- previous releases).
-
-- Issue #7466: Segmentation fault when the garbage collector is called in the
- middle of populating a tuple. Patch by Florent Xicluna.
-
-- Issue #7419: setlocale() could crash the interpreter on Windows when called
- with invalid values.
-
-- Issue #6077: On Windows, files opened with tempfile.TemporaryFile in "wt+"
- mode would appear truncated on the first '0x1a' byte (aka. Ctrl+Z).
-
-- Issue #7085: Fix crash when importing some extensions in a thread on MacOSX
- 10.6.
-
-- Issue #1757126: Fix the cyrillic-asian alias for the ptcp154 encoding.
-
-- Issue #6970: Remove redundant calls when comparing objects that don't
- implement the relevant rich comparison methods.
-
-- Issue #7298: Fixes for range and reversed(range(...)). Iteration over
- range(a, b, c) incorrectly gave an empty iterator when a, b and c fit in C
- long but the length of the range did not. Also fix several cases where
- reversed(range(a, b, c)) gave wrong results, and fix a refleak for
- reversed(range(a, b, c)) with large arguments.
-
-- Issue #7244: itertools.izip_longest() no longer ignores exceptions raised
- during the formation of an output tuple.
-
-- Issue #3297: On wide unicode builds, do not split unicode characters into
- surrogates.
-
-- Remove length limitation when constructing a complex number from a string.
-
-- Issue #1087418: Boost performance of bitwise operations for longs.
-
-- Support for AtheOS has been completely removed from the code base. It was
- disabled since Python 3.0.
-
-- Support for several legacy threading libraries has been disabled. These
- libraries are: Mach C threads, SunOS LWP, GNU pth, Irix threads. Support code
- will be entirely removed in 3.3.
-
-- Support for OSF* has been disabled. If nobody stands up, support will be
- removed in 3.3. See <http://bugs.python.org/issue8606>.
-
-- Peephole constant folding had missed UNARY_POSITIVE.
-
-- Issue #1722344: threading._shutdown() is now called in Py_Finalize(), which
- fixes the problem of some exceptions being thrown at shutdown when the
- interpreter is killed. Patch by Adam Olsen.
-
-- Issue #7147: Remove support for compiling Python without complex number
- support.
-
-- Issue #7120: logging: Removed import of multiprocessing which is causing crash
- in GAE.
-
-- Issue #1754094: Improve the stack depth calculation in the compiler. There
- should be no other effect than a small decrease in memory use. Patch by
- Christopher Tur Lesniewski-Laas.
-
-- Issue #7065: Fix a crash in bytes.maketrans and bytearray.maketrans when using
- byte values greater than 127. Patch by Derk Drukker.
-
-- Issue #1571184: The Unicode database contains properties for more characters.
- The tables for code points representing numeric values, white spaces or line
- breaks are now generated from the official Unicode Character Database files,
- and include information from the Unihan.txt file.
-
-- Issue #7019: Raise ValueError when unmarshalling bad long data, instead of
- producing internally inconsistent Python longs.
-
-- Issue #6990: Fix threading.local subclasses leaving old state around after a
- reference cycle GC which could be recycled by new locals.
-
-- Issue #5460: Fix an ambiguity in the grammar.
-
-- Issue #1766304: Improve performance of membership tests on range objects.
-
-- Issue #6713: Improve performance of integer -> string conversions.
-
-- Issue #6846: Fix bug where bytearray.pop() returns negative integers.
-
-- Issue #6750: A text file opened with io.open() could duplicate its output when
- writing from multiple threads at the same time.
-
-- Issue #6707: dir() on an uninitialized module caused a crash.
-
-- Issue #6540: Fixed crash for bytearray.translate() with invalid parameters.
-
-- Issue #6573: set.union() stopped processing inputs if an instance of self
- occurred in the argument chain.
-
-- Issue #6070: On posix platforms import no longer copies the execute bit from
- the .py file to the .pyc file if it is set.
-
-- Issue #1616979: Added the cp720 (Arabic DOS) encoding.
-
-- Issue #6428: Since Python 3.0, the __bool__ method must return a bool object,
- and not an int. Fix the corresponding error message, and the documentation.
-
-- The deprecated PyCObject has been removed.
-
-- Issue #6347: Include inttypes.h as well as stdint.h in pyport.h. This fixes a
- build failure on HP-UX: int32_t and uint32_t are defined in inttypes.h instead
- of stdint.h on that platform.
-
-- Issue #6373: Fixed a SystemError when encoding with the latin-1 codec and the
- 'surrogateescape' error handler, a string which contains unpaired surrogates.
-
-- Issue #4856: Remove checks for win NT.
-
-- Issue #6687: PyBytes_FromObject() no longer accepts an integer as its argument
- to construct a null-initialized bytes object.
-
-- Issue #1023290: Add from_bytes() and to_bytes() methods to integers. These
- methods allow the conversion of integers to bytes, and vice-versa.
-
-- Issue #7382: Fix bug in bytes.__getnewargs__ that prevented bytes instances
- from being copied with copy.copy(), and bytes subclasses from being pickled
- properly.
-
-- Code objects now support weak references.
-
-- Issue #7072: isspace(0xa0) is true on Mac OS X.
-
-- Issue #8084: PEP 370 now conforms to system conventions for framework builds
- on MacOS X. That is, "python setup.py install --user" will install into
- "~/Library/Python/2.7" instead of "~/.local".
-
-C-API
------
-
-- Issue #2443: A new macro, `Py_VA_COPY`, copies the state of the
- variable argument list. `Py_VA_COPY` is equivalent to C99
- `va_copy`, but available on all python platforms.
-
-- PySlice_GetIndicesEx now clips the step to [-PY_SSIZE_T_MAX, PY_SSIZE_T_MAX]
- instead of [-PY_SSIZE_T_MAX-1, PY_SSIZE_T_MAX]. This makes it safe to do
- "step = -step" when reversing a slice.
-
-- Issue #5753: A new C API function, `PySys_SetArgvEx`, allows embedders of the
- interpreter to set sys.argv without also modifying sys.path. This helps fix
- `CVE-2008-5983
- <http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2008-5983>`_.
-
-- Add PyArg_ValidateKeywordArguments, which checks if all keyword arguments are
- strings in an efficient manner.
-
-- Issue #8276: PyEval_CallObject() is now only available in macro form. The
- function declaration, which was kept for backwards compatibility reasons, is
- now removed (the macro was introduced in 1997!).
-
-- Issue #7767: New function PyLong_AsLongLongAndOverflow added, analogous to
- PyLong_AsLongAndOverflow.
-
-- Make PyUnicode_CompareWithASCIIString return not equal if the Python string
- has '\0' at the end.
-
-- Issue #5080: The argument parsing functions PyArg_ParseTuple,
- PyArg_ParseTupleAndKeywords, PyArg_VaParse, PyArg_VaParseTupleAndKeywords and
- PyArg_Parse now raise a DeprecationWarning for float arguments passed with the
- 'L' format code. This will become a TypeError in a future version of Python,
- to match the behaviour of the other integer format codes.
-
-- Issue #7033: Function ``PyErr_NewExceptionWithDoc()`` added.
-
-- Issue #7414: 'C' code wasn't being skipped properly (for keyword arguments) in
- PyArg_ParseTupleAndKeywords.
-
-- Issue #7228: Add '%lld' and '%llu' support to PyString_FromFormat(V) and
- PyErr_Format, on machines with HAVE_LONG_LONG defined.
-
-- Issue #6151: Made PyDescr_COMMON conform to standard C (like PyObject_HEAD in
- PEP 3123). The PyDescr_TYPE and PyDescr_NAME macros should be should used for
- accessing the d_type and d_name members of structures using PyDescr_COMMON.
-
-- Issue #6405: Remove duplicate type declarations in descrobject.h.
-
-- The code flags for old __future__ features are now available again.
-
-- Issue #5954: Add a PyFrame_GetLineNumber() function to replace most uses of
- PyCode_Addr2Line().
-
-- Issue #5959: Add a PyCode_NewEmpty() function to create a new empty code
- object at a specified file, function, and line number.
-
-- Issue #1419652: Change the first argument to PyImport_AppendInittab() to
- ``const char *`` as the string is stored beyond the call.
-
-- Issue #2422: When compiled with the ``--with-valgrind`` option, the pymalloc
- allocator will be automatically disabled when running under Valgrind. This
- gives improved memory leak detection when running under Valgrind, while taking
- advantage of pymalloc at other times.
-
-Library
--------
-
-- In pdb, when Ctrl-C is entered while defining commands for a breakpoint, the
- old commands are restored.
-
-- For traceback debugging, the pdb listing now also shows the locations where
- the exception was originally (re)raised, if it differs from the last line
- executed (e.g. in case of finally clauses).
-
-- The pdb command "source" has been added. It displays the source code for a
- given object, if possible.
-
-- The pdb command "longlist" has been added. It displays the whole source code
- for the current function.
-
-- Issue #1503502: Make pdb.Pdb easier to subclass by putting message and error
- output into methods.
-
-- Issue #809887: Make the output of pdb's breakpoint deletions more consistent;
- emit a message when a breakpoint is enabled or disabled.
-
-- Issue #5294: Fix the behavior of pdb's "continue" command when called in the
- top-level debugged frame.
-
-- Issue #5727: Restore the ability to use readline when calling into pdb in
- doctests.
-
-- Issue #6719: In pdb, do not stop somewhere in the encodings machinery if the
- source file to be debugged is in a non-builtin encoding.
-
-- Issue #8048: Prevent doctests from failing when sys.displayhook has been
- reassigned.
-
-- Issue #8015: In pdb, do not crash when an empty line is entered as a
- breakpoint command.
-
-- In pdb, allow giving a line number to the "until" command.
-
-- Issue #1437051: For pdb, allow "continue" and related commands in .pdbrc
- files. Also, add a command-line option "-c" that runs a command as if given
- in .pdbrc.
-
-- Issue #4179: In pdb, allow "list ." as a command to return to the currently
- debugged line.
-
-- Issue #4108: In urllib.robotparser, if there are multiple ``User-agent: *``
- entries, consider the first one.
-
-- Issue #6630: Allow customizing regex flags when subclassing the
- string.Template class.
-
-- Issue #9411: Allow specifying an encoding for config files in the configparser
- module.
-
-- Issue #1682942: Improvements to configparser: support alternate delimiters,
- alternate comment prefixes and empty lines in values.
-
-- Issue #9354: Provide getsockopt() in asyncore's file_wrapper.
-
-- Issue #8966: ctypes: Remove implicit bytes-unicode conversion.
-
-- Issue #9378: python -m pickle <pickle file> will now load and display the
- first object in the pickle file.
-
-- Issue #4770: Restrict binascii module to accept only bytes (as specified).
- And fix the email package to encode to ASCII instead of ``raw-unicode-escape``
- before ASCII-to-binary decoding.
-
-- Issue #9384: ``python -m tkinter`` will now display a simple demo applet.
-
-- The default size of the re module's compiled regular expression cache has been
- increased from 100 to 500 and the cache replacement policy has changed from
- simply clearing the entire cache on overflow to forgetting the least recently
- used cached compiled regular expressions. This is a performance win for
- applications that use a lot of regular expressions and limits the impact of
- the performance hit anytime the cache is exceeded.
-
-- Issue #7113: Speed up loading in configparser. Patch by Łukasz Langa.
-
-- Issue #9032: XML-RPC client retries the request on EPIPE error. The EPIPE
- error occurs when the server closes the socket and the client sends a big
- XML-RPC request.
-
-- Issue #4629: getopt raises an error if an argument ends with "=", whereas
- getopt doesn't accept a value (eg. --help= is rejected if getopt uses
- ['help='] long options).
-
-- Issue #7989: Added pure python implementation of the `datetime` module. The C
- module is renamed to `_datetime` and if available, overrides all classes
- defined in datetime with fast C impementation. Python implementation is based
- on the original python prototype for the datetime module by Tim Peters with
- minor modifications by the PyPy project. The test suite now tests `datetime`
- module with and without `_datetime` acceleration using the same test cases.
-
-- Issue #7895: platform.mac_ver() no longer crashes after calling os.fork().
-
-- Issue #9323: Fixed a bug in trace.py that resulted in loosing the name of the
- script being traced. Patch by Eli Bendersky.
-
-- Issue #9282: Fixed --listfuncs option of trace.py. Thanks Eli Bendersky for
- the patch.
-
-- Issue #3704: http.cookiejar was not properly handling URLs with a / in the
- parameters.
-
-- Issue #9268: ``pickletools.dis()`` now has an optional *annotate* argument
- which controls printing of opcode descriptions in ``dis()`` output.
-
-- Issue #1555570: email no longer inserts extra blank lines when a \r\n combo
- crosses an 8192 byte boundary.
-
-- Issue #9243: Fix sndhdr module and add unit tests, contributed by James Lee.
-
-- ``ast.literal_eval()`` now allows byte literals.
-
-- Issue #9137: Fix issue in MutableMapping.update, which incorrectly treated
- keyword arguments called 'self' or 'other' specially.
-
-- ``ast.literal_eval()`` now allows set literals.
-
-- Issue #9164: Ensure that sysconfig handles duplicate -arch flags in CFLAGS.
-
-- Issue #7646: The fnmatch pattern cache no longer grows without bound.
-
-- Issue #9136: Fix 'dictionary changed size during iteration' RuntimeError
- produced when profiling the decimal module. This was due to a dangerous
- iteration over 'locals()' in Context.__init__.
-
-- Fix extreme speed issue in Decimal.pow when the base is an exact power of 10
- and the exponent is tiny (for example, ``Decimal(10) **
- Decimal('1e-999999999')``).
-
-- Issue #9186: Fix math.log1p(-1.0) to raise ValueError, not OverflowError.
-
-- Issue #9130: Fix validation of relative imports in parser module.
-
-- Issue #9128: Fix validation of class decorators in parser module.
-
-- Issue #9094: python -m pickletools will now disassemble pickle files listed in
- the command line arguments. See output of python -m pickletools -h for more
- details.
-
-- Issue #5468: urlencode to handle bytes type and other encodings in its query
- parameter. Patch by Dan Mahn.
-
-- Issue #7673: Fix security vulnerability (CVE-2010-2089) in the audioop module,
- ensure that the input string length is a multiple of the frame size.
-
-- Issue #6507: Accept source strings in dis.dis(). Original patch by Daniel
- Urban.
-
-- Issue #7829: Clearly document that the dis module is exposing an
- implementation detail that is not stable between Python VMs or releases.
-
-- Issue #6589: cleanup asyncore.socket_map in case smtpd.SMTPServer constructor
- raises an exception.
-
-- Issue #9110: Addition of ContextDecorator to contextlib, for creating APIs
- that act as both context managers and decorators. contextmanager changes to
- use ContextDecorator.
-
-- Implement importlib.abc.SourceLoader and deprecate PyLoader and PyPycLoader
- for removal in Python 3.4.
-
-- Issue #9064: pdb's "up" and "down" commands now accept an optional argument
- giving the number of frames to go.
-
-- Issue #9018: os.path.normcase() now raises a TypeError if the argument is not
- ``str`` or ``bytes``.
-
-- Issue #9075: In the ssl module, remove the setting of a ``debug`` flag on an
- OpenSSL structure.
-
-- Issue #8682: The ssl module now temporary increments the reference count of a
- socket object got through ``PyWeakref_GetObject``, so as to avoid possible
- deallocation while the object is still being used.
-
-- Issue #1368368: FancyURLOpener class changed to throw an Exception on wrong
- password instead of presenting an interactive prompt. Older behavior can be
- obtained by passing retry=True to http_error_xxx methods of FancyURLOpener.
-
-- Issue #8720: Fix regression caused by fix for #4050 by making getsourcefile
- smart enough to find source files in the linecache.
-
-- Issue #5610: feedparser no longer eats extra characters at the end of a body
- part if the body part ends with a ``\r\n``.
-
-- Issue #8986: math.erfc was incorrectly raising OverflowError for values
- between -27.3 and -30.0 on some platforms.
-
-- Issue #8784: Set tarfile default encoding to 'utf-8' on Windows.
-
-- Issue #8966: If a ctypes structure field is an array of c_char, convert its
- value to bytes instead of str (as done for c_char and c_char_p).
-
-- Issue #8188: Comparisons between Decimal and Fraction objects are now
- permitted, returning a result based on the exact numerical values of the
- operands. This builds on issue #2531, which allowed Decimal-to-float
- comparisons; all comparisons involving numeric types (bool, int, float,
- complex, Decimal, Fraction) should now act as expected.
-
-- Issue #8897: Fix sunau module, use bytes to write the header. Patch written by
- Thomas Jollans.
-
-- Issue #8899: time.struct_time now has class and attribute docstrings.
-
-- Issue #6470: Drop UNC prefix in FixTk.
-
-- Issue #4768: base64 encoded email body parts were incorrectly stored as binary
- strings. They are now correctly converted to strings.
-
-- Issue #8833: tarfile created hard link entries with a size field != 0 by
- mistake.
-
-- Charset.body_encode now correctly handles base64 encoding by encoding with the
- output_charset before calling base64mime.encode. Passes the tests from 2.x
- issue #1368247.
-
-- Issue #8845: sqlite3 Connection objects now have a read-only in_transaction
- attribute that is True iff there are uncommitted changes.
-
-- Issue #1289118: datetime.timedelta objects can now be multiplied by float and
- divided by float and int objects. Results are rounded to the nearest multiple
- of timedelta.resolution with ties resolved using round-half-to-even method.
-
-- Issue #7150: Raise OverflowError if the result of adding or subtracting
- timedelta from date or datetime falls outside of the MINYEAR:MAXYEAR range.
-
-- Issue #8806: add SSL contexts support to ftplib.
-
-- Issue #4769: Fix main() function of the base64 module, use sys.stdin.buffer
- and sys.stdout.buffer (instead of sys.stdin and sys.stdout) to use the bytes
- API.
-
-- Issue #8770: Now sysconfig displays information when it's called as a script.
- Initial idea by Sridhar Ratnakumar.
-
-- Issue #6662: Fix parsing of malformatted charref (&#bad;), patch written by
- Fredrik Håård.
-
-- Issue #8540: Decimal module: rename the Context._clamp attribute to
- Context.clamp and make it public. This is useful in creating contexts that
- correspond to the decimal interchange formats specified in IEEE 754.
-
-- Issue #6268: Fix seek() method of codecs.open(), don't read or write the BOM
- twice after seek(0). Fix also reset() method of codecs, UTF-16, UTF-32 and
- StreamWriter classes.
-
-- Issue #3798: sys.exit(message) writes the message to sys.stderr file, instead
- of the C file stderr, to use stderr encoding and error handler.
-
-- Issue #8782: Add a trailing newline in linecache.updatecache to the last line
- of files without one.
-
-- Issue #8729: Return NotImplemented from collections.Mapping.__eq__ when
- comparing to a non-mapping.
-
-- Issue #8774: tabnanny uses the encoding cookie (#coding:...) to use the
- correct encoding.
-
-- Issue #4870: Add an `options` attribute to SSL contexts, as well as several
- ``OP_*`` constants to the `ssl` module. This allows to selectively disable
- protocol versions, when used in combination with `PROTOCOL_SSLv23`.
-
-- Issue #8759: Fixed user paths in sysconfig for posix and os2 schemes.
-
-- Issue #8663: distutils.log emulates backslashreplace error handler. Fix
- compilation in a non-ASCII directory if stdout encoding is ASCII (eg. if
- stdout is not a TTY).
-
-- Issue #8513: os.get_exec_path() supports b'PATH' key and bytes value.
- subprocess.Popen() and os._execvpe() support bytes program name. Add
- os.supports_bytes_environ flag: True if the native OS type of the environment
- is bytes (eg. False on Windows).
-
-- Issue #8633: tarfile is now able to read and write archives with "raw" binary
- pax headers as described in POSIX.1-2008.
-
-- Issue #1285086: Speed up urllib.parse functions: quote, quote_from_bytes,
- unquote, unquote_to_bytes.
-
-- Issue #8688: Distutils now recalculates MANIFEST everytime.
-
-- Issue #8477: ssl.RAND_egd() and ssl._test_decode_cert() support str with
- surrogates and bytes for the filename.
-
-- Issue #8550: Add first class ``SSLContext`` objects to the ssl module.
-
-- Issue #8681: Make the zlib module's error messages more informative when the
- zlib itself doesn't give any detailed explanation.
-
-- The audioop module now supports sound fragments of length greater than 2**31
- bytes on 64-bit machines, and is PY_SSIZE_T_CLEAN.
-
-- Issue #4972: Add support for the context manager protocol to the ftplib.FTP
- class.
-
-- Issue #8664: In py_compile, create __pycache__ when the compiled path is
- given.
-
-- Issue #8514: Add os.fsencode() function (Unix only): encode a string to bytes
- for use in the file system, environment variables or the command line.
-
-- Issue #8571: Fix an internal error when compressing or decompressing a chunk
- larger than 1GB with the zlib module's compressor and decompressor objects.
-
-- Issue #8603: Support bytes environmental variables on Unix: Add os.environb
- mapping and os.getenvb() function. os.unsetenv() encodes str argument to the
- file system encoding with the surrogateescape error handler (instead of
- utf8/strict) and accepts bytes. posix.environ keys and values are now bytes.
-
-- Issue #8573: asyncore _strerror() function might throw ValueError.
-
-- Issue #8483: asyncore.dispatcher's __getattr__ method produced confusing error
- messages when accessing undefined class attributes because of the cheap
- inheritance with the underlying socket object. The cheap inheritance has been
- deprecated.
-
-- Issue #4265: shutil.copyfile() was leaking file descriptors when disk fills.
- Patch by Tres Seaver.
-
-- Issue #8390: tarfile uses surrogateescape as the default error handler
- (instead of replace in read mode or strict in write mode).
-
-- Issue #7755: Use an unencumbered audio file for tests.
-
-- Issue #8621: uuid.uuid4() returned the same sequence of values in the parent
- and any children created using ``os.fork`` on MacOS X 10.6.
-
-- Issue #8567: Fix precedence of signals in Decimal module: when a Decimal
- operation raises multiple signals and more than one of those signals is
- trapped, the specification determines the order in which the signals should be
- handled. In many cases this order wasn't being followed, leading to the wrong
- Python exception being raised.
-
-- Issue #7865: The close() method of ``io`` objects should not swallow
- exceptions raised by the implicit flush(). Also qensure that calling close()
- several times is supported. Patch by Pascal Chambon.
-
-- Issue #4687: Fix accuracy of garbage collection runtimes displayed with
- gc.DEBUG_STATS.
-
-- Issue #8354: The siginterrupt setting is now preserved for all signals, not
- just SIGCHLD.
-
-- Issue #7192: webbrowser.get("firefox") now works on Mac OS X, as does
- webbrowser.get("safari").
-
-- Issue #8464: tarfile no longer creates files with execute permissions set when
- mode="w|" is used.
-
-- Issue #7834: Fix connect() of Bluetooth L2CAP sockets with recent versions of
- the Linux kernel. Patch by Yaniv Aknin.
-
-- Issue #8295: Added shutil.unpack_archive.
-
-- Issue #6312: Fixed http HEAD request when the transfer encoding is chunked.
- It should correctly return an empty response now.
-
-- Issue #8546: Reject None given as the buffering argument to _pyio.open.
-
-- Issue #8549: Fix compiling the _ssl extension under AIX. Patch by
- Sridhar Ratnakumar.
-
-- Issue #6656: fix locale.format_string to handle escaped percents
- and mappings.
-
-- Issue #2302: Fix a race condition in SocketServer.BaseServer.shutdown, where
- the method could block indefinitely if called just before the event loop
- started running. This also fixes the occasional freezes witnessed in
- test_httpservers.
-
-- Issue #8524: When creating an SSL socket, the timeout value of the original
- socket wasn't retained (instead, a socket with a positive timeout would be
- turned into a non-blocking SSL socket).
-
-- Issue #5103: SSL handshake would ignore the socket timeout and block
- indefinitely if the other end didn't respond.
-
-- The do_handshake() method of SSL objects now adjusts the blocking mode of the
- SSL structure if necessary (as other methods already do).
-
-- Issue #8391: os.execvpe() and os.getenv() supports unicode with surrogates and
- bytes strings for environment keys and values.
-
-- Issue #8467: Pure Python implementation of subprocess encodes the error
- message using surrogatepass error handler to support surrogates in the
- message.
-
-- Issue #8468: bz2.BZ2File() accepts str with surrogates and bytes filenames.
-
-- Issue #8451: Syslog module now uses basename(sys.argv[0]) instead of the
- string "python" as the *ident*. openlog() arguments are all optional and
- keywords.
-
-- Issue #8108: Fix the unwrap() method of SSL objects when the socket has a
- non-infinite timeout. Also make that method friendlier with applications
- wanting to continue using the socket in clear-text mode, by disabling
- OpenSSL's internal readahead. Thanks to Darryl Miles for guidance.
-
-- Issue #8496: make mailcap.lookup() always return a list, rather than an
- iterator. Patch by Gregory Nofi.
-
-- Issue #8195: Fix a crash in sqlite Connection.create_collation() if the
- collation name contains a surrogate character.
-
-- Issue #8484: Load all ciphers and digest algorithms when initializing the _ssl
- extension, such that verification of some SSL certificates doesn't fail
- because of an "unknown algorithm".
-
-- Issue #6547: Added the ignore_dangling_symlinks option to shutil.copytree.
-
-- Issue #1540112: Now allowing the choice of a copy function in shutil.copytree.
-
-- Issue #4814: timeout parameter is now applied also for connections resulting
- from PORT/EPRT commands.
-
-- Issue #8463: added missing reference to bztar in shutil's documentation.
-
-- Issue #7154: urllib.request can now detect the proxy settings on OSX 10.6 (as
- long as the user didn't specify 'automatic proxy configuration').
-
-- Issue #3817: ftplib.FTP.abort() method now considers 225 a valid response code
- as stated in RFC-959 at chapter 5.4.
-
-- Issue #8394: _ctypes.dlopen() accepts bytes, bytearray and str with
- surrogates.
-
-- Issue #850728: Add a *timeout* parameter to the `acquire()` method of
- `threading.Semaphore` objects. Original patch by Torsten Landschoff.
-
-- Issue #8322: Add a *ciphers* argument to SSL sockets, so as to change the
- available cipher list. Helps fix test_ssl with OpenSSL 1.0.0.
-
-- Issue #8393: subprocess accepts bytes, bytearray and str with surrogates for
- the current working directory.
-
-- Issue #7606: XML-RPC traceback stored in X-traceback is now encoded to ASCII
- using backslashreplace error handler.
-
-- Issue #8412: os.system() now accepts bytes, bytearray and str with surrogates.
-
-- Issue #2987: RFC2732 support for urlparse (IPv6 addresses). Patch by Tony
- Locke and Hans Ulrich Niedermann.
-
-- Issue #5277: Fix quote counting when parsing RFC 2231 encoded parameters.
-
-- Issue #7316: The acquire() method of lock objects in the ``threading``
- module now takes an optional timeout argument in seconds. Timeout support
- relies on the system threading library, so as to avoid a semi-busy wait loop.
-
-- Issue #8383: pickle and pickletools use surrogatepass error handler when
- encoding unicode as utf8 to support lone surrogates and stay compatible with
- Python 2.x and 3.x.
-
-- Issue #7585: difflib context and unified diffs now place a tab between
- filename and date, conforming to the 'standards' they were originally designed
- to follow. This improves compatibility with patch tools.
-
-- Issue #7472: Fixed typo in email.encoders module; messages using ISO-2022
- character sets will now consistently use a Content-Transfer-Encoding of 7bit
- rather than sometimes being marked as 8bit.
-
-- Issue #8375: test_distutils now checks if the temporary directory are still
- present before it cleans them.
-
-- Issue #8374: Update the internal alias table in the ``locale`` module to
- cover recent locale changes and additions.
-
-- Issue #8321: Give access to OpenSSL version numbers from the `ssl` module,
- using the new attributes `ssl.OPENSSL_VERSION`, `ssl.OPENSSL_VERSION_INFO` and
- `ssl.OPENSSL_VERSION_NUMBER`.
-
-- Add functools.total_ordering() and functools.cmp_to_key().
-
-- Issue #8257: The Decimal construct now accepts a float instance directly,
- converting that float to a Decimal of equal value:
-
- >>> Decimal(1.1)
- Decimal('1.100000000000000088817841970012523233890533447265625')
-
-- Issue #8294: The Fraction constructor now accepts Decimal and float instances
- directly.
-
-- Issue #7279: Comparisons involving a Decimal signaling NaN now signal
- InvalidOperation instead of returning False. (Comparisons involving a quiet
- NaN are unchanged.) Also, Decimal quiet NaNs are now hashable; Decimal
- signaling NaNs remain unhashable.
-
-- Issue #2531: Comparison operations between floats and Decimal instances now
- return a result based on the numeric values of the operands; previously they
- returned an arbitrary result based on the relative ordering of id(float) and
- id(Decimal). See also issue #8188, which adds Decimal-to-Fraction
- comparisons.
-
-- Added a subtract() method to collections.Counter().
-
-- Issue #8233: When run as a script, py_compile.py optionally takes a single
- argument `-` which tells it to read files to compile from stdin. Each line is
- read on demand and the named file is compiled immediately. (Original patch by
- Piotr Ożarowski).
-
-- Backwards incompatible change: Unicode codepoints line tabulation (0x0B) and
- form feed (0x0C) are now considered linebreaks, as specified in Unicode
- Standard Annex #14. See issue #7643. http://www.unicode.org/reports/tr14/
-
-- Comparisons using one of <, <=, >, >= between a complex instance and a
- Fractions instance now raise TypeError instead of returning True/False. This
- makes Fraction <=> complex comparisons consistent with int <=> complex, float
- <=> complex, and complex <=> complex comparisons.
-
-- Issue #8139: ossaudiodev didn't initialize its types properly, therefore some
- methods (such as oss_mixer_device.fileno()) were not available. Initial patch
- by Bertrand Janin.
-
-- Issue #8205: Remove the "Modules" directory from sys.path when Python is
- running from the build directory (POSIX only).
-
-- Issue #7512: shutil.copystat() could raise an OSError when the filesystem
- didn't support chflags() (for example ZFS under FreeBSD). The error is now
- silenced.
-
-- Issue #7860: platform.uname now reports the correct 'machine' type when Python
- is running in WOW64 mode on 64 bit Windows.
-
-- Issue #3890, #8222: Fix recv() and recv_into() on non-blocking SSL sockets.
- Also, enable the SSL_MODE_AUTO_RETRY flag on SSL sockets, so that blocking
- reads and writes are always retried by OpenSSL itself.
-
-- Issue #4282: Fix the main function of the profile module for a non-ASCII
- script, open the file in binary mode and not in text mode with the default
- (utf8) encoding.
-
-- Issue #8179: Fix macpath.realpath() on a non-existing path.
-
-- Issue #8024: Update the Unicode database to 5.2.
-
-- Issue #8168: py_compile now handles files with utf-8 BOMS.
-
-- ``tokenize.detect_encoding`` now returns ``'utf-8-sig'`` when a UTF-8 BOM is
- detected.
-
-- Issue #6716/2: Backslash-replace error output in compilall.
-
-- Issue #4961: Inconsistent/wrong result of askyesno function in tkMessageBox
- with Tcl/Tk-8.5.
-
-- Issue #8140: extend compileall to compile single files. Add -i option.
-
-- Issue #7356: ctypes.util: Make parsing of ldconfig output independent of the
- locale.
-
-- The internals of the subprocess module on POSIX systems have been replaced by
- an extension module (_posixsubprocess) so that the fork()+exec() can be done
- safely without the possibility of deadlock in multithreaded applications.
-
-- subprocess.Popen now has restore_signals and start_new_session features. The
- default of restore_signals=True is a new behavior compared to earlier Python
- versions. This means that signals such as SIGPIPE are not ignored by default
- in subprocesses launched by Python (Issue #1652).
-
-- Issue #6472: The xml.etree package is updated to ElementTree 1.3. The
- cElementTree module is updated too.
-
-- Issue #7774: Set sys.executable to an empty string if argv[0] has been set to
- an non existent program name and Python is unable to retrieve the real program
- name.
-
-- Issue #7880: Fix sysconfig when the python executable is a symbolic link.
-
-- Issue #6509: fix re.sub to work properly when the pattern, the string, and the
- replacement were all bytes. Patch by Antoine Pitrou.
-
-- The sqlite3 module was updated to pysqlite 2.6.0. This fixes several obscure
- bugs and allows loading SQLite extensions from shared libraries.
-
-- Issue #1054943: Fix ``unicodedata.normalize('NFC', text)`` for the Public
- Review Issue #29 (http://unicode.org/review/pr-29.html).
-
-- Issue #7494: fix a crash in _lsprof (cProfile) after clearing the profiler,
- reset also the pointer to the current pointer context.
-
-- Issue #7232: Add support for the context manager protocol to the TarFile
- class.
-
-- Issue #7250: Fix info leak of os.environ across multi-run uses of
- wsgiref.handlers.CGIHandler.
-
-- Issue #1729305: Fix doctest to handle encode error with "backslashreplace".
-
-- Issue #691291: codecs.open() should not convert end of lines on reading and
- writing.
-
-- Issue #7869: logging: improved diagnostic for format-time errors.
-
-- Issue #7868: logging: added loggerClass attribute to Manager.
-
-- logging: Implemented PEP 391.
-
-- Issue #1537721: Add a writeheader() method to csv.DictWriter.
-
-- Issue #7959: ctypes callback functions are now registered correctly with the
- cycle garbage collector.
-
-- Issue #5801: removed spurious empty lines in wsgiref.
-
-- Issue #6666: fix bug in trace.py that applied the list of directories to be
- ignored only to the first file. Noted by Bogdan Opanchuk.
-
-- Issue #7597: curses.use_env() can now be called before initscr(). Noted by
- Kan-Ru Chen.
-
-- Issue #7310: fix the __repr__ of os.environ to show the environment variables.
-
-- Issue #7970: email.Generator.flatten now correctly flattens message/rfc822
- messages parsed by email.Parser.HeaderParser.
-
-- Issue #7361: Importlib was not properly checking the number of bytes in
- bytecode file when it was less then 8 bytes.
-
-- Issue #7633: In the decimal module, Context class methods (with the exception
- of canonical and is_canonical) now accept instances of int and long wherever a
- Decimal instance is accepted, and implicitly convert that argument to Decimal.
- Previously only some arguments were converted.
-
-- Issue #7835: shelve should no longer produce mysterious warnings during
- interpreter shutdown.
-
-- Issue #2746: Don't escape ampersands and angle brackets ("&", "<", ">") in XML
- processing instructions and comments. These raw characters are allowed by the
- XML specification, and are necessary when outputting e.g. PHP code in a
- processing instruction. Patch by Neil Muller.
-
-- Issue #6233: ElementTree failed converting unicode characters to XML entities
- when they could't be represented in the requested output encoding. Patch by
- Jerry Chen.
-
-- Issue #6003: add an argument to ``zipfile.Zipfile.writestr`` to specify the
- compression type.
-
-- Issue #4772: Raise a ValueError when an unknown Bluetooth protocol is
- specified, rather than fall through to AF_PACKET (in the `socket` module).
- Also, raise ValueError rather than TypeError when an unknown TIPC address type
- is specified. Patch by Brian Curtin.
-
-- Issue #6939: Fix file I/O objects in the `io` module to keep the original file
- position when calling `truncate()`. It would previously change the file
- position to the given argument, which goes against the tradition of
- ftruncate() and other truncation APIs. Patch by Pascal Chambon.
-
-- Issue #7610: Reworked implementation of the internal
- ``zipfile.ZipExtFile`` class used to represent files stored inside an
- archive. The new implementation is significantly faster and can be wrapped in
- a ``io.BufferedReader`` object for more speedups. It also solves an
- issue where interleaved calls to `read()` and `readline()` give wrong results.
- Patch by Nir Aides.
-
-- Issue #6963: Added "maxtasksperchild" argument to multiprocessing.Pool,
- allowing for a maximum number of tasks within the pool to be completed by the
- worker before that worker is terminated, and a new one created to replace it.
-
-- Issue #7792: Registering non-classes to ABCs raised an obscure error.
-
-- Issue #7785: Don't accept bytes in FileIO.write().
-
-- Removed the functions 'verify' and 'vereq' from Lib/test/support.py.
-
-- Issue #7773: Fix an UnboundLocalError in platform.linux_distribution() when
- the release file is empty.
-
-- Issue #7561: Fix crashes when using bytearray objects with the posix
- module.
-
-- Issue #1670765: Prevent email.generator.Generator from re-wrapping headers in
- multipart/signed MIME parts, which fixes one of the sources of invalid
- modifications to such parts by Generator.
-
-- Issue #7703: Add support for the new buffer API to `binascii.a2bhqx`. Patch
- by Florent Xicluna, along with some additional tests.
-
-- Issue #7701: Fix crash in binascii.b2a_uu() in debug mode when given a 1-byte
- argument. Patch by Victor Stinner.
-
-- Issue #3299: Fix possible crash in the _sre module when given bad argument
- values in debug mode. Patch by Victor Stinner.
-
-- Issue #2846: Add support for gzip.GzipFile reading zero-padded files. Patch
- by Brian Curtin.
-
-- Issue #7681: Use floor division in appropiate places in the wave module.
-
-- Issue #5372: Drop the reuse of .o files in Distutils' ccompiler (since
- Extension extra options may change the output without changing the .c
- file). Initial patch by Collin Winter.
-
-- Issue #7617: Make sure distutils.unixccompiler.UnixCCompiler recognizes gcc
- when it has a fully qualified configuration prefix. Initial patch by Arfrever.
-
-- Issue #7105: Make WeakKeyDictionary and WeakValueDictionary robust against the
- destruction of weakref'ed objects while iterating.
-
-- Issue #7455: Fix possible crash in cPickle on invalid input. Patch by Victor
- Stinner.
-
-- Issue #1628205: Socket file objects returned by socket.socket.makefile() now
- properly handles EINTR within the read, readline, write & flush methods. The
- socket.sendall() method now properly handles interrupted system calls.
-
-- Issue #7471: Improve the performance of GzipFile's buffering mechanism, and
- make it implement the `io.BufferedIOBase` ABC to allow for further speedups by
- wrapping it in an `io.BufferedReader`. Patch by Nir Aides.
-
-- Issue #3972: http.client.HTTPConnection now accepts an optional source_address
- parameter to allow specifying where your connections come from.
-
-- socket.create_connection now accepts an optional source_address parameter.
-
-- Issue #5511: now zipfile.ZipFile can be used as a context manager. Initial
- patch by Brian Curtin.
-
-- Issue #7556: Make sure Distutils' msvc9compile reads and writes the MSVC XML
- Manifest file in text mode so string patterns can be used in regular
- expressions.
-
-- Issue #7552: Removed line feed in the base64 Authorization header in the
- Distutils upload command to avoid an error when PyPI reads it. This occurs on
- long passwords. Initial patch by JP St. Pierre.
-
-- Issue #7231: urllib2 cannot handle https with proxy requiring auth. Patch by
- Tatsuhiro Tsujikawa.
-
-- Issue #4757: `zlib.compress` and other methods in the zlib module now raise a
- TypeError when given an `str` object (rather than a `bytes`-like object).
- Patch by Victor Stinner and Florent Xicluna.
-
-- Issue #7349: Make methods of file objects in the io module accept None as an
- argument where file-like objects (ie StringIO and BytesIO) accept them to mean
- the same as passing no argument.
-
-- Issue #7357: tarfile no longer suppresses fatal extraction errors by default.
-
-- Issue #5949: added check for correct lineends in input from IMAP server in
- imaplib.
-
-- Add count() and reverse() methods to collections.deque().
-
-- Fix variations of extending deques: d.extend(d) d.extendleft(d) d+=d
-
-- Issue #6986: Fix crash in the JSON C accelerator when called with the wrong
- parameter types. Patch by Victor Stinner.
-
-- Issue #7457: added a read_pkg_file method to
- distutils.dist.DistributionMetadata.
-
-- logging: Added optional `secure` parameter to SMTPHandler, to enable use of
- TLS with authentication credentials.
-
-- Issue #1923: Fixed the removal of meaningful spaces when PKG-INFO is generated
- in Distutils. Patch by Stephen Emslie.
-
-- Issue #4120: Drop reference to CRT from manifest when building extensions with
- msvc9compiler.
-
-- Issue #7333: The `posix` module gains an `initgroups()` function providing
- access to the initgroups(3) C library call on Unix systems which implement it.
- Patch by Jean-Paul Calderone.
-
-- Issue #7408: Fixed distutils.tests.sdist so it doesn't check for group
- ownership when the group is not forced, because the group may be different
- from the user's group and inherit from its container when the test is run.
-
-- Issue #4486: When an exception has an explicit cause, do not print its
- implicit context too. This affects the `traceback` module as well as built-in
- exception printing.
-
-- Issue #1515: Enable use of deepcopy() with instance methods. Patch by Robert
- Collins.
-
-- Issue #7403: logging: Fixed possible race condition in lock creation.
-
-- Issue #6845: Add restart support for binary upload in ftplib. The
- `storbinary()` method of FTP and FTP_TLS objects gains an optional `rest`
- argument. Patch by Pablo Mouzo.
-
-- Issue #5788: `datetime.timedelta` objects get a new `total_seconds()` method
- returning the total number of seconds in the duration. Patch by Brian
- Quinlan.
-
-- Issue #7133: SSL objects now support the new buffer API.
-
-- Issue #1488943: difflib.Differ() doesn't always add hints for tab characters.
-
-- Issue #6123: tarfile now opens empty archives correctly and consistently
- raises ReadError on empty files.
-
-- Issue #7354: distutils.tests.test_msvc9compiler - dragfullwindows can be 2.
-
-- Issue #5037: Proxy the __bytes__ special method instead to __bytes__ instead
- of __str__.
-
-- Issue #7341: Close the internal file object in the TarFile constructor in case
- of an error.
-
-- Issue #7293: distutils.test_msvc9compiler is fixed to work on any fresh
- Windows box. Help provided by David Bolen.
-
-- Issue #2054: ftplib now provides an FTP_TLS class to do secure FTP using TLS
- or SSL. Patch by Giampaolo Rodola'.
-
-- Issue #7328: pydoc no longer corrupts sys.path when run with the '-m' switch.
-
-- Issue #4969: The mimetypes module now reads the MIME database from the
- registry under Windows. Patch by Gabriel Genellina.
-
-- Issue #6816: runpy now provides a run_path function that allows Python code to
- execute file paths that refer to source or compiled Python files as well as
- zipfiles, directories and other valid sys.path entries that contain a
- __main__.py file. This allows applications that run other Python scripts to
- support the same flexibility as the CPython command line itself.
-
-- Issue #7318: multiprocessing now uses a timeout when it fails to establish a
- connection with another process, rather than looping endlessly. The default
- timeout is 20 seconds, which should be amply sufficient for local connections.
-
-- Issue #7197: Allow unittest.TextTestRunner objects to be pickled and
- unpickled. This fixes crashes under Windows when trying to run
- test_multiprocessing in verbose mode.
-
-- Issue #7893: ``unittest.TextTestResult`` is made public and a ``resultclass``
- argument added to the TextTestRunner constructor allowing a different result
- class to be used without having to subclass.
-
-- Issue #7588: ``unittest.TextTestResult.getDescription`` now includes the test
- name in failure reports even if the test has a docstring.
-
-- Issue #3001: Add a C implementation of recursive locks which is used by
- default when instantiating a `threading.RLock` object. This makes recursive
- locks as fast as regular non-recursive locks (previously, they were slower by
- 10x to 15x).
-
-- Issue #7282: Fix a memory leak when an RLock was used in a thread other than
- those started through `threading.Thread` (for example, using
- `_thread.start_new_thread()`).
-
-- Issue #7187: Importlib would not silence the IOError raised when trying to
- write new bytecode when it was made read-only.
-
-- Issue #7264: Fix a possible deadlock when deallocating thread-local objects
- which are part of a reference cycle.
-
-- Issue #7211: Allow 64-bit values for the `ident` and `data` fields of kevent
- objects on 64-bit systems. Patch by Michael Broghton.
-
-- Issue #6896: mailbox.Maildir now invalidates its internal cache each time a
- modification is done through it. This fixes inconsistencies and test failures
- on systems with slightly bogus mtime behaviour.
-
-- Issue #7246 & Issue #7208: getpass now properly flushes input before reading
- from stdin so that existing input does not confuse it and lead to incorrect
- entry or an IOError. It also properly flushes it afterwards to avoid the
- terminal echoing the input afterwards on OSes such as Solaris.
-
-- Issue #7233: Fix a number of two-argument Decimal methods to make sure that
- they accept an int or long as the second argument. Also fix buggy handling of
- large arguments (those with coefficient longer than the current precision) in
- shift and rotate.
-
-- Issue #4750: Store the basename of the original filename in the gzip FNAME
- header as required by RFC 1952.
-
-- Issue #1180: Added a new global option to ignore ~/.pydistutils.cfg in
- Distutils.
-
-- Issue #7218: Fix test_site for win32, the directory comparison was done with
- an uppercase.
-
-- Issue #7205: Fix a possible deadlock when using a BZ2File object from
- several threads at once.
-
-- Issue #7077: logging: SysLogHandler now treats Unicode as per RFC 5424.
-
-- Issue #7099: Decimal.is_normal now returns True for numbers with exponent
- larger than emax.
-
-- Issue #7080: locale.strxfrm() raises a MemoryError on 64-bit non-Windows
- platforms, and assorted locale fixes by Derk Drukker.
-
-- Issue #5833: Fix extra space character in readline completion with the GNU
- readline library version 6.0.
-
-- Issue #6894: Fixed the issue urllib2 doesn't respect "no_proxy" environment.
-
-- Issue #7086: Added TCP support to SysLogHandler, and tidied up some
- anachronisms in the code which were a relic of 1.5.2 compatibility.
-
-- Issue #7082: When falling back to the MIME 'name' parameter, the correct place
- to look for it is the Content-Type header.
-
-- Make tokenize.detect_coding() normalize utf-8 and iso-8859-1 variants like the
- builtin tokenizer.
-
-- Issue #7048: Force Decimal.logb to round its result when that result is too
- large to fit in the current precision.
-
-- Issue #6236, #6348: Fix various failures in the I/O library under AIX and
- other platforms, when using a non-gcc compiler. Patch by Derk Drukker.
-
-- Issue #4606: Passing 'None' if ctypes argtype is set to POINTER(...) does now
- always result in NULL.
-
-- Issue #5042: Structure sub-subclass does now initialize correctly with base
- class positional arguments.
-
-- Issue #6882: Import uuid creates zombies processes.
-
-- Issue #6635: Fix profiler printing usage message.
-
-- Issue #6856: Add a filter keyword argument to TarFile.add().
-
-- Issue #6888: pdb's alias command was broken when no arguments were given.
-
-- Issue #6857: Default format() alignment should be '>' for Decimal instances.
-
-- Issue #6795: int(Decimal('nan')) now raises ValueError instead of returning
- NaN or raising InvalidContext. Also, fix infinite recursion in
- long(Decimal('nan')).
-
-- Issue #6850: Fix bug in Decimal._parse_format_specifier for formats with no
- type specifier.
-
-- Issue #6239: ctypes.c_char_p return value must return bytes.
-
-- Issue #6838: Use a list to accumulate the value instead of repeatedly
- concatenating strings in http.client's HTTPResponse._read_chunked providing a
- significant speed increase when downloading large files servend with a
- Transfer-Encoding of 'chunked'.
-
-- Trying to import a submodule from a module that is not a package, ImportError
- should be raised, not AttributeError.
-
-- When the globals past to importlib.__import__() has __package__ set to None,
- fall back to computing what __package__ should be instead of giving up.
-
-- Raise a TypeError when the name of a module to be imported for
- importlib.__import__ is not a string (was raising an AttributeError before).
-
-- Allow the fromlist passed into importlib.__import__ to be any iterable.
-
-- Have importlib raise ImportError if None is found in sys.modules.
-
-- Issue #6054: Do not normalize stored pathnames in tarfile.
-
-- Issue #6794: Fix Decimal.compare_total and Decimal.compare_total_mag: NaN
- payloads are now ordered by integer value rather than lexicographically.
-
-- Issue #1356969: Add missing info methods in tix.HList.
-
-- Issue #1522587: New constants and methods for the tix.Grid widget.
-
-- Issue #1250469: Fix the return value of tix.PanedWindow.panes.
-
-- Issue #1119673: Do not override tkinter.Text methods when creating a
- ScrolledText.
-
-- Issue #6665: Fix fnmatch to properly match filenames with newlines in them.
-
-- Issue #1135: Add the XView and YView mix-ins to avoid duplicating the xview*
- and yview* methods.
-
-- Issue #6629: Fix a data corruption issue in the new I/O library, which could
- occur when writing to a BufferedRandom object (e.g. a file opened in "rb+" or
- "wb+" mode) after having buffered a certain amount of data for reading. This
- bug was not present in the pure Python implementation.
-
-- Issue #6622: Fix "local variable 'secret' referenced before assignment" bug in
- POP3.apop.
-
-- Issue #2715: Remove remnants of Carbon.File from binhex module.
-
-- Issue #6595: The Decimal constructor now allows arbitrary Unicode decimal
- digits in input, as recommended by the standard. Previously it was restricted
- to accepting [0-9].
-
-- Issue #6106: telnetlib.Telnet.process_rawq doesn't handle default WILL/WONT
- DO/DONT correctly.
-
-- Issue #1424152: Fix for http.client, urllib.request to support SSL while
- working through proxy. Original patch by Christopher Li, changes made by
- Senthil Kumaran.
-
-- Add importlib.abc.ExecutionLoader to represent the PEP 302 protocol for
- loaders that allow for modules to be executed. Both importlib.abc.PyLoader and
- PyPycLoader inherit from this class and provide implementations in relation to
- other methods required by the ABCs.
-
-- importlib.abc.PyLoader did not inherit from importlib.abc.ResourceLoader like
- the documentation said it did even though the code in PyLoader relied on the
- abstract method required by ResourceLoader.
-
-- Issue #6431: Make Fraction type return NotImplemented when it doesn't know how
- to handle a comparison without loss of precision. Also add correct handling
- of infinities and nans for comparisons with float.
-
-- Issue #6415: Fixed warnings.warn segfault on bad formatted string.
-
-- Issue #6358: The exit status of a command started with os.popen() was reported
- differently than it did with python 2.x.
-
-- Issue #6323: The pdb debugger did not exit when running a script with a syntax
- error.
-
-- Issue #3392: The subprocess communicate() method no longer fails in select()
- when file descriptors are large; communicate() now uses poll() when possible.
-
-- Issue #6369: Fix an RLE decompression bug in the binhex module.
-
-- Issue #6344: Fixed a crash of mmap.read() when passed a negative argument.
-
-- The deprecated function string.maketrans has been removed.
-
-- Issue #4005: Fixed a crash of pydoc when there was a zip file present in
- sys.path.
-
-- Issue #6218: io.StringIO and io.BytesIO instances are now picklable.
-
-- The os.get_exec_path() function to return the list of directories that will be
- searched for an executable when launching a subprocess was added.
-
-- Issue #7481: When a threading.Thread failed to start it would leave the
- instance stuck in initial state and present in threading.enumerate().
-
-- Issue #1068268: The subprocess module now handles EINTR in internal os.waitpid
- and os.read system calls where appropriate.
-
-- Issue #6729: Added ctypes.c_ssize_t to represent ssize_t.
-
-- Issue #6247: The argparse module has been added to the standard library.
-
-- Issue #8235: _socket: Add the constant ``SO_SETFIB``. SO_SETFIB is a socket
- option available on FreeBSD 7.1 and newer.
-
-- Issue #9315: Fix for the trace module to record correct class name
- for tracing methods.
-
-Extension Modules
------------------
-
-- Issue #9959: Tweak formula used for computing math.log of an integer,
- making it marginally more accurate for exact powers of 2.
-
-- Issue #9422: Fix memory leak when re-initializing a struct.Struct object.
-
-- Issue #7900: The getgroups(2) system call on MacOSX behaves rather oddly
- compared to other unix systems. In particular, os.getgroups() does not reflect
- any changes made using os.setgroups() but basicly always returns the same
- information as the id command. os.getgroups() can now return more than 16
- groups on MacOSX.
-
-- Issue #6095: Make directory argument to os.listdir optional.
-
-- Issue #9277: Fix bug in struct.pack for bools in standard mode (e.g.,
- struct.pack('>?')): if conversion to bool raised an exception then that
- exception wasn't properly propagated on machines where char is unsigned.
-
-- Issue #5180: Fixed a bug that prevented loading 2.x pickles in 3.x python when
- they contain instances of old-style classes.
-
-- Issue #9165: Add new functions math.isfinite and cmath.isfinite, to accompany
- existing isinf and isnan functions.
-
-- Issue #1578269: Implement os.symlink for Windows 6.0+. Patch by Jason
- R. Coombs.
-
-- In struct.pack, correctly propogate exceptions from computing the truth of an
- object in the '?' format.
-
-- Issue #9000: datetime.timezone objects now have eval-friendly repr.
-
-- In the math module, correctly lookup __trunc__, __ceil__, and __floor__ as
- special methods.
-
-- Issue #9005: Prevent utctimetuple() from producing year 0 or year 10,000.
- Prior to this change, timezone adjustment in utctimetuple() could produce
- tm_year value of 0 or 10,000. Now an OverflowError is raised in these edge
- cases.
-
-- Issue #6641: The ``datetime.strptime`` method now supports the ``%z``
- directive. When the ``%z`` directive is present in the format string, an
- aware ``datetime`` object is returned with ``tzinfo`` bound to a
- ``datetime.timezone`` instance constructed from the parsed offset. If both
- ``%z`` and ``%Z`` are present, the data in ``%Z`` field is used for timezone
- name, but ``%Z`` data without ``%z`` is discarded.
-
-- Issue #5094: The ``datetime`` module now has a simple concrete class
- implementing ``datetime.tzinfo`` interface. Instances of the new class,
- ``datetime.timezone``, return fixed name and UTC offset from their
- ``tzname(dt)`` and ``utcoffset(dt)`` methods. The ``dst(dt)`` method always
- returns ``None``. A class attribute, ``utc`` contains an instance
- representing the UTC timezone. Original patch by Rafe Kaplan.
-
-- Issue #8973: Add __all__ to struct module; this ensures that help(struct)
- includes documentation for the struct.Struct class.
-
-- Issue #3129: Trailing digits in struct format string are no longer ignored.
- For example, "1" or "ilib123" are now invalid formats and cause
- ``struct.error`` to be raised. Patch by Caleb Deveraux.
-
-- Issue #7384: If the system readline library is linked against ncurses, the
- curses module must be linked against ncurses as well. Otherwise it is not safe
- to load both the readline and curses modules in an application.
-
-- Issue #2810: Fix cases where the Windows registry API returns ERROR_MORE_DATA,
- requiring a re-try in order to get the complete result.
-
-- Issue #8692: Optimize math.factorial: replace the previous naive algorithm
- with an improved 'binary-split' algorithm that uses fewer multiplications and
- allows many of the multiplications to be performed using plain C integer
- arithmetic instead of PyLong arithmetic. Also uses a lookup table for small
- arguments.
-
-- Issue #8674: Fixed a number of incorrect or undefined-behaviour-inducing
- overflow checks in the audioop module.
-
-- Issue #8644: The accuracy of td.total_seconds() has been improved (by
- calculating with integer arithmetic instead of float arithmetic internally):
- the result is now always correctly rounded, and is equivalent to ``td /
- timedelta(seconds=1)``.
-
-- Issue #2706: Allow division of a timedelta by another timedelta: timedelta /
- timedelta, timedelta % timedelta, timedelta // timedelta and divmod(timedelta,
- timedelta) are all supported.
-
-- Issue #8314: Fix unsigned long long bug in libffi on Sparc v8.
-
-- Issue #8300: When passing a non-integer argument to struct.pack with any
- integer format code, struct.pack first attempts to convert the non-integer
- using its __index__ method. If that method is non-existent or raises
- TypeError it goes on to try the __int__ method, as described below.
-
-- Issue #8142: Update libffi to the 3.0.9 release.
-
-- Issue #6949: Allow the _dbm extension to be built with db 4.8.x.
-
-- Issue #6544: Fix a reference leak in the kqueue implementation's error
- handling.
-
-- Stop providing crtassem.h symbols when compiling with Visual Studio 2010, as
- msvcr100.dll is not a platform assembly anymore.
-
-- Issue #6508: Add posix.{getresuid,getresgid,setresuid,setresgid}.
-
-- Issue #7078: Set struct.__doc__ from _struct.__doc__.
-
-- Issue #3366: Add erf, erfc, expm1, gamma, lgamma functions to math module.
-
-- Issue #6877: It is now possible to link the readline extension to the libedit
- readline emulation on OSX 10.5 or later.
-
-- Issue #6848: Fix curses module build failure on OS X 10.6.
-
-- Fix a segfault that could be triggered by expat with specially formed input.
-
-- Issue #6561: '\d' in a regex now matches only characters with Unicode category
- 'Nd' (Number, Decimal Digit). Previously it also matched characters with
- category 'No'.
-
-- Issue #4509: Array objects are no longer modified after an operation failing
- due to the resize restriction in-place when the object has exported buffers.
-
-- Issue #2389: Array objects are now pickled in a portable manner.
-
-- Expat: Fix DoS via XML document with malformed UTF-8 sequences
- (CVE_2009_3560).
-
-- Issue #7242: On Solaris 9 and earlier calling os.fork() from within a thread
- could raise an incorrect RuntimeError about not holding the import lock. The
- import lock is now reinitialized after fork.
-
-- Issue #7999: os.setreuid() and os.setregid() would refuse to accept a -1
- parameter on some platforms such as OS X.
-
-- Build the ossaudio extension on GNU/kFreeBSD.
-
-- Issue #7347: winreg: Add CreateKeyEx and DeleteKeyEx, as well as fix a bug in
- the return value of QueryReflectionKey.
-
-- Issue #7567: PyCurses_setupterm: Don't call ``setupterm`` twice.
-
-Build
------
-
-- Use OpenSSL 1.0.0a on Windows.
-
-- Issue #9280: Make sharedinstall depend on sharedmods.
-
-- Issue #9189: Make a user-specified CFLAGS, CPPFLAGS, or LDFLAGS setting
- override the configure and makefile defaults, without deleting options the
- user didn't intend to override. Developers should no longer need to specify
- OPT or EXTRA_CFLAGS, although those variables are still present for
- backward-compatibility.
-
-- Issue #8854: Fix finding Visual Studio 2008 on Windows x64.
-
-- Issue #1759169, #8864: Drop _XOPEN_SOURCE on Solaris, define it for
- multiprocessing only.
-
-- Issue #8625: Turn off optimization in --with-pydebug builds with gcc.
- (Optimization was unintentionally turned on in gcc --with-pydebug builds as a
- result of the issue #1628484 fix, combined with autoconf's strange choice of
- default CFLAGS produced by AC_PROG_CC for gcc.)
-
-- Issue #3646: It is now easily possible to install a Python framework into your
- home directory on MacOSX, see Mac/README for more information.
-
-- Issue #3928: os.mknod() now available in Solaris, also.
-
-- Issue #3326: Build Python without -fno-strict-aliasing when the gcc does not
- give false warnings.
-
-- Issue #1628484: The Makefile doesn't ignore the CFLAGS environment variable
- anymore. It also forwards the LDFLAGS settings to the linker when building a
- shared library.
-
-- Issue #6716: Quote -x arguments of compileall in MSI installer. Exclude 2to3
- tests from compileall.
-
-- Issue #3920, #7903: Define _BSD_SOURCE on OpenBSD 4.4 through 4.9.
-
-- Issue #7632: When Py_USING_MEMORY_DEBUGGER is defined, disable the private
- memory allocation scheme in dtoa.c and use PyMem_Malloc and PyMem_Free
- instead. Also disable caching of powers of 5.
-
-- Issue #6491: Allow --with-dbmliborder to specify that no dbms will be built.
-
-- Issue #6943: Use pkg-config to find the libffi headers when the
- --with-system-ffi flag is used.
-
-- Issue #7609: Add a --with-system-expat option that causes the system's expat
- library to be used for the pyexpat module instead of the one included with
- Python.
-
-- Issue #7589: Only build the nis module when the correct header files are
- found.
-
-- Switch to OpenSSL 0.9.8l and sqlite 3.6.21 on Windows.
-
-- Issue #5792: Extend the short float repr support to x86 systems using
- icc or suncc.
-
-- Issue #6603: Change READ_TIMESTAMP macro in ceval.c so that it compiles
- correctly under gcc on x86-64. This fixes a reported problem with the
- --with-tsc build on x86-64.
-
-- Issue #6802: Fix build issues on MacOSX 10.6.
-
-- Issue #6244: Allow detect_tkinter to look for Tcl/Tk 8.6.
-
-- Issue #4601: 'make install' did not set the appropriate permissions on
- directories.
-
-- Issue #5390: Add uninstall icon independent of whether file extensions are
- installed.
-
-- Issue #7541: When using ``python-config`` with a framework install the
- compiler might use the wrong library.
-
-- python-config now supports multiple options on the same command line.
-
-- Issue #8509: Fix quoting in help strings and code snippets in configure.in.
-
-- Issue #8510: Update to autoconf2.65.
-
-Documentation
--------------
-
-- Issue #9817: Add expat COPYING file; add expat, libffi and expat licenses
- to Doc/license.rst.
-
-- Issue #9524: Document that two CTRL* signals are meant for use only
- with os.kill.
-
-- Issue #9255: Document that the 'test' package is meant for internal Python use
- only.
-
-- A small WSGI server was added as Tools/scripts/serve.py, and is used to
- implement a local documentation server via 'make serve' in the doc directory.
-
-- Updating `Using Python` documentation to include description of CPython's -J
- and -X options.
-
-- Document that importing a module that has None in sys.modules triggers an
- ImportError.
-
-- Issue #6556: Fixed the Distutils configuration files location explanation for
- Windows.
-
-- Update python manual page (options -B, -O0, -s, environment variables
- PYTHONDONTWRITEBYTECODE, PYTHONNOUSERSITE).
-
-- Issue #8909: Added the size of the bitmap used in the installer created by
- distutils' bdist_wininst. Patch by Anatoly Techtonik.
-
-Tests
------
-
-- Issue #9251: test_threaded_import didn't fail when run through regrtest if the
- import lock was disabled.
-
-- Issue #8605: Skip test_gdb if Python is compiled with optimizations.
-
-- Issue #7449: Skip test_socketserver if threading support is disabled.
-
-- Issue #8672: Add a zlib test ensuring that an incomplete stream can be handled
- by a decompressor object without errors (it returns incomplete uncompressed
- data).
-
-- Issue #8533: regrtest uses backslashreplace error handler for stdout to avoid
- UnicodeEncodeError (write non-ASCII character to stdout using ASCII encoding).
-
-- Issue #8576: Remove use of find_unused_port() in test_smtplib and
- test_multiprocessing. Patch by Paul Moore.
-
-- Issue #7449: Fix many tests to support Python compiled without thread
- support. Patches written by Jerry Seutter.
-
-- Issue #8108: test_ftplib's non-blocking SSL server now has proper handling of
- SSL shutdowns.
-
-- Issues #8279, #8330, #8437, #8480, #8495: Fix test_gdb failures, patch written
- by Dave Malcolm.
-
-- Issue #3864: Skip three test_signal tests on freebsd6 because they fail if any
- thread was previously started, most likely due to a platform bug.
-
-- Issue #8193: Fix test_zlib failure with zlib 1.2.4.
-
-- Issue #8248: Add some tests for the bool type. Patch by Gregory Nofi.
-
-- Issue #8263: Now regrtest.py will report a failure if it receives a
- KeyboardInterrupt (SIGINT).
-
-- Issue #8180 and #8207: Fix test_pep277 on OS X and add more tests for special
- Unicode normalization cases.
-
-- Issue #7783: test.support.open_urlresource invalidates the outdated files from
- the local cache.
-
-- Issue #7849: Now the utility ``check_warnings`` verifies if the warnings are
- effectively raised.
-
-- The four path modules (genericpath, macpath, ntpath, posixpath) share a common
- TestCase for some tests: test_genericpath.CommonTest.
-
-- Print platform information when running the whole test suite, or using the
- --verbose flag.
-
-- Issue #767675: enable test_pep277 on POSIX platforms with Unicode-friendly
- filesystem encoding.
-
-- Issue #6292: for the moment at least, the test suite runs cleanly if python is
- run with the -OO flag. Tests requiring docstrings are skipped.
-
-- Issue #7712: test.support gained a new `temp_cwd` context manager which is now
- also used by regrtest to run all the tests in a temporary directory. The
- original CWD is saved in `support.SAVEDCWD`. Thanks to Florent Xicluna who
- helped with the patch.
-
-- Issue #7924: Fix an intermittent 'XXX undetected error' failure in test_capi
- (only seen so far on platforms where the curses module wasn't built), due to
- an uncleared exception.
-
-- Issue #7728: test_timeout was changed to use support.bind_port instead of a
- hard coded port.
-
-- Issue #7376: Instead of running a self-test (which was failing) when called
- with no arguments, doctest.py now gives a usage message.
-
-- Issue #7396: fix regrtest -s, which was broken by the -j enhancement.
-
-- Issue #7498: test_multiprocessing now uses test.support.find_unused_port
- instead of a hardcoded port number in test_rapid_restart.
-
-- Issue #7431: Use TESTFN in test_linecache instead of trying to create a file
- in the Lib/test directory, which might be read-only for the user running the
- tests.
-
-- Issue #7324: Add a sanity check to regrtest argument parsing to catch the case
- of an option with no handler.
-
-- Issue #7312: Add a -F flag to run the selected tests in a loop until a test
- fails. Can be combined with -j.
-
-- Issue #6551: test_zipimport could import and then destroy some modules of the
- encodings package, which would make other tests fail further down the road
- because the internally cached encoders and decoders would point to empty
- global variables.
-
-- Issue #7295: Do not use a hardcoded file name in test_tarfile.
-
-- Issue #7270: Add some dedicated unit tests for multi-thread synchronization
- primitives such as Lock, RLock, Condition, Event and Semaphore.
-
-- Issue #7248 (part 2): Use a unique temporary directory for importlib source
- tests instead of tempfile.tempdir. This prevents the tests from sharing state
- between concurrent executions on the same system.
-
-- Issue #7248: In importlib.test.source.util a try/finally block did not make
- sure that some referenced objects actually were created in the block before
- calling methods on the object.
-
-- Issue #7222: Make thread "reaping" more reliable so that reference
- leak-chasing test runs give sensible results. The previous method of reaping
- threads could return successfully while some Thread objects were still
- referenced. This also introduces a new private function:
- ``_thread._count()``.
-
-- Issue #7151: Fixed regrtest -j so that output to stderr from a test no longer
- runs the risk of causing the worker thread to fail.
-
-- Issue #7055: test___all__ now greedily detects all modules which have an
- __all__ attribute, rather than using a hardcoded and incomplete list.
-
-- Issue #7058: Added save/restore for things like sys.argv and cwd to
- runtest_inner in regrtest, with warnings if the called test modifies them, and
- a new section in the summary report at the end.
-
-- Issue #7042: Fix test_signal (test_itimer_virtual) failure on OS X 10.6.
-
-- Fixed tests in importlib.test.source.test_abc_loader that were masking the
- proper exceptions that should be raised for missing or improper code object
- bytecode.
-
-- Removed importlib's custom test discovery code and switched to
- unittest.TestLoader.discover().
-
-Tools/Demos
------------
-
-- Issue #5464, #8974: Implement plural forms in msgfmt.py.
-
-- iobench (a file I/O benchmark) and ccbench (a concurrency benchmark) were
- added to the `Tools/` directory. They were previously living in the sandbox.
-
-
-What's New in Python 3.1?
-=========================
-
-*Release date: 27-June-2009*
-
-Core and Builtins
------------------
-
-- Issue #6334: Fix bug in range length calculation for ranges with
- large arguments.
-
-- Issue #6329: Fixed iteration for memoryview objects (it was being blocked
- because it wasn't recognized as a sequence).
-
-Library
--------
-
-- Issue #6126: Fixed pdb command-line usage.
-
-- Issue #6314: logging: performs extra checks on the "level" argument.
-
-- Issue #6274: Fixed possible file descriptors leak in subprocess.py
-
-- Accessing io.StringIO.buffer now raises an AttributeError instead of
- io.UnsupportedOperation.
-
-- Issue #6271: mmap tried to close invalid file handle (-1) when anonymous.
- (On Unix)
-
-- Issue #1202: zipfile module would cause a struct.error when attempting to
- store files with a CRC32 > 2**31-1.
-
-Extension Modules
------------------
-
-- Issue #5590: Remove unused global variable in pyexpat extension.
-
-
-What's New in Python 3.1 Release Candidate 2?
-=============================================
-
-*Release date: 13-June-2009*
-
-Core and Builtins
------------------
-
-- Fixed SystemError triggered by "range([], 1, -1)".
-
-- Issue #5924: On Windows, a large PYTHONPATH environment variable
- (more than 255 characters) would be completely ignored.
-
-- Issue #4547: When debugging a very large function, it was not always
- possible to update the lineno attribute of the current frame.
-
-- Issue #5330: C functions called with keyword arguments were not reported by
- the various profiling modules (profile, cProfile). Patch by Hagen Fürstenau.
-
-Library
--------
-
-- Issue #6438: Fixed distutils.cygwinccompiler.get_versions : the regular
- expression string pattern was trying to match against a bytes returned by
- Popen. Tested under win32 to build the py-postgresql project.
-
-- Issue #6258: Support AMD64 in bdist_msi.
-
-- Issue #6195: fixed doctest to no longer try to read 'source' data from
- binary files.
-
-- Issue #5262: Fixed bug in next rollover time computation in
- TimedRotatingFileHandler.
-
-- Issue #6217: The C implementation of io.TextIOWrapper didn't include the
- errors property. Additionally, the errors and encoding properties of StringIO
- are always None now.
-
-- Issue #6137: The pickle module now translates module names when loading
- or dumping pickles with a 2.x-compatible protocol, in order to make data
- sharing and migration easier. This behaviour can be disabled using the
- new `fix_imports` optional argument.
-
-- Removed the ipaddr module.
-
-- Issue #3613: base64.{encode,decode}string are now called
- base64.{encode,decode}bytes which reflects what type they accept and return.
- The old names are still there as deprecated aliases.
-
-- Issue #5767: Remove sgmlop support from xmlrpc.client.
-
-- Issue #6150: Fix test_unicode on wide-unicode builds.
-
-- Issue #6149: Fix initialization of WeakValueDictionary objects from non-empty
- parameters.
-
-Windows
--------
-
-- Issue #6221: Delete test registry key before running the test.
-
-- Issue #6158: Package Sine-1000Hz-300ms.aif in MSI file.
-
-C-API
------
-
-- Issue #5735: Python compiled with --with-pydebug should throw an
- ImportError when trying to import modules compiled without
- --with-pydebug, and vice-versa.
-
-
-Build
------
-
-- Issue #6154: Make sure the intl library is added to LIBS if needed. Also
- added LIBS to OS X framework builds.
-
-- Issue #5809: Specifying both --enable-framework and --enable-shared is
- an error. Configure now explicity tells you about this.
-
-
-
-What's New in Python 3.1 release candidate 1?
-=============================================
-
-*Release date: 2009-05-30*
-
-Core and Builtins
------------------
-
-- Issue #6097: Escape UTF-8 surrogates resulting from mbstocs conversion
- of the command line.
-
-- Issue #6012: Add cleanup support to O& argument parsing.
-
-- Issue #6089: Fixed str.format with certain invalid field specifiers
- that would raise SystemError.
-
-- Issue #5982: staticmethod and classmethod now expose the wrapped
- function with __func__.
-
-- Added support for multiple context managers in the same with-statement.
- Deprecated contextlib.nested() which is no longer needed.
-
-- Issue #5829: complex("1e500") no longer raises OverflowError. This
- makes it consistent with float("1e500") and interpretation of real
- and imaginary literals.
-
-- Issue #3527: Removed Py_WIN_WIDE_FILENAMES which is not used any more.
-
-- Issue #5994: the marshal module now has docstrings.
-
-- Issue #5981: Fix three minor inf/nan issues in float.fromhex:
- (1) inf and nan strings with trailing whitespace were incorrectly
- rejected; (2) parsing of strings representing infinities and nans
- was locale aware; and (3) the interpretation of fromhex('-nan')
- didn't match that of float('-nan').
-
-Library
--------
-
-- Issue #4859: Implement PEP 383 for pwd, spwd, and grp.
-
-- smtplib 'login' and 'cram-md5' login are also fixed (see Issue #5259).
-
-- Issue #6121: pydoc now ignores leading and trailing spaces in the
- argument to the 'help' function.
-
-- Issue #6118: urllib.parse.quote_plus ignored the encoding and errors
- arguments for strings with a space in them.
-
-- collections.namedtuple() was not working with the following field
- names: cls, self, tuple, itemgetter, and property.
-
-- In unittest, using a skipping decorator on a class is now equivalent to
- skipping every test on the class. The ClassTestSuite class has been removed.
-
-- Issue #6050: Don't fail extracting a directory from a zipfile if
- the directory already exists.
-
-- Issue #1309352: fcntl now converts its third arguments to a C `long` rather
- than an int, which makes some operations possible under 64-bit Linux (e.g.
- DN_MULTISHOT with F_NOTIFY).
-
-- Issue #5761: Add the name of the underlying file to the repr() of various
- IO objects.
-
-- Issue #5259: smtplib plain auth login no longer gives a traceback. Fix
- by Musashi Tamura, tests by Marcin Bachry.
-
-- Issue #1983: Fix functions taking or returning a process identifier to use
- the dedicated C type ``pid_t`` instead of a C ``int``. Some platforms have
- a process identifier type wider than the standard C integer type.
-
-- Issue #4066: smtplib.SMTP_SSL._get_socket now correctly returns the socket.
- Patch by Farhan Ahmad, test by Marcin Bachry.
-
-- Issue #2116: Weak references and weak dictionaries now support copy()ing and
- deepcopy()ing.
-
-- Issue #1655: Make imaplib IPv6-capable. Patch by Derek Morr.
-
-- Issue #5918: Fix a crash in the parser module.
-
-- Issue #1664: Make nntplib IPv6-capable. Patch by Derek Morr.
-
-- Issue #5006: Better handling of unicode byte-order marks (BOM) in the io
- library. This means, for example, that opening an UTF-16 text file in
- append mode doesn't add a BOM at the end of the file if the file isn't
- empty.
-
-- Issue #4050: inspect.findsource/getsource now raise an IOError if the 'source'
- file is a binary. Patch by Brodie Rao, tests by Daniel Diniz. This fix
- corrects a pydoc regression.
-
-- Issue #5955: aifc's close method did not close the file it wrapped,
- now it does. This also means getfp method now returns the real fp.
-
-Installation
-------------
-
-- Issue #6047: fullinstall has been removed because Python 3's executable will
- now be known as python3.
-
-- Lib/smtpd.py is no longer installed as a script.
-
-Extension Modules
------------------
-
-- Issue #3061: Use wcsftime for time.strftime where available.
-
-- Issue #4873: Fix resource leaks in error cases of pwd and grp.
-
-- Issue #6093: Fix off-by-one error in locale.strxfrm.
-
-- The _functools and _locale modules are now built into the libpython shared
- library instead of as extension modules.
-
-Build
------
-
-- Issue #3585: Add pkg-config support. It creates a python-2.7.pc file
- and a python3.pc symlink in the $(LIBDIR)/pkgconfig directory. Patch by
- Clinton Roy.
-
-Tests
------
-
-- Issue #5442: Tests for importlib were not properly skipping case-sensitivity
- tests on darwin even when the OS was installed on a case-sensitive
- filesystem. Also fixed tests that should not be run when
- sys.dont_write_bytecode is true.
-
-
-What's New in Python 3.1 beta 1?
-================================
-
-*Release date: 2009-05-06*
-
-Core and Builtins
------------------
-
-- Issue #5914: Add new C API function PyOS_string_to_double, and
- deprecate PyOS_ascii_strtod and PyOS_ascii_atof.
-
-- Issue #3382: float.__format__, complex.__format__, and %-formatting
- no longer map 'F' to 'f'. Because of issue #5859 (below), this only
- affects nan -> NAN and inf -> INF.
-
-- Issue #5799: ntpath (ie, os.path on Windows) fully supports UNC pathnames
- in all operations, including splitdrive, split, etc. splitunc() now issues
- a PendingDeprecation warning.
-
-- Issue #5920: For float.__format__, change the behavior with the
- empty presentation type (that is, not one of 'e', 'f', 'g', or 'n')
- to be like 'g' but with at least one decimal point and with a
- default precision of 12. Previously, the behavior the same but with
- a default precision of 6. This more closely matches str(), and
- reduces surprises when adding alignment flags to the empty
- presentation type. This also affects the new complex.__format__ in
- the same way.
-
-- Implement PEP 383, Non-decodable Bytes in System Character Interfaces.
-
-- Issue #5890: in subclasses of 'property' the __doc__ attribute was
- shadowed by classtype's, even if it was None. property now
- inserts the __doc__ into the subclass instance __dict__.
-
-- Issue #4426: The UTF-7 decoder was too strict and didn't accept some legal
- sequences. Patch by Nick Barnes and Victor Stinner.
-
-- Issue #3672: Reject surrogates in utf-8 codec; add surrogatepass error handler.
-
-- Issue #5883: In the io module, the BufferedIOBase and TextIOBase ABCs have
- received a new method, detach(). detach() disconnects the underlying stream
- from the buffer or text IO and returns it.
-
-- Issue #5859: Remove switch from '%f' to '%g'-style formatting for
- floats with absolute value over 1e50. Also remove length
- restrictions for float formatting: '%.67f' % 12.34 and '%.120e' %
- 12.34 no longer raise an exception.
-
-- Issue #1588: Add complex.__format__. For example,
- format(complex(1, 2./3), '.5') now produces a sensible result.
-
-- Issue #5864: Fix empty format code formatting for floats so that it
- never gives more than the requested number of significant digits.
-
-- Issue #5793: Rationalize isdigit / isalpha / tolower, etc. Includes
- new Py_ISDIGIT / Py_ISALPHA / Py_TOLOWER, etc. in pctypes.h.
-
-- Issue #5835: Deprecate PyOS_ascii_formatd.
-
-- Issue #4971: Fix titlecase for characters that are their own
- titlecase, but not their own uppercase.
-
-- Issue #5283: Setting __class__ in __del__ caused a segfault.
-
-- Issue #5816: complex(repr(z)) now recovers z exactly, even when
- z involves nans, infs or negative zeros.
-
-- Issue #3166: Make int -> float conversions correctly rounded.
-
-- Issue #1869 (and many duplicates): make round(x, n) correctly
- rounded for a float x, by using the decimal <-> binary conversions
- from Python/dtoa.c. As a consequence, (e.g.) round(x, 2) now
- consistently agrees with format(x, '.2f').
-
-- Issue #5787: object.__getattribute__(some_type, "__bases__") segfaulted on
- some builtin types.
-
-- Issue #5772: format(1e100, '<') produces '1e+100', not '1.0e+100'.
-
-- Issue #5515: str.format() type 'n' combined with commas and leading
- zeros no longer gives odd results with ints and floats.
-
-- Implement PEP 378, Format Specifier for Thousands Separator, for
- floats.
-
-- The str function switches to exponential notation at
- 1e11, not 1e12. This avoids printing 13 significant digits in
- situations where only 12 of them are correct. Example problem
- value: str(1e11 + 0.5). (This minor issue has existed in 2.x for a
- long time.)
-
-- Issue #1580: On most platforms, use a 'short' float repr: for a
- finite float x, repr(x) now outputs a string based on the shortest
- sequence of decimal digits that rounds to x. Previous behaviour was
- to output 17 significant digits and then strip trailing zeros.
- Another minor difference is that the new repr switches to
- exponential notation at 1e16 instead of the previous 1e17; this
- avoids misleading output in some cases.
-
- There's a new sys attribute sys.float_repr_style, which takes
- the value 'short' to indicate that we're using short float repr,
- and 'legacy' if the short float repr isn't available for one
- reason or another.
-
- The float repr change involves incorporating David Gay's 'perfect
- rounding' code into the Python core (it's in Python/dtoa.c). As a
- secondary consequence, all string-to-float and float-to-string
- conversions (including all float formatting operations) will be
- correctly rounded on these platforms.
-
- See issue #1580 discussions for details of platforms for which
- this change does not apply.
-
-- Issue #5759: float() didn't call __float__ on str subclasses.
-
-- The string.maketrans() function is deprecated; there is a new static method
- maketrans() on the bytes and bytearray classes. This removes confusion about
- the types string.maketrans() is supposed to work with, and mirrors the
- methods available on the str class.
-
-- Issue #2170: refactored xml.dom.minidom.normalize, increasing both
- its clarity and its speed.
-
-- Issue #1113244: Py_XINCREF, Py_DECREF, Py_XDECREF: Add ``do { ... } while (0)``
- to avoid compiler warnings.
-
-- Issue #3739: The unicode-internal encoder now reports the number of characters
- consumed like any other encoder (instead of the number of bytes).
-
-Installation
-------------
-
-- Issue #5756: Install idle and pydoc with a 3 suffix.
-
-Library
--------
-
-- Issue #8203: Fix IDLE Credits dialog: view_file() uses its encoding argument.
-
-- Issue #5311: bdist_msi can now build packages that do not depend on a
- specific Python version.
-
-- Issue #5150: IDLE's format menu now has an option to strip trailing
- whitespace.
-
-- Issue #5940: distutils.command.build_clib.check_library_list was not doing
- the right type checkings anymore.
-
-- Issue #4875: On win32, ctypes.util.find_library does no longer
- return directories.
-
-- Issue #5142: Add the ability to skip modules while stepping to pdb.
-
-- Issue #1309567: Fix linecache behavior of stripping subdirectories when
- looking for files given by a relative filename.
-
-- Issue #5923: Update the ``turtle`` module to version 1.1, add two new
- turtle demos in Demo/turtle.
-
-- Issue #5692: In ``zipfile.Zipfile``, fix wrong path calculation when
- extracting a file to the root directory.
-
-- Issue #5913: os.listdir() should fail for empty path on windows.
-
-- Issue #5084: unpickling now interns the attribute names of pickled objects,
- saving memory and avoiding growth in size of subsequent pickles. Proposal
- and original patch by Jake McGuire.
-
-- The json module now works exclusively with str and not bytes.
-
-- Issue #3959: The ipaddr module has been added to the standard library.
- Contributed by Google.
-
-- Issue #3002: ``shutil.copyfile()`` and ``shutil.copytree()`` now raise an
- error when a named pipe is encountered, rather than blocking infinitely.
-
-- Issue #5857: tokenize.tokenize() now returns named tuples.
-
-- Issue #4305: ctypes should now build again on mipsel-linux-gnu
-
-- Issue #1734234: Massively speedup ``unicodedata.normalize()`` when the
- string is already in normalized form, by performing a quick check beforehand.
- Original patch by Rauli Ruohonen.
-
-- Issue #5853: calling a function of the mimetypes module from several threads
- at once could hit the recursion limit if the mimetypes database hadn't been
- initialized before.
-
-- Issue #5854: Updated __all__ to include some missing names and remove some
- names which should not be exported.
-
-- Issue #3102: All global symbols that the _ctypes extension defines
- are now prefixed with 'Py' or '_ctypes'.
-
-- Issue #5041: ctypes does now allow pickling wide character.
-
-- Issue #5812: For the two-argument form of the Fraction constructor,
- Fraction(m, n), m and n are permitted to be arbitrary Rational
- instances.
-
-- Issue #5812: Fraction('1e6') is valid: more generally, any string
- that's valid for float() is now valid for Fraction(), with the
- exception of strings representing NaNs and infinities.
-
-- Issue #5734: BufferedRWPair was poorly tested and had several glaring
- bugs. Patch by Brian Quinlan.
-
-- Issue #1161031: fix readwrite select flag handling: POLLPRI now
- results in a handle_expt_event call, not handle_read_event, and POLLERR
- and POLLNVAL now call handle_close, not handle_expt_event. Also,
- dispatcher now has an 'ignore_log_types' attribute for suppressing
- log messages, which is set to 'warning' by default.
-
-- Issue #2703: SimpleXMLRPCDispatcher.__init__: Provide default values for
- new arguments introduced in 2.5.
-
-- Issue #5828 (Invalid behavior of unicode.lower): Fixed bogus logic in
- makeunicodedata.py and regenerated the Unicode database (This fixes
- u'\u1d79'.lower() == '\x00').
-
-Extension Modules
------------------
-
-- Issue #5881: Remove old undocumented compatibility interfaces in hashlib and
- pwd.
-
-- Issue #5463: In struct module, remove deprecated float coercion
- for integer type codes: struct.pack('L', 0.3) should now raise
- an error. The _PY_STRUCT_FLOAT_COERCE constant has been removed.
- The version number has been bumped to 0.3.
-
-- Issue #5359: Readd the Berkeley DB detection code to allow _dbm be built
- using Berkeley DB.
-
-Tests
------
-
-- Issue #5354: New test support function import_fresh_module() makes
- it easy to import both normal and optimised versions of modules.
- test_heapq and test_warnings have been adjusted to use it, tests for
- other modules with both C and Python implementations in the stdlib
- can be adjusted to use it over time.
-
-- Issue #5837: Certain sequences of calls to set() and unset() for
- support.EnvironmentVarGuard objects restored the environment variables
- incorrectly on __exit__.
-
-C-API
------
-
-- Issue #5630: A replacement PyCObject API, PyCapsule, has been added.
-
-
-What's New in Python 3.1 alpha 2?
-=================================
-
-*Release date: 2009-4-4*
-
-Core and Builtins
------------------
-
-- Implement PEP 378, Format Specifier for Thousands Separator, for
- integers.
-
-- Issue #5666: Py_BuildValue's 'c' code should create byte strings.
-
-- Issue #5499: The 'c' code for argument parsing functions now only accepts a
- byte, and the 'C' code only accepts a unicode character.
-
-- Fix a problem in PyErr_NormalizeException that leads to "undetected errors"
- when hitting the recursion limit under certain circumstances.
-
-- Issue #1665206: Remove the last eager import in _warnings.c and make it lazy.
-
-- Fix a segfault when running test_exceptions with coverage, caused by
- insufficient checks in accessors of Exception.__context__.
-
-- Issue #5604: non-ASCII characters in module name passed to
- imp.find_module() were converted to UTF-8 while the path is
- converted to the default filesystem encoding, causing nonsense.
-
-- Issue #5126: str.isprintable() returned False for space characters.
-
-- Issue #4865: On MacOSX /Library/Python/2.7/site-packages is added to
- the end sys.path, for compatibility with the system install of Python.
-
-- Issue #4688: Add a heuristic so that tuples and dicts containing only
- untrackable objects are not tracked by the garbage collector. This can
- reduce the size of collections and therefore the garbage collection overhead
- on long-running programs, depending on their particular use of datatypes.
-
-- Issue #5512: Rewrite PyLong long division algorithm (x_divrem) to
- improve its performance. Long divisions and remainder operations
- are now between 50% and 150% faster.
-
-- Issue #4258: Make it possible to use base 2**30 instead of base
- 2**15 for the internal representation of integers, for performance
- reasons. Base 2**30 is enabled by default on 64-bit machines. Add
- --enable-big-digits option to configure, which overrides the
- default. Add sys.int_info structseq to provide information about
- the internal format.
-
-- Issue #4474: PyUnicode_FromWideChar now converts characters outside
- the BMP to surrogate pairs, on systems with sizeof(wchar_t) == 4
- and sizeof(Py_UNICODE) == 2.
-
-- Issue #5237: Allow auto-numbered fields in str.format(). For
- example: '{} {}'.format(1, 2) == '1 2'.
-
-- Issue #5392: when a very low recursion limit was set, the interpreter would
- abort with a fatal error after the recursion limit was hit twice.
-
-- Issue #3845: In PyRun_SimpleFileExFlags avoid invalid memory access with
- short file names.
-
-Library
--------
-
-- Issue #2625: added missing items() call to the for loop in
- mailbox.MH.get_message().
-
-- Issue #5640: Fix _multibytecodec so that CJK codecs don't repeat
- error substitutions from non-strict codec error callbacks in
- incrementalencoder and StreamWriter.
-
-- Issue #5656: Fix the coverage reporting when running the test suite with
- the -T argument.
-
-- Issue #5647: MutableSet.__iand__() no longer mutates self during iteration.
-
-- Issue #5624: Fix the _winreg module name still used in several modules.
-
-- Issue #5628: Fix io.TextIOWrapper.read() with a unreadable buffer.
-
-- Issue #5619: Multiprocessing children disobey the debug flag and causes
- popups on windows buildbots. Patch applied to work around this issue.
-
-- Issue #5400: Added patch for multiprocessing on netbsd compilation/support
-
-- Issue #5387: Fixed mmap.move crash by integer overflow.
-
-- Issue #5261: Patch multiprocessing's semaphore.c to support context
- manager use: "with multiprocessing.Lock()" works now.
-
-- Issue #5236: Change time.strptime() to only take strings. Didn't work with
- bytes already but the failure was non-obvious.
-
-- Issue #5177: Multiprocessing's SocketListener class now uses
- socket.SO_REUSEADDR on all connections so that the user no longer needs
- to wait 120 seconds for the socket to expire.
-
-- Issue #5595: Fix UnboundedLocalError in ntpath.ismount().
-
-- Issue #1174606: Calling read() without arguments of an unbounded file
- (typically /dev/zero under Unix) could crash the interpreter.
-
-- The max_buffer_size arguments of io.BufferedWriter, io.BufferedRWPair, and
- io.BufferedRandom have been deprecated for removal in Python 3.2.
-
-- Issue #5068: Fixed the tarfile._BZ2Proxy.read() method that would loop
- forever on incomplete input. That caused tarfile.open() to hang when used
- with mode 'r' or 'r:bz2' and a fileobj argument that contained no data or
- partial bzip2 compressed data.
-
-- Issue #2110: Add support for thousands separator and 'n' type
- specifier to Decimal.__format__
-
-- Fix Decimal.__format__ bug that swapped the meanings of the '<' and
- '>' alignment characters.
-
-- The error detection code in FileIO.close() could fail to reflect the `errno`
- value, and report it as -1 instead.
-
-- Issue #5016: FileIO.seekable() could return False if the file position
- was negative when truncated to a C int. Patch by Victor Stinner.
-
-Extension Modules
------------------
-
-- Issue #5391: mmap now deals exclusively with bytes.
-
-- Issue #5463: In struct module, remove deprecated overflow wrapping
- when packing an integer: struct.pack('=L', -1) now raises
- struct.error instead of returning b'\xff\xff\xff\xff'. The
- _PY_STRUCT_RANGE_CHECKING and _PY_STRUCT_OVERFLOW_MASKING constants
- have been removed from the struct module.
-
-
-What's New in Python 3.1 alpha 1
-================================
-
-*Release date: 2009-03-07*
-
-Core and Builtins
------------------
-
-- The io module has been reimplemented in C for speed.
-
-- Give dict views an informative __repr__.
-
-- Issue #5247: Improve error message when unknown format codes are
- used when using str.format() with str, int, and float arguments.
-
-- Issue #5249: time.strftime returned malformed string when format string
- contained non ascii character on windows.
-
-- Issue #4626: compile(), exec(), and eval() ignore the coding cookie if the
- source has already been decoded into str.
-
-- Issue #5186: Reduce hash collisions for objects with no __hash__ method by
- rotating the object pointer by 4 bits to the right.
-
-- Issue #4575: Fix Py_IS_INFINITY macro to work correctly on x87 FPUs:
- it now forces its argument to double before testing for infinity.
-
-- Issue #5137: Make len() correctly raise a TypeError when a __len__ method
- returns a non-number type.
-
-- Issue #5182: Removed memoryview.__str__.
-
-- Issue #1717: Removed builtin cmp() function, dropped tp_compare
- slot, the C API functions PyObject_Compare and PyUnicode_Compare and
- the type definition cmpfunc. The tp_compare slot has been renamed
- to tp_reserved, and is reserved for future usage.
-
-- Issue #1242657: the __len__() and __length_hint__() calls in several tools
- were suppressing all exceptions. These include list() and bytearray().
-
-- Issue #4707: round(x, n) now returns an integer if x is an integer.
- Previously it returned a float.
-
-- Issue #4753: By enabling a configure option named '--with-computed-gotos'
- on compilers that support it (notably: gcc, SunPro, icc), the bytecode
- evaluation loop is compiled with a new dispatch mechanism which gives
- speedups of up to 20%, depending on the system, on various benchmarks.
-
-- Issue #4874: Most builtin decoders now reject unicode input.
-
-- Issue #4842: Don't allow trailing 'L' when constructing an integer
- from a string.
-
-- Issue #4991: os.fdopen now raises an OSError for invalid file descriptors.
-
-- Issue #4838: When a module is deallocated, free the memory backing the
- optional module state data.
-
-- Issue #4910: Rename nb_long slot to nb_reserved, and change its
- type to ``(void *)``.
-
-- Issue #4935: The overflow checking code in the expandtabs() method common
- to str, bytes and bytearray could be optimized away by the compiler, letting
- the interpreter segfault instead of raising an error.
-
-- Issue #3720: Fix a crash when an iterator modifies its class and removes its
- __next__ method.
-
-- Issue #4910: Builtin int() function and PyNumber_Long/PyNumber_Int API
- function no longer attempt to call the __long__ slot to convert an object
- to an integer. Only the __int__ and __trunc__ slots are examined.
-
-- Issue #4893: Use NT threading on CE.
-
-- Issue #4915: Port sysmodule to Windows CE.
-
-- Issue #4868: utf-8, utf-16 and latin1 decoding are now 2x to 4x faster. The
- common cases are optimized thanks to a dedicated fast path and a moderate
- amount of loop unrolling.
-
-- Issue #4074: Change the criteria for doing a full garbage collection (i.e.
- collecting the oldest generation) so that allocating lots of objects without
- destroying them does not show quadratic performance. Based on a proposal by
- Martin von Löwis at
- http://mail.python.org/pipermail/python-dev/2008-June/080579.html.
-
-- Issue #4604: Some objects of the I/O library could still be used after
- having been closed (for instance, a read() call could return some
- previously buffered data). Patch by Dmitry Vasiliev.
-
-- Issue #4705: Fix the -u ("unbuffered binary stdout and stderr") command-line
- flag to work properly. Furthermore, when specifying -u, the text stdout
- and stderr streams have line-by-line buffering enabled (the default being
- to buffer arbitrary chunks of data).
-
-- The internal table, _PyLong_DigitValue, is now an array of unsigned chars
- instead of ints (reducing its size from 4 to 8 times thereby reducing
- Python's overall memory).
-
-- Issue #1180193: When importing a module from a .pyc (or .pyo) file with
- an existing .py counterpart, override the co_filename attributes of all
- code objects if the original filename is obsolete (which can happen if the
- file has been renamed, moved, or if it is accessed through different paths).
- Patch by Ziga Seilnacht and Jean-Paul Calderone.
-
-- Issue #4580: Fix slicing of memoryviews when the item size is greater than
- one byte. Also fixes the meaning of len() so that it returns the number of
- items, rather than the size in bytes.
-
-- Issue #4075: Use OutputDebugStringW in Py_FatalError.
-
-- Issue #4747: When the terminal does not use utf-8, executing a script with
- non-ascii characters in its name could fail with a "SyntaxError: None" error.
-
-- Issue #4797: IOError.filename was not set when ``_fileio.FileIO`` failed
- to open file with a bytes filename on Windows.
-
-- Issue #3680: Reference cycles created through a dict, set or deque iterator
- did not get collected.
-
-- Issue #4701: PyObject_Hash now implicitly calls PyType_Ready on types
- where the tp_hash and tp_dict slots are both NULL.
-
-- Issue #4759: None is now allowed as the first argument of
- bytearray.translate(). It was always allowed for bytes.translate().
-
-- Added test case to ensure attempts to read from a file opened for writing
- fail.
-
-- Issue #3106: Speedup some comparisons (str/str and int/int).
-
-- Issue #2183: Simplify and optimize bytecode for list, dict and set
- comprehensions. Original patch for list comprehensions by Neal Norwitz.
-
-- Issue #2467: gc.DEBUG_STATS reported invalid elapsed times. Also, always
- print elapsed times, not only when some objects are uncollectable /
- unreachable. Original patch by Neil Schemenauer.
-
-- Issue #3439: Add a bit_length method to int.
-
-- Issue #2173: When getting device encoding, check that return value of
- nl_langinfo is not the empty string. This was causing silent build
- failures on OS X.
-
-- Issue #4597: Fixed several opcodes that weren't always propagating
- exceptions.
-
-- Issue #4589: Fixed exception handling when the __exit__ function of a
- context manager returns a value that cannot be converted to a bool.
-
-- Issue #4445: Replace "sizeof(PyBytesObject)" with
- "offsetof(PyBytesObject, ob_sval) + 1" when allocating memory for
- bytes instances. On a typical machine this saves 3 bytes of memory
- (on average) per allocation of a bytes instance.
-
-- Issue #4533: File read operation was dreadfully slow due to a slowly
- growing read buffer. Fixed by using the same growth rate algorithm as
- Python 2.x.
-
-- Issue #4509: Various issues surrounding resize of bytearray objects to
- which there are buffer exports (e.g. memoryview instances).
-
-- Issue #4233: Changed semantic of ``_fileio.FileIO``'s ``close()``
- method on file objects with closefd=False. The file descriptor is still
- kept open but the file object behaves like a closed file. The ``FileIO``
- object also got a new readonly attribute ``closefd``.
-
-- Issue #4569: Interpreter crash when mutating a memoryview with an item size
- larger than 1.
-
-- Issue #4748: Lambda generators no longer return a value.
-
-- The re.sub(), re.subn() and re.split() functions now accept a flags parameter.
-
-- Issue #5108: Handle %s like %S, %R and %A in PyUnicode_FromFormatV(): Call
- PyUnicode_DecodeUTF8() once, remember the result and output it in a second
- step. This avoids problems with counting UTF-8 bytes that ignores the effect
- of using the replace error handler in PyUnicode_DecodeUTF8().
-
-Library
--------
-
-- Issue #7071: byte-compilation in Distutils is now done with respect to
- sys.dont_write_bytecode.
-
-- Issue #7066: archive_util.make_archive now restores the cwd if an error is
- raised. Initial patch by Ezio Melotti.
-
-- Issue #6516: Added owner/group support when creating tar archives in
- Distutils.
-
-- Issue #6954: Fixed crash when using DISTUTILS_DEBUG flag in Distutils.
-
-- Issue #6163: Fixed HP-UX runtime library dir options in
- distutils.unixcompiler. Initial patch by Sridhar Ratnakumar and
- Michael Haubenwallner.
-
-- Issue #6693: New functions in site.py to get user/global site packages paths.
-
-- Issue #6511: ZipFile now raises BadZipfile (instead of an IOError) when
- opening an empty or very small file.
-
-- Issue #6545: Removed assert statements in distutils.Extension, so the
- behavior is similar when used with -O.
-
-- unittest has been split up into a package. All old names should still work.
-
-- Issue #6466: now distutils.cygwinccompiler and distutils.emxccompiler
- uses the same refactored function to get gcc/ld/dllwrap versions numbers.
- It's `distutils.util.get_compiler_versions`. Added deprecation warnings
- for the obsolete get_versions() functions.
-
-- Issue #6433: fixed issues with multiprocessing.pool.map hanging on empty list
-
-- Issue #6314: logging: Extra checks on the "level" argument in more places.
-
-- Issue #2622: Fixed an ImportError when importing email.message from a
- standalone application built with py2exe or py2app.
-
-- Issue #6455: Fixed test_build_ext under win32.
-
-- Issue #6377: Enabled the compiler option, and deprecate its usage as an
- attribute.
-
-- Issue #6413: Fixed the log level in distutils.dist for announce.
-
-- Issue #6403: Fixed package path usage in build_ext.
-
-- Issues #5155, 5313, 5331: multiprocessing.Process._bootstrap was
- unconditionally calling "os.close(sys.stdin.fileno())" resulting in file
- descriptor errors
-
-- Issue #6365: Distutils build_ext inplace mode was copying the compiled
- extension in a subdirectory if the extension name had dots.
-
-- Issue #6164: Added an AIX specific linker argument in Distutils
- unixcompiler. Original patch by Sridhar Ratnakumar.
-
-- Issue #6286: Now Distutils upload command is based on urllib2 instead of
- httplib, allowing the usage of http_proxy.
-
-- Issue #6287: Added the license field in Distutils documentation.
-
-- Issue #6263: Fixed syntax error in distutils.cygwincompiler.
-
-- Issue #5201: distutils.sysconfig.parse_makefile() now understands `$$`
- in Makefiles. This prevents compile errors when using syntax like:
- `LDFLAGS='-rpath=\$$LIB:/some/other/path'`. Patch by Floris Bruynooghe.
-
-- Issue #6131: test_modulefinder leaked when run after test_distutils.
- Patch by Hirokazu Yamamoto.
-
-- Issue #6048: Now Distutils uses the tarfile module in archive_util.
-
-- Issue #6062: In distutils, fixed the package option of build_ext. Feedback
- and tests on pywin32 by Tim Golden.
-
-- Issue #6053: Fixed distutils tests on win32. patch by Hirokazu Yamamoto.
-
-- Issue #6046: Fixed the library extension when distutils build_ext is used
- inplace. Initial patch by Roumen Petrov.
-
-- Issue #6041: Now distutils `sdist` and `register` commands use `check` as a
- subcommand.
-
-- Issue #6022: a test file was created in the current working directory by
- test_get_outputs in Distutils.
-
-- Issue #5977: distutils build_ext.get_outputs was not taking into account the
- inplace option. Initial patch by kxroberto.
-
-- Issue #5984: distutils.command.build_ext.check_extensions_list checks were broken
- for old-style extensions.
-
-- Issue #5976: Fixed Distutils test_check_environ.
-
-- Issue #5941: Distutils build_clib command was not working anymore because
- of an incomplete costumization of the archiver command. Added ARFLAGS in the
- Makefile besides AR and make Distutils use it. Original patch by David
- Cournapeau.
-
-- Issue #2245: aifc now skips chunk types it doesn't recognize, per spec.
-
-- Issue #5874: distutils.tests.test_config_cmd is not locale-sensitive
- anymore.
-
-- Issue #5810: Fixed Distutils test_build_scripts so it uses
- sysconfig.get_config_vars.
-
-- Issue #4951: Fixed failure in test_httpservers.
-
-- Issue #5795: Fixed test_distutils failure on Debian ppc.
-
-- Issue #5607: fixed Distutils test_get_platform for Mac OS X fat binaries.
-
-- Issue #5741: don't disallow "%%" (which is an escape for "%") when setting
- a value in SafeConfigParser.
-
-- Issue #5732: added a new command in Distutils: check.
-
-- Issue #5731: Distutils bdist_wininst no longer worked on non-Windows
- platforms. Initial patch by Paul Moore.
-
-- Issue #5095: Added bdist_msi to the list of bdist supported formats.
- Initial fix by Steven Bethard.
-
-- Issue #1491431: Fixed distutils.filelist.glob_to_re for edge cases.
- Initial fix by Wayne Davison.
-
-- Issue #5694: removed spurious test output in Distutils (test_clean).
-
-- Issue #1326077: fix the formatting of SyntaxErrors by the traceback module.
-
-- Issue #1665206 (partially): Move imports in cgitb to the top of the module
- instead of performing them in functions. Helps prevent import deadlocking in
- threads.
-
-- Issue #2522: locale.format now checks its first argument to ensure it has
- been passed only one pattern, avoiding mysterious errors where it appeared
- that it was failing to do localization.
-
-- Issue #5583: Added optional Extensions in Distutils. Initial patch by Georg
- Brandl.
-
-- Issue #1222: locale.format() bug when the thousands separator is a space
- character.
-
-- Issue #5472: Fixed distutils.test_util tear down. Original patch by
- Tim Golden.
-
-- collections.deque() objects now have a read-only attribute called maxlen.
-
-- Issue #2638: Show a window constructed with tkSimpleDialog.Dialog only after
- it is has been populated and properly configured in order to prevent
- window flashing.
-
-- Issue #4792: Prevent a segfault in _tkinter by using the
- guaranteed to be safe interp argument given to the PythonCmd in place of
- the Tcl interpreter taken from a PythonCmd_ClientData.
-
-- Issue #5193: Guarantee that tkinter.Text.search returns a string.
-
-- Issue #5394: removed > 2.3 syntax from distutils.msvc9compiler.
- Original patch by Akira Kitada.
-
-- Issue #5334: array.fromfile() failed to insert values when EOFError was raised.
-
-- Issue #5385: Fixed mmap crash after resize failure on windows.
-
-- Issue #5179: Fixed subprocess handle leak on failure on windows.
-
-- PEP 372: Added collections.OrderedDict().
-
-- The _asdict() for method for namedtuples now returns an OrderedDict().
-
-- configparser now defaults to using an ordered dictionary.
-
-- Issue #5401: Fixed a performance problem in mimetypes when ``from mimetypes
- import guess_extension`` was used.
-
-- Issue #1733986: Fixed mmap crash in accessing elements of second map object
- with same tagname but larger size than first map. (Windows)
-
-- Issue #5386: mmap.write_byte didn't check map size, so it could cause buffer
- overrun.
-
-- Issue #1533164: Installed but not listed ``*.pyo`` was breaking Distutils
- bdist_rpm command.
-
-- Issue #5378: added --quiet option to Distutils bdist_rpm command.
-
-- Issue #5052: make Distutils compatible with 2.3 again.
-
-- Issue #5316: Fixed buildbot failures introduced by multiple inheritance
- in Distutils tests.
-
-- Issue #5287: Add exception handling around findCaller() call to help out
- IronPython.
-
-- Issue #5282: Fixed mmap resize on 32bit windows and unix. When offset > 0,
- The file was resized to wrong size.
-
-- Issue #5292: Fixed mmap crash on its boundary access m[len(m)].
-
-- Issue #2279: distutils.sdist.add_defaults now add files
- from the package_data and the data_files metadata.
-
-- Issue #5257: refactored all tests in distutils, so they use
- support.TempdirManager, to avoid writing in the tests directory.
-
-- Issue #4524: distutils build_script command failed with --with-suffix=3.
- Initial patch by Amaury Forgeot d'Arc.
-
-- Issue #2461: added tests for distutils.util
-
-- Issue #4998: The memory saving effect of __slots__ had been lost on Fractions
- which inherited from numbers.py which did not have __slots__ defined. The
- numbers hierarchy now has its own __slots__ declarations.
-
-- Issue #4631: Fix urlopen() result when an HTTP response uses chunked
- encoding.
-
-- Issue #5203: Fixed ctypes segfaults when passing a unicode string to a
- function without argtypes (only occurs if HAVE_USABLE_WCHAR_T is false).
-
-- Issue #3386: distutils.sysconfig.get_python_lib prefix argument was ignored
- under NT and OS2. Patch by Philip Jenvey.
-
-- Issue #5128: Make compileall properly inspect bytecode to determine if needs
- to be recreated. This avoids a timing hole thanks to the old reliance on the
- ctime of the files involved.
-
-- Issue #5122: Synchronize tk load failure check to prevent a potential
- deadlock.
-
-- Issue #1818: collections.namedtuple() now supports a keyword argument
- 'rename' which lets invalid fieldnames be automatically converted to
- positional names in the form, _1, _2, ...
-
-- Issue #4890: Handle empty text search pattern in Tkinter.Text.search.
-
-- Issue #4512 (part 2): Promote ``ZipImporter._get_filename()`` to be a
- public documented method ``ZipImporter.get_filename()``.
-
-- Issue #4195: The ``runpy`` module (and the ``-m`` switch) now support
- the execution of packages by looking for and executing a ``__main__``
- submodule when a package name is supplied. Initial patch by Andi
- Vajda.
-
-- Issue #1731706: Call Tcl_ConditionFinalize for Tcl_Conditions that will
- not be used again (this requires Tcl/Tk 8.3.1), also fix a memory leak in
- Tkapp_Call when calling from a thread different than the one that created
- the Tcl interpreter. Patch by Robert Hancock.
-
-- Issue #4285: Change sys.version_info to be a named tuple. Patch by
- Ross Light.
-
-- Issue #1520877: Now distutils.sysconfig reads $AR from the
- environment/Makefile. Patch by Douglas Greiman.
-
-- Issue #1276768: The verbose option was not used in the code of
- distutils.file_util and distutils.dir_util.
-
-- Issue #5132: Fixed trouble building extensions under Solaris with
- --enabled-shared activated. Initial patch by Dave Peterson.
-
-- Issue #1581476: Always use the Tcl global namespace when calling into Tcl.
-
-- The shelve module now defaults to pickle protocol 3.
-
-- Fix a bug in the trace module where a bytes object from co_lnotab had its
- items being passed through ord().
-
-- Issue #2047: shutil.move() could believe that its destination path was
- inside its source path if it began with the same letters (e.g. "src" vs.
- "src.new").
-
-- Added the ttk module. See issue #2983: Ttk support for Tkinter.
-
-- Removed isSequenceType(), isMappingType, and isNumberType() from the
- operator module; use the abstract base classes instead. Also removed
- the repeat() function; use mul() instead.
-
-- Issue #5021: doctest.testfile() did not create __name__ and
- collections.namedtuple() relied on __name__ being defined.
-
-- Backport importlib from Python 3.1. Only the import_module() function has
- been backported to help facilitate transitions from 2.7 to 3.1.
-
-- Issue #1885: distutils. When running sdist with --formats=tar,gztar
- the tar file was overriden by the gztar one.
-
-- Issue #4863: distutils.mwerkscompiler has been removed.
-
-- Added a new itertools functions: combinations_with_replacement()
- and compress().
-
-- Issue #5032: added a step argument to itertools.count() and
- allowed non-integer arguments.
-
-- Fix and properly document the multiprocessing module's logging
- support, expose the internal levels and provide proper usage
- examples.
-
-- Issue #1672332: fix unpickling of subnormal floats, which was
- producing a ValueError on some platforms.
-
-- Issue #3881: Help Tcl to load even when started through the
- unreadable local symlink to "Program Files" on Vista.
-
-- Issue #4710: Extract directories properly in the zipfile module;
- allow adding directories to a zipfile.
-
-- Issue #3807: _multiprocessing build fails when configure is passed
- --without-threads argument. When this occurs, _multiprocessing will
- be disabled, and not compiled.
-
-- Issue #5008: When a file is opened in append mode with the new IO library,
- do an explicit seek to the end of file (so that e.g. tell() returns the
- file size rather than 0). This is consistent with the behaviour of the
- traditional 2.x file object.
-
-- Issue #5013: Fixed a bug in FileHandler which occurred when the delay
- parameter was set.
-
-- Issue #4842: Always append a trailing 'L' when pickling longs using
- pickle protocol 0. When reading, the 'L' is optional.
-
-- Add the importlib package.
-
-- Issue #4301: Patch the logging module to add processName support, remove
- _check_logger_class from multiprocessing.
-
-- Issue #3325: Remove python2.x try: except: imports for old cPickle from
- multiprocessing.
-
-- Issue #4959: inspect.formatargspec now works for keyword only arguments
- without defaults.
-
-- Issue #3321: ``_multiprocessing.Connection()`` doesn't check handle; added checks
- for Unix machines for negative handles and large int handles. Without this check
- it is possible to segfault the interpreter.
-
-- Issue #4449: AssertionError in mp_benchmarks.py, caused by an underlying issue
- in sharedctypes.py.
-
-- Issue #1225107: inspect.isclass() returned True for instances with a custom
- __getattr__.
-
-- Issue #3826 and #4791: The socket module now closes the underlying socket
- appropriately when it is being used via socket.makefile() objects
- rather than delaying the close by waiting for garbage collection to do it.
-
-- Issue #1696199: Add collections.Counter() for rapid and convenient
- counting.
-
-- Issue #3860: GzipFile and BZ2File now support the context manager protocol.
-
-- Issue #4867: Fixed a crash in ctypes when passing a string to a
- function without defining argtypes.
-
-- Issue #4272: Add an optional argument to the GzipFile constructor to override
- the timestamp in the gzip stream. The default value remains the current time.
- The information can be used by e.g. gunzip when decompressing. Patch by
- Jacques Frechet.
-
-- Restore Python 2.3 compatibility for decimal.py.
-
-- Issue #3638: Remove functions from _tkinter module level that depend on
- TkappObject to work with multiple threads.
-
-- Issue #4718: Adapt the wsgiref package so that it actually works with
- Python 3.x, in accordance with the `official amendments of the spec
- <http://www.wsgi.org/wsgi/Amendments_1.0>`_.
-
-- Issue #4796: Added Decimal.from_float() and Context.create_decimal_from_float()
- to the decimal module.
-
-- Fractions.from_float() no longer loses precision for integers too big to
- cast as floats.
-
-- Issue #4812: add missing underscore prefix to some internal-use-only
- constants in the decimal module. (Dec_0 becomes _Dec_0, etc.)
-
-- Issue #4790: The nsmallest() and nlargest() functions in the heapq module
- did unnecessary work in the common case where no key function was specified.
-
-- Issue #4795: inspect.isgeneratorfunction() returns False instead of None when
- the function is not a generator.
-
-- Issue #4702: Throwing a DistutilsPlatformError instead of IOError in case
- no MSVC compiler is found under Windows. Original patch by Philip Jenvey.
-
-- Issue #4646: distutils was choking on empty options arg in the setup
- function. Original patch by Thomas Heller.
-
-- Issue #3767: Convert Tk object to string in tkColorChooser.
-
-- Issue #3248: Allow placing ScrolledText in a PanedWindow.
-
-- Issue #4444: Allow assertRaises() to be used as a context handler, so that
- the code under test can be written inline if more practical.
-
-- Issue #4739: Add pydoc help topics for symbols, so that e.g. help('@')
- works as expected in the interactive environment.
-
-- Issue #4756: zipfile.is_zipfile() now supports file-like objects. Patch by
- Gabriel Genellina.
-
-- Issue #4574: reading an UTF16-encoded text file crashes if \r on 64-char
- boundary.
-
-- Issue #4223: inspect.getsource() will now correctly display source code
- for packages loaded via zipimport (or any other conformant PEP 302
- loader). Original patch by Alexander Belopolsky.
-
-- Issue #4201: pdb can now access and display source code loaded via
- zipimport (or any other conformant PEP 302 loader). Original patch by
- Alexander Belopolsky.
-
-- Issue #4197: doctests in modules loaded via zipimport (or any other PEP
- 302 conformant loader) will now work correctly in most cases (they
- are still subject to the constraints that exist for all code running
- from inside a module loaded via a PEP 302 loader and attempting to
- perform IO operations based on __file__). Original patch by
- Alexander Belopolsky.
-
-- Issues #4082 and #4512: Add runpy support to zipimport in a manner that
- allows backporting to maintenance branches. Original patch by
- Alexander Belopolsky.
-
-- Issue #4163: textwrap module: allow word splitting on a hyphen preceded by
- a non-ASCII letter.
-
-- Issue #4616: TarFile.utime(): Restore directory times on Windows.
-
-- Issue #4021: tokenize.detect_encoding() now raises a SyntaxError when the
- codec cannot be found. This is for compatibility with the builtin behavior.
-
-- Issue #4084: Fix max, min, max_mag and min_mag Decimal methods to
- give correct results in the case where one argument is a quiet NaN
- and the other is a finite number that requires rounding.
-
-- Issue #4483: _dbm module now builds on systems with gdbm & gdbm_compat
- libs.
-
-- Added the subprocess.check_call_output() convenience function to get output
- from a subprocess on success or raise an exception on error.
-
-- Issue #1055234: cgi.parse_header(): Fixed parsing of header parameters to
- support unusual filenames (such as those containing semi-colons) in
- Content-Disposition headers.
-
-- Issue #4384: Added logging integration with warnings module using
- captureWarnings(). This change includes a NullHandler which does nothing;
- it will be of use to library developers who want to avoid the "No handlers
- could be found for logger XXX" message which can appear if the library user
- doesn't configure logging.
-
-- Issue #3741: DISTUTILS_USE_SDK set causes msvc9compiler.py to raise an
- exception.
-
-- Issue #4529: fix the parser module's validation of try-except-finally
- statements.
-
-- Issue #4458: getopt.gnu_getopt() now recognizes a single "-" as an argument,
- not a malformed option.
-
-- Added the subprocess.check_output() convenience function to get output
- from a subprocess on success or raise an exception on error.
-
-- Issue #4542: On Windows, binascii.crc32 still accepted str as binary input;
- the corresponding tests now pass.
-
-- Issue #4537: webbrowser.UnixBrowser would fail to open the browser because
- it was calling the wrong open() function.
-
-- Issue #1055234: cgi.parse_header(): Fixed parsing of header parameters to
- support unusual filenames (such as those containing semi-colons) in
- Content-Disposition headers.
-
-- Issue #4861: ctypes.util.find_library(): Robustify. Fix library detection on
- biarch systems. Try to rely on ldconfig only, without using objdump and gcc.
-
-- Issue #5104: The socket module now raises OverflowError when 16-bit port and
- protocol numbers are supplied outside the allowed 0-65536 range on bind()
- and getservbyport().
-
-- Windows locale mapping updated to Vista.
-
-Tools/Demos
------------
-
-- Issue #4704: remove use of cmp() in pybench, bump its version number to 2.1,
- and make it 2.6-compatible.
-
-- Ttk demos added in Demo/tkinter/ttk/
-
-- Issue #4677: add two list comprehension tests to pybench.
-
-
-Build
------
-
-- Issue #6094: Build correctly with Subversion 1.7.
-
-- Issue #5847: Remove -n switch on "Edit with IDLE" menu item.
-
-- Issue #5726: Make Modules/ld_so_aix return the actual exit code of the
- linker, rather than always exit successfully. Patch by Floris Bruynooghe.
-
-- Issue #4587: Add configure option --with-dbmliborder=db1:db2:... to specify
- the order that backends for the dbm extension are checked.
-
-- Link the shared python library with $(MODLIBS).
-
-- Issue #5134: Silence compiler warnings when compiling sqlite with VC++.
-
-- Issue #4494: Fix build with Py_NO_ENABLE_SHARED on Windows.
-
-- Issue #4895: Use _strdup on Windows CE.
-
-- Issue #4472: "configure --enable-shared" now works on OSX
-
-- Issues #4728 and #4060: WORDS_BIGEDIAN is now correct in Universal builds.
-
-- Issue #4389: Add icon to the uninstall entry in "add-and-remove-programs".
-
-- Issue #4289: Remove Cancel button from AdvancedDlg.
-
-- Issue #1656675: Register a drop handler for .py* files on Windows.
-
-- Issue #4120: Exclude manifest from extension modules in VS2008.
-
-- Issue #4091: Install pythonxy.dll in system32 again.
-
-- Issue #4018: Disable "for me" installations on Vista.
-
-- Issue #3758: Add ``patchcheck`` build target to .PHONY.
-
-- Issue #4204: Fixed module build errors on FreeBSD 4.
-
-
-C-API
------
-
-- Issue #6624: yArg_ParseTuple with "s" format when parsing argument with
- NUL: Bogus TypeError detail string.
-
-- Issue #5175: PyLong_AsUnsignedLongLong now raises OverflowError
- for negative arguments. Previously, it raised TypeError.
-
-- Issue #4720: The format for PyArg_ParseTupleAndKeywords can begin with '|'.
-
-- Issue #3632: from the gdb debugger, the 'pyo' macro can now be called when
- the GIL is released, or owned by another thread.
-
-- Issue #4122: On Windows, fix a compilation error when using the
- Py_UNICODE_ISSPACE macro in an extension module.
-
-
-Extension Modules
------------------
-
-- Issue #3745: Fix hashlib to always reject unicode and non buffer-api
- supporting objects as input no matter how it was compiled (built in
- implementations or external openssl library).
-
-- Issue #4397: Fix occasional test_socket failure on OS X.
-
-- Issue #4279: Fix build of parsermodule under Cygwin.
-
-- Issue #4751: hashlib now releases the GIL when hashing large buffers
- (with a hardwired threshold of 2048 bytes), allowing better parallelization
- on multi-CPU systems. Contributed by Lukas Lueg (ebfe) and Victor Stinner.
-
-- Issue #4051: Prevent conflict of UNICODE macros in cPickle.
-
-- Issue #4738: Each zlib object now has a separate lock, allowing to compress
- or decompress several streams at once on multi-CPU systems. Also, the GIL
- is now released when computing the CRC of a large buffer. Patch by ebfe.
-
-- Issue #4228: Pack negative values the same way as 2.4 in struct's L format.
-
-- Issue #1040026: Fix os.times result on systems where HZ is incorrect.
-
-- Issues #3167, #3682: Fix test_math failures for log, log10 on Solaris,
- OpenBSD.
-
-- Issue #4583: array.array would not always prohibit resizing when a buffer
- has been exported, resulting in an interpreter crash when accessing the
- buffer.
-
-
-- Issue #5228: Make functools.partial objects can now be pickled.
-
-Tests
------
-
-- Issue #6152: New option '-j'/'--multiprocess' for regrtest allows running
- regression tests in parallel, shortening the total runtime.
-
-- Issue #5450: Moved tests involving loading tk from Lib/test/test_tcl to
- Lib/tkinter/test/test_tkinter/test_loadtk. With this, these tests demonstrate
- the same behaviour as test_ttkguionly (and now also test_tk) which is to
- skip the tests if DISPLAY is defined but can't be used.
-
-- regrtest no longer treats ImportError as equivalent to SkipTest. Imports
- that should cause a test to be skipped are now done using import_module
- from test support, which does the conversion.
-
-- Issue #5083: New 'gui' resource for regrtest.
-
-
-Docs
-----
-
-
**(For information about older versions, consult the HISTORY file.)**
diff --git a/Modules/_codecsmodule.c b/Modules/_codecsmodule.c
--- a/Modules/_codecsmodule.c
+++ b/Modules/_codecsmodule.c
@@ -177,12 +177,12 @@
return NULL;
size = PyBytes_GET_SIZE(str);
- newsize = 4*size;
- if (newsize > PY_SSIZE_T_MAX || newsize / 4 != size) {
+ if (size > PY_SSIZE_T_MAX / 4) {
PyErr_SetString(PyExc_OverflowError,
"string is too large to encode");
return NULL;
}
+ newsize = 4*size;
v = PyBytes_FromStringAndSize(NULL, newsize);
if (v == NULL) {
diff --git a/Modules/_datetimemodule.c b/Modules/_datetimemodule.c
--- a/Modules/_datetimemodule.c
+++ b/Modules/_datetimemodule.c
@@ -1265,14 +1265,13 @@
assert(ptoappend != NULL);
assert(ntoappend > 0);
while (usednew + ntoappend > totalnew) {
- size_t bigger = totalnew << 1;
- if ((bigger >> 1) != totalnew) { /* overflow */
+ if (totalnew > (PY_SSIZE_T_MAX >> 1)) { /* overflow */
PyErr_NoMemory();
goto Done;
}
- if (_PyBytes_Resize(&newfmt, bigger) < 0)
+ totalnew <<= 1;
+ if (_PyBytes_Resize(&newfmt, totalnew) < 0)
goto Done;
- totalnew = bigger;
pnew = PyBytes_AsString(newfmt) + usednew;
}
memcpy(pnew, ptoappend, ntoappend);
diff --git a/Modules/_decimal/libmpdec/typearith.h b/Modules/_decimal/libmpdec/typearith.h
--- a/Modules/_decimal/libmpdec/typearith.h
+++ b/Modules/_decimal/libmpdec/typearith.h
@@ -207,10 +207,10 @@
{
mpd_uint_t h, l;
- asm ( "mulq %3\n\t"
- : "=d" (h), "=a" (l)
- : "%a" (a), "rm" (b)
- : "cc"
+ __asm__ ( "mulq %3\n\t"
+ : "=d" (h), "=a" (l)
+ : "%a" (a), "rm" (b)
+ : "cc"
);
*hi = h;
@@ -223,10 +223,10 @@
{
mpd_uint_t qq, rr;
- asm ( "divq %4\n\t"
- : "=a" (qq), "=d" (rr)
- : "a" (lo), "d" (hi), "rm" (d)
- : "cc"
+ __asm__ ( "divq %4\n\t"
+ : "=a" (qq), "=d" (rr)
+ : "a" (lo), "d" (hi), "rm" (d)
+ : "cc"
);
*q = qq;
@@ -464,10 +464,10 @@
{
mpd_uint_t h, l;
- asm ( "mull %3\n\t"
- : "=d" (h), "=a" (l)
- : "%a" (a), "rm" (b)
- : "cc"
+ __asm__ ( "mull %3\n\t"
+ : "=d" (h), "=a" (l)
+ : "%a" (a), "rm" (b)
+ : "cc"
);
*hi = h;
@@ -480,10 +480,10 @@
{
mpd_uint_t qq, rr;
- asm ( "divl %4\n\t"
- : "=a" (qq), "=d" (rr)
- : "a" (lo), "d" (hi), "rm" (d)
- : "cc"
+ __asm__ ( "divl %4\n\t"
+ : "=a" (qq), "=d" (rr)
+ : "a" (lo), "d" (hi), "rm" (d)
+ : "cc"
);
*q = qq;
diff --git a/Modules/_decimal/libmpdec/umodarith.h b/Modules/_decimal/libmpdec/umodarith.h
--- a/Modules/_decimal/libmpdec/umodarith.h
+++ b/Modules/_decimal/libmpdec/umodarith.h
@@ -402,22 +402,22 @@
{
mpd_uint_t retval;
- asm (
- "fildl %2\n\t"
- "fildl %1\n\t"
- "fmulp %%st, %%st(1)\n\t"
- "fldt (%4)\n\t"
- "fmul %%st(1), %%st\n\t"
- "flds %5\n\t"
- "fadd %%st, %%st(1)\n\t"
- "fsubrp %%st, %%st(1)\n\t"
- "fldl (%3)\n\t"
- "fmulp %%st, %%st(1)\n\t"
- "fsubrp %%st, %%st(1)\n\t"
- "fistpl %0\n\t"
- : "=m" (retval)
- : "m" (a), "m" (b), "r" (dmod), "r" (dinvmod), "m" (MPD_TWO63)
- : "st", "memory"
+ __asm__ (
+ "fildl %2\n\t"
+ "fildl %1\n\t"
+ "fmulp %%st, %%st(1)\n\t"
+ "fldt (%4)\n\t"
+ "fmul %%st(1), %%st\n\t"
+ "flds %5\n\t"
+ "fadd %%st, %%st(1)\n\t"
+ "fsubrp %%st, %%st(1)\n\t"
+ "fldl (%3)\n\t"
+ "fmulp %%st, %%st(1)\n\t"
+ "fsubrp %%st, %%st(1)\n\t"
+ "fistpl %0\n\t"
+ : "=m" (retval)
+ : "m" (a), "m" (b), "r" (dmod), "r" (dinvmod), "m" (MPD_TWO63)
+ : "st", "memory"
);
return retval;
@@ -432,33 +432,33 @@
ppro_mulmod2c(mpd_uint_t *a0, mpd_uint_t *a1, mpd_uint_t w,
double *dmod, uint32_t *dinvmod)
{
- asm (
- "fildl %2\n\t"
- "fildl (%1)\n\t"
- "fmul %%st(1), %%st\n\t"
- "fxch %%st(1)\n\t"
- "fildl (%0)\n\t"
- "fmulp %%st, %%st(1) \n\t"
- "fldt (%4)\n\t"
- "flds %5\n\t"
- "fld %%st(2)\n\t"
- "fmul %%st(2)\n\t"
- "fadd %%st(1)\n\t"
- "fsub %%st(1)\n\t"
- "fmull (%3)\n\t"
- "fsubrp %%st, %%st(3)\n\t"
- "fxch %%st(2)\n\t"
- "fistpl (%0)\n\t"
- "fmul %%st(2)\n\t"
- "fadd %%st(1)\n\t"
- "fsubp %%st, %%st(1)\n\t"
- "fmull (%3)\n\t"
- "fsubrp %%st, %%st(1)\n\t"
- "fistpl (%1)\n\t"
- : : "r" (a0), "r" (a1), "m" (w),
- "r" (dmod), "r" (dinvmod),
- "m" (MPD_TWO63)
- : "st", "memory"
+ __asm__ (
+ "fildl %2\n\t"
+ "fildl (%1)\n\t"
+ "fmul %%st(1), %%st\n\t"
+ "fxch %%st(1)\n\t"
+ "fildl (%0)\n\t"
+ "fmulp %%st, %%st(1) \n\t"
+ "fldt (%4)\n\t"
+ "flds %5\n\t"
+ "fld %%st(2)\n\t"
+ "fmul %%st(2)\n\t"
+ "fadd %%st(1)\n\t"
+ "fsub %%st(1)\n\t"
+ "fmull (%3)\n\t"
+ "fsubrp %%st, %%st(3)\n\t"
+ "fxch %%st(2)\n\t"
+ "fistpl (%0)\n\t"
+ "fmul %%st(2)\n\t"
+ "fadd %%st(1)\n\t"
+ "fsubp %%st, %%st(1)\n\t"
+ "fmull (%3)\n\t"
+ "fsubrp %%st, %%st(1)\n\t"
+ "fistpl (%1)\n\t"
+ : : "r" (a0), "r" (a1), "m" (w),
+ "r" (dmod), "r" (dinvmod),
+ "m" (MPD_TWO63)
+ : "st", "memory"
);
}
@@ -471,41 +471,41 @@
ppro_mulmod2(mpd_uint_t *a0, mpd_uint_t b0, mpd_uint_t *a1, mpd_uint_t b1,
double *dmod, uint32_t *dinvmod)
{
- asm (
- "fildl %3\n\t"
- "fildl (%2)\n\t"
- "fmulp %%st, %%st(1)\n\t"
- "fildl %1\n\t"
- "fildl (%0)\n\t"
- "fmulp %%st, %%st(1)\n\t"
- "fldt (%5)\n\t"
- "fld %%st(2)\n\t"
- "fmul %%st(1), %%st\n\t"
- "fxch %%st(1)\n\t"
- "fmul %%st(2), %%st\n\t"
- "flds %6\n\t"
- "fldl (%4)\n\t"
- "fxch %%st(3)\n\t"
- "fadd %%st(1), %%st\n\t"
- "fxch %%st(2)\n\t"
- "fadd %%st(1), %%st\n\t"
- "fxch %%st(2)\n\t"
- "fsub %%st(1), %%st\n\t"
- "fxch %%st(2)\n\t"
- "fsubp %%st, %%st(1)\n\t"
- "fxch %%st(1)\n\t"
- "fmul %%st(2), %%st\n\t"
- "fxch %%st(1)\n\t"
- "fmulp %%st, %%st(2)\n\t"
- "fsubrp %%st, %%st(3)\n\t"
- "fsubrp %%st, %%st(1)\n\t"
- "fxch %%st(1)\n\t"
- "fistpl (%2)\n\t"
- "fistpl (%0)\n\t"
- : : "r" (a0), "m" (b0), "r" (a1), "m" (b1),
- "r" (dmod), "r" (dinvmod),
- "m" (MPD_TWO63)
- : "st", "memory"
+ __asm__ (
+ "fildl %3\n\t"
+ "fildl (%2)\n\t"
+ "fmulp %%st, %%st(1)\n\t"
+ "fildl %1\n\t"
+ "fildl (%0)\n\t"
+ "fmulp %%st, %%st(1)\n\t"
+ "fldt (%5)\n\t"
+ "fld %%st(2)\n\t"
+ "fmul %%st(1), %%st\n\t"
+ "fxch %%st(1)\n\t"
+ "fmul %%st(2), %%st\n\t"
+ "flds %6\n\t"
+ "fldl (%4)\n\t"
+ "fxch %%st(3)\n\t"
+ "fadd %%st(1), %%st\n\t"
+ "fxch %%st(2)\n\t"
+ "fadd %%st(1), %%st\n\t"
+ "fxch %%st(2)\n\t"
+ "fsub %%st(1), %%st\n\t"
+ "fxch %%st(2)\n\t"
+ "fsubp %%st, %%st(1)\n\t"
+ "fxch %%st(1)\n\t"
+ "fmul %%st(2), %%st\n\t"
+ "fxch %%st(1)\n\t"
+ "fmulp %%st, %%st(2)\n\t"
+ "fsubrp %%st, %%st(3)\n\t"
+ "fsubrp %%st, %%st(1)\n\t"
+ "fxch %%st(1)\n\t"
+ "fistpl (%2)\n\t"
+ "fistpl (%0)\n\t"
+ : : "r" (a0), "m" (b0), "r" (a1), "m" (b1),
+ "r" (dmod), "r" (dinvmod),
+ "m" (MPD_TWO63)
+ : "st", "memory"
);
}
/* END PPRO GCC ASM */
diff --git a/Modules/_decimal/tests/bench.py b/Modules/_decimal/tests/bench.py
--- a/Modules/_decimal/tests/bench.py
+++ b/Modules/_decimal/tests/bench.py
@@ -18,8 +18,13 @@
C = import_fresh_module('decimal', fresh=['_decimal'])
P = import_fresh_module('decimal', blocked=['_decimal'])
-
-# Pi function from the decimal.py documentation
+#
+# NOTE: This is the pi function from the decimal documentation, modified
+# for benchmarking purposes. Since floats do not have a context, the higher
+# intermediate precision from the original is NOT used, so the modified
+# algorithm only gives an approximation to the correctly rounded result.
+# For serious use, refer to the documentation or the appropriate literature.
+#
def pi_float():
"""native float"""
lasts, t, s, n, na, d, da = 0, 3.0, 3, 1, 0, 0, 24
diff --git a/Modules/_elementtree.c b/Modules/_elementtree.c
--- a/Modules/_elementtree.c
+++ b/Modules/_elementtree.c
@@ -123,17 +123,11 @@
return NULL;
}
- args = PyTuple_New(2);
+ args = PyTuple_Pack(2, object, memo);
if (!args)
return NULL;
-
- Py_INCREF(object); PyTuple_SET_ITEM(args, 0, (PyObject*) object);
- Py_INCREF(memo); PyTuple_SET_ITEM(args, 1, (PyObject*) memo);
-
result = PyObject_CallObject(elementtree_deepcopy_obj, args);
-
Py_DECREF(args);
-
return result;
}
@@ -141,48 +135,16 @@
list_join(PyObject* list)
{
/* join list elements (destroying the list in the process) */
-
PyObject* joiner;
- PyObject* function;
- PyObject* args;
PyObject* result;
- switch (PyList_GET_SIZE(list)) {
- case 0:
- Py_DECREF(list);
- return PyBytes_FromString("");
- case 1:
- result = PyList_GET_ITEM(list, 0);
- Py_INCREF(result);
- Py_DECREF(list);
- return result;
- }
-
- /* two or more elements: slice out a suitable separator from the
- first member, and use that to join the entire list */
-
- joiner = PySequence_GetSlice(PyList_GET_ITEM(list, 0), 0, 0);
+ joiner = PyUnicode_FromStringAndSize("", 0);
if (!joiner)
return NULL;
-
- function = PyObject_GetAttrString(joiner, "join");
- if (!function) {
- Py_DECREF(joiner);
- return NULL;
- }
-
- args = PyTuple_New(1);
- if (!args)
- return NULL;
-
- PyTuple_SET_ITEM(args, 0, list);
-
- result = PyObject_CallObject(function, args);
-
- Py_DECREF(args); /* also removes list */
- Py_DECREF(function);
+ result = PyUnicode_Join(joiner, list);
Py_DECREF(joiner);
-
+ if (result)
+ Py_DECREF(list);
return result;
}
@@ -399,6 +361,7 @@
return -1;
if (kwds) {
if (PyDict_Update(attrib, kwds) < 0) {
+ Py_DECREF(attrib);
return -1;
}
}
@@ -407,38 +370,34 @@
attrib = get_attrib_from_keywords(kwds);
if (!attrib)
return -1;
- } else {
- /* no attrib arg, no kwds, so no attributes */
- Py_INCREF(Py_None);
- attrib = Py_None;
}
self_elem = (ElementObject *)self;
- if (attrib != Py_None && !is_empty_dict(attrib)) {
+ if (attrib != NULL && !is_empty_dict(attrib)) {
if (create_extra(self_elem, attrib) < 0) {
- PyObject_Del(self_elem);
+ Py_DECREF(attrib);
return -1;
}
}
/* We own a reference to attrib here and it's no longer needed. */
- Py_DECREF(attrib);
+ Py_XDECREF(attrib);
/* Replace the objects already pointed to by tag, text and tail. */
tmp = self_elem->tag;
+ Py_INCREF(tag);
self_elem->tag = tag;
- Py_INCREF(tag);
Py_DECREF(tmp);
tmp = self_elem->text;
+ Py_INCREF(Py_None);
self_elem->text = Py_None;
+ Py_DECREF(JOIN_OBJ(tmp));
+
+ tmp = self_elem->tail;
Py_INCREF(Py_None);
- Py_DECREF(JOIN_OBJ(tmp));
-
- tmp = self_elem->tail;
self_elem->tail = Py_None;
- Py_INCREF(Py_None);
Py_DECREF(JOIN_OBJ(tmp));
return 0;
@@ -520,11 +479,11 @@
PyObject* res = self->extra->attrib;
if (res == Py_None) {
- Py_DECREF(res);
/* create missing dictionary */
res = PyDict_New();
if (!res)
return NULL;
+ Py_DECREF(Py_None);
self->extra->attrib = res;
}
@@ -824,7 +783,7 @@
}
/* add object to memo dictionary (so deepcopy won't visit it again) */
- id = PyLong_FromLong((Py_uintptr_t) self);
+ id = PyLong_FromSsize_t((Py_uintptr_t) self);
if (!id)
goto error;
@@ -2038,8 +1997,8 @@
PyObject *root; /* root node (first created node) */
- ElementObject *this; /* current node */
- ElementObject *last; /* most recently created node */
+ PyObject *this; /* current node */
+ PyObject *last; /* most recently created node */
PyObject *data; /* data collector (string or list), or NULL */
@@ -2071,9 +2030,9 @@
t->root = NULL;
Py_INCREF(Py_None);
- t->this = (ElementObject *)Py_None;
+ t->this = Py_None;
Py_INCREF(Py_None);
- t->last = (ElementObject *)Py_None;
+ t->last = Py_None;
t->data = NULL;
t->element_factory = NULL;
@@ -2081,6 +2040,7 @@
if (!t->stack) {
Py_DECREF(t->this);
Py_DECREF(t->last);
+ Py_DECREF((PyObject *) t);
return NULL;
}
t->index = 0;
@@ -2098,6 +2058,7 @@
static char *kwlist[] = {"element_factory", 0};
PyObject *element_factory = NULL;
TreeBuilderObject *self_tb = (TreeBuilderObject *)self;
+ PyObject *tmp;
if (!PyArg_ParseTupleAndKeywords(args, kwds, "|O:TreeBuilder", kwlist,
&element_factory)) {
@@ -2106,8 +2067,9 @@
if (element_factory) {
Py_INCREF(element_factory);
- Py_XDECREF(self_tb->element_factory);
+ tmp = self_tb->element_factory;
self_tb->element_factory = element_factory;
+ Py_XDECREF(tmp);
}
return 0;
@@ -2128,17 +2090,17 @@
static int
treebuilder_gc_clear(TreeBuilderObject *self)
{
- Py_XDECREF(self->end_ns_event_obj);
- Py_XDECREF(self->start_ns_event_obj);
- Py_XDECREF(self->end_event_obj);
- Py_XDECREF(self->start_event_obj);
- Py_XDECREF(self->events);
- Py_DECREF(self->stack);
- Py_XDECREF(self->data);
- Py_DECREF(self->last);
- Py_DECREF(self->this);
+ Py_CLEAR(self->end_ns_event_obj);
+ Py_CLEAR(self->start_ns_event_obj);
+ Py_CLEAR(self->end_event_obj);
+ Py_CLEAR(self->start_event_obj);
+ Py_CLEAR(self->events);
+ Py_CLEAR(self->stack);
+ Py_CLEAR(self->data);
+ Py_CLEAR(self->last);
+ Py_CLEAR(self->this);
Py_CLEAR(self->element_factory);
- Py_XDECREF(self->root);
+ Py_CLEAR(self->root);
return 0;
}
@@ -2151,6 +2113,64 @@
}
/* -------------------------------------------------------------------- */
+/* helpers for handling of arbitrary element-like objects */
+
+static int
+treebuilder_set_element_text_or_tail(PyObject *element, PyObject *data,
+ PyObject **dest, _Py_Identifier *name)
+{
+ if (Element_CheckExact(element)) {
+ Py_DECREF(JOIN_OBJ(*dest));
+ *dest = JOIN_SET(data, PyList_CheckExact(data));
+ return 0;
+ }
+ else {
+ PyObject *joined = list_join(data);
+ int r;
+ if (joined == NULL)
+ return -1;
+ r = _PyObject_SetAttrId(element, name, joined);
+ Py_DECREF(joined);
+ return r;
+ }
+}
+
+/* These two functions steal a reference to data */
+static int
+treebuilder_set_element_text(PyObject *element, PyObject *data)
+{
+ _Py_IDENTIFIER(text);
+ return treebuilder_set_element_text_or_tail(
+ element, data, &((ElementObject *) element)->text, &PyId_text);
+}
+
+static int
+treebuilder_set_element_tail(PyObject *element, PyObject *data)
+{
+ _Py_IDENTIFIER(tail);
+ return treebuilder_set_element_text_or_tail(
+ element, data, &((ElementObject *) element)->tail, &PyId_tail);
+}
+
+static int
+treebuilder_add_subelement(PyObject *element, PyObject *child)
+{
+ _Py_IDENTIFIER(append);
+ if (Element_CheckExact(element)) {
+ ElementObject *elem = (ElementObject *) element;
+ return element_add_subelement(elem, child);
+ }
+ else {
+ PyObject *res;
+ res = _PyObject_CallMethodId(element, &PyId_append, "O", child);
+ if (res == NULL)
+ return -1;
+ Py_DECREF(res);
+ return 0;
+ }
+}
+
+/* -------------------------------------------------------------------- */
/* handlers */
LOCAL(PyObject*)
@@ -2162,15 +2182,12 @@
if (self->data) {
if (self->this == self->last) {
- Py_DECREF(JOIN_OBJ(self->last->text));
- self->last->text = JOIN_SET(
- self->data, PyList_CheckExact(self->data)
- );
- } else {
- Py_DECREF(JOIN_OBJ(self->last->tail));
- self->last->tail = JOIN_SET(
- self->data, PyList_CheckExact(self->data)
- );
+ if (treebuilder_set_element_text(self->last, self->data))
+ return NULL;
+ }
+ else {
+ if (treebuilder_set_element_tail(self->last, self->data))
+ return NULL;
}
self->data = NULL;
}
@@ -2184,10 +2201,10 @@
return NULL;
}
- this = (PyObject*) self->this;
+ this = self->this;
if (this != Py_None) {
- if (element_add_subelement((ElementObject*) this, node) < 0)
+ if (treebuilder_add_subelement(this, node) < 0)
goto error;
} else {
if (self->root) {
@@ -2213,19 +2230,17 @@
Py_DECREF(this);
Py_INCREF(node);
- self->this = (ElementObject*) node;
+ self->this = node;
Py_DECREF(self->last);
Py_INCREF(node);
- self->last = (ElementObject*) node;
+ self->last = node;
if (self->start_event_obj) {
PyObject* res;
PyObject* action = self->start_event_obj;
- res = PyTuple_New(2);
+ res = PyTuple_Pack(2, action, node);
if (res) {
- Py_INCREF(action); PyTuple_SET_ITEM(res, 0, (PyObject*) action);
- Py_INCREF(node); PyTuple_SET_ITEM(res, 1, (PyObject*) node);
PyList_Append(self->events, res);
Py_DECREF(res);
} else
@@ -2243,7 +2258,7 @@
treebuilder_handle_data(TreeBuilderObject* self, PyObject* data)
{
if (!self->data) {
- if (self->last == (ElementObject*) Py_None) {
+ if (self->last == Py_None) {
/* ignore calls to data before the first call to start */
Py_RETURN_NONE;
}
@@ -2253,6 +2268,7 @@
/* more than one item; use a list to collect items */
if (PyBytes_CheckExact(self->data) && Py_REFCNT(self->data) == 1 &&
PyBytes_CheckExact(data) && PyBytes_GET_SIZE(data) == 1) {
+ /* XXX this code path unused in Python 3? */
/* expat often generates single character data sections; handle
the most common case by resizing the existing string... */
Py_ssize_t size = PyBytes_GET_SIZE(self->data);
@@ -2282,15 +2298,11 @@
if (self->data) {
if (self->this == self->last) {
- Py_DECREF(JOIN_OBJ(self->last->text));
- self->last->text = JOIN_SET(
- self->data, PyList_CheckExact(self->data)
- );
+ if (treebuilder_set_element_text(self->last, self->data))
+ return NULL;
} else {
- Py_DECREF(JOIN_OBJ(self->last->tail));
- self->last->tail = JOIN_SET(
- self->data, PyList_CheckExact(self->data)
- );
+ if (treebuilder_set_element_tail(self->last, self->data))
+ return NULL;
}
self->data = NULL;
}
@@ -2310,17 +2322,15 @@
Py_DECREF(self->last);
- self->last = (ElementObject*) self->this;
- self->this = (ElementObject*) item;
+ self->last = self->this;
+ self->this = item;
if (self->end_event_obj) {
PyObject* res;
PyObject* action = self->end_event_obj;
PyObject* node = (PyObject*) self->last;
- res = PyTuple_New(2);
+ res = PyTuple_Pack(2, action, node);
if (res) {
- Py_INCREF(action); PyTuple_SET_ITEM(res, 0, (PyObject*) action);
- Py_INCREF(node); PyTuple_SET_ITEM(res, 1, (PyObject*) node);
PyList_Append(self->events, res);
Py_DECREF(res);
} else
@@ -2366,8 +2376,12 @@
PyTuple_SET_ITEM(res, 1, parcel);
PyList_Append(self->events, res);
Py_DECREF(res);
- } else
+ }
+ else {
+ Py_DECREF(action);
+ Py_DECREF(parcel);
PyErr_Clear(); /* FIXME: propagate error */
+ }
}
/* -------------------------------------------------------------------- */
@@ -2526,7 +2540,7 @@
/* convert a UTF-8 tag/attribute name from the expat parser
to a universal name string */
- int size = strlen(string);
+ Py_ssize_t size = (Py_ssize_t) strlen(string);
PyObject* key;
PyObject* value;
@@ -2545,7 +2559,7 @@
PyObject* tag;
char* p;
- int i;
+ Py_ssize_t i;
/* look for namespace separator */
for (i = 0; i < size; i++)
@@ -2717,13 +2731,7 @@
attrib_in += 2;
}
} else {
- Py_INCREF(Py_None);
- attrib = Py_None;
- }
-
- /* If we get None, pass an empty dictionary on */
- if (attrib == Py_None) {
- Py_DECREF(attrib);
+ /* Pass an empty dictionary on */
attrib = PyDict_New();
if (!attrib)
return;
@@ -3015,14 +3023,14 @@
self_xp->names = PyDict_New();
if (!self_xp->names) {
- Py_XDECREF(self_xp->entity);
+ Py_CLEAR(self_xp->entity);
return -1;
}
self_xp->parser = EXPAT(ParserCreate_MM)(encoding, &ExpatMemoryHandler, "}");
if (!self_xp->parser) {
- Py_XDECREF(self_xp->entity);
- Py_XDECREF(self_xp->names);
+ Py_CLEAR(self_xp->entity);
+ Py_CLEAR(self_xp->names);
PyErr_NoMemory();
return -1;
}
@@ -3032,8 +3040,8 @@
} else {
target = treebuilder_new(&TreeBuilder_Type, NULL, NULL);
if (!target) {
- Py_XDECREF(self_xp->entity);
- Py_XDECREF(self_xp->names);
+ Py_CLEAR(self_xp->entity);
+ Py_CLEAR(self_xp->names);
EXPAT(ParserFree)(self_xp->parser);
return -1;
}
@@ -3109,17 +3117,17 @@
{
EXPAT(ParserFree)(self->parser);
- Py_XDECREF(self->handle_close);
- Py_XDECREF(self->handle_pi);
- Py_XDECREF(self->handle_comment);
- Py_XDECREF(self->handle_end);
- Py_XDECREF(self->handle_data);
- Py_XDECREF(self->handle_start);
- Py_XDECREF(self->handle_doctype);
-
- Py_XDECREF(self->target);
- Py_XDECREF(self->entity);
- Py_XDECREF(self->names);
+ Py_CLEAR(self->handle_close);
+ Py_CLEAR(self->handle_pi);
+ Py_CLEAR(self->handle_comment);
+ Py_CLEAR(self->handle_end);
+ Py_CLEAR(self->handle_data);
+ Py_CLEAR(self->handle_start);
+ Py_CLEAR(self->handle_doctype);
+
+ Py_CLEAR(self->target);
+ Py_CLEAR(self->entity);
+ Py_CLEAR(self->names);
return 0;
}
@@ -3227,17 +3235,12 @@
break;
}
temp = PyUnicode_AsEncodedString(buffer, "utf-8", "surrogatepass");
+ Py_DECREF(buffer);
if (!temp) {
/* Propagate exception from PyUnicode_AsEncodedString */
- Py_DECREF(buffer);
Py_DECREF(reader);
return NULL;
}
-
- /* Here we no longer need the original buffer since it contains
- * unicode. Make it point to the encoded bytes object.
- */
- Py_DECREF(buffer);
buffer = temp;
}
else if (!PyBytes_CheckExact(buffer) || PyBytes_GET_SIZE(buffer) == 0) {
@@ -3307,10 +3310,10 @@
target->events = events;
/* clear out existing events */
- Py_XDECREF(target->start_event_obj); target->start_event_obj = NULL;
- Py_XDECREF(target->end_event_obj); target->end_event_obj = NULL;
- Py_XDECREF(target->start_ns_event_obj); target->start_ns_event_obj = NULL;
- Py_XDECREF(target->end_ns_event_obj); target->end_ns_event_obj = NULL;
+ Py_CLEAR(target->start_event_obj);
+ Py_CLEAR(target->end_event_obj);
+ Py_CLEAR(target->start_ns_event_obj);
+ Py_CLEAR(target->end_ns_event_obj);
if (event_set == Py_None) {
/* default is "end" only */
diff --git a/Modules/_randommodule.c b/Modules/_randommodule.c
--- a/Modules/_randommodule.c
+++ b/Modules/_randommodule.c
@@ -284,7 +284,8 @@
n = newn;
if (keyused >= keymax) {
unsigned long bigger = keymax << 1;
- if ((bigger >> 1) != keymax) {
+ if ((bigger >> 1) != keymax ||
+ bigger > PY_SSIZE_T_MAX / sizeof(*key)) {
PyErr_NoMemory();
goto Done;
}
diff --git a/Modules/_testcapimodule.c b/Modules/_testcapimodule.c
--- a/Modules/_testcapimodule.c
+++ b/Modules/_testcapimodule.c
@@ -1238,7 +1238,7 @@
o = PySequence_Fast_GET_ITEM(sub_keywords, i);
if (!PyUnicode_FSConverter(o, (void *)(converted + i))) {
PyErr_Format(PyExc_ValueError,
- "parse_tuple_and_keywords: could not convert keywords[%s] to narrow string", i);
+ "parse_tuple_and_keywords: could not convert keywords[%zd] to narrow string", i);
goto exit;
}
keywords[i] = PyBytes_AS_STRING(converted[i]);
diff --git a/Modules/arraymodule.c b/Modules/arraymodule.c
--- a/Modules/arraymodule.c
+++ b/Modules/arraymodule.c
@@ -483,11 +483,11 @@
return NULL;
}
- nbytes = size * descr->itemsize;
/* Check for overflow */
- if (nbytes / descr->itemsize != (size_t)size) {
+ if (size > PY_SSIZE_T_MAX / descr->itemsize) {
return PyErr_NoMemory();
}
+ nbytes = size * descr->itemsize;
op = (arrayobject *) type->tp_alloc(type, 0);
if (op == NULL) {
return NULL;
@@ -1251,11 +1251,15 @@
if (!PyArg_ParseTuple(args, "On:fromfile", &f, &n))
return NULL;
- nbytes = n * itemsize;
- if (nbytes < 0 || nbytes/itemsize != n) {
+ if (n < 0) {
+ PyErr_SetString(PyExc_ValueError, "negative count");
+ return NULL;
+ }
+ if (n > PY_SSIZE_T_MAX / itemsize) {
PyErr_NoMemory();
return NULL;
}
+ nbytes = n * itemsize;
b = _PyObject_CallMethodId(f, &PyId_read, "n", nbytes);
if (b == NULL)
diff --git a/Modules/audioop.c b/Modules/audioop.c
--- a/Modules/audioop.c
+++ b/Modules/audioop.c
@@ -1108,8 +1108,7 @@
PyErr_SetString(AudioopError, "# of channels should be >= 1");
return NULL;
}
- bytes_per_frame = size * nchannels;
- if (bytes_per_frame / nchannels != size) {
+ if (size > INT_MAX / nchannels) {
/* This overflow test is rigorously correct because
both multiplicands are >= 1. Use the argument names
from the docs for the error msg. */
@@ -1117,6 +1116,7 @@
"width * nchannels too big for a C int");
return NULL;
}
+ bytes_per_frame = size * nchannels;
if (weightA < 1 || weightB < 0) {
PyErr_SetString(AudioopError,
"weightA should be >= 1, weightB should be >= 0");
diff --git a/Modules/zipimport.c b/Modules/zipimport.c
--- a/Modules/zipimport.c
+++ b/Modules/zipimport.c
@@ -875,7 +875,12 @@
PyErr_Format(ZipImportError, "can't open Zip file: %R", archive);
return NULL;
}
- fseek(fp, -22, SEEK_END);
+
+ if (fseek(fp, -22, SEEK_END) == -1) {
+ fclose(fp);
+ PyErr_Format(ZipImportError, "can't read Zip file: %R", archive);
+ return NULL;
+ }
header_position = ftell(fp);
if (fread(endof_central_dir, 1, 22, fp) != 22) {
fclose(fp);
@@ -904,11 +909,13 @@
PyObject *t;
int err;
- fseek(fp, header_offset, 0); /* Start of file header */
+ if (fseek(fp, header_offset, 0) == -1) /* Start of file header */
+ goto fseek_error;
l = PyMarshal_ReadLongFromFile(fp);
if (l != 0x02014B50)
break; /* Bad: Central Dir File Header */
- fseek(fp, header_offset + 8, 0);
+ if (fseek(fp, header_offset + 8, 0) == -1)
+ goto fseek_error;
flags = (unsigned short)PyMarshal_ReadShortFromFile(fp);
compress = PyMarshal_ReadShortFromFile(fp);
time = PyMarshal_ReadShortFromFile(fp);
@@ -920,7 +927,8 @@
header_size = 46 + name_size +
PyMarshal_ReadShortFromFile(fp) +
PyMarshal_ReadShortFromFile(fp);
- fseek(fp, header_offset + 42, 0);
+ if (fseek(fp, header_offset + 42, 0) == -1)
+ goto fseek_error;
file_offset = PyMarshal_ReadLongFromFile(fp) + arc_offset;
if (name_size > MAXPATHLEN)
name_size = MAXPATHLEN;
@@ -980,6 +988,12 @@
PySys_FormatStderr("# zipimport: found %ld names in %R\n",
count, archive);
return files;
+fseek_error:
+ fclose(fp);
+ Py_XDECREF(files);
+ Py_XDECREF(nameobj);
+ PyErr_Format(ZipImportError, "can't read Zip file: %R", archive);
+ return NULL;
error:
fclose(fp);
Py_XDECREF(files);
@@ -1050,7 +1064,12 @@
}
/* Check to make sure the local file header is correct */
- fseek(fp, file_offset, 0);
+ if (fseek(fp, file_offset, 0) == -1) {
+ fclose(fp);
+ PyErr_Format(ZipImportError, "can't read Zip file: %R", archive);
+ return NULL;
+ }
+
l = PyMarshal_ReadLongFromFile(fp);
if (l != 0x04034B50) {
/* Bad: Local File Header */
@@ -1060,7 +1079,12 @@
fclose(fp);
return NULL;
}
- fseek(fp, file_offset + 26, 0);
+ if (fseek(fp, file_offset + 26, 0) == -1) {
+ fclose(fp);
+ PyErr_Format(ZipImportError, "can't read Zip file: %R", archive);
+ return NULL;
+ }
+
l = 30 + PyMarshal_ReadShortFromFile(fp) +
PyMarshal_ReadShortFromFile(fp); /* local header size */
file_offset += l; /* Start of file data */
@@ -1077,8 +1101,13 @@
buf = PyBytes_AsString(raw_data);
err = fseek(fp, file_offset, 0);
- if (err == 0)
+ if (err == 0) {
bytes_read = fread(buf, 1, data_size, fp);
+ } else {
+ fclose(fp);
+ PyErr_Format(ZipImportError, "can't read Zip file: %R", archive);
+ return NULL;
+ }
fclose(fp);
if (err || bytes_read != data_size) {
PyErr_SetString(PyExc_IOError,
diff --git a/Objects/longobject.c b/Objects/longobject.c
--- a/Objects/longobject.c
+++ b/Objects/longobject.c
@@ -668,10 +668,9 @@
assert(ndigits == 0 || v->ob_digit[ndigits - 1] != 0);
if (ndigits > 0) {
digit msd = v->ob_digit[ndigits - 1];
-
- result = (ndigits - 1) * PyLong_SHIFT;
- if (result / PyLong_SHIFT != (size_t)(ndigits - 1))
+ if ((size_t)(ndigits - 1) > PY_SIZE_MAX / (size_t)PyLong_SHIFT)
goto Overflow;
+ result = (size_t)(ndigits - 1) * (size_t)PyLong_SHIFT;
do {
++result;
if (result == 0)
@@ -4849,13 +4848,20 @@
};
PyDoc_STRVAR(long_doc,
-"int(x[, base]) -> integer\n\
+"int(x=0) -> integer\n\
+int(x, base=10) -> integer\n\
\n\
-Convert a string or number to an integer, if possible. A floating\n\
-point argument will be truncated towards zero (this does not include a\n\
-string representation of a floating point number!) When converting a\n\
-string, use the optional base. It is an error to supply a base when\n\
-converting a non-string.");
+Convert a number or string to an integer, or return 0 if no arguments\n\
+are given. If x is a number, return x.__int__(). For floating point\n\
+numbers, this truncates towards zero.\n\
+\n\
+If x is not a number or if base is given, then x must be a string,\n\
+bytes, or bytearray instance representing an integer literal in the\n\
+given base. The literal can be preceded by '+' or '-' and be surrounded\n\
+by whitespace. The base defaults to 10. Valid bases are 0 and 2-36.\n\
+Base 0 means to interpret the base from the string as an integer literal.\n\
+>>> int('0b100', base=0)\n\
+4");
static PyNumberMethods long_as_number = {
(binaryfunc)long_add, /*nb_add*/
diff --git a/Objects/rangeobject.c b/Objects/rangeobject.c
--- a/Objects/rangeobject.c
+++ b/Objects/rangeobject.c
@@ -136,7 +136,8 @@
}
PyDoc_STRVAR(range_doc,
-"range([start,] stop[, step]) -> range object\n\
+"range(stop) -> range object\n\
+range(start, stop[, step]) -> range object\n\
\n\
Returns a virtual sequence of numbers from start to stop by step.");
@@ -969,7 +970,7 @@
{
PyObject *start=NULL, *stop=NULL, *step=NULL;
PyObject *range;
-
+
/* create a range object for pickling */
start = PyLong_FromLong(r->start);
if (start == NULL)
diff --git a/Objects/sliceobject.c b/Objects/sliceobject.c
--- a/Objects/sliceobject.c
+++ b/Objects/sliceobject.c
@@ -269,7 +269,8 @@
}
PyDoc_STRVAR(slice_doc,
-"slice([start,] stop[, step])\n\
+"slice(stop)\n\
+slice(start, stop[, step])\n\
\n\
Create a slice object. This is used for extended slicing (e.g. a[0:10:2]).");
diff --git a/Objects/tupleobject.c b/Objects/tupleobject.c
--- a/Objects/tupleobject.c
+++ b/Objects/tupleobject.c
@@ -96,15 +96,11 @@
else
#endif
{
- Py_ssize_t nbytes = size * sizeof(PyObject *);
/* Check for overflow */
- if (nbytes / sizeof(PyObject *) != (size_t)size ||
- (nbytes > PY_SSIZE_T_MAX - sizeof(PyTupleObject) - sizeof(PyObject *)))
- {
+ if (size > (PY_SSIZE_T_MAX - sizeof(PyTupleObject) -
+ sizeof(PyObject *)) / sizeof(PyObject *)) {
return PyErr_NoMemory();
}
- /* nbytes += sizeof(PyTupleObject) - sizeof(PyObject *); */
-
op = PyObject_GC_NewVar(PyTupleObject, &PyTuple_Type, size);
if (op == NULL)
return NULL;
@@ -481,9 +477,9 @@
if (Py_SIZE(a) == 0)
return PyTuple_New(0);
}
+ if (n > PY_SSIZE_T_MAX / Py_SIZE(a))
+ return PyErr_NoMemory();
size = Py_SIZE(a) * n;
- if (size/Py_SIZE(a) != n)
- return PyErr_NoMemory();
np = (PyTupleObject *) PyTuple_New(size);
if (np == NULL)
return NULL;
diff --git a/Objects/unicodeobject.c b/Objects/unicodeobject.c
--- a/Objects/unicodeobject.c
+++ b/Objects/unicodeobject.c
@@ -4492,7 +4492,6 @@
void *data;
Py_ssize_t len;
PyObject *v;
- Py_ssize_t allocated;
int inShift = 0;
Py_ssize_t i;
unsigned int base64bits = 0;
@@ -4510,11 +4509,9 @@
return PyBytes_FromStringAndSize(NULL, 0);
/* It might be possible to tighten this worst case */
- allocated = 8 * len;
- if (allocated / 8 != len)
+ if (len > PY_SSIZE_T_MAX / 8)
return PyErr_NoMemory();
-
- v = PyBytes_FromStringAndSize(NULL, allocated);
+ v = PyBytes_FromStringAndSize(NULL, len * 8);
if (v == NULL)
return NULL;
@@ -5092,7 +5089,7 @@
Py_ssize_t len;
PyObject *v;
unsigned char *p;
- Py_ssize_t nsize, bytesize, i;
+ Py_ssize_t nsize, i;
/* Offsets from p for storing byte pairs in the right order. */
#ifdef BYTEORDER_IS_LITTLE_ENDIAN
int iorder[] = {0, 1, 2, 3};
@@ -5120,10 +5117,9 @@
len = PyUnicode_GET_LENGTH(str);
nsize = len + (byteorder == 0);
- bytesize = nsize * 4;
- if (bytesize / 4 != nsize)
+ if (nsize > PY_SSIZE_T_MAX / 4)
return PyErr_NoMemory();
- v = PyBytes_FromStringAndSize(NULL, bytesize);
+ v = PyBytes_FromStringAndSize(NULL, nsize * 4);
if (v == NULL)
return NULL;
@@ -5772,18 +5768,12 @@
void *data;
Py_ssize_t expandsize = 0;
- /* Initial allocation is based on the longest-possible unichr
+ /* Initial allocation is based on the longest-possible character
escape.
- In wide (UTF-32) builds '\U00xxxxxx' is 10 chars per source
- unichr, so in this case it's the longest unichr escape. In
- narrow (UTF-16) builds this is five chars per source unichr
- since there are two unichrs in the surrogate pair, so in narrow
- (UTF-16) builds it's not the longest unichr escape.
-
- In wide or narrow builds '\uxxxx' is 6 chars per source unichr,
- so in the narrow (UTF-16) build case it's the longest unichr
- escape.
+ For UCS1 strings it's '\xxx', 4 bytes per source character.
+ For UCS2 strings it's '\uxxxx', 6 bytes per source character.
+ For UCS4 strings it's '\U00xxxxxx', 10 bytes per source character.
*/
if (!PyUnicode_Check(unicode)) {
@@ -10165,7 +10155,7 @@
}
else {
Py_ssize_t n, i, j, ires;
- Py_ssize_t product, new_size;
+ Py_ssize_t new_size;
int rkind = skind;
char *res;
@@ -10197,19 +10187,18 @@
}
/* new_size = PyUnicode_GET_LENGTH(self) + n * (PyUnicode_GET_LENGTH(str2) -
PyUnicode_GET_LENGTH(str1))); */
- product = n * (len2-len1);
- if ((product / (len2-len1)) != n) {
+ if (len2 > len1 && len2 - len1 > (PY_SSIZE_T_MAX - slen) / n) {
PyErr_SetString(PyExc_OverflowError,
"replace string is too long");
goto error;
}
- new_size = slen + product;
+ new_size = slen + n * (len2 - len1);
if (new_size == 0) {
Py_INCREF(unicode_empty);
u = unicode_empty;
goto done;
}
- if (new_size < 0 || new_size > (PY_SSIZE_T_MAX >> (rkind-1))) {
+ if (new_size > (PY_SSIZE_T_MAX >> (rkind-1))) {
PyErr_SetString(PyExc_OverflowError,
"replace string is too long");
goto error;
@@ -13442,8 +13431,10 @@
uformat = PyUnicode_FromObject(format);
if (uformat == NULL)
return NULL;
- if (PyUnicode_READY(uformat) == -1)
+ if (PyUnicode_READY(uformat) == -1) {
Py_DECREF(uformat);
+ return NULL;
+ }
fmt = PyUnicode_DATA(uformat);
fmtkind = PyUnicode_KIND(uformat);
@@ -14083,7 +14074,8 @@
}
PyDoc_STRVAR(unicode_doc,
- "str(object[, encoding[, errors]]) -> str\n\
+"str(object='') -> str\n\
+str(bytes_or_buffer[, encoding[, errors]]) -> str\n\
\n\
Create a new string object from the given object. If encoding or\n\
errors is specified, then the object must expose a data buffer\n\
diff --git a/Parser/asdl_c.py b/Parser/asdl_c.py
--- a/Parser/asdl_c.py
+++ b/Parser/asdl_c.py
@@ -1064,7 +1064,7 @@
self.emit("case %s:" % t.name, 2)
self.emit("Py_INCREF(%s_singleton);" % t.name, 3)
self.emit("return %s_singleton;" % t.name, 3)
- self.emit("default:" % name, 2)
+ self.emit("default:", 2)
self.emit('/* should never happen, but just in case ... */', 3)
code = "PyErr_Format(PyExc_SystemError, \"unknown %s found\");" % name
self.emit(code, 3, reflow=False)
diff --git a/setup.py b/setup.py
--- a/setup.py
+++ b/setup.py
@@ -1985,6 +1985,7 @@
# solaris: problems with register allocation.
# icc >= 11.0 works as well.
define_macros = config['ppro']
+ extra_compile_args.append('-Wno-unknown-pragmas')
else:
define_macros = config['ansi32']
else:
--
Repository URL: http://hg.python.org/cpython
More information about the Python-checkins
mailing list