Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 1 | **************************** |
| 2 | What's New In Python 3.4 |
| 3 | **************************** |
| 4 | |
Georg Brandl | 3b80d34 | 2012-10-28 13:37:54 +0100 | [diff] [blame] | 5 | .. :Author: Someone <email> |
| 6 | (uncomment if there is a principal author) |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 7 | |
| 8 | .. Rules for maintenance: |
| 9 | |
Nick Coghlan | 03074fd | 2012-09-30 18:51:53 +0530 | [diff] [blame] | 10 | * Anyone can add text to this document, but the maintainer reserves the |
| 11 | right to rewrite any additions. In particular, for obscure or esoteric |
| 12 | features, the maintainer may reduce any addition to a simple reference to |
| 13 | the new documentation rather than explaining the feature inline. |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 14 | |
Nick Coghlan | 03074fd | 2012-09-30 18:51:53 +0530 | [diff] [blame] | 15 | * While the maintainer will periodically go through Misc/NEWS |
| 16 | and add changes, it's best not to rely on this. We know from experience |
| 17 | that any changes that aren't in the What's New documentation around the |
| 18 | time of the original release will remain largely unknown to the community |
| 19 | for years, even if they're added later. We also know from experience that |
| 20 | other priorities can arise, and the maintainer will run out of time to do |
| 21 | updates - in such cases, end users will be much better served by partial |
| 22 | notifications that at least give a hint about new features to |
| 23 | investigate. |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 24 | |
| 25 | * This is not a complete list of every single change; completeness |
Nick Coghlan | 03074fd | 2012-09-30 18:51:53 +0530 | [diff] [blame] | 26 | is the purpose of Misc/NEWS. The What's New should focus on changes that |
| 27 | are visible to Python *users* and that *require* a feature release (i.e. |
| 28 | most bug fixes should only be recorded in Misc/NEWS) |
| 29 | |
| 30 | * PEPs should not be marked Final until they have an entry in What's New. |
| 31 | A placeholder entry that is just a section header and a link to the PEP |
| 32 | (e.g ":pep:`397` has been implemented") is acceptable. If a PEP has been |
| 33 | implemented and noted in What's New, don't forget to mark it as Final! |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 34 | |
| 35 | * If you want to draw your new text to the attention of the |
| 36 | maintainer, add 'XXX' to the beginning of the paragraph or |
| 37 | section. |
| 38 | |
Nick Coghlan | 03074fd | 2012-09-30 18:51:53 +0530 | [diff] [blame] | 39 | * It's OK to add just a very brief note about a change. For |
| 40 | example: "The :ref:`~socket.transmogrify()` function was added to the |
| 41 | :mod:`socket` module." The maintainer will research the change and |
| 42 | write the necessary text (if appropriate). The advantage of doing this |
| 43 | is that even if no more descriptive text is ever added, readers will at |
| 44 | least have a notification that the new feature exists and a link to the |
| 45 | relevant documentation. |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 46 | |
| 47 | * You can comment out your additions if you like, but it's not |
| 48 | necessary (especially when a final release is some months away). |
| 49 | |
| 50 | * Credit the author of a patch or bugfix. Just the name is |
| 51 | sufficient; the e-mail address isn't necessary. |
| 52 | |
| 53 | * It's helpful to add the bug/patch number as a comment: |
| 54 | |
Nick Coghlan | 03074fd | 2012-09-30 18:51:53 +0530 | [diff] [blame] | 55 | The :ref:`~socket.transmogrify()` function was added to the |
| 56 | :mod:`socket` module. (Contributed by P.Y. Developer in :issue:`12345`.) |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 57 | |
| 58 | This saves the maintainer the effort of going through the Mercurial log |
| 59 | when researching a change. |
| 60 | |
Nick Coghlan | 03074fd | 2012-09-30 18:51:53 +0530 | [diff] [blame] | 61 | * Cross referencing tip: :ref:`mod.attr` will display as ``mod.attr``, |
| 62 | while :ref:`~mod.attr` will display as ``attr``. |
| 63 | |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 64 | This article explains the new features in Python 3.4, compared to 3.3. |
| 65 | |
Nick Coghlan | 03074fd | 2012-09-30 18:51:53 +0530 | [diff] [blame] | 66 | .. Python 3.4 was released on TBD. |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 67 | |
Ezio Melotti | 25bbe5e | 2012-11-17 19:30:48 +0200 | [diff] [blame] | 68 | For full details, see the |
| 69 | `changelog <http://docs.python.org/3.4/whatsnew/changelog.html>`_. |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 70 | |
| 71 | .. note:: Prerelease users should be aware that this document is currently in |
| 72 | draft form. It will be updated substantially as Python 3.4 moves towards |
| 73 | release, so it's worth checking back even after reading earlier versions. |
| 74 | |
| 75 | |
| 76 | .. seealso:: |
| 77 | |
Nick Coghlan | 03074fd | 2012-09-30 18:51:53 +0530 | [diff] [blame] | 78 | .. :pep:`4XX` - Python 3.4 Release Schedule |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 79 | |
| 80 | |
| 81 | Summary -- Release highlights |
| 82 | ============================= |
| 83 | |
| 84 | .. This section singles out the most important changes in Python 3.3. |
| 85 | Brevity is key. |
| 86 | |
| 87 | New syntax features: |
| 88 | |
| 89 | * None yet. |
| 90 | |
| 91 | New library modules: |
| 92 | |
| 93 | * None yet. |
| 94 | |
| 95 | New built-in features: |
| 96 | |
| 97 | * None yet. |
| 98 | |
| 99 | Implementation improvements: |
| 100 | |
| 101 | * None yet. |
| 102 | |
| 103 | Significantly Improved Library Modules: |
| 104 | |
Christian Heimes | 4a0270d | 2012-10-06 02:23:36 +0200 | [diff] [blame] | 105 | * SHA-3 (Keccak) support for :mod:`hashlib`. |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 106 | |
| 107 | Security improvements: |
| 108 | |
| 109 | * None yet. |
| 110 | |
| 111 | Please read on for a comprehensive list of user-facing changes. |
| 112 | |
| 113 | |
| 114 | .. PEP-sized items next. |
| 115 | |
| 116 | .. _pep-4XX: |
| 117 | |
Nick Coghlan | 03074fd | 2012-09-30 18:51:53 +0530 | [diff] [blame] | 118 | .. PEP 4XX: Example PEP |
| 119 | .. ==================== |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 120 | |
| 121 | |
| 122 | .. (Implemented by Foo Bar.) |
| 123 | |
| 124 | .. .. seealso:: |
| 125 | |
Nick Coghlan | 03074fd | 2012-09-30 18:51:53 +0530 | [diff] [blame] | 126 | :pep:`4XX` - Example PEP |
| 127 | PEP written by Example Author |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 128 | |
| 129 | |
| 130 | |
| 131 | |
| 132 | Other Language Changes |
| 133 | ====================== |
| 134 | |
| 135 | Some smaller changes made to the core Python language are: |
| 136 | |
Georg Brandl | 50de850 | 2012-09-30 14:39:18 +0200 | [diff] [blame] | 137 | * Unicode database updated to UCD version 6.2. |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 138 | |
| 139 | |
| 140 | |
| 141 | New Modules |
| 142 | =========== |
| 143 | |
| 144 | .. module name |
| 145 | .. ----------- |
| 146 | |
| 147 | * None yet. |
| 148 | |
| 149 | |
| 150 | Improved Modules |
| 151 | ================ |
| 152 | |
R David Murray | 5a9d706 | 2012-11-21 15:09:21 -0500 | [diff] [blame] | 153 | doctest |
| 154 | ------- |
| 155 | |
| 156 | Added ``FAIL_FAST`` flag to halt test running as soon as the first failure is |
| 157 | detected. (Contributed by R. David Murray and Daniel Urban in :issue:`16522`.) |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 158 | |
| 159 | |
| 160 | Optimizations |
| 161 | ============= |
| 162 | |
| 163 | Major performance enhancements have been added: |
| 164 | |
Victor Stinner | e64322e | 2012-10-30 23:12:47 +0100 | [diff] [blame] | 165 | * The UTF-32 decoder is now 3x to 4x faster. |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 166 | |
| 167 | |
| 168 | Build and C API Changes |
| 169 | ======================= |
| 170 | |
| 171 | Changes to Python's build process and to the C API include: |
| 172 | |
| 173 | * None yet. |
| 174 | |
| 175 | |
| 176 | Deprecated |
| 177 | ========== |
| 178 | |
| 179 | Unsupported Operating Systems |
| 180 | ----------------------------- |
| 181 | |
| 182 | * None yet. |
| 183 | |
| 184 | |
| 185 | Deprecated Python modules, functions and methods |
| 186 | ------------------------------------------------ |
| 187 | |
| 188 | * None yet. |
| 189 | |
| 190 | |
| 191 | Deprecated functions and types of the C API |
| 192 | ------------------------------------------- |
| 193 | |
| 194 | * None yet. |
| 195 | |
| 196 | |
| 197 | Deprecated features |
| 198 | ------------------- |
| 199 | |
| 200 | * None yet. |
| 201 | |
| 202 | |
Benjamin Peterson | 88f3b23 | 2012-10-04 12:45:10 -0400 | [diff] [blame] | 203 | Porting to Python 3.4 |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 204 | ===================== |
| 205 | |
| 206 | This section lists previously described changes and other bugfixes |
| 207 | that may require changes to your code. |
| 208 | |
| 209 | * Nothing yet. |