Skip to content

Commit 6ee6727

Browse files
committed
Update What's New and Changelog pages
1 parent 87c46f4 commit 6ee6727

File tree

2 files changed

+141
-133
lines changed

2 files changed

+141
-133
lines changed

docs/changelog.rst

Lines changed: 139 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,135 @@ Changes in previous versions
55

66
Changes in the most recent major version are here: :ref:`whats-new`.
77

8+
.. _whats-new-0.14.x:
9+
10+
Changes in version 0.14.3 (2014-12-15)
11+
======================================
12+
13+
This is a bug-fix release:
14+
15+
- Expose contents of ``thread`` (not ``dummy_thread``) as ``_thread`` on Py2 (issue #124)
16+
- Add signed support for ``newint.to_bytes()`` (issue #128)
17+
- Fix ``OrderedDict.clear()`` on Py2.6 (issue #125)
18+
- Improve ``newrange``: equality and slicing, start/stop/step properties, refactoring (issues #129, #130)
19+
- Minor doc updates
20+
21+
Changes in version 0.14.2 (2014-11-21)
22+
======================================
23+
24+
This is a bug-fix release:
25+
26+
- Speed up importing of ``past.translation`` (issue #117)
27+
- ``html.escape()``: replace function with the more robust one from Py3.4
28+
- futurize: avoid displacing encoding comments by __future__ imports (issues #97, #10, #121)
29+
- futurize: don't swallow exit code (issue #119)
30+
- Packaging: don't forcibly remove the old build dir in ``setup.py`` (issue #108)
31+
- Docs: update further docs and tests to refer to ``install_aliases()`` instead of
32+
``install_hooks()``
33+
- Docs: fix ``iteritems`` import error in cheat sheet (issue #120)
34+
- Tests: don't rely on presence of ``test.test_support`` on Py2 or ``test.support`` on Py3 (issue #109)
35+
- Tests: don't override existing ``PYTHONPATH`` for tests (PR #111)
36+
37+
Changes in version 0.14.1 (2014-10-02)
38+
======================================
39+
40+
This is a minor bug-fix release:
41+
42+
- Docs: add a missing template file for building docs (issue #108)
43+
- Tests: fix a bug in error handling while reporting failed script runs (issue #109)
44+
- install_aliases(): don't assume that the ``test.test_support`` module always
45+
exists on Py2 (issue #109)
46+
47+
48+
Changes in version 0.14.0 (2014-10-02)
49+
======================================
50+
51+
This is a major new release that offers a cleaner interface for most imports in
52+
Python 2/3 compatible code.
53+
54+
Instead of this interface::
55+
56+
>>> from future.builtins import str, open, range, dict
57+
58+
>>> from future.standard_library import hooks
59+
>>> with hooks():
60+
... import queue
61+
... import configparser
62+
... import tkinter.dialog
63+
... # etc.
64+
65+
you can now use the following interface for much Python 2/3 compatible code::
66+
67+
>>> # Alias for future.builtins on Py2:
68+
>>> from builtins import str, open, range, dict
69+
70+
>>> # Alias for future.moves.* on Py2:
71+
>>> import queue
72+
>>> import configparser
73+
>>> import tkinter.dialog
74+
>>> etc.
75+
76+
Notice that the above code will run on Python 3 even without the presence of the
77+
``future`` package. Of the 44 standard library modules that were refactored with
78+
PEP 3108, 30 are supported with direct imports in this manner. (These are listed
79+
here: :ref:`direct-imports`.)
80+
81+
The other 14 standard library modules that kept the same top-level names in
82+
Py3.x are not supported with this direct import interface on Py2. These include
83+
the 5 modules in the Py3 ``urllib`` package. These modules are accessible through
84+
the following interface (as well as the interfaces offered in previous versions
85+
of ``python-future``)::
86+
87+
from future.standard_library import install_aliases
88+
install_aliases()
89+
90+
from collections import UserDict, UserList, UserString
91+
import dbm.gnu
92+
from itertools import filterfalse, zip_longest
93+
from subprocess import getoutput, getstatusoutput
94+
from sys import intern
95+
import test.support
96+
from urllib.request import urlopen
97+
from urllib.parse import urlparse
98+
# etc.
99+
from collections import Counter, OrderedDict # backported to Py2.6
100+
101+
The complete list of packages supported with this interface is here:
102+
:ref:`list-standard-library-refactored`.
103+
104+
For more information on these and other interfaces to the standard library, see
105+
:ref:`standard-library-imports`.
106+
107+
Bug fixes
108+
---------
109+
110+
- This release expands the ``future.moves`` package to include most of the remaining
111+
modules that were moved in the standard library reorganization (PEP 3108).
112+
(Issue #104).
113+
114+
- This release also removes the broken ``--doctests_only`` option from the ``futurize``
115+
and ``pasteurize`` scripts for now (issue #103).
116+
117+
Internal cleanups
118+
-----------------
119+
120+
The project folder structure has changed. Top-level packages are now in a
121+
``src`` folder and the tests have been moved into a project-level ``tests``
122+
folder.
123+
124+
The following deprecated internal modules have been removed (issue #80):
125+
126+
- ``future.utils.encoding`` and ``future.utils.six``.
127+
128+
Deprecations
129+
------------
130+
131+
The following internal functions have been deprecated and will be removed in a future release:
132+
133+
- ``future.standard_library.scrub_py2_sys_modules``
134+
- ``future.standard_library.scrub_future_sys_modules``
135+
136+
8137
.. _whats-new-0.13.x:
9138

10139
Changes in version 0.13.1 (2014-09-23)
@@ -19,8 +148,8 @@ This is a bug-fix release:
19148
- Doc formatting fix (issues #98, 100)
20149

21150

22-
Changes in version 0.13 (2014-08-13)
23-
====================================
151+
Changes in version 0.13.0 (2014-08-13)
152+
======================================
24153

25154
This is mostly a clean-up release. It adds some small new compatibility features
26155
and fixes several bugs.
@@ -765,6 +894,13 @@ deprecated.
765894
Summary of all changes
766895
======================
767896

897+
v0.15.0:
898+
* Full backports of ``urllib.parse`` and other ``urllib`` submodules are exposed by ``install_aliases()``.
899+
* ``tkinter.ttk`` support
900+
* Initial ``surrogateescape`` support
901+
* Additional backports: ``collections``, ``http`` constants, etc.
902+
* Bug fixes
903+
768904
v0.14.3:
769905
* Bug fixes
770906

@@ -774,7 +910,7 @@ v0.14.2:
774910
v0.14.1:
775911
* Bug fixes
776912

777-
v0.14:
913+
v0.14.0:
778914
* New top-level ``builtins`` package on Py2 for cleaner imports. Equivalent to
779915
``future.builtins``
780916
* New top-level packages on Py2 with the same names as Py3 standard modules:

docs/whatsnew.rst

Lines changed: 2 additions & 130 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
What's New
44
**********
55

6-
.. _whats-new-0.14.x:
6+
.. _whats-new-0.15.x:
77

88
What's new in version 0.15.0 (2015-07-25)
99
=========================================
@@ -42,135 +42,7 @@ Bug fixes:
4242
``past.builtins`` (issues #127 and #156)
4343
- ``future.utils``: add ``string_types`` etc. and update docs (issue #126)
4444

45-
46-
What's new in version 0.14.3 (2014-12-15)
47-
=========================================
48-
49-
This is a bug-fix release:
50-
51-
- Expose contents of ``thread`` (not ``dummy_thread``) as ``_thread`` on Py2 (issue #124)
52-
- Add signed support for ``newint.to_bytes()`` (issue #128)
53-
- Fix ``OrderedDict.clear()`` on Py2.6 (issue #125)
54-
- Improve ``newrange``: equality and slicing, start/stop/step properties, refactoring (issues #129, #130)
55-
- Minor doc updates
56-
57-
What's new in version 0.14.2 (2014-11-21)
58-
=========================================
59-
60-
This is a bug-fix release:
61-
62-
- Speed up importing of ``past.translation`` (issue #117)
63-
- ``html.escape()``: replace function with the more robust one from Py3.4
64-
- futurize: avoid displacing encoding comments by __future__ imports (issues #97, #10, #121)
65-
- futurize: don't swallow exit code (issue #119)
66-
- Packaging: don't forcibly remove the old build dir in ``setup.py`` (issue #108)
67-
- Docs: update further docs and tests to refer to ``install_aliases()`` instead of
68-
``install_hooks()``
69-
- Docs: fix ``iteritems`` import error in cheat sheet (issue #120)
70-
- Tests: don't rely on presence of ``test.test_support`` on Py2 or ``test.support`` on Py3 (issue #109)
71-
- Tests: don't override existing ``PYTHONPATH`` for tests (PR #111)
72-
73-
What's new in version 0.14.1 (2014-10-02)
74-
=========================================
75-
76-
This is a minor bug-fix release:
77-
78-
- Docs: add a missing template file for building docs (issue #108)
79-
- Tests: fix a bug in error handling while reporting failed script runs (issue #109)
80-
- install_aliases(): don't assume that the ``test.test_support`` module always
81-
exists on Py2 (issue #109)
82-
83-
84-
What's new in version 0.14 (2014-10-02)
85-
=======================================
86-
87-
This is a major new release that offers a cleaner interface for most imports in
88-
Python 2/3 compatible code.
89-
90-
Instead of this interface::
91-
92-
>>> from future.builtins import str, open, range, dict
93-
94-
>>> from future.standard_library import hooks
95-
>>> with hooks():
96-
... import queue
97-
... import configparser
98-
... import tkinter.dialog
99-
... # etc.
100-
101-
you can now use the following interface for much Python 2/3 compatible code::
102-
103-
>>> # Alias for future.builtins on Py2:
104-
>>> from builtins import str, open, range, dict
105-
106-
>>> # Alias for future.moves.* on Py2:
107-
>>> import queue
108-
>>> import configparser
109-
>>> import tkinter.dialog
110-
>>> etc.
111-
112-
Notice that the above code will run on Python 3 even without the presence of the
113-
``future`` package. Of the 44 standard library modules that were refactored with
114-
PEP 3108, 30 are supported with direct imports in this manner. (These are listed
115-
here: :ref:`direct-imports`.)
116-
117-
The other 14 standard library modules that kept the same top-level names in
118-
Py3.x are not supported with this direct import interface on Py2. These include
119-
the 5 modules in the Py3 ``urllib`` package. These modules are accessible through
120-
the following interface (as well as the interfaces offered in previous versions
121-
of ``python-future``)::
122-
123-
from future.standard_library import install_aliases
124-
install_aliases()
125-
126-
from collections import UserDict, UserList, UserString
127-
import dbm.gnu
128-
from itertools import filterfalse, zip_longest
129-
from subprocess import getoutput, getstatusoutput
130-
from sys import intern
131-
import test.support
132-
from urllib.request import urlopen
133-
from urllib.parse import urlparse
134-
# etc.
135-
from collections import Counter, OrderedDict # backported to Py2.6
136-
137-
The complete list of packages supported with this interface is here:
138-
:ref:`list-standard-library-refactored`.
139-
140-
For more information on these and other interfaces to the standard library, see
141-
:ref:`standard-library-imports`.
142-
143-
Bug fixes
144-
---------
145-
146-
- This release expands the ``future.moves`` package to include most of the remaining
147-
modules that were moved in the standard library reorganization (PEP 3108).
148-
(Issue #104).
149-
150-
- This release also removes the broken ``--doctests_only`` option from the ``futurize``
151-
and ``pasteurize`` scripts for now (issue #103).
152-
153-
Internal cleanups
154-
-----------------
155-
156-
The project folder structure has changed. Top-level packages are now in a
157-
``src`` folder and the tests have been moved into a project-level ``tests``
158-
folder.
159-
160-
The following deprecated internal modules have been removed (issue #80):
161-
162-
- ``future.utils.encoding`` and ``future.utils.six``.
163-
164-
Deprecations
165-
------------
166-
167-
The following internal functions have been deprecated and will be removed in a future release:
168-
169-
- ``future.standard_library.scrub_py2_sys_modules``
170-
- ``future.standard_library.scrub_future_sys_modules``
171-
172-
17345
Previous versions
17446
=================
17547

176-
See :ref:`whats-old` for versions prior to v0.14.
48+
See :ref:`whats-old` for versions prior to v0.15.

0 commit comments

Comments
 (0)