1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
|
.. _whats-new:
What's New
**********
.. _whats-new-0.14.x:
What's new in version 0.15.0 (2015-07-25)
=========================================
This release fixes compatibility bugs with CherryPy's Py2/3 compat layer and
the latest version of the ``urllib3`` package. It also adds some additional
backports for Py2.6 and Py2.7 from Py3.4's standard library.
New features:
- ``install_aliases()`` now exposes full backports of the Py3 urllib submodules
(``parse``, ``request`` etc.) from ``future.backports.urllib`` as submodules
of ``urllib`` on Py2. This implies, for example, that
``urllib.parse.unquote`` now takes an optional encoding argument as it does
on Py3. This improves compatibility with CherryPy's Py2/3 compat layer (issue
#158).
- ``tkinter.ttk`` support (issue #151)
- Backport of ``collections.ChainMap`` (issue #150)
- Backport of ``itertools.count`` for Py2.6 (issue #152)
- Enable and document support for the ``surrogateescape`` error handler for ``newstr`` and ``newbytes`` objects on Py2.x (issue #116). This feature is currently in alpha.
- Add constants to ``http.client`` such as ``HTTP_PORT`` and ``BAD_REQUEST`` (issue #137)
- Backport of ``reprlib.recursive_repr`` to Py2
Bug fixes:
- Add ``HTTPMessage`` to ``http.client``, which is missing from ``httplib.__all__`` on Python <= 2.7.10. This restores compatibility with the latest ``urllib3`` package (issue #159, thanks to Waldemar Kornewald)
- Expand newint.__divmod__ and newint.__rdivmod__ to fall back to <type 'long'>
implementations where appropriate (issue #146 - thanks to Matt Bogosian)
- Fix newrange slicing for some slice/range combos (issue #132, thanks to Brad Walker)
- Small doc fixes (thanks to Michael Joseph and Tim Tröndle)
- Improve robustness of test suite against opening .pyc files as text on Py2
- Update backports of ``Counter`` and ``OrderedDict`` to use the newer
implementations from Py3.4. This fixes ``.copy()`` preserving subclasses etc.
- ``futurize`` no longer breaks working Py2 code by changing ``basestring`` to
``str``. Instead it imports the ``basestring`` forward-port from
``past.builtins`` (issues #127 and #156)
- ``future.utils``: add ``string_types`` etc. and update docs (issue #126)
What's new in version 0.14.3 (2014-12-15)
=========================================
This is a bug-fix release:
- Expose contents of ``thread`` (not ``dummy_thread``) as ``_thread`` on Py2 (issue #124)
- Add signed support for ``newint.to_bytes()`` (issue #128)
- Fix ``OrderedDict.clear()`` on Py2.6 (issue #125)
- Improve ``newrange``: equality and slicing, start/stop/step properties, refactoring (issues #129, #130)
- Minor doc updates
What's new in version 0.14.2 (2014-11-21)
=========================================
This is a bug-fix release:
- Speed up importing of ``past.translation`` (issue #117)
- ``html.escape()``: replace function with the more robust one from Py3.4
- futurize: avoid displacing encoding comments by __future__ imports (issues #97, #10, #121)
- futurize: don't swallow exit code (issue #119)
- Packaging: don't forcibly remove the old build dir in ``setup.py`` (issue #108)
- Docs: update further docs and tests to refer to ``install_aliases()`` instead of
``install_hooks()``
- Docs: fix ``iteritems`` import error in cheat sheet (issue #120)
- Tests: don't rely on presence of ``test.test_support`` on Py2 or ``test.support`` on Py3 (issue #109)
- Tests: don't override existing ``PYTHONPATH`` for tests (PR #111)
What's new in version 0.14.1 (2014-10-02)
=========================================
This is a minor bug-fix release:
- Docs: add a missing template file for building docs (issue #108)
- Tests: fix a bug in error handling while reporting failed script runs (issue #109)
- install_aliases(): don't assume that the ``test.test_support`` module always
exists on Py2 (issue #109)
What's new in version 0.14 (2014-10-02)
=======================================
This is a major new release that offers a cleaner interface for most imports in
Python 2/3 compatible code.
Instead of this interface::
>>> from future.builtins import str, open, range, dict
>>> from future.standard_library import hooks
>>> with hooks():
... import queue
... import configparser
... import tkinter.dialog
... # etc.
you can now use the following interface for much Python 2/3 compatible code::
>>> # Alias for future.builtins on Py2:
>>> from builtins import str, open, range, dict
>>> # Alias for future.moves.* on Py2:
>>> import queue
>>> import configparser
>>> import tkinter.dialog
>>> etc.
Notice that the above code will run on Python 3 even without the presence of the
``future`` package. Of the 44 standard library modules that were refactored with
PEP 3108, 30 are supported with direct imports in this manner. (These are listed
here: :ref:`direct-imports`.)
The other 14 standard library modules that kept the same top-level names in
Py3.x are not supported with this direct import interface on Py2. These include
the 5 modules in the Py3 ``urllib`` package. These modules are accessible through
the following interface (as well as the interfaces offered in previous versions
of ``python-future``)::
from future.standard_library import install_aliases
install_aliases()
from collections import UserDict, UserList, UserString
import dbm.gnu
from itertools import filterfalse, zip_longest
from subprocess import getoutput, getstatusoutput
from sys import intern
import test.support
from urllib.request import urlopen
from urllib.parse import urlparse
# etc.
from collections import Counter, OrderedDict # backported to Py2.6
The complete list of packages supported with this interface is here:
:ref:`list-standard-library-refactored`.
For more information on these and other interfaces to the standard library, see
:ref:`standard-library-imports`.
Bug fixes
---------
- This release expands the ``future.moves`` package to include most of the remaining
modules that were moved in the standard library reorganization (PEP 3108).
(Issue #104).
- This release also removes the broken ``--doctests_only`` option from the ``futurize``
and ``pasteurize`` scripts for now (issue #103).
Internal cleanups
-----------------
The project folder structure has changed. Top-level packages are now in a
``src`` folder and the tests have been moved into a project-level ``tests``
folder.
The following deprecated internal modules have been removed (issue #80):
- ``future.utils.encoding`` and ``future.utils.six``.
Deprecations
------------
The following internal functions have been deprecated and will be removed in a future release:
- ``future.standard_library.scrub_py2_sys_modules``
- ``future.standard_library.scrub_future_sys_modules``
Previous versions
=================
See :ref:`whats-old` for versions prior to v0.14.
|
