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 | |
Kristjan Valur Jonsson | a1e8244 | 2013-03-26 13:56:14 +0000 | [diff] [blame] | 84 | .. This section singles out the most important changes in Python 3.4. |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 85 | Brevity is key. |
| 86 | |
| 87 | New syntax features: |
| 88 | |
| 89 | * None yet. |
| 90 | |
| 91 | New library modules: |
| 92 | |
Victor Stinner | 84e33c8 | 2013-06-21 00:31:55 +0200 | [diff] [blame] | 93 | * :mod:`enum`: Implementation of the :pep:`435`. |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 94 | |
| 95 | New built-in features: |
| 96 | |
Antoine Pitrou | f89aa9a | 2013-08-12 20:46:47 +0200 | [diff] [blame] | 97 | * :ref:`PEP 442: Safe object finalization <pep-442>`. |
| 98 | * :ref:`PEP 445: Configurable memory allocators <pep-445>`. |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 99 | |
| 100 | Implementation improvements: |
| 101 | |
Antoine Pitrou | f89aa9a | 2013-08-12 20:46:47 +0200 | [diff] [blame] | 102 | * A more efficient :mod:`marshal` format (:issue:`16475`). |
| 103 | * Improve finalization of Python modules to avoid setting their globals |
| 104 | to None, in most cases (:issue:`18214`). |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 105 | |
| 106 | Significantly Improved Library Modules: |
| 107 | |
Antoine Pitrou | f89aa9a | 2013-08-12 20:46:47 +0200 | [diff] [blame] | 108 | * Single-dispatch generic functions (:pep:`443`) |
| 109 | * SHA-3 (Keccak) support for :mod:`hashlib`. |
| 110 | * TLSv1.1 and TLSv1.2 support for :mod:`ssl`. |
| 111 | |
Christian Heimes | 4a0270d | 2012-10-06 02:23:36 +0200 | [diff] [blame] | 112 | * SHA-3 (Keccak) support for :mod:`hashlib`. |
Antoine Pitrou | 2463e5f | 2013-03-28 22:24:43 +0100 | [diff] [blame] | 113 | * TLSv1.1 and TLSv1.2 support for :mod:`ssl`. |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 114 | |
| 115 | Security improvements: |
| 116 | |
Christian Heimes | ad73a9c | 2013-08-10 16:36:18 +0200 | [diff] [blame] | 117 | * command line option for :ref:`isolated mode <using-on-misc-options>`, |
| 118 | :issue:`16499`. |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 119 | |
| 120 | Please read on for a comprehensive list of user-facing changes. |
| 121 | |
Antoine Pitrou | f89aa9a | 2013-08-12 20:46:47 +0200 | [diff] [blame] | 122 | .. _pep-445: |
| 123 | |
| 124 | PEP 445: Add new APIs to customize Python memory allocators |
| 125 | =========================================================== |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 126 | |
Victor Stinner | 0507bf5 | 2013-07-07 02:05:46 +0200 | [diff] [blame] | 127 | PEP 445: Add new APIs to customize Python memory allocators |
| 128 | =========================================================== |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 129 | |
Victor Stinner | 0507bf5 | 2013-07-07 02:05:46 +0200 | [diff] [blame] | 130 | The :pep:`445` adds new Application Programming Interfaces (API) to customize |
| 131 | Python memory allocators. |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 132 | |
| 133 | |
Antoine Pitrou | 796564c | 2013-07-30 19:59:21 +0200 | [diff] [blame] | 134 | .. _pep-442: |
| 135 | |
| 136 | PEP 442: Safe object finalization |
| 137 | ================================= |
| 138 | |
| 139 | This PEP removes the current limitations and quirks of object finalization. |
| 140 | With it, objects with :meth:`__del__` methods, as well as generators |
| 141 | with :keyword:`finally` clauses, can be finalized when they are part of a |
| 142 | reference cycle. |
| 143 | |
| 144 | .. seealso:: |
| 145 | |
| 146 | :pep:`442` - Safe object finalization |
| 147 | PEP written and implemented by Antoine Pitrou |
| 148 | |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 149 | |
| 150 | Other Language Changes |
| 151 | ====================== |
| 152 | |
| 153 | Some smaller changes made to the core Python language are: |
| 154 | |
Georg Brandl | 50de850 | 2012-09-30 14:39:18 +0200 | [diff] [blame] | 155 | * Unicode database updated to UCD version 6.2. |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 156 | |
R David Murray | 9a2f139 | 2013-06-28 13:31:19 -0400 | [diff] [blame] | 157 | * :func:`min` and :func:`max` now accept a *default* argument that can be used |
| 158 | to specify the value they return if the iterable they are evaluating has no |
| 159 | elements. Contributed by Julian Berman in :issue:`18111`. |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 160 | |
Antoine Pitrou | f89aa9a | 2013-08-12 20:46:47 +0200 | [diff] [blame] | 161 | * Module objects are now :mod:`weakref`'able. |
| 162 | |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 163 | |
| 164 | New Modules |
| 165 | =========== |
| 166 | |
| 167 | .. module name |
| 168 | .. ----------- |
| 169 | |
| 170 | * None yet. |
| 171 | |
| 172 | |
| 173 | Improved Modules |
| 174 | ================ |
| 175 | |
Antoine Pitrou | d6cbd34 | 2013-08-12 20:48:15 +0200 | [diff] [blame^] | 176 | aifc |
| 177 | ---- |
| 178 | |
| 179 | The :meth:`~aifc.getparams` method now returns a namedtuple rather than a |
| 180 | plain tuple. (Contributed by Claudiu Popa in :issue:`17818`.) |
| 181 | |
| 182 | |
| 183 | colorsys |
| 184 | -------- |
| 185 | |
| 186 | The number of digits in the coefficients for the RGB --- YIQ conversions have |
| 187 | been expanded so that they match the FCC NTSC versions. The change in |
| 188 | results should be less than 1% and may better match results found elsewhere. |
| 189 | |
R David Murray | 8e37d5d | 2013-04-13 14:49:48 -0400 | [diff] [blame] | 190 | |
Nick Coghlan | b39fd0c | 2013-05-06 23:59:20 +1000 | [diff] [blame] | 191 | dis |
| 192 | --- |
| 193 | |
| 194 | The :mod:`dis` module is now built around an :class:`Instruction` class that |
| 195 | provides details of individual bytecode operations and a |
| 196 | :func:`get_instructions` iterator that emits the Instruction stream for a |
| 197 | given piece of Python code. The various display tools in the :mod:`dis` |
| 198 | module have been updated to be based on these new components. |
| 199 | |
| 200 | The new :class:`dis.Bytecode` class provides an object-oriented API for |
| 201 | inspecting bytecode, both in human-readable form and for iterating over |
| 202 | instructions. |
| 203 | |
| 204 | (Contributed by Nick Coghlan, Ryan Kelly and Thomas Kluyver in :issue:`11816`) |
| 205 | |
Antoine Pitrou | d6cbd34 | 2013-08-12 20:48:15 +0200 | [diff] [blame^] | 206 | |
R David Murray | 5a9d706 | 2012-11-21 15:09:21 -0500 | [diff] [blame] | 207 | doctest |
| 208 | ------- |
| 209 | |
R David Murray | 5707d50 | 2013-06-23 14:24:13 -0400 | [diff] [blame] | 210 | Added :data:`~doctest.FAIL_FAST` flag to halt test running as soon as the first |
| 211 | failure is detected. (Contributed by R. David Murray and Daniel Urban in |
| 212 | :issue:`16522`.) |
| 213 | |
| 214 | Updated the doctest command line interface to use :mod:`argparse`, and added |
| 215 | ``-o`` and ``-f`` options to the interface. ``-o`` allows doctest options to |
| 216 | be specified on the command line, and ``-f`` is a shorthand for ``-o |
| 217 | FAIL_FAST`` (to parallel the similar option supported by the :mod:`unittest` |
| 218 | CLI). (Contributed by R. David Murray in :issue:`11390`.) |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 219 | |
R David Murray | 8e37d5d | 2013-04-13 14:49:48 -0400 | [diff] [blame] | 220 | |
R David Murray | bb17d2b | 2013-08-09 16:15:28 -0400 | [diff] [blame] | 221 | email |
| 222 | ----- |
| 223 | |
| 224 | :meth:`~email.message.Message.as_string` now accepts a *policy* argument to |
| 225 | override the default policy of the message when generating a string |
| 226 | representation of it. This means that ``as_string`` can now be used in more |
| 227 | circumstances, instead of having to create and use a :mod:`~email.generator` in |
| 228 | order to pass formatting parameters to its ``flatten`` method. |
| 229 | |
| 230 | New method :meth:`~email.message.Message.as_bytes` added to produce a bytes |
| 231 | representation of the message in a fashion similar to how ``as_string`` |
| 232 | produces a string representation. It does not accept the *maxheaderlen* |
| 233 | argument, but does accept the *unixfrom* and *policy* arguments. The |
| 234 | :class:`~email.message.Message` :meth:`~email.message.Message.__bytes__` method |
| 235 | calls it, meaning that ``bytes(mymsg)`` will now produce the intuitive |
| 236 | result: a bytes object containing the fully formatted message. |
| 237 | |
| 238 | (Contributed by R. David Murray in :issue:`18600`.) |
| 239 | |
| 240 | |
Victor Stinner | 854ffcb | 2013-06-21 00:36:30 +0200 | [diff] [blame] | 241 | functools |
| 242 | --------- |
| 243 | |
| 244 | New :func:`functools.singledispatch` decorator: see the :pep:`443`. |
| 245 | |
Nick Coghlan | e8c45d6 | 2013-07-28 20:00:01 +1000 | [diff] [blame] | 246 | |
Antoine Pitrou | d6cbd34 | 2013-08-12 20:48:15 +0200 | [diff] [blame^] | 247 | inspect |
| 248 | ------- |
| 249 | |
| 250 | :func:`~inspect.unwrap` makes it easy to unravel wrapper function chains |
| 251 | created by :func:`functools.wraps` (and any other API that sets the |
| 252 | ``__wrapped__`` attribute on a wrapper function). |
| 253 | |
| 254 | |
Antoine Pitrou | f89aa9a | 2013-08-12 20:46:47 +0200 | [diff] [blame] | 255 | mmap |
| 256 | ---- |
| 257 | |
| 258 | mmap objects can now be weakref'ed. |
| 259 | |
| 260 | (Contributed by Valerie Lambert in :issue:`4885`.) |
| 261 | |
| 262 | |
| 263 | poplib |
| 264 | ------ |
| 265 | |
| 266 | New :meth:`~poplib.POP3.stls` method to switch a clear-text POP3 session into |
| 267 | an encrypted POP3 session. |
| 268 | |
| 269 | New :meth:`~poplib.POP3.capa` method to query the capabilities advertised by the |
| 270 | POP3 server. |
| 271 | |
| 272 | (Contributed by Lorenzo Catucci in :issue:`4473`.) |
| 273 | |
| 274 | |
R David Murray | 8e37d5d | 2013-04-13 14:49:48 -0400 | [diff] [blame] | 275 | smtplib |
| 276 | ------- |
| 277 | |
R David Murray | 8a34596 | 2013-04-14 06:46:35 -0400 | [diff] [blame] | 278 | :exc:`~smtplib.SMTPException` is now a subclass of :exc:`OSError`, which allows |
R David Murray | 8e37d5d | 2013-04-13 14:49:48 -0400 | [diff] [blame] | 279 | both socket level errors and SMTP protocol level errors to be caught in one |
| 280 | try/except statement by code that only cares whether or not an error occurred. |
| 281 | (:issue:`2118`). |
| 282 | |
Antoine Pitrou | d6cbd34 | 2013-08-12 20:48:15 +0200 | [diff] [blame^] | 283 | |
Christian Heimes | 24cd4cf | 2013-06-22 19:31:58 +0200 | [diff] [blame] | 284 | ssl |
| 285 | --- |
| 286 | |
Antoine Pitrou | f89aa9a | 2013-08-12 20:46:47 +0200 | [diff] [blame] | 287 | TLSv1.1 and TLSv1.2 support. |
Christian Heimes | 70833a8 | 2013-06-22 19:34:17 +0200 | [diff] [blame] | 288 | |
Antoine Pitrou | f89aa9a | 2013-08-12 20:46:47 +0200 | [diff] [blame] | 289 | (Contributed by Michele Orrù and Antoine Pitrou in :issue:`16692`) |
Christian Heimes | 24cd4cf | 2013-06-22 19:31:58 +0200 | [diff] [blame] | 290 | |
Antoine Pitrou | f89aa9a | 2013-08-12 20:46:47 +0200 | [diff] [blame] | 291 | * New diagnostic functions :func:`~ssl.get_default_verify_paths`, |
| 292 | :meth:`~ssl.SSLContext.cert_store_stats` and |
| 293 | :meth:`~ssl.SSLContext.get_ca_certs` |
| 294 | |
| 295 | * Add :func:`ssl.enum_cert_store` to retrieve certificates and CRL from Windows' |
| 296 | cert store. |
Christian Heimes | 24cd4cf | 2013-06-22 19:31:58 +0200 | [diff] [blame] | 297 | |
| 298 | (Contributed by Christian Heimes in :issue:`18143`, :issue:`18147` and |
Antoine Pitrou | f89aa9a | 2013-08-12 20:46:47 +0200 | [diff] [blame] | 299 | :issue:`17134`.) |
| 300 | |
| 301 | Support for server-side SNI using the new |
| 302 | :meth:`ssl.SSLContext.set_servername_callback` method. |
| 303 | |
| 304 | (Contributed by Daniel Black in :issue:`8109`.) |
| 305 | |
| 306 | |
Antoine Pitrou | d6cbd34 | 2013-08-12 20:48:15 +0200 | [diff] [blame^] | 307 | stat |
| 308 | ---- |
| 309 | |
| 310 | The :mod:`stat` module is now backed by a C implementation in :mod:`_stat`. A C |
| 311 | implementation is required as most of the values aren't standardized and |
| 312 | platform-dependent. (Contributed by Christian Heimes in :issue:`11016`.) |
| 313 | |
| 314 | The module supports new file types: door, event port and whiteout. |
| 315 | |
| 316 | |
Antoine Pitrou | f89aa9a | 2013-08-12 20:46:47 +0200 | [diff] [blame] | 317 | struct |
| 318 | ------ |
| 319 | |
| 320 | Streaming struct unpacking using :func:`struct.iter_unpack`. |
| 321 | |
| 322 | (Contributed by Antoine Pitrou in :issue:`17804`.) |
| 323 | |
| 324 | |
| 325 | urllib |
| 326 | ------ |
| 327 | |
| 328 | Add support.for ``data:`` URLs in :mod:`urllib.request`. |
| 329 | |
| 330 | (Contributed by Mathias Panzenböck in :issue:`16423`.) |
| 331 | |
| 332 | |
| 333 | unittest |
| 334 | -------- |
| 335 | |
| 336 | Support for easy dynamically-generated subtests using the |
| 337 | :meth:`~unittest.TestCase.subTest` context manager. |
| 338 | |
| 339 | (Contributed by Antoine Pitrou in :issue:`16997`.) |
| 340 | |
R David Murray | 8e37d5d | 2013-04-13 14:49:48 -0400 | [diff] [blame] | 341 | |
R David Murray | 671cd32 | 2013-04-10 12:31:43 -0400 | [diff] [blame] | 342 | wave |
| 343 | ---- |
| 344 | |
| 345 | The :meth:`~wave.getparams` method now returns a namedtuple rather than a |
| 346 | plain tuple. (Contributed by Claudiu Popa in :issue:`17487`.) |
| 347 | |
R David Murray | c91d5ee | 2013-07-31 13:46:08 -0400 | [diff] [blame] | 348 | :meth:`wave.open` now supports the context manager protocol. (Contributed |
| 349 | by Claudiu Popa in :issue:`17616`.) |
| 350 | |
Antoine Pitrou | f89aa9a | 2013-08-12 20:46:47 +0200 | [diff] [blame] | 351 | |
Antoine Pitrou | f89aa9a | 2013-08-12 20:46:47 +0200 | [diff] [blame] | 352 | weakref |
| 353 | ------- |
| 354 | |
| 355 | New :class:`~weakref.WeakMethod` class simulates weak references to bound |
| 356 | methods. |
| 357 | |
| 358 | (Contributed by Antoine Pitrou in :issue:`14631`.) |
| 359 | |
| 360 | |
| 361 | xml.etree |
| 362 | --------- |
| 363 | |
| 364 | Add an event-driven parser for non-blocking applications, |
| 365 | :class:`~xml.etree.ElementTree.IncrementalParser`. |
| 366 | |
| 367 | (Contributed by Antoine Pitrou in :issue:`17782`.) |
| 368 | |
| 369 | |
Antoine Pitrou | f89aa9a | 2013-08-12 20:46:47 +0200 | [diff] [blame] | 370 | Other improvements |
| 371 | ================== |
| 372 | |
| 373 | Tab-completion is now enabled by default in the interactive interpreter. |
| 374 | |
| 375 | (Contributed by Antoine Pitrou and Éric Araujo in :issue:`5845`.) |
| 376 | |
| 377 | |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 378 | Optimizations |
| 379 | ============= |
| 380 | |
| 381 | Major performance enhancements have been added: |
| 382 | |
Victor Stinner | e64322e | 2012-10-30 23:12:47 +0100 | [diff] [blame] | 383 | * The UTF-32 decoder is now 3x to 4x faster. |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 384 | |
| 385 | |
| 386 | Build and C API Changes |
| 387 | ======================= |
| 388 | |
| 389 | Changes to Python's build process and to the C API include: |
| 390 | |
| 391 | * None yet. |
| 392 | |
| 393 | |
| 394 | Deprecated |
| 395 | ========== |
| 396 | |
| 397 | Unsupported Operating Systems |
| 398 | ----------------------------- |
| 399 | |
Victor Stinner | f3fd13b | 2013-08-04 10:30:57 +0200 | [diff] [blame] | 400 | * OS/2 |
Victor Stinner | f3fd13b | 2013-08-04 10:30:57 +0200 | [diff] [blame] | 401 | * Windows 2000 |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 402 | |
| 403 | |
| 404 | Deprecated Python modules, functions and methods |
| 405 | ------------------------------------------------ |
| 406 | |
Terry Jan Reedy | 2b6c26e | 2013-03-21 19:36:26 -0400 | [diff] [blame] | 407 | * :meth:`difflib.SequenceMatcher.isbjunk` and |
Andrew Kuchling | 0d0813a | 2013-06-15 13:29:09 -0400 | [diff] [blame] | 408 | :meth:`difflib.SequenceMatcher.isbpopular` were removed: use ``x in sm.bjunk`` and |
| 409 | ``x in sm.bpopular``, where *sm* is a :class:`~difflib.SequenceMatcher` object. |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 410 | |
Brett Cannon | 82b3d6a | 2013-06-14 22:37:11 -0400 | [diff] [blame] | 411 | * :func:`importlib.util.module_for_loader` is pending deprecation. Using |
| 412 | :func:`importlib.util.module_to_load` and |
| 413 | :meth:`importlib.abc.Loader.init_module_attrs` allows subclasses of a loader |
| 414 | to more easily customize module loading. |
| 415 | |
Brett Cannon | e4f41de | 2013-06-16 13:13:40 -0400 | [diff] [blame] | 416 | * The :mod:`imp` module is pending deprecation. To keep compatibility with |
| 417 | Python 2/3 code bases, the module's removal is currently not scheduled. |
| 418 | |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 419 | |
| 420 | Deprecated functions and types of the C API |
| 421 | ------------------------------------------- |
| 422 | |
| 423 | * None yet. |
| 424 | |
| 425 | |
| 426 | Deprecated features |
| 427 | ------------------- |
| 428 | |
Brett Cannon | 82b3d6a | 2013-06-14 22:37:11 -0400 | [diff] [blame] | 429 | * None yet. |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 430 | |
| 431 | |
Benjamin Peterson | 88f3b23 | 2012-10-04 12:45:10 -0400 | [diff] [blame] | 432 | Porting to Python 3.4 |
Georg Brandl | b80f511 | 2012-09-30 09:11:58 +0200 | [diff] [blame] | 433 | ===================== |
| 434 | |
| 435 | This section lists previously described changes and other bugfixes |
| 436 | that may require changes to your code. |
| 437 | |
Brett Cannon | 777622b | 2013-04-09 17:03:10 -0400 | [diff] [blame] | 438 | * The ABCs defined in :mod:`importlib.abc` now either raise the appropriate |
| 439 | exception or return a default value instead of raising |
| 440 | :exc:`NotImplementedError` blindly. This will only affect code calling |
| 441 | :func:`super` and falling through all the way to the ABCs. For compatibility, |
| 442 | catch both :exc:`NotImplementedError` or the appropriate exception as needed. |
Brett Cannon | 4c14b5d | 2013-05-04 13:56:58 -0400 | [diff] [blame] | 443 | |
| 444 | * The module type now initializes the :attr:`__package__` and :attr:`__loader__` |
| 445 | attributes to ``None`` by default. To determine if these attributes were set |
| 446 | in a backwards-compatible fashion, use e.g. |
Brett Cannon | 3dc48d6 | 2013-05-28 18:35:54 -0400 | [diff] [blame] | 447 | ``getattr(module, '__loader__', None) is not None``. |
| 448 | |
| 449 | * :meth:`importlib.util.module_for_loader` now sets ``__loader__`` and |
| 450 | ``__package__`` unconditionally to properly support reloading. If this is not |
| 451 | desired then you will need to set these attributes manually. You can use |
Brett Cannon | 028d512 | 2013-05-31 18:02:11 -0400 | [diff] [blame] | 452 | :func:`importlib.util.module_to_load` for module management. |
Brett Cannon | 3e0651b | 2013-05-31 23:18:39 -0400 | [diff] [blame] | 453 | |
| 454 | * Import now resets relevant attributes (e.g. ``__name__``, ``__loader__``, |
| 455 | ``__package__``, ``__file__``, ``__cached__``) unconditionally when reloading. |
| 456 | |
| 457 | * Frozen packages no longer set ``__path__`` to a list containg the package name |
| 458 | but an empty list instead. Determing if a module is a package should be done |
| 459 | using ``hasattr(module, '__path__')``. |
Brett Cannon | 8f5ac51 | 2013-06-12 23:29:18 -0400 | [diff] [blame] | 460 | |
| 461 | * :c:func:`PyErr_SetImportError` now sets :exc:`TypeError` when its **msg** |
Brett Cannon | 82da888 | 2013-07-04 17:48:16 -0400 | [diff] [blame] | 462 | argument is not set. Previously only ``NULL`` was returned with no exception |
| 463 | set. |
Brett Cannon | 33915eb | 2013-06-14 18:33:00 -0400 | [diff] [blame] | 464 | |
| 465 | * :func:`py_compile.compile` now raises :exc:`FileExistsError` if the file path |
| 466 | it would write to is a symlink or a non-regular file. This is to act as a |
| 467 | warning that import will overwrite those files with a regular file regardless |
| 468 | of what type of file path they were originally. |
Brett Cannon | f4375ef | 2013-06-16 18:05:54 -0400 | [diff] [blame] | 469 | |
| 470 | * :meth:`importlib.abc.SourceLoader.get_source` no longer raises |
| 471 | :exc:`ImportError` when the source code being loaded triggers a |
| 472 | :exc:`SyntaxError` or :exc:`UnicodeDecodeError`. As :exc:`ImportError` is |
| 473 | meant to be raised only when source code cannot be found but it should, it was |
| 474 | felt to be over-reaching/overloading of that meaning when the source code is |
| 475 | found but improperly structured. If you were catching ImportError before and |
| 476 | wish to continue to ignore syntax or decoding issues, catch all three |
Victor Stinner | 84e33c8 | 2013-06-21 00:31:55 +0200 | [diff] [blame] | 477 | exceptions now. |
Nick Coghlan | 24c05bc | 2013-07-15 21:13:08 +1000 | [diff] [blame] | 478 | |
| 479 | * :func:`functools.update_wrapper` and :func:`functools.wraps` now correctly |
| 480 | set the ``__wrapped__`` attribute even if the wrapped function had a |
| 481 | wrapped attribute set. This means ``__wrapped__`` attributes now correctly |
| 482 | link a stack of decorated functions rather than every ``__wrapped__`` |
| 483 | attribute in the chain referring to the innermost function. Introspection |
Nick Coghlan | e8c45d6 | 2013-07-28 20:00:01 +1000 | [diff] [blame] | 484 | libraries that assumed the previous behaviour was intentional can use |
| 485 | :func:`inspect.unwrap` to gain equivalent behaviour. |