python-docs-fr/whatsnew/2.5.po

2790 lines
104 KiB
Plaintext
Raw Permalink Normal View History

2018-07-04 09:06:45 +00:00
# Copyright (C) 2001-2018, Python Software Foundation
2018-07-04 09:08:42 +00:00
# For licence information, see README file.
2016-10-30 09:46:26 +00:00
#
msgid ""
msgstr ""
2019-12-05 22:15:54 +00:00
"Project-Id-Version: Python 3\n"
2016-10-30 09:46:26 +00:00
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-01-15 22:33+0100\n"
"PO-Revision-Date: 2018-07-31 23:32+0200\n"
2017-08-11 17:15:07 +00:00
"Last-Translator: Julien Palard <julien@palard.fr>\n"
2018-07-04 09:14:25 +00:00
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
2017-05-23 22:40:56 +00:00
"Language: fr\n"
2016-10-30 09:46:26 +00:00
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
2017-08-09 22:23:54 +00:00
"X-Generator: Poedit 1.8.11\n"
2016-10-30 09:46:26 +00:00
#: whatsnew/2.5.rst:3
2016-10-30 09:46:26 +00:00
msgid "What's New in Python 2.5"
msgstr "Nouveautés de Python 2.5"
#: whatsnew/2.5.rst:0
2018-05-01 22:20:18 +00:00
msgid "Author"
msgstr "Auteur"
2018-05-01 22:20:18 +00:00
#: whatsnew/2.5.rst:5
2016-10-30 09:46:26 +00:00
msgid "A.M. Kuchling"
msgstr "A.M. Kuchling"
#: whatsnew/2.5.rst:12
2016-10-30 09:46:26 +00:00
msgid ""
"This article explains the new features in Python 2.5. The final release of "
"Python 2.5 is scheduled for August 2006; :pep:`356` describes the planned "
"release schedule. Python 2.5 was released on September 19, 2006."
2016-10-30 09:46:26 +00:00
msgstr ""
#: whatsnew/2.5.rst:16
2016-10-30 09:46:26 +00:00
msgid ""
"The changes in Python 2.5 are an interesting mix of language and library "
"improvements. The library enhancements will be more important to Python's "
"user community, I think, because several widely useful packages were added. "
2016-10-30 09:46:26 +00:00
"New modules include ElementTree for XML processing (:mod:`xml.etree`), the "
"SQLite database module (:mod:`sqlite`), and the :mod:`ctypes` module for "
"calling C functions."
msgstr ""
#: whatsnew/2.5.rst:23
2016-10-30 09:46:26 +00:00
msgid ""
"The language changes are of middling significance. Some pleasant new "
"features were added, but most of them aren't features that you'll use every "
"day. Conditional expressions were finally added to the language using a "
"novel syntax; see section :ref:`pep-308`. The new ':keyword:`with`' "
"statement will make writing cleanup code easier (section :ref:`pep-343`). "
"Values can now be passed into generators (section :ref:`pep-342`). Imports "
"are now visible as either absolute or relative (section :ref:`pep-328`). "
"Some corner cases of exception handling are handled better (section :ref:"
"`pep-341`). All these improvements are worthwhile, but they're improvements "
"to one specific language feature or another; none of them are broad "
"modifications to Python's semantics."
msgstr ""
#: whatsnew/2.5.rst:34
2016-10-30 09:46:26 +00:00
msgid ""
"As well as the language and library additions, other improvements and "
"bugfixes were made throughout the source tree. A search through the SVN "
"change logs finds there were 353 patches applied and 458 bugs fixed between "
"Python 2.4 and 2.5. (Both figures are likely to be underestimates.)"
msgstr ""
#: whatsnew/2.5.rst:39
2016-10-30 09:46:26 +00:00
msgid ""
"This article doesn't try to be a complete specification of the new features; "
"instead changes are briefly introduced using helpful examples. For full "
"details, you should always refer to the documentation for Python 2.5 at "
"https://docs.python.org. If you want to understand the complete "
"implementation and design rationale, refer to the PEP for a particular new "
"feature."
msgstr ""
#: whatsnew/2.5.rst:45
2016-10-30 09:46:26 +00:00
msgid ""
"Comments, suggestions, and error reports for this document are welcome; "
"please e-mail them to the author or open a bug in the Python bug tracker."
msgstr ""
#: whatsnew/2.5.rst:54
2016-10-30 09:46:26 +00:00
msgid "PEP 308: Conditional Expressions"
msgstr "PEP 308 : Expressions conditionnelles"
#: whatsnew/2.5.rst:56
2016-10-30 09:46:26 +00:00
msgid ""
"For a long time, people have been requesting a way to write conditional "
"expressions, which are expressions that return value A or value B depending "
"on whether a Boolean value is true or false. A conditional expression lets "
"you write a single assignment statement that has the same effect as the "
"following::"
msgstr ""
#: whatsnew/2.5.rst:66
2016-10-30 09:46:26 +00:00
msgid ""
"There have been endless tedious discussions of syntax on both python-dev and "
"comp.lang.python. A vote was even held that found the majority of voters "
"wanted conditional expressions in some form, but there was no syntax that "
"was preferred by a clear majority. Candidates included C's ``cond ? true_v : "
"false_v``, ``if cond then true_v else false_v``, and 16 other variations."
msgstr ""
#: whatsnew/2.5.rst:72
2016-10-30 09:46:26 +00:00
msgid "Guido van Rossum eventually chose a surprising syntax::"
msgstr "Guido van Rossum a finalement choisi une syntaxe surprenante ::"
#: whatsnew/2.5.rst:76
2016-10-30 09:46:26 +00:00
msgid ""
"Evaluation is still lazy as in existing Boolean expressions, so the order of "
"evaluation jumps around a bit. The *condition* expression in the middle is "
"evaluated first, and the *true_value* expression is evaluated only if the "
"condition was true. Similarly, the *false_value* expression is only "
"evaluated when the condition is false."
msgstr ""
#: whatsnew/2.5.rst:82
2016-10-30 09:46:26 +00:00
msgid ""
"This syntax may seem strange and backwards; why does the condition go in the "
"*middle* of the expression, and not in the front as in C's ``c ? x : y``? "
"The decision was checked by applying the new syntax to the modules in the "
"standard library and seeing how the resulting code read. In many cases "
"where a conditional expression is used, one value seems to be the 'common "
"case' and one value is an 'exceptional case', used only on rarer occasions "
"when the condition isn't met. The conditional syntax makes this pattern a "
"bit more obvious::"
msgstr ""
#: whatsnew/2.5.rst:92
2016-10-30 09:46:26 +00:00
msgid ""
"I read the above statement as meaning \"here *contents* is usually assigned "
"a value of ``doc+'\\n'``; sometimes *doc* is empty, in which special case "
"an empty string is returned.\" I doubt I will use conditional expressions "
"very often where there isn't a clear common and uncommon case."
msgstr ""
#: whatsnew/2.5.rst:97
2016-10-30 09:46:26 +00:00
msgid ""
"There was some discussion of whether the language should require surrounding "
"conditional expressions with parentheses. The decision was made to *not* "
"require parentheses in the Python language's grammar, but as a matter of "
"style I think you should always use them. Consider these two statements::"
msgstr ""
#: whatsnew/2.5.rst:108
2016-10-30 09:46:26 +00:00
msgid ""
"In the first version, I think a reader's eye might group the statement into "
"'level = 1', 'if logging', 'else 0', and think that the condition decides "
"whether the assignment to *level* is performed. The second version reads "
"better, in my opinion, because it makes it clear that the assignment is "
"always performed and the choice is being made between two values."
msgstr ""
#: whatsnew/2.5.rst:114
2016-10-30 09:46:26 +00:00
msgid ""
"Another reason for including the brackets: a few odd combinations of list "
"comprehensions and lambdas could look like incorrect conditional "
"expressions. See :pep:`308` for some examples. If you put parentheses "
"around your conditional expressions, you won't run into this case."
msgstr ""
#: whatsnew/2.5.rst:123
2016-10-30 09:46:26 +00:00
msgid ":pep:`308` - Conditional Expressions"
msgstr ":pep:`308` -- Expressions conditionnelles"
2016-10-30 09:46:26 +00:00
#: whatsnew/2.5.rst:123
2016-10-30 09:46:26 +00:00
msgid ""
"PEP written by Guido van Rossum and Raymond D. Hettinger; implemented by "
"Thomas Wouters."
msgstr ""
"PEP écrite par Guido van Rossum et Raymond D. Hettinger; implémentée par "
"Thomas Wouters."
#: whatsnew/2.5.rst:132
2016-10-30 09:46:26 +00:00
msgid "PEP 309: Partial Function Application"
msgstr "PEP 309 : Application partielle de fonction"
#: whatsnew/2.5.rst:134
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`functools` module is intended to contain tools for functional-"
"style programming."
msgstr ""
#: whatsnew/2.5.rst:137
2016-10-30 09:46:26 +00:00
msgid ""
"One useful tool in this module is the :func:`partial` function. For programs "
"written in a functional style, you'll sometimes want to construct variants "
"of existing functions that have some of the parameters filled in. Consider "
"a Python function ``f(a, b, c)``; you could create a new function ``g(b, "
"c)`` that was equivalent to ``f(1, b, c)``. This is called \"partial "
"function application\"."
msgstr ""
#: whatsnew/2.5.rst:144
2016-10-30 09:46:26 +00:00
msgid ""
":func:`partial` takes the arguments ``(function, arg1, arg2, ... "
"kwarg1=value1, kwarg2=value2)``. The resulting object is callable, so you "
"can just call it to invoke *function* with the filled-in arguments."
msgstr ""
#: whatsnew/2.5.rst:148
2016-10-30 09:46:26 +00:00
msgid "Here's a small but realistic example::"
msgstr "Voici un exemple court mais réaliste ::"
#: whatsnew/2.5.rst:160
2016-10-30 09:46:26 +00:00
msgid ""
2017-04-02 20:14:06 +00:00
"Here's another example, from a program that uses PyGTK. Here a context-"
2016-10-30 09:46:26 +00:00
"sensitive pop-up menu is being constructed dynamically. The callback "
"provided for the menu option is a partially applied version of the :meth:"
"`open_item` method, where the first argument has been provided. ::"
msgstr ""
#: whatsnew/2.5.rst:173
2016-10-30 09:46:26 +00:00
msgid ""
"Another function in the :mod:`functools` module is the "
2017-04-02 20:14:06 +00:00
"``update_wrapper(wrapper, wrapped)`` function that helps you write well-"
2016-10-30 09:46:26 +00:00
"behaved decorators. :func:`update_wrapper` copies the name, module, and "
"docstring attribute to a wrapper function so that tracebacks inside the "
"wrapped function are easier to understand. For example, you might write::"
msgstr ""
#: whatsnew/2.5.rst:186
2016-10-30 09:46:26 +00:00
msgid ""
":func:`wraps` is a decorator that can be used inside your own decorators to "
"copy the wrapped function's information. An alternate version of the "
"previous example would be::"
msgstr ""
#: whatsnew/2.5.rst:201
2016-10-30 09:46:26 +00:00
msgid ":pep:`309` - Partial Function Application"
msgstr ":pep:`309` -- Application partielle de fonction"
2016-10-30 09:46:26 +00:00
#: whatsnew/2.5.rst:201
2016-10-30 09:46:26 +00:00
msgid ""
"PEP proposed and written by Peter Harris; implemented by Hye-Shik Chang and "
"Nick Coghlan, with adaptations by Raymond Hettinger."
msgstr ""
#: whatsnew/2.5.rst:210
2016-10-30 09:46:26 +00:00
msgid "PEP 314: Metadata for Python Software Packages v1.1"
msgstr ""
#: whatsnew/2.5.rst:212
2016-10-30 09:46:26 +00:00
msgid ""
"Some simple dependency support was added to Distutils. The :func:`setup` "
"function now has ``requires``, ``provides``, and ``obsoletes`` keyword "
"parameters. When you build a source distribution using the ``sdist`` "
"command, the dependency information will be recorded in the :file:`PKG-INFO` "
"file."
msgstr ""
#: whatsnew/2.5.rst:217
2016-10-30 09:46:26 +00:00
msgid ""
"Another new keyword parameter is ``download_url``, which should be set to a "
"URL for the package's source code. This means it's now possible to look up "
"an entry in the package index, determine the dependencies for a package, and "
"download the required packages. ::"
msgstr ""
#: whatsnew/2.5.rst:231
2016-10-30 09:46:26 +00:00
msgid ""
2018-06-10 09:32:30 +00:00
"Another new enhancement to the Python package index at https://pypi.org is "
"storing source and binary archives for a package. The new :command:`upload` "
"Distutils command will upload a package to the repository."
2016-10-30 09:46:26 +00:00
msgstr ""
#: whatsnew/2.5.rst:236
2016-10-30 09:46:26 +00:00
msgid ""
"Before a package can be uploaded, you must be able to build a distribution "
"using the :command:`sdist` Distutils command. Once that works, you can run "
"``python setup.py upload`` to add your package to the PyPI archive. "
2017-04-02 20:14:06 +00:00
"Optionally you can GPG-sign the package by supplying the :option:`!--sign` "
"and :option:`!--identity` options."
2016-10-30 09:46:26 +00:00
msgstr ""
#: whatsnew/2.5.rst:242
2016-10-30 09:46:26 +00:00
msgid ""
"Package uploading was implemented by Martin von Löwis and Richard Jones."
msgstr ""
#: whatsnew/2.5.rst:248
2016-10-30 09:46:26 +00:00
msgid ":pep:`314` - Metadata for Python Software Packages v1.1"
msgstr ""
#: whatsnew/2.5.rst:248
2016-10-30 09:46:26 +00:00
msgid ""
"PEP proposed and written by A.M. Kuchling, Richard Jones, and Fred Drake; "
"implemented by Richard Jones and Fred Drake."
msgstr ""
#: whatsnew/2.5.rst:257
2016-10-30 09:46:26 +00:00
msgid "PEP 328: Absolute and Relative Imports"
msgstr ""
#: whatsnew/2.5.rst:259
2016-10-30 09:46:26 +00:00
msgid ""
2019-09-04 09:35:23 +00:00
"The simpler part of :pep:`328` was implemented in Python 2.4: parentheses "
"could now be used to enclose the names imported from a module using the "
"``from ... import ...`` statement, making it easier to import many different "
"names."
2016-10-30 09:46:26 +00:00
msgstr ""
#: whatsnew/2.5.rst:263
2016-10-30 09:46:26 +00:00
msgid ""
"The more complicated part has been implemented in Python 2.5: importing a "
"module can be specified to use absolute or package-relative imports. The "
"plan is to move toward making absolute imports the default in future "
"versions of Python."
msgstr ""
#: whatsnew/2.5.rst:267
2016-10-30 09:46:26 +00:00
msgid "Let's say you have a package directory like this::"
msgstr ""
#: whatsnew/2.5.rst:274
2016-10-30 09:46:26 +00:00
msgid ""
"This defines a package named :mod:`pkg` containing the :mod:`pkg.main` and :"
"mod:`pkg.string` submodules."
msgstr ""
#: whatsnew/2.5.rst:277
2016-10-30 09:46:26 +00:00
msgid ""
"Consider the code in the :file:`main.py` module. What happens if it "
"executes the statement ``import string``? In Python 2.4 and earlier, it "
"will first look in the package's directory to perform a relative import, "
"finds :file:`pkg/string.py`, imports the contents of that file as the :mod:"
"`pkg.string` module, and that module is bound to the name ``string`` in the :"
"mod:`pkg.main` module's namespace."
msgstr ""
#: whatsnew/2.5.rst:284
2016-10-30 09:46:26 +00:00
msgid ""
"That's fine if :mod:`pkg.string` was what you wanted. But what if you "
"wanted Python's standard :mod:`string` module? There's no clean way to "
"ignore :mod:`pkg.string` and look for the standard module; generally you had "
"to look at the contents of ``sys.modules``, which is slightly unclean. "
"Holger Krekel's :mod:`py.std` package provides a tidier way to perform "
"imports from the standard library, ``import py; py.std.string.join()``, but "
"that package isn't available on all Python installations."
msgstr ""
#: whatsnew/2.5.rst:292
2016-10-30 09:46:26 +00:00
msgid ""
"Reading code which relies on relative imports is also less clear, because a "
"reader may be confused about which module, :mod:`string` or :mod:`pkg."
"string`, is intended to be used. Python users soon learned not to duplicate "
"the names of standard library modules in the names of their packages' "
"submodules, but you can't protect against having your submodule's name being "
"used for a new module added in a future version of Python."
msgstr ""
#: whatsnew/2.5.rst:299
2016-10-30 09:46:26 +00:00
msgid ""
"In Python 2.5, you can switch :keyword:`import`'s behaviour to absolute "
"imports using a ``from __future__ import absolute_import`` directive. This "
2017-04-02 20:14:06 +00:00
"absolute-import behaviour will become the default in a future version "
2016-10-30 09:46:26 +00:00
"(probably Python 2.7). Once absolute imports are the default, ``import "
"string`` will always find the standard library's version. It's suggested "
"that users should begin using absolute imports as much as possible, so it's "
"preferable to begin writing ``from pkg import string`` in your code."
msgstr ""
#: whatsnew/2.5.rst:307
2016-10-30 09:46:26 +00:00
msgid ""
"Relative imports are still possible by adding a leading period to the "
"module name when using the ``from ... import`` form::"
msgstr ""
#: whatsnew/2.5.rst:315
2016-10-30 09:46:26 +00:00
msgid ""
"This imports the :mod:`string` module relative to the current package, so "
"in :mod:`pkg.main` this will import *name1* and *name2* from :mod:`pkg."
"string`. Additional leading periods perform the relative import starting "
"from the parent of the current package. For example, code in the :mod:`A.B."
"C` module can do::"
msgstr ""
#: whatsnew/2.5.rst:324
2016-10-30 09:46:26 +00:00
msgid ""
"Leading periods cannot be used with the ``import modname`` form of the "
"import statement, only the ``from ... import`` form."
msgstr ""
#: whatsnew/2.5.rst:331
2020-02-14 10:18:53 +00:00
#, fuzzy
2016-10-30 09:46:26 +00:00
msgid ":pep:`328` - Imports: Multi-Line and Absolute/Relative"
msgstr ""
2020-02-14 10:18:53 +00:00
":pep:`328` : *Importations : multilignes et absolues/relatives* (ressource "
"en anglais)"
2016-10-30 09:46:26 +00:00
#: whatsnew/2.5.rst:331
2016-10-30 09:46:26 +00:00
msgid "PEP written by Aahz; implemented by Thomas Wouters."
msgstr "PEP écrite par Aahz; implémentée par Thomas Wouters."
#: whatsnew/2.5.rst:333
2018-06-28 13:32:56 +00:00
msgid "https://pylib.readthedocs.io/"
2016-10-30 09:46:26 +00:00
msgstr ""
#: whatsnew/2.5.rst:334
2016-10-30 09:46:26 +00:00
msgid ""
"The py library by Holger Krekel, which contains the :mod:`py.std` package."
msgstr ""
#: whatsnew/2.5.rst:342
2016-10-30 09:46:26 +00:00
msgid "PEP 338: Executing Modules as Scripts"
msgstr ""
#: whatsnew/2.5.rst:344
2016-10-30 09:46:26 +00:00
msgid ""
"The :option:`-m` switch added in Python 2.4 to execute a module as a script "
"gained a few more abilities. Instead of being implemented in C code inside "
"the Python interpreter, the switch now uses an implementation in a new "
"module, :mod:`runpy`."
msgstr ""
#: whatsnew/2.5.rst:349
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`runpy` module implements a more sophisticated import mechanism so "
"that it's now possible to run modules in a package such as :mod:`pychecker."
"checker`. The module also supports alternative import mechanisms such as "
"the :mod:`zipimport` module. This means you can add a .zip archive's path "
"to ``sys.path`` and then use the :option:`-m` switch to execute code from "
"the archive."
msgstr ""
#: whatsnew/2.5.rst:359
2016-10-30 09:46:26 +00:00
msgid ":pep:`338` - Executing modules as scripts"
msgstr ":pep:`338` - Executing modules as scripts"
#: whatsnew/2.5.rst:360
2016-10-30 09:46:26 +00:00
msgid "PEP written and implemented by Nick Coghlan."
msgstr ""
#: whatsnew/2.5.rst:368
2016-10-30 09:46:26 +00:00
msgid "PEP 341: Unified try/except/finally"
msgstr ""
#: whatsnew/2.5.rst:370
2016-10-30 09:46:26 +00:00
msgid ""
"Until Python 2.5, the :keyword:`try` statement came in two flavours. You "
"could use a :keyword:`finally` block to ensure that code is always executed, "
"or one or more :keyword:`except` blocks to catch specific exceptions. You "
2018-12-24 13:20:55 +00:00
"couldn't combine both :keyword:`!except` blocks and a :keyword:`!finally` "
2016-10-30 09:46:26 +00:00
"block, because generating the right bytecode for the combined version was "
"complicated and it wasn't clear what the semantics of the combined statement "
"should be."
msgstr ""
#: whatsnew/2.5.rst:377
2016-10-30 09:46:26 +00:00
msgid ""
"Guido van Rossum spent some time working with Java, which does support the "
"equivalent of combining :keyword:`except` blocks and a :keyword:`finally` "
"block, and this clarified what the statement should mean. In Python 2.5, "
"you can now write::"
msgstr ""
#: whatsnew/2.5.rst:393
2016-10-30 09:46:26 +00:00
msgid ""
"The code in *block-1* is executed. If the code raises an exception, the "
"various :keyword:`except` blocks are tested: if the exception is of class :"
"class:`Exception1`, *handler-1* is executed; otherwise if it's of class :"
"class:`Exception2`, *handler-2* is executed, and so forth. If no exception "
"is raised, the *else-block* is executed."
msgstr ""
#: whatsnew/2.5.rst:399
2016-10-30 09:46:26 +00:00
msgid ""
"No matter what happened previously, the *final-block* is executed once the "
"code block is complete and any raised exceptions handled. Even if there's an "
"error in an exception handler or the *else-block* and a new exception is "
"raised, the code in the *final-block* is still run."
msgstr ""
#: whatsnew/2.5.rst:407
2016-10-30 09:46:26 +00:00
msgid ":pep:`341` - Unifying try-except and try-finally"
msgstr ""
#: whatsnew/2.5.rst:408
2016-10-30 09:46:26 +00:00
msgid "PEP written by Georg Brandl; implementation by Thomas Lee."
msgstr ""
#: whatsnew/2.5.rst:416
2016-10-30 09:46:26 +00:00
msgid "PEP 342: New Generator Features"
msgstr ""
#: whatsnew/2.5.rst:418
2016-10-30 09:46:26 +00:00
msgid ""
"Python 2.5 adds a simple way to pass values *into* a generator. As "
"introduced in Python 2.3, generators only produce output; once a generator's "
"code was invoked to create an iterator, there was no way to pass any new "
"information into the function when its execution is resumed. Sometimes the "
"ability to pass in some information would be useful. Hackish solutions to "
"this include making the generator's code look at a global variable and then "
"changing the global variable's value, or passing in some mutable object that "
"callers then modify."
msgstr ""
#: whatsnew/2.5.rst:426
2016-10-30 09:46:26 +00:00
msgid "To refresh your memory of basic generators, here's a simple example::"
msgstr ""
#: whatsnew/2.5.rst:434
2016-10-30 09:46:26 +00:00
msgid ""
"When you call ``counter(10)``, the result is an iterator that returns the "
"values from 0 up to 9. On encountering the :keyword:`yield` statement, the "
"iterator returns the provided value and suspends the function's execution, "
"preserving the local variables. Execution resumes on the following call to "
2018-12-24 13:20:55 +00:00
"the iterator's :meth:`next` method, picking up after the :keyword:`!yield` "
2016-10-30 09:46:26 +00:00
"statement."
msgstr ""
#: whatsnew/2.5.rst:440
2016-10-30 09:46:26 +00:00
msgid ""
"In Python 2.3, :keyword:`yield` was a statement; it didn't return any "
2018-12-24 13:20:55 +00:00
"value. In 2.5, :keyword:`!yield` is now an expression, returning a value "
2016-10-30 09:46:26 +00:00
"that can be assigned to a variable or otherwise operated on::"
msgstr ""
#: whatsnew/2.5.rst:446
2016-10-30 09:46:26 +00:00
msgid ""
"I recommend that you always put parentheses around a :keyword:`yield` "
"expression when you're doing something with the returned value, as in the "
"above example. The parentheses aren't always necessary, but it's easier to "
"always add them instead of having to remember when they're needed."
msgstr ""
#: whatsnew/2.5.rst:451
2020-02-14 10:18:53 +00:00
#, fuzzy
2016-10-30 09:46:26 +00:00
msgid ""
"(:pep:`342` explains the exact rules, which are that a :keyword:`yield`\\ -"
"expression must always be parenthesized except when it occurs at the top-"
"level expression on the right-hand side of an assignment. This means you "
"can write ``val = yield i`` but have to use parentheses when there's an "
"operation, as in ``val = (yield i) + 12``.)"
msgstr ""
2020-02-14 10:18:53 +00:00
"(Les règles exactes de parenthésage sont spécifies dans la :pep:`342` : une "
"expression ``yield`` doit toujours être parenthésée sauf s'il s'agit de "
"l'expression la plus externe du côté droit d'une assignation. Cela signifie "
"que vous pouvez écrire ``val = yield i`` mais que les parenthèses sont "
"requises s'il y a une opération, comme dans ``val = (yield i) + 12``.)"
2016-10-30 09:46:26 +00:00
#: whatsnew/2.5.rst:458
2016-10-30 09:46:26 +00:00
msgid ""
"Values are sent into a generator by calling its ``send(value)`` method. The "
"generator's code is then resumed and the :keyword:`yield` expression returns "
"the specified *value*. If the regular :meth:`next` method is called, the :"
2018-12-24 13:20:55 +00:00
"keyword:`!yield` returns :const:`None`."
2016-10-30 09:46:26 +00:00
msgstr ""
#: whatsnew/2.5.rst:463
2016-10-30 09:46:26 +00:00
msgid ""
"Here's the previous example, modified to allow changing the value of the "
"internal counter. ::"
msgstr ""
#: whatsnew/2.5.rst:476
2020-02-14 10:18:53 +00:00
#, fuzzy
2016-10-30 09:46:26 +00:00
msgid "And here's an example of changing the counter::"
msgstr "Et voici comment il est possible de modifier le compteur ::"
2016-10-30 09:46:26 +00:00
#: whatsnew/2.5.rst:493
2016-10-30 09:46:26 +00:00
msgid ""
":keyword:`yield` will usually return :const:`None`, so you should always "
"check for this case. Don't just use its value in expressions unless you're "
"sure that the :meth:`send` method will be the only method used to resume "
"your generator function."
msgstr ""
#: whatsnew/2.5.rst:498
2020-02-14 10:18:53 +00:00
#, fuzzy
2016-10-30 09:46:26 +00:00
msgid ""
"In addition to :meth:`send`, there are two other new methods on generators:"
msgstr ""
2020-02-14 10:18:53 +00:00
"En plus de :meth:`~generator.send`, il existe deux autres méthodes "
"s'appliquant aux générateurs :"
2016-10-30 09:46:26 +00:00
#: whatsnew/2.5.rst:500
2016-10-30 09:46:26 +00:00
msgid ""
"``throw(type, value=None, traceback=None)`` is used to raise an exception "
"inside the generator; the exception is raised by the :keyword:`yield` "
"expression where the generator's execution is paused."
msgstr ""
#: whatsnew/2.5.rst:504
2016-10-30 09:46:26 +00:00
msgid ""
":meth:`close` raises a new :exc:`GeneratorExit` exception inside the "
"generator to terminate the iteration. On receiving this exception, the "
"generator's code must either raise :exc:`GeneratorExit` or :exc:"
"`StopIteration`. Catching the :exc:`GeneratorExit` exception and returning "
"a value is illegal and will trigger a :exc:`RuntimeError`; if the function "
"raises some other exception, that exception is propagated to the caller. :"
"meth:`close` will also be called by Python's garbage collector when the "
"generator is garbage-collected."
msgstr ""
#: whatsnew/2.5.rst:512
2020-02-14 10:18:53 +00:00
#, fuzzy
2016-10-30 09:46:26 +00:00
msgid ""
"If you need to run cleanup code when a :exc:`GeneratorExit` occurs, I "
"suggest using a ``try: ... finally:`` suite instead of catching :exc:"
"`GeneratorExit`."
msgstr ""
2020-02-14 10:18:53 +00:00
"Si vous devez exécuter du code pour faire le ménage lors d'une :exc:"
"`GeneratorExit`, nous vous suggérons d'utiliser une structure ``try: ... "
"finally`` plutôt que d'attraper :exc:`GeneratorExit`."
2016-10-30 09:46:26 +00:00
#: whatsnew/2.5.rst:515
2016-10-30 09:46:26 +00:00
msgid ""
"The cumulative effect of these changes is to turn generators from one-way "
"producers of information into both producers and consumers."
msgstr ""
2019-12-06 09:55:45 +00:00
"Ces changements cumulés transforment les générateurs de producteurs "
"unidirectionnels d'information vers un statut hybride à la fois producteur "
"et consommateur."
2016-10-30 09:46:26 +00:00
#: whatsnew/2.5.rst:518
2016-10-30 09:46:26 +00:00
msgid ""
"Generators also become *coroutines*, a more generalized form of subroutines. "
"Subroutines are entered at one point and exited at another point (the top of "
"the function, and a :keyword:`return` statement), but coroutines can be "
"entered, exited, and resumed at many different points (the :keyword:`yield` "
"statements). We'll have to figure out patterns for using coroutines "
"effectively in Python."
msgstr ""
#: whatsnew/2.5.rst:524
2016-10-30 09:46:26 +00:00
msgid ""
"The addition of the :meth:`close` method has one side effect that isn't "
"obvious. :meth:`close` is called when a generator is garbage-collected, so "
"this means the generator's code gets one last chance to run before the "
"generator is destroyed. This last chance means that ``try...finally`` "
"statements in generators can now be guaranteed to work; the :keyword:"
"`finally` clause will now always get a chance to run. The syntactic "
"restriction that you couldn't mix :keyword:`yield` statements with a ``try..."
"finally`` suite has therefore been removed. This seems like a minor bit of "
"language trivia, but using generators and ``try...finally`` is actually "
2019-09-04 09:35:23 +00:00
"necessary in order to implement the :keyword:`with` statement described by :"
"pep:`343`. I'll look at this new statement in the following section."
2016-10-30 09:46:26 +00:00
msgstr ""
#: whatsnew/2.5.rst:536
2016-10-30 09:46:26 +00:00
msgid ""
"Another even more esoteric effect of this change: previously, the :attr:"
"`gi_frame` attribute of a generator was always a frame object. It's now "
"possible for :attr:`gi_frame` to be ``None`` once the generator has been "
"exhausted."
msgstr ""
#: whatsnew/2.5.rst:549
2016-10-30 09:46:26 +00:00
msgid ":pep:`342` - Coroutines via Enhanced Generators"
msgstr ":pep:`342` -- Coroutines *via* des générateurs améliorés"
2016-10-30 09:46:26 +00:00
#: whatsnew/2.5.rst:545
2016-10-30 09:46:26 +00:00
msgid ""
"PEP written by Guido van Rossum and Phillip J. Eby; implemented by Phillip "
"J. Eby. Includes examples of some fancier uses of generators as coroutines."
msgstr ""
#: whatsnew/2.5.rst:548
2016-10-30 09:46:26 +00:00
msgid ""
"Earlier versions of these features were proposed in :pep:`288` by Raymond "
"Hettinger and :pep:`325` by Samuele Pedroni."
msgstr ""
#: whatsnew/2.5.rst:552
2016-10-30 09:46:26 +00:00
msgid "https://en.wikipedia.org/wiki/Coroutine"
msgstr "https://en.wikipedia.org/wiki/Coroutine"
#: whatsnew/2.5.rst:552
2016-10-30 09:46:26 +00:00
msgid "The Wikipedia entry for coroutines."
msgstr "Larticle de Wikipédia sur les coroutines."
#: whatsnew/2.5.rst:554
#, fuzzy
msgid ""
"https://web.archive.org/web/20160321211320/http://www.sidhe.org/~dan/blog/"
"archives/000178.html"
2016-10-30 09:46:26 +00:00
msgstr "http://www.sidhe.org/~dan/blog/archives/000178.html"
#: whatsnew/2.5.rst:555
2016-10-30 09:46:26 +00:00
msgid ""
"An explanation of coroutines from a Perl point of view, written by Dan "
"Sugalski."
msgstr ""
#: whatsnew/2.5.rst:563
2016-10-30 09:46:26 +00:00
msgid "PEP 343: The 'with' statement"
msgstr ""
#: whatsnew/2.5.rst:565
2016-10-30 09:46:26 +00:00
msgid ""
"The ':keyword:`with`' statement clarifies code that previously would use "
"``try...finally`` blocks to ensure that clean-up code is executed. In this "
"section, I'll discuss the statement as it will commonly be used. In the "
"next section, I'll examine the implementation details and show how to write "
"objects for use with this statement."
msgstr ""
#: whatsnew/2.5.rst:571
2016-10-30 09:46:26 +00:00
msgid ""
"The ':keyword:`with`' statement is a new control-flow structure whose basic "
"structure is::"
msgstr ""
#: whatsnew/2.5.rst:577
2016-10-30 09:46:26 +00:00
msgid ""
"The expression is evaluated, and it should result in an object that supports "
"the context management protocol (that is, has :meth:`__enter__` and :meth:"
"`__exit__` methods."
msgstr ""
#: whatsnew/2.5.rst:581
2016-10-30 09:46:26 +00:00
msgid ""
"The object's :meth:`__enter__` is called before *with-block* is executed and "
"therefore can run set-up code. It also may return a value that is bound to "
"the name *variable*, if given. (Note carefully that *variable* is *not* "
"assigned the result of *expression*.)"
msgstr ""
#: whatsnew/2.5.rst:586
2016-10-30 09:46:26 +00:00
msgid ""
"After execution of the *with-block* is finished, the object's :meth:"
"`__exit__` method is called, even if the block raised an exception, and can "
"therefore run clean-up code."
msgstr ""
#: whatsnew/2.5.rst:590
2016-10-30 09:46:26 +00:00
msgid ""
"To enable the statement in Python 2.5, you need to add the following "
"directive to your module::"
msgstr ""
#: whatsnew/2.5.rst:595
2016-10-30 09:46:26 +00:00
msgid "The statement will always be enabled in Python 2.6."
msgstr ""
#: whatsnew/2.5.rst:597
2016-10-30 09:46:26 +00:00
msgid ""
"Some standard Python objects now support the context management protocol and "
"can be used with the ':keyword:`with`' statement. File objects are one "
"example::"
msgstr ""
#: whatsnew/2.5.rst:605
2016-10-30 09:46:26 +00:00
msgid ""
"After this statement has executed, the file object in *f* will have been "
"automatically closed, even if the :keyword:`for` loop raised an exception "
2017-04-02 20:14:06 +00:00
"part-way through the block."
2016-10-30 09:46:26 +00:00
msgstr ""
#: whatsnew/2.5.rst:611
2016-10-30 09:46:26 +00:00
msgid ""
"In this case, *f* is the same object created by :func:`open`, because :meth:"
"`file.__enter__` returns *self*."
msgstr ""
#: whatsnew/2.5.rst:614
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`threading` module's locks and condition variables also support "
"the ':keyword:`with`' statement::"
msgstr ""
#: whatsnew/2.5.rst:622
2016-10-30 09:46:26 +00:00
msgid ""
"The lock is acquired before the block is executed and always released once "
"the block is complete."
msgstr ""
#: whatsnew/2.5.rst:625
2016-10-30 09:46:26 +00:00
msgid ""
"The new :func:`localcontext` function in the :mod:`decimal` module makes it "
"easy to save and restore the current decimal context, which encapsulates the "
"desired precision and rounding characteristics for computations::"
msgstr ""
#: whatsnew/2.5.rst:644
2016-10-30 09:46:26 +00:00
msgid "Writing Context Managers"
msgstr "Écrire des gestionnaires de contexte"
#: whatsnew/2.5.rst:646
2016-10-30 09:46:26 +00:00
msgid ""
"Under the hood, the ':keyword:`with`' statement is fairly complicated. Most "
2018-12-24 13:20:55 +00:00
"people will only use ':keyword:`!with`' in company with existing objects and "
2016-10-30 09:46:26 +00:00
"don't need to know these details, so you can skip the rest of this section "
"if you like. Authors of new objects will need to understand the details of "
"the underlying implementation and should keep reading."
msgstr ""
#: whatsnew/2.5.rst:652
2016-10-30 09:46:26 +00:00
msgid "A high-level explanation of the context management protocol is:"
msgstr ""
#: whatsnew/2.5.rst:654
2016-10-30 09:46:26 +00:00
msgid ""
"The expression is evaluated and should result in an object called a "
"\"context manager\". The context manager must have :meth:`__enter__` and :"
"meth:`__exit__` methods."
msgstr ""
#: whatsnew/2.5.rst:658
2016-10-30 09:46:26 +00:00
msgid ""
"The context manager's :meth:`__enter__` method is called. The value "
"returned is assigned to *VAR*. If no ``'as VAR'`` clause is present, the "
"value is simply discarded."
msgstr ""
#: whatsnew/2.5.rst:662
2016-10-30 09:46:26 +00:00
msgid "The code in *BLOCK* is executed."
msgstr "Le code dans *BLOCK* est exécuté."
#: whatsnew/2.5.rst:664
2016-10-30 09:46:26 +00:00
msgid ""
"If *BLOCK* raises an exception, the ``__exit__(type, value, traceback)`` is "
"called with the exception details, the same values returned by :func:`sys."
"exc_info`. The method's return value controls whether the exception is re-"
"raised: any false value re-raises the exception, and ``True`` will result in "
"suppressing it. You'll only rarely want to suppress the exception, because "
"if you do the author of the code containing the ':keyword:`with`' statement "
"will never realize anything went wrong."
msgstr ""
#: whatsnew/2.5.rst:672
2016-10-30 09:46:26 +00:00
msgid ""
"If *BLOCK* didn't raise an exception, the :meth:`__exit__` method is still "
"called, but *type*, *value*, and *traceback* are all ``None``."
msgstr ""
#: whatsnew/2.5.rst:675
2016-10-30 09:46:26 +00:00
msgid ""
"Let's think through an example. I won't present detailed code but will only "
"sketch the methods necessary for a database that supports transactions."
msgstr ""
#: whatsnew/2.5.rst:678
2016-10-30 09:46:26 +00:00
msgid ""
"(For people unfamiliar with database terminology: a set of changes to the "
"database are grouped into a transaction. Transactions can be either "
"committed, meaning that all the changes are written into the database, or "
"rolled back, meaning that the changes are all discarded and the database is "
"unchanged. See any database textbook for more information.)"
msgstr ""
#: whatsnew/2.5.rst:684
2016-10-30 09:46:26 +00:00
msgid ""
"Let's assume there's an object representing a database connection. Our goal "
"will be to let the user write code like this::"
msgstr ""
#: whatsnew/2.5.rst:693
2016-10-30 09:46:26 +00:00
msgid ""
"The transaction should be committed if the code in the block runs flawlessly "
"or rolled back if there's an exception. Here's the basic interface for :"
"class:`DatabaseConnection` that I'll assume::"
msgstr ""
#: whatsnew/2.5.rst:706
2016-10-30 09:46:26 +00:00
msgid ""
"The :meth:`__enter__` method is pretty easy, having only to start a new "
"transaction. For this application the resulting cursor object would be a "
"useful result, so the method will return it. The user can then add ``as "
"cursor`` to their ':keyword:`with`' statement to bind the cursor to a "
"variable name. ::"
msgstr ""
#: whatsnew/2.5.rst:718
2016-10-30 09:46:26 +00:00
msgid ""
"The :meth:`__exit__` method is the most complicated because it's where most "
"of the work has to be done. The method has to check if an exception "
"occurred. If there was no exception, the transaction is committed. The "
"transaction is rolled back if there was an exception."
msgstr ""
#: whatsnew/2.5.rst:723
2016-10-30 09:46:26 +00:00
msgid ""
"In the code below, execution will just fall off the end of the function, "
"returning the default value of ``None``. ``None`` is false, so the "
"exception will be re-raised automatically. If you wished, you could be more "
"explicit and add a :keyword:`return` statement at the marked location. ::"
msgstr ""
#: whatsnew/2.5.rst:743
2016-10-30 09:46:26 +00:00
msgid "The contextlib module"
msgstr "Le module *contextlib*"
2016-10-30 09:46:26 +00:00
#: whatsnew/2.5.rst:745
2016-10-30 09:46:26 +00:00
msgid ""
"The new :mod:`contextlib` module provides some functions and a decorator "
"that are useful for writing objects for use with the ':keyword:`with`' "
"statement."
msgstr ""
#: whatsnew/2.5.rst:748
2016-10-30 09:46:26 +00:00
msgid ""
"The decorator is called :func:`contextmanager`, and lets you write a single "
"generator function instead of defining a new class. The generator should "
"yield exactly one value. The code up to the :keyword:`yield` will be "
"executed as the :meth:`__enter__` method, and the value yielded will be the "
"method's return value that will get bound to the variable in the ':keyword:"
2018-12-24 13:20:55 +00:00
"`with`' statement's :keyword:`!as` clause, if any. The code after the :"
2016-10-30 09:46:26 +00:00
"keyword:`yield` will be executed in the :meth:`__exit__` method. Any "
2018-12-24 13:20:55 +00:00
"exception raised in the block will be raised by the :keyword:`!yield` "
2016-10-30 09:46:26 +00:00
"statement."
msgstr ""
#: whatsnew/2.5.rst:757
2016-10-30 09:46:26 +00:00
msgid ""
"Our database example from the previous section could be written using this "
"decorator as::"
msgstr ""
#: whatsnew/2.5.rst:777
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`contextlib` module also has a ``nested(mgr1, mgr2, ...)`` function "
"that combines a number of context managers so you don't need to write nested "
2018-12-24 13:20:55 +00:00
"':keyword:`with`' statements. In this example, the single ':keyword:`!"
"with`' statement both starts a database transaction and acquires a thread "
"lock::"
2016-10-30 09:46:26 +00:00
msgstr ""
#: whatsnew/2.5.rst:786
2016-10-30 09:46:26 +00:00
msgid ""
"Finally, the ``closing(object)`` function returns *object* so that it can be "
"bound to a variable, and calls ``object.close`` at the end of the block. ::"
msgstr ""
#: whatsnew/2.5.rst:803
2016-10-30 09:46:26 +00:00
msgid ":pep:`343` - The \"with\" statement"
2017-08-10 05:17:13 +00:00
msgstr ":pep:`343` - The \"with\" statement"
2016-10-30 09:46:26 +00:00
#: whatsnew/2.5.rst:800
2016-10-30 09:46:26 +00:00
msgid ""
"PEP written by Guido van Rossum and Nick Coghlan; implemented by Mike Bland, "
"Guido van Rossum, and Neal Norwitz. The PEP shows the code generated for a "
"':keyword:`with`' statement, which can be helpful in learning how the "
"statement works."
msgstr ""
#: whatsnew/2.5.rst:805
2016-10-30 09:46:26 +00:00
msgid "The documentation for the :mod:`contextlib` module."
msgstr ""
#: whatsnew/2.5.rst:813
2016-10-30 09:46:26 +00:00
msgid "PEP 352: Exceptions as New-Style Classes"
msgstr ""
#: whatsnew/2.5.rst:815
2016-10-30 09:46:26 +00:00
msgid ""
"Exception classes can now be new-style classes, not just classic classes, "
"and the built-in :exc:`Exception` class and all the standard built-in "
"exceptions (:exc:`NameError`, :exc:`ValueError`, etc.) are now new-style "
"classes."
msgstr ""
#: whatsnew/2.5.rst:819
2016-10-30 09:46:26 +00:00
msgid ""
"The inheritance hierarchy for exceptions has been rearranged a bit. In 2.5, "
"the inheritance relationships are::"
msgstr ""
#: whatsnew/2.5.rst:828
2016-10-30 09:46:26 +00:00
msgid ""
"This rearrangement was done because people often want to catch all "
"exceptions that indicate program errors. :exc:`KeyboardInterrupt` and :exc:"
"`SystemExit` aren't errors, though, and usually represent an explicit action "
"such as the user hitting :kbd:`Control-C` or code calling :func:`sys.exit`. "
"A bare ``except:`` will catch all exceptions, so you commonly need to list :"
"exc:`KeyboardInterrupt` and :exc:`SystemExit` in order to re-raise them. "
"The usual pattern is::"
msgstr ""
#: whatsnew/2.5.rst:843
2016-10-30 09:46:26 +00:00
msgid ""
"In Python 2.5, you can now write ``except Exception`` to achieve the same "
"result, catching all the exceptions that usually indicate errors but "
"leaving :exc:`KeyboardInterrupt` and :exc:`SystemExit` alone. As in "
"previous versions, a bare ``except:`` still catches all exceptions."
msgstr ""
#: whatsnew/2.5.rst:848
2016-10-30 09:46:26 +00:00
msgid ""
"The goal for Python 3.0 is to require any class raised as an exception to "
"derive from :exc:`BaseException` or some descendant of :exc:`BaseException`, "
"and future releases in the Python 2.x series may begin to enforce this "
"constraint. Therefore, I suggest you begin making all your exception classes "
"derive from :exc:`Exception` now. It's been suggested that the bare "
"``except:`` form should be removed in Python 3.0, but Guido van Rossum "
"hasn't decided whether to do this or not."
msgstr ""
#: whatsnew/2.5.rst:856
2016-10-30 09:46:26 +00:00
msgid ""
"Raising of strings as exceptions, as in the statement ``raise \"Error "
"occurred\"``, is deprecated in Python 2.5 and will trigger a warning. The "
"aim is to be able to remove the string-exception feature in a few releases."
msgstr ""
#: whatsnew/2.5.rst:863
2016-10-30 09:46:26 +00:00
msgid ":pep:`352` - Required Superclass for Exceptions"
msgstr ""
#: whatsnew/2.5.rst:864
2016-10-30 09:46:26 +00:00
msgid ""
"PEP written by Brett Cannon and Guido van Rossum; implemented by Brett "
"Cannon."
msgstr ""
#: whatsnew/2.5.rst:872
2016-10-30 09:46:26 +00:00
msgid "PEP 353: Using ssize_t as the index type"
msgstr ""
#: whatsnew/2.5.rst:874
2016-10-30 09:46:26 +00:00
msgid ""
"A wide-ranging change to Python's C API, using a new :c:type:`Py_ssize_t` "
"type definition instead of :c:expr:`int`, will permit the interpreter to "
2016-10-30 09:46:26 +00:00
"handle more data on 64-bit platforms. This change doesn't affect Python's "
"capacity on 32-bit platforms."
msgstr ""
#: whatsnew/2.5.rst:879
2016-10-30 09:46:26 +00:00
msgid ""
"Various pieces of the Python interpreter used C's :c:expr:`int` type to "
2016-10-30 09:46:26 +00:00
"store sizes or counts; for example, the number of items in a list or tuple "
"were stored in an :c:expr:`int`. The C compilers for most 64-bit platforms "
"still define :c:expr:`int` as a 32-bit type, so that meant that lists could "
2016-10-30 09:46:26 +00:00
"only hold up to ``2**31 - 1`` = 2147483647 items. (There are actually a few "
"different programming models that 64-bit C compilers can use -- see https://"
"unix.org/version2/whatsnew/lp64_wp.html for a discussion -- but the most "
"commonly available model leaves :c:expr:`int` as 32 bits.)"
2016-10-30 09:46:26 +00:00
msgstr ""
#: whatsnew/2.5.rst:888
2016-10-30 09:46:26 +00:00
msgid ""
"A limit of 2147483647 items doesn't really matter on a 32-bit platform "
"because you'll run out of memory before hitting the length limit. Each list "
"item requires space for a pointer, which is 4 bytes, plus space for a :c:"
"type:`PyObject` representing the item. 2147483647\\*4 is already more bytes "
"than a 32-bit address space can contain."
msgstr ""
#: whatsnew/2.5.rst:894
2016-10-30 09:46:26 +00:00
msgid ""
"It's possible to address that much memory on a 64-bit platform, however. "
"The pointers for a list that size would only require 16 GiB of space, so "
"it's not unreasonable that Python programmers might construct lists that "
"large. Therefore, the Python interpreter had to be changed to use some type "
"other than :c:expr:`int`, and this will be a 64-bit type on 64-bit "
2016-10-30 09:46:26 +00:00
"platforms. The change will cause incompatibilities on 64-bit machines, so "
"it was deemed worth making the transition now, while the number of 64-bit "
"users is still relatively small. (In 5 or 10 years, we may *all* be on 64-"
"bit machines, and the transition would be more painful then.)"
msgstr ""
#: whatsnew/2.5.rst:904
2016-10-30 09:46:26 +00:00
msgid ""
"This change most strongly affects authors of C extension modules. Python "
"strings and container types such as lists and tuples now use :c:type:"
"`Py_ssize_t` to store their size. Functions such as :c:func:`PyList_Size` "
"now return :c:type:`Py_ssize_t`. Code in extension modules may therefore "
"need to have some variables changed to :c:type:`Py_ssize_t`."
msgstr ""
#: whatsnew/2.5.rst:910
2016-10-30 09:46:26 +00:00
msgid ""
"The :c:func:`PyArg_ParseTuple` and :c:func:`Py_BuildValue` functions have a "
"new conversion code, ``n``, for :c:type:`Py_ssize_t`. :c:func:"
"`PyArg_ParseTuple`'s ``s#`` and ``t#`` still output :c:expr:`int` by "
2016-10-30 09:46:26 +00:00
"default, but you can define the macro :c:macro:`PY_SSIZE_T_CLEAN` before "
"including :file:`Python.h` to make them return :c:type:`Py_ssize_t`."
msgstr ""
#: whatsnew/2.5.rst:916
2016-10-30 09:46:26 +00:00
msgid ""
":pep:`353` has a section on conversion guidelines that extension authors "
"should read to learn about supporting 64-bit platforms."
msgstr ""
#: whatsnew/2.5.rst:922
2016-10-30 09:46:26 +00:00
msgid ":pep:`353` - Using ssize_t as the index type"
msgstr ""
#: whatsnew/2.5.rst:923
2016-10-30 09:46:26 +00:00
msgid "PEP written and implemented by Martin von Löwis."
msgstr ""
#: whatsnew/2.5.rst:931
2016-10-30 09:46:26 +00:00
msgid "PEP 357: The '__index__' method"
msgstr ""
#: whatsnew/2.5.rst:933
2016-10-30 09:46:26 +00:00
msgid ""
"The NumPy developers had a problem that could only be solved by adding a new "
"special method, :meth:`__index__`. When using slice notation, as in "
"``[start:stop:step]``, the values of the *start*, *stop*, and *step* indexes "
"must all be either integers or long integers. NumPy defines a variety of "
"specialized integer types corresponding to unsigned and signed integers of "
"8, 16, 32, and 64 bits, but there was no way to signal that these types "
"could be used as slice indexes."
msgstr ""
#: whatsnew/2.5.rst:941
2016-10-30 09:46:26 +00:00
msgid ""
"Slicing can't just use the existing :meth:`__int__` method because that "
"method is also used to implement coercion to integers. If slicing used :"
"meth:`__int__`, floating-point numbers would also become legal slice indexes "
"and that's clearly an undesirable behaviour."
msgstr ""
#: whatsnew/2.5.rst:946
2016-10-30 09:46:26 +00:00
msgid ""
"Instead, a new special method called :meth:`__index__` was added. It takes "
"no arguments and returns an integer giving the slice index to use. For "
"example::"
msgstr ""
#: whatsnew/2.5.rst:953
2016-10-30 09:46:26 +00:00
msgid ""
"The return value must be either a Python integer or long integer. The "
"interpreter will check that the type returned is correct, and raises a :exc:"
"`TypeError` if this requirement isn't met."
msgstr ""
#: whatsnew/2.5.rst:957
2016-10-30 09:46:26 +00:00
msgid ""
"A corresponding :attr:`nb_index` slot was added to the C-level :c:type:"
"`PyNumberMethods` structure to let C extensions implement this protocol. "
"``PyNumber_Index(obj)`` can be used in extension code to call the :meth:"
"`__index__` function and retrieve its result."
msgstr ""
#: whatsnew/2.5.rst:965
2016-10-30 09:46:26 +00:00
msgid ":pep:`357` - Allowing Any Object to be Used for Slicing"
msgstr ""
#: whatsnew/2.5.rst:966
2016-10-30 09:46:26 +00:00
msgid "PEP written and implemented by Travis Oliphant."
msgstr ""
#: whatsnew/2.5.rst:974
2016-10-30 09:46:26 +00:00
msgid "Other Language Changes"
msgstr ""
#: whatsnew/2.5.rst:976
2016-10-30 09:46:26 +00:00
msgid ""
"Here are all of the changes that Python 2.5 makes to the core Python "
"language."
msgstr ""
#: whatsnew/2.5.rst:978
2016-10-30 09:46:26 +00:00
msgid ""
"The :class:`dict` type has a new hook for letting subclasses provide a "
"default value when a key isn't contained in the dictionary. When a key isn't "
"found, the dictionary's ``__missing__(key)`` method will be called. This "
"hook is used to implement the new :class:`defaultdict` class in the :mod:"
"`collections` module. The following example defines a dictionary that "
"returns zero for any missing key::"
msgstr ""
#: whatsnew/2.5.rst:993
2016-10-30 09:46:26 +00:00
msgid ""
"Both 8-bit and Unicode strings have new ``partition(sep)`` and "
"``rpartition(sep)`` methods that simplify a common use case."
msgstr ""
#: whatsnew/2.5.rst:996
2016-10-30 09:46:26 +00:00
msgid ""
"The ``find(S)`` method is often used to get an index which is then used to "
"slice the string and obtain the pieces that are before and after the "
"separator. ``partition(sep)`` condenses this pattern into a single method "
"call that returns a 3-tuple containing the substring before the separator, "
"the separator itself, and the substring after the separator. If the "
"separator isn't found, the first element of the tuple is the entire string "
"and the other two elements are empty. ``rpartition(sep)`` also returns a 3-"
"tuple but starts searching from the end of the string; the ``r`` stands for "
"'reverse'."
msgstr ""
#: whatsnew/2.5.rst:1005
2016-10-30 09:46:26 +00:00
msgid "Some examples::"
msgstr "Quelques exemples ::"
2016-10-30 09:46:26 +00:00
#: whatsnew/2.5.rst:1018
2016-10-30 09:46:26 +00:00
msgid ""
"(Implemented by Fredrik Lundh following a suggestion by Raymond Hettinger.)"
msgstr ""
#: whatsnew/2.5.rst:1020
2016-10-30 09:46:26 +00:00
msgid ""
"The :meth:`startswith` and :meth:`endswith` methods of string types now "
"accept tuples of strings to check for. ::"
msgstr ""
#: whatsnew/2.5.rst:1026
2016-10-30 09:46:26 +00:00
msgid "(Implemented by Georg Brandl following a suggestion by Tom Lynn.)"
msgstr ""
#: whatsnew/2.5.rst:1030
2016-10-30 09:46:26 +00:00
msgid ""
"The :func:`min` and :func:`max` built-in functions gained a ``key`` keyword "
"parameter analogous to the ``key`` argument for :meth:`sort`. This "
"parameter supplies a function that takes a single argument and is called for "
"every value in the list; :func:`min`/:func:`max` will return the element "
"with the smallest/largest return value from this function. For example, to "
"find the longest string in a list, you can do::"
msgstr ""
#: whatsnew/2.5.rst:1043
2016-10-30 09:46:26 +00:00
msgid "(Contributed by Steven Bethard and Raymond Hettinger.)"
msgstr ""
#: whatsnew/2.5.rst:1045
2016-10-30 09:46:26 +00:00
msgid ""
"Two new built-in functions, :func:`any` and :func:`all`, evaluate whether an "
"iterator contains any true or false values. :func:`any` returns :const:"
"`True` if any value returned by the iterator is true; otherwise it will "
"return :const:`False`. :func:`all` returns :const:`True` only if all of the "
"values returned by the iterator evaluate as true. (Suggested by Guido van "
"Rossum, and implemented by Raymond Hettinger.)"
msgstr ""
#: whatsnew/2.5.rst:1052
2016-10-30 09:46:26 +00:00
msgid ""
"The result of a class's :meth:`__hash__` method can now be either a long "
"integer or a regular integer. If a long integer is returned, the hash of "
"that value is taken. In earlier versions the hash value was required to be "
"a regular integer, but in 2.5 the :func:`id` built-in was changed to always "
"return non-negative numbers, and users often seem to use ``id(self)`` in :"
"meth:`__hash__` methods (though this is discouraged)."
msgstr ""
#: whatsnew/2.5.rst:1061
2016-10-30 09:46:26 +00:00
msgid ""
"ASCII is now the default encoding for modules. It's now a syntax error if "
"a module contains string literals with 8-bit characters but doesn't have an "
"encoding declaration. In Python 2.4 this triggered a warning, not a syntax "
"error. See :pep:`263` for how to declare a module's encoding; for example, "
"you might add a line like this near the top of the source file::"
msgstr ""
#: whatsnew/2.5.rst:1069
2016-10-30 09:46:26 +00:00
msgid ""
"A new warning, :class:`UnicodeWarning`, is triggered when you attempt to "
"compare a Unicode string and an 8-bit string that can't be converted to "
"Unicode using the default ASCII encoding. The result of the comparison is "
"false::"
msgstr ""
#: whatsnew/2.5.rst:1081
2016-10-30 09:46:26 +00:00
msgid ""
"Previously this would raise a :class:`UnicodeDecodeError` exception, but in "
"2.5 this could result in puzzling problems when accessing a dictionary. If "
"you looked up ``unichr(128)`` and ``chr(128)`` was being used as a key, "
"you'd get a :class:`UnicodeDecodeError` exception. Other changes in 2.5 "
"resulted in this exception being raised instead of suppressed by the code "
"in :file:`dictobject.c` that implements dictionaries."
msgstr ""
#: whatsnew/2.5.rst:1088
2016-10-30 09:46:26 +00:00
msgid ""
"Raising an exception for such a comparison is strictly correct, but the "
"change might have broken code, so instead :class:`UnicodeWarning` was "
"introduced."
msgstr ""
#: whatsnew/2.5.rst:1091
2016-10-30 09:46:26 +00:00
msgid "(Implemented by Marc-André Lemburg.)"
msgstr ""
#: whatsnew/2.5.rst:1093
2016-10-30 09:46:26 +00:00
msgid ""
"One error that Python programmers sometimes make is forgetting to include "
"an :file:`__init__.py` module in a package directory. Debugging this mistake "
"can be confusing, and usually requires running Python with the :option:`-v` "
"switch to log all the paths searched. In Python 2.5, a new :exc:"
"`ImportWarning` warning is triggered when an import would have picked up a "
"directory as a package but no :file:`__init__.py` was found. This warning "
"is silently ignored by default; provide the :option:`-Wd <-W>` option when "
"running the Python executable to display the warning message. (Implemented "
"by Thomas Wouters.)"
msgstr ""
#: whatsnew/2.5.rst:1102
2016-10-30 09:46:26 +00:00
msgid ""
"The list of base classes in a class definition can now be empty. As an "
"example, this is now legal::"
msgstr ""
#: whatsnew/2.5.rst:1108
2016-10-30 09:46:26 +00:00
msgid "(Implemented by Brett Cannon.)"
msgstr ""
#: whatsnew/2.5.rst:1116
2016-10-30 09:46:26 +00:00
msgid "Interactive Interpreter Changes"
msgstr "Changements de linterpréteur interactif"
#: whatsnew/2.5.rst:1118
2016-10-30 09:46:26 +00:00
msgid ""
"In the interactive interpreter, ``quit`` and ``exit`` have long been "
"strings so that new users get a somewhat helpful message when they try to "
"quit::"
msgstr ""
#: whatsnew/2.5.rst:1124
2016-10-30 09:46:26 +00:00
msgid ""
"In Python 2.5, ``quit`` and ``exit`` are now objects that still produce "
"string representations of themselves, but are also callable. Newbies who try "
"``quit()`` or ``exit()`` will now exit the interpreter as they expect. "
"(Implemented by Georg Brandl.)"
msgstr ""
#: whatsnew/2.5.rst:1129
2016-10-30 09:46:26 +00:00
msgid ""
"The Python executable now accepts the standard long options :option:`--"
"help` and :option:`--version`; on Windows, it also accepts the :option:`/? "
"<-?>` option for displaying a help message. (Implemented by Georg Brandl.)"
msgstr ""
#: whatsnew/2.5.rst:1139
2020-02-14 10:18:53 +00:00
#, fuzzy
2016-10-30 09:46:26 +00:00
msgid "Optimizations"
2020-02-14 10:18:53 +00:00
msgstr "Optimisation"
2016-10-30 09:46:26 +00:00
#: whatsnew/2.5.rst:1141
2016-10-30 09:46:26 +00:00
msgid ""
"Several of the optimizations were developed at the NeedForSpeed sprint, an "
"event held in Reykjavik, Iceland, from May 21--28 2006. The sprint focused "
"on speed enhancements to the CPython implementation and was funded by EWT "
"LLC with local support from CCP Games. Those optimizations added at this "
"sprint are specially marked in the following list."
msgstr ""
#: whatsnew/2.5.rst:1147
2016-10-30 09:46:26 +00:00
msgid ""
"When they were introduced in Python 2.4, the built-in :class:`set` and :"
"class:`frozenset` types were built on top of Python's dictionary type. In "
"2.5 the internal data structure has been customized for implementing sets, "
"and as a result sets will use a third less memory and are somewhat faster. "
"(Implemented by Raymond Hettinger.)"
msgstr ""
#: whatsnew/2.5.rst:1153
2016-10-30 09:46:26 +00:00
msgid ""
"The speed of some Unicode operations, such as finding substrings, string "
"splitting, and character map encoding and decoding, has been improved. "
"(Substring search and splitting improvements were added by Fredrik Lundh and "
"Andrew Dalke at the NeedForSpeed sprint. Character maps were improved by "
"Walter Dörwald and Martin von Löwis.)"
msgstr ""
#: whatsnew/2.5.rst:1161
2016-10-30 09:46:26 +00:00
msgid ""
"The ``long(str, base)`` function is now faster on long digit strings because "
"fewer intermediate results are calculated. The peak is for strings of "
"around 800--1000 digits where the function is 6 times faster. (Contributed "
"by Alan McIntyre and committed at the NeedForSpeed sprint.)"
msgstr ""
#: whatsnew/2.5.rst:1168
2016-10-30 09:46:26 +00:00
msgid ""
"It's now illegal to mix iterating over a file with ``for line in file`` and "
"calling the file object's :meth:`read`/:meth:`readline`/:meth:`readlines` "
"methods. Iteration uses an internal buffer and the :meth:`read\\*` methods "
"don't use that buffer. Instead they would return the data following the "
"buffer, causing the data to appear out of order. Mixing iteration and these "
"methods will now trigger a :exc:`ValueError` from the :meth:`read\\*` "
"method. (Implemented by Thomas Wouters.)"
msgstr ""
#: whatsnew/2.5.rst:1178
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`struct` module now compiles structure format strings into an "
"internal representation and caches this representation, yielding a 20% "
"speedup. (Contributed by Bob Ippolito at the NeedForSpeed sprint.)"
msgstr ""
#: whatsnew/2.5.rst:1182
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`re` module got a 1 or 2% speedup by switching to Python's "
"allocator functions instead of the system's :c:func:`malloc` and :c:func:"
"`free`. (Contributed by Jack Diederich at the NeedForSpeed sprint.)"
msgstr ""
#: whatsnew/2.5.rst:1186
2016-10-30 09:46:26 +00:00
msgid ""
"The code generator's peephole optimizer now performs simple constant folding "
"in expressions. If you write something like ``a = 2+3``, the code generator "
"will do the arithmetic and produce code corresponding to ``a = 5``. "
"(Proposed and implemented by Raymond Hettinger.)"
msgstr ""
#: whatsnew/2.5.rst:1191
2016-10-30 09:46:26 +00:00
msgid ""
"Function calls are now faster because code objects now keep the most "
"recently finished frame (a \"zombie frame\") in an internal field of the "
"code object, reusing it the next time the code object is invoked. (Original "
"patch by Michael Hudson, modified by Armin Rigo and Richard Jones; committed "
"at the NeedForSpeed sprint.) Frame objects are also slightly smaller, which "
"may improve cache locality and reduce memory usage a bit. (Contributed by "
"Neal Norwitz.)"
msgstr ""
#: whatsnew/2.5.rst:1201
2016-10-30 09:46:26 +00:00
msgid ""
"Python's built-in exceptions are now new-style classes, a change that speeds "
"up instantiation considerably. Exception handling in Python 2.5 is "
"therefore about 30% faster than in 2.4. (Contributed by Richard Jones, Georg "
"Brandl and Sean Reifschneider at the NeedForSpeed sprint.)"
msgstr ""
#: whatsnew/2.5.rst:1206
2016-10-30 09:46:26 +00:00
msgid ""
"Importing now caches the paths tried, recording whether they exist or not "
"so that the interpreter makes fewer :c:func:`open` and :c:func:`stat` calls "
"on startup. (Contributed by Martin von Löwis and Georg Brandl.)"
msgstr ""
#: whatsnew/2.5.rst:1218
2016-10-30 09:46:26 +00:00
msgid "New, Improved, and Removed Modules"
msgstr "Modules ajoutés, modifiés, et supprimés"
#: whatsnew/2.5.rst:1220
2016-10-30 09:46:26 +00:00
msgid ""
"The standard library received many enhancements and bug fixes in Python 2.5. "
"Here's a partial list of the most notable changes, sorted alphabetically by "
"module name. Consult the :file:`Misc/NEWS` file in the source tree for a "
"more complete list of changes, or look through the SVN logs for all the "
"details."
msgstr ""
#: whatsnew/2.5.rst:1225
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`audioop` module now supports the a-LAW encoding, and the code for "
"u-LAW encoding has been improved. (Contributed by Lars Immisch.)"
msgstr ""
#: whatsnew/2.5.rst:1228
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`codecs` module gained support for incremental codecs. The :func:"
"`codec.lookup` function now returns a :class:`CodecInfo` instance instead of "
"a tuple. :class:`CodecInfo` instances behave like a 4-tuple to preserve "
"backward compatibility but also have the attributes :attr:`encode`, :attr:"
"`decode`, :attr:`incrementalencoder`, :attr:`incrementaldecoder`, :attr:"
"`streamwriter`, and :attr:`streamreader`. Incremental codecs can receive "
"input and produce output in multiple chunks; the output is the same as if "
"the entire input was fed to the non-incremental codec. See the :mod:`codecs` "
"module documentation for details. (Designed and implemented by Walter "
"Dörwald.)"
msgstr ""
#: whatsnew/2.5.rst:1240
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`collections` module gained a new type, :class:`defaultdict`, that "
"subclasses the standard :class:`dict` type. The new type mostly behaves "
"like a dictionary but constructs a default value when a key isn't present, "
"automatically adding it to the dictionary for the requested key value."
msgstr ""
#: whatsnew/2.5.rst:1245
2016-10-30 09:46:26 +00:00
msgid ""
"The first argument to :class:`defaultdict`'s constructor is a factory "
"function that gets called whenever a key is requested but not found. This "
"factory function receives no arguments, so you can use built-in type "
"constructors such as :func:`list` or :func:`int`. For example, you can "
"make an index of words based on their initial letter like this::"
msgstr ""
#: whatsnew/2.5.rst:1261
2016-10-30 09:46:26 +00:00
msgid "Printing ``index`` results in the following output::"
msgstr ""
#: whatsnew/2.5.rst:1269
2016-10-30 09:46:26 +00:00
msgid "(Contributed by Guido van Rossum.)"
msgstr "(Contribution par Guido van Rossum.)"
#: whatsnew/2.5.rst:1271
2016-10-30 09:46:26 +00:00
msgid ""
"The :class:`deque` double-ended queue type supplied by the :mod:"
"`collections` module now has a ``remove(value)`` method that removes the "
"first occurrence of *value* in the queue, raising :exc:`ValueError` if the "
"value isn't found. (Contributed by Raymond Hettinger.)"
msgstr ""
#: whatsnew/2.5.rst:1276
2016-10-30 09:46:26 +00:00
msgid ""
"New module: The :mod:`contextlib` module contains helper functions for use "
"with the new ':keyword:`with`' statement. See section :ref:`contextlibmod` "
"for more about this module."
msgstr ""
#: whatsnew/2.5.rst:1280
2016-10-30 09:46:26 +00:00
msgid ""
"New module: The :mod:`cProfile` module is a C implementation of the "
"existing :mod:`profile` module that has much lower overhead. The module's "
"interface is the same as :mod:`profile`: you run ``cProfile.run('main()')`` "
"to profile a function, can save profile data to a file, etc. It's not yet "
"known if the Hotshot profiler, which is also written in C but doesn't match "
"the :mod:`profile` module's interface, will continue to be maintained in "
"future versions of Python. (Contributed by Armin Rigo.)"
msgstr ""
#: whatsnew/2.5.rst:1288
2016-10-30 09:46:26 +00:00
msgid ""
"Also, the :mod:`pstats` module for analyzing the data measured by the "
"profiler now supports directing the output to any file object by supplying a "
"*stream* argument to the :class:`Stats` constructor. (Contributed by Skip "
"Montanaro.)"
msgstr ""
#: whatsnew/2.5.rst:1292
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`csv` module, which parses files in comma-separated value format, "
"received several enhancements and a number of bugfixes. You can now set the "
"maximum size in bytes of a field by calling the ``csv."
"field_size_limit(new_limit)`` function; omitting the *new_limit* argument "
"will return the currently set limit. The :class:`reader` class now has a :"
2016-10-30 09:46:26 +00:00
"attr:`line_num` attribute that counts the number of physical lines read from "
"the source; records can span multiple physical lines, so :attr:`line_num` is "
"not the same as the number of records read."
msgstr ""
#: whatsnew/2.5.rst:1301
2016-10-30 09:46:26 +00:00
msgid ""
"The CSV parser is now stricter about multi-line quoted fields. Previously, "
"if a line ended within a quoted field without a terminating newline "
"character, a newline would be inserted into the returned field. This "
"behavior caused problems when reading files that contained carriage return "
"characters within fields, so the code was changed to return the field "
"without inserting newlines. As a consequence, if newlines embedded within "
"fields are important, the input should be split into lines in a manner that "
"preserves the newline characters."
msgstr ""
#: whatsnew/2.5.rst:1309
2016-10-30 09:46:26 +00:00
msgid "(Contributed by Skip Montanaro and Andrew McNamara.)"
msgstr ""
#: whatsnew/2.5.rst:1311
2016-10-30 09:46:26 +00:00
msgid ""
2017-04-02 20:14:06 +00:00
"The :class:`~datetime.datetime` class in the :mod:`datetime` module now has "
"a ``strptime(string, format)`` method for parsing date strings, contributed "
2016-10-30 09:46:26 +00:00
"by Josh Spoerri. It uses the same format characters as :func:`time.strptime` "
"and :func:`time.strftime`::"
msgstr ""
#: whatsnew/2.5.rst:1321
2016-10-30 09:46:26 +00:00
msgid ""
"The :meth:`SequenceMatcher.get_matching_blocks` method in the :mod:`difflib` "
"module now guarantees to return a minimal list of blocks describing matching "
"subsequences. Previously, the algorithm would occasionally break a block of "
"matching elements into two list entries. (Enhancement by Tim Peters.)"
msgstr ""
#: whatsnew/2.5.rst:1326
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`doctest` module gained a ``SKIP`` option that keeps an example "
"from being executed at all. This is intended for code snippets that are "
"usage examples intended for the reader and aren't actually test cases."
msgstr ""
#: whatsnew/2.5.rst:1330
2016-10-30 09:46:26 +00:00
msgid ""
"An *encoding* parameter was added to the :func:`testfile` function and the :"
"class:`DocFileSuite` class to specify the file's encoding. This makes it "
"easier to use non-ASCII characters in tests contained within a docstring. "
"(Contributed by Bjorn Tillenius.)"
msgstr ""
#: whatsnew/2.5.rst:1337
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`email` package has been updated to version 4.0. (Contributed by "
"Barry Warsaw.)"
msgstr ""
#: whatsnew/2.5.rst:1345
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`fileinput` module was made more flexible. Unicode filenames are "
"now supported, and a *mode* parameter that defaults to ``\"r\"`` was added "
"to the :func:`input` function to allow opening files in binary or :term:"
"`universal newlines` mode. Another new parameter, *openhook*, lets you use "
"a function other than :func:`open` to open the input files. Once you're "
"iterating over the set of files, the :class:`FileInput` object's new :meth:"
"`fileno` returns the file descriptor for the currently opened file. "
"(Contributed by Georg Brandl.)"
msgstr ""
#: whatsnew/2.5.rst:1354
2016-10-30 09:46:26 +00:00
msgid ""
"In the :mod:`gc` module, the new :func:`get_count` function returns a 3-"
"tuple containing the current collection counts for the three GC "
"generations. This is accounting information for the garbage collector; when "
"these counts reach a specified threshold, a garbage collection sweep will be "
"made. The existing :func:`gc.collect` function now takes an optional "
"*generation* argument of 0, 1, or 2 to specify which generation to collect. "
"(Contributed by Barry Warsaw.)"
msgstr ""
#: whatsnew/2.5.rst:1361
2016-10-30 09:46:26 +00:00
msgid ""
"The :func:`nsmallest` and :func:`nlargest` functions in the :mod:`heapq` "
"module now support a ``key`` keyword parameter similar to the one provided "
"by the :func:`min`/:func:`max` functions and the :meth:`sort` methods. For "
"example::"
msgstr ""
2020-10-02 08:55:01 +00:00
#: whatsnew/2.5.rst:1382
2016-10-30 09:46:26 +00:00
msgid "(Contributed by Raymond Hettinger.)"
msgstr ""
#: whatsnew/2.5.rst:1375
2016-10-30 09:46:26 +00:00
msgid ""
"The :func:`itertools.islice` function now accepts ``None`` for the start and "
"step arguments. This makes it more compatible with the attributes of slice "
"objects, so that you can now write the following::"
msgstr ""
#: whatsnew/2.5.rst:1384
2016-10-30 09:46:26 +00:00
msgid ""
"The :func:`format` function in the :mod:`locale` module has been modified "
"and two new functions were added, :func:`format_string` and :func:`currency`."
msgstr ""
#: whatsnew/2.5.rst:1387
2016-10-30 09:46:26 +00:00
msgid ""
"The :func:`format` function's *val* parameter could previously be a string "
"as long as no more than one %char specifier appeared; now the parameter must "
"be exactly one %char specifier with no surrounding text. An optional "
"*monetary* parameter was also added which, if ``True``, will use the "
"locale's rules for formatting currency in placing a separator between groups "
"of three digits."
msgstr ""
#: whatsnew/2.5.rst:1393
2016-10-30 09:46:26 +00:00
msgid ""
"To format strings with multiple %char specifiers, use the new :func:"
"`format_string` function that works like :func:`format` but also supports "
"mixing %char specifiers with arbitrary text."
msgstr ""
#: whatsnew/2.5.rst:1397
2016-10-30 09:46:26 +00:00
msgid ""
"A new :func:`currency` function was also added that formats a number "
"according to the current locale's settings."
msgstr ""
#: whatsnew/2.5.rst:1400
2016-10-30 09:46:26 +00:00
msgid "(Contributed by Georg Brandl.)"
msgstr ""
#: whatsnew/2.5.rst:1404
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`mailbox` module underwent a massive rewrite to add the capability "
"to modify mailboxes in addition to reading them. A new set of classes that "
"include :class:`mbox`, :class:`MH`, and :class:`Maildir` are used to read "
"mailboxes, and have an ``add(message)`` method to add messages, "
"``remove(key)`` to remove messages, and :meth:`lock`/:meth:`unlock` to lock/"
"unlock the mailbox. The following example converts a maildir-format mailbox "
"into an mbox-format one::"
msgstr ""
#: whatsnew/2.5.rst:1422
2016-10-30 09:46:26 +00:00
msgid ""
"(Contributed by Gregory K. Johnson. Funding was provided by Google's 2005 "
"Summer of Code.)"
msgstr ""
#: whatsnew/2.5.rst:1425
2016-10-30 09:46:26 +00:00
msgid ""
"New module: the :mod:`msilib` module allows creating Microsoft Installer :"
"file:`.msi` files and CAB files. Some support for reading the :file:`.msi` "
"database is also included. (Contributed by Martin von Löwis.)"
msgstr ""
#: whatsnew/2.5.rst:1429
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`nis` module now supports accessing domains other than the system "
"default domain by supplying a *domain* argument to the :func:`nis.match` "
"and :func:`nis.maps` functions. (Contributed by Ben Bell.)"
msgstr ""
#: whatsnew/2.5.rst:1433
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`operator` module's :func:`itemgetter` and :func:`attrgetter` "
"functions now support multiple fields. A call such as ``operator."
"attrgetter('a', 'b')`` will return a function that retrieves the :attr:`a` "
"and :attr:`b` attributes. Combining this new feature with the :meth:`sort` "
"method's ``key`` parameter lets you easily sort lists using multiple "
"fields. (Contributed by Raymond Hettinger.)"
msgstr ""
#: whatsnew/2.5.rst:1440
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`optparse` module was updated to version 1.5.1 of the Optik "
"library. The :class:`OptionParser` class gained an :attr:`epilog` attribute, "
"a string that will be printed after the help message, and a :meth:`destroy` "
"method to break reference cycles created by the object. (Contributed by Greg "
"Ward.)"
msgstr ""
#: whatsnew/2.5.rst:1445
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`os` module underwent several changes. The :attr:"
"`stat_float_times` variable now defaults to true, meaning that :func:`os."
"stat` will now return time values as floats. (This doesn't necessarily mean "
"that :func:`os.stat` will return times that are precise to fractions of a "
"second; not all systems support such precision.)"
msgstr ""
#: whatsnew/2.5.rst:1451
2016-10-30 09:46:26 +00:00
msgid ""
"Constants named :attr:`os.SEEK_SET`, :attr:`os.SEEK_CUR`, and :attr:`os."
"SEEK_END` have been added; these are the parameters to the :func:`os.lseek` "
"function. Two new constants for locking are :attr:`os.O_SHLOCK` and :attr:"
"`os.O_EXLOCK`."
msgstr ""
#: whatsnew/2.5.rst:1456
2016-10-30 09:46:26 +00:00
msgid ""
"Two new functions, :func:`wait3` and :func:`wait4`, were added. They're "
"similar the :func:`waitpid` function which waits for a child process to exit "
"and returns a tuple of the process ID and its exit status, but :func:`wait3` "
"and :func:`wait4` return additional information. :func:`wait3` doesn't take "
"a process ID as input, so it waits for any child process to exit and returns "
"a 3-tuple of *process-id*, *exit-status*, *resource-usage* as returned from "
"the :func:`resource.getrusage` function. ``wait4(pid)`` does take a process "
"ID. (Contributed by Chad J. Schroeder.)"
msgstr ""
#: whatsnew/2.5.rst:1465
2016-10-30 09:46:26 +00:00
msgid ""
"On FreeBSD, the :func:`os.stat` function now returns times with nanosecond "
"resolution, and the returned object now has :attr:`st_gen` and :attr:"
"`st_birthtime`. The :attr:`st_flags` attribute is also available, if the "
"platform supports it. (Contributed by Antti Louko and Diego Pettenò.)"
msgstr ""
#: whatsnew/2.5.rst:1472
2016-10-30 09:46:26 +00:00
msgid ""
"The Python debugger provided by the :mod:`pdb` module can now store lists of "
"commands to execute when a breakpoint is reached and execution stops. Once "
"breakpoint #1 has been created, enter ``commands 1`` and enter a series of "
"commands to be executed, finishing the list with ``end``. The command list "
"can include commands that resume execution, such as ``continue`` or "
"``next``. (Contributed by Grégoire Dooms.)"
msgstr ""
#: whatsnew/2.5.rst:1481
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`pickle` and :mod:`cPickle` modules no longer accept a return value "
"of ``None`` from the :meth:`__reduce__` method; the method must return a "
"tuple of arguments instead. The ability to return ``None`` was deprecated "
"in Python 2.4, so this completes the removal of the feature."
msgstr ""
#: whatsnew/2.5.rst:1486
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`pkgutil` module, containing various utility functions for finding "
2019-09-04 09:35:23 +00:00
"packages, was enhanced to support :pep:`302`'s import hooks and now also "
"works for packages stored in ZIP-format archives. (Contributed by Phillip J. "
"Eby.)"
2016-10-30 09:46:26 +00:00
msgstr ""
#: whatsnew/2.5.rst:1490
2016-10-30 09:46:26 +00:00
msgid ""
"The pybench benchmark suite by Marc-André Lemburg is now included in the :"
"file:`Tools/pybench` directory. The pybench suite is an improvement on the "
"commonly used :file:`pystone.py` program because pybench provides a more "
"detailed measurement of the interpreter's speed. It times particular "
"operations such as function calls, tuple slicing, method lookups, and "
"numeric operations, instead of performing many different operations and "
"reducing the result to a single number as :file:`pystone.py` does."
msgstr ""
#: whatsnew/2.5.rst:1498
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`pyexpat` module now uses version 2.0 of the Expat parser. "
"(Contributed by Trent Mick.)"
msgstr ""
#: whatsnew/2.5.rst:1501
2016-10-30 09:46:26 +00:00
msgid ""
2017-04-02 20:14:06 +00:00
"The :class:`~queue.Queue` class provided by the :mod:`Queue` module gained "
"two new methods. :meth:`join` blocks until all items in the queue have been "
2016-10-30 09:46:26 +00:00
"retrieved and all processing work on the items have been completed. Worker "
"threads call the other new method, :meth:`task_done`, to signal that "
"processing for an item has been completed. (Contributed by Raymond "
"Hettinger.)"
msgstr ""
#: whatsnew/2.5.rst:1507
2016-10-30 09:46:26 +00:00
msgid ""
"The old :mod:`regex` and :mod:`regsub` modules, which have been deprecated "
"ever since Python 2.0, have finally been deleted. Other deleted modules: :"
"mod:`statcache`, :mod:`tzparse`, :mod:`whrandom`."
msgstr ""
#: whatsnew/2.5.rst:1511
2016-10-30 09:46:26 +00:00
msgid ""
"Also deleted: the :file:`lib-old` directory, which includes ancient modules "
"such as :mod:`dircmp` and :mod:`ni`, was removed. :file:`lib-old` wasn't on "
"the default ``sys.path``, so unless your programs explicitly added the "
"directory to ``sys.path``, this removal shouldn't affect your code."
msgstr ""
#: whatsnew/2.5.rst:1516
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`rlcompleter` module is no longer dependent on importing the :mod:"
"`readline` module and therefore now works on non-Unix platforms. (Patch from "
"Robert Kiendl.)"
msgstr ""
#: whatsnew/2.5.rst:1522
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`SimpleXMLRPCServer` and :mod:`DocXMLRPCServer` classes now have "
"a :attr:`rpc_paths` attribute that constrains XML-RPC operations to a "
"limited set of URL paths; the default is to allow only ``'/'`` and ``'/"
"RPC2'``. Setting :attr:`rpc_paths` to ``None`` or an empty tuple disables "
"this path checking."
msgstr ""
#: whatsnew/2.5.rst:1529
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`socket` module now supports :const:`AF_NETLINK` sockets on Linux, "
"thanks to a patch from Philippe Biondi. Netlink sockets are a Linux-"
"specific mechanism for communications between a user-space process and "
"kernel code; an introductory article about them is at https://www."
"linuxjournal.com/article/7356. In Python code, netlink addresses are "
"represented as a tuple of 2 integers, ``(pid, group_mask)``."
msgstr ""
#: whatsnew/2.5.rst:1536
2016-10-30 09:46:26 +00:00
msgid ""
"Two new methods on socket objects, ``recv_into(buffer)`` and "
"``recvfrom_into(buffer)``, store the received data in an object that "
"supports the buffer protocol instead of returning the data as a string. "
"This means you can put the data directly into an array or a memory-mapped "
"file."
msgstr ""
#: whatsnew/2.5.rst:1541
2016-10-30 09:46:26 +00:00
msgid ""
"Socket objects also gained :meth:`getfamily`, :meth:`gettype`, and :meth:"
"`getproto` accessor methods to retrieve the family, type, and protocol "
"values for the socket."
msgstr ""
#: whatsnew/2.5.rst:1545
2016-10-30 09:46:26 +00:00
msgid ""
"New module: the :mod:`spwd` module provides functions for accessing the "
"shadow password database on systems that support shadow passwords."
msgstr ""
#: whatsnew/2.5.rst:1548
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`struct` is now faster because it compiles format strings into :"
"class:`Struct` objects with :meth:`pack` and :meth:`unpack` methods. This "
"is similar to how the :mod:`re` module lets you create compiled regular "
"expression objects. You can still use the module-level :func:`pack` and :"
"func:`unpack` functions; they'll create :class:`Struct` objects and cache "
"them. Or you can use :class:`Struct` instances directly::"
msgstr ""
#: whatsnew/2.5.rst:1560
2016-10-30 09:46:26 +00:00
msgid ""
"You can also pack and unpack data to and from buffer objects directly using "
"the ``pack_into(buffer, offset, v1, v2, ...)`` and ``unpack_from(buffer, "
"offset)`` methods. This lets you store data directly into an array or a "
2017-04-02 20:14:06 +00:00
"memory-mapped file."
2016-10-30 09:46:26 +00:00
msgstr ""
#: whatsnew/2.5.rst:1565
2016-10-30 09:46:26 +00:00
msgid ""
"(:class:`Struct` objects were implemented by Bob Ippolito at the "
"NeedForSpeed sprint. Support for buffer objects was added by Martin Blais, "
"also at the NeedForSpeed sprint.)"
msgstr ""
#: whatsnew/2.5.rst:1569
2016-10-30 09:46:26 +00:00
msgid ""
"The Python developers switched from CVS to Subversion during the 2.5 "
"development process. Information about the exact build version is available "
"as the ``sys.subversion`` variable, a 3-tuple of ``(interpreter-name, branch-"
"name, revision-range)``. For example, at the time of writing my copy of 2.5 "
"was reporting ``('CPython', 'trunk', '45313:45315')``."
msgstr ""
#: whatsnew/2.5.rst:1575
2016-10-30 09:46:26 +00:00
msgid ""
"This information is also available to C extensions via the :c:func:"
"`Py_GetBuildInfo` function that returns a string of build information like "
"this: ``\"trunk:45355:45356M, Apr 13 2006, 07:42:19\"``. (Contributed by "
"Barry Warsaw.)"
msgstr ""
#: whatsnew/2.5.rst:1580
2016-10-30 09:46:26 +00:00
msgid ""
"Another new function, :func:`sys._current_frames`, returns the current stack "
"frames for all running threads as a dictionary mapping thread identifiers to "
"the topmost stack frame currently active in that thread at the time the "
"function is called. (Contributed by Tim Peters.)"
msgstr ""
#: whatsnew/2.5.rst:1585
2016-10-30 09:46:26 +00:00
msgid ""
"The :class:`TarFile` class in the :mod:`tarfile` module now has an :meth:"
"`extractall` method that extracts all members from the archive into the "
"current working directory. It's also possible to set a different directory "
"as the extraction target, and to unpack only a subset of the archive's "
"members."
msgstr ""
#: whatsnew/2.5.rst:1590
2016-10-30 09:46:26 +00:00
msgid ""
"The compression used for a tarfile opened in stream mode can now be "
"autodetected using the mode ``'r|*'``. (Contributed by Lars Gustäbel.)"
msgstr ""
#: whatsnew/2.5.rst:1595
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`threading` module now lets you set the stack size used when new "
"threads are created. The ``stack_size([*size*])`` function returns the "
"currently configured stack size, and supplying the optional *size* parameter "
"sets a new value. Not all platforms support changing the stack size, but "
"Windows, POSIX threading, and OS/2 all do. (Contributed by Andrew MacIntyre.)"
msgstr ""
#: whatsnew/2.5.rst:1603
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`unicodedata` module has been updated to use version 4.1.0 of the "
"Unicode character database. Version 3.2.0 is required by some "
"specifications, so it's still available as :attr:`unicodedata.ucd_3_2_0`."
msgstr ""
#: whatsnew/2.5.rst:1607
2016-10-30 09:46:26 +00:00
msgid ""
"New module: the :mod:`uuid` module generates universally unique "
"identifiers (UUIDs) according to :rfc:`4122`. The RFC defines several "
"different UUID versions that are generated from a starting string, from "
"system properties, or purely randomly. This module contains a :class:`UUID` "
"class and functions named :func:`uuid1`, :func:`uuid3`, :func:`uuid4`, "
"and :func:`uuid5` to generate different versions of UUID. (Version 2 "
"UUIDs are not specified in :rfc:`4122` and are not supported by this "
"module.) ::"
msgstr ""
#: whatsnew/2.5.rst:1632
2016-10-30 09:46:26 +00:00
msgid "(Contributed by Ka-Ping Yee.)"
msgstr ""
#: whatsnew/2.5.rst:1634
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`weakref` module's :class:`WeakKeyDictionary` and :class:"
"`WeakValueDictionary` types gained new methods for iterating over the weak "
"references contained in the dictionary. :meth:`iterkeyrefs` and :meth:"
"`keyrefs` methods were added to :class:`WeakKeyDictionary`, and :meth:"
"`itervaluerefs` and :meth:`valuerefs` were added to :class:"
"`WeakValueDictionary`. (Contributed by Fred L. Drake, Jr.)"
msgstr ""
#: whatsnew/2.5.rst:1641
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`webbrowser` module received a number of enhancements. It's now "
"usable as a script with ``python -m webbrowser``, taking a URL as the "
"argument; there are a number of switches to control the behaviour (:option:"
2017-04-02 20:14:06 +00:00
"`!-n` for a new browser window, :option:`!-t` for a new tab). New module-"
2016-10-30 09:46:26 +00:00
"level functions, :func:`open_new` and :func:`open_new_tab`, were added to "
"support this. The module's :func:`open` function supports an additional "
"feature, an *autoraise* parameter that signals whether to raise the open "
"window when possible. A number of additional browsers were added to the "
"supported list such as Firefox, Opera, Konqueror, and elinks. (Contributed "
"by Oleg Broytmann and Georg Brandl.)"
msgstr ""
#: whatsnew/2.5.rst:1653
2016-10-30 09:46:26 +00:00
msgid ""
2017-04-02 20:14:06 +00:00
"The :mod:`xmlrpclib` module now supports returning :class:`~datetime."
"datetime` objects for the XML-RPC date type. Supply ``use_datetime=True`` "
"to the :func:`loads` function or the :class:`Unmarshaller` class to enable "
"this feature. (Contributed by Skip Montanaro.)"
2016-10-30 09:46:26 +00:00
msgstr ""
#: whatsnew/2.5.rst:1660
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`zipfile` module now supports the ZIP64 version of the format, "
"meaning that a .zip archive can now be larger than 4 GiB and can contain "
"individual files larger than 4 GiB. (Contributed by Ronald Oussoren.)"
msgstr ""
#: whatsnew/2.5.rst:1666
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`zlib` module's :class:`Compress` and :class:`Decompress` objects "
"now support a :meth:`copy` method that makes a copy of the object's "
"internal state and returns a new :class:`Compress` or :class:`Decompress` "
"object. (Contributed by Chris AtLee.)"
msgstr ""
#: whatsnew/2.5.rst:1679
2016-10-30 09:46:26 +00:00
msgid "The ctypes package"
msgstr ""
#: whatsnew/2.5.rst:1681
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`ctypes` package, written by Thomas Heller, has been added to the "
"standard library. :mod:`ctypes` lets you call arbitrary functions in "
"shared libraries or DLLs. Long-time users may remember the :mod:`dl` "
"module, which provides functions for loading shared libraries and calling "
"functions in them. The :mod:`ctypes` package is much fancier."
msgstr ""
#: whatsnew/2.5.rst:1687
2016-10-30 09:46:26 +00:00
msgid ""
"To load a shared library or DLL, you must create an instance of the :class:"
"`CDLL` class and provide the name or path of the shared library or DLL. Once "
"that's done, you can call arbitrary functions by accessing them as "
"attributes of the :class:`CDLL` object. ::"
msgstr ""
#: whatsnew/2.5.rst:1697
2016-10-30 09:46:26 +00:00
msgid ""
"Type constructors for the various C types are provided: :func:`c_int`, :func:"
"`c_float`, :func:`c_double`, :func:`c_char_p` (equivalent to :c:expr:`char "
2016-10-30 09:46:26 +00:00
"\\*`), and so forth. Unlike Python's types, the C versions are all mutable; "
"you can assign to their :attr:`value` attribute to change the wrapped "
"value. Python integers and strings will be automatically converted to the "
"corresponding C types, but for other types you must call the correct type "
"constructor. (And I mean *must*; getting it wrong will often result in the "
"interpreter crashing with a segmentation fault.)"
msgstr ""
#: whatsnew/2.5.rst:1706
2016-10-30 09:46:26 +00:00
msgid ""
"You shouldn't use :func:`c_char_p` with a Python string when the C function "
"will be modifying the memory area, because Python strings are supposed to "
"be immutable; breaking this rule will cause puzzling bugs. When you need a "
"modifiable memory area, use :func:`create_string_buffer`::"
msgstr ""
#: whatsnew/2.5.rst:1715
2016-10-30 09:46:26 +00:00
msgid ""
"C functions are assumed to return integers, but you can set the :attr:"
"`restype` attribute of the function object to change this::"
msgstr ""
#: whatsnew/2.5.rst:1724
2016-10-30 09:46:26 +00:00
msgid ""
":mod:`ctypes` also provides a wrapper for Python's C API as the ``ctypes."
"pythonapi`` object. This object does *not* release the global interpreter "
"lock before calling a function, because the lock must be held when calling "
"into the interpreter's code. There's a :class:`py_object()` type "
"constructor that will create a :c:expr:`PyObject *` pointer. A simple "
2016-10-30 09:46:26 +00:00
"usage::"
msgstr ""
#: whatsnew/2.5.rst:1737
2016-10-30 09:46:26 +00:00
msgid ""
"Don't forget to use :class:`py_object()`; if it's omitted you end up with a "
"segmentation fault."
msgstr ""
#: whatsnew/2.5.rst:1740
2016-10-30 09:46:26 +00:00
msgid ""
":mod:`ctypes` has been around for a while, but people still write and "
"distribution hand-coded extension modules because you can't rely on :mod:"
"`ctypes` being present. Perhaps developers will begin to write Python "
"wrappers atop a library accessed through :mod:`ctypes` instead of extension "
"modules, now that :mod:`ctypes` is included with core Python."
msgstr ""
#: whatsnew/2.5.rst:1750
msgid ""
"https://web.archive.org/web/20180410025338/http://starship.python.net/crew/"
"theller/ctypes/"
2016-10-30 09:46:26 +00:00
msgstr ""
#: whatsnew/2.5.rst:1750
msgid "The pre-stdlib ctypes web page, with a tutorial, reference, and FAQ."
2016-10-30 09:46:26 +00:00
msgstr ""
#: whatsnew/2.5.rst:1752
2020-02-14 10:18:53 +00:00
#, fuzzy
2016-10-30 09:46:26 +00:00
msgid "The documentation for the :mod:`ctypes` module."
2020-02-14 10:18:53 +00:00
msgstr "La documentation du module :mod:`codecs`."
2016-10-30 09:46:26 +00:00
#: whatsnew/2.5.rst:1760
2016-10-30 09:46:26 +00:00
msgid "The ElementTree package"
msgstr ""
#: whatsnew/2.5.rst:1762
2016-10-30 09:46:26 +00:00
msgid ""
"A subset of Fredrik Lundh's ElementTree library for processing XML has been "
"added to the standard library as :mod:`xml.etree`. The available modules "
"are :mod:`ElementTree`, :mod:`ElementPath`, and :mod:`ElementInclude` from "
"ElementTree 1.2.6. The :mod:`cElementTree` accelerator module is also "
"included."
msgstr ""
#: whatsnew/2.5.rst:1768
2016-10-30 09:46:26 +00:00
msgid ""
"The rest of this section will provide a brief overview of using ElementTree. "
2022-05-22 21:15:02 +00:00
"Full documentation for ElementTree is available at https://web.archive.org/"
"web/20201124024954/http://effbot.org/zone/element-index.htm."
2016-10-30 09:46:26 +00:00
msgstr ""
#: whatsnew/2.5.rst:1772
2016-10-30 09:46:26 +00:00
msgid ""
"ElementTree represents an XML document as a tree of element nodes. The text "
"content of the document is stored as the :attr:`text` and :attr:`tail` "
"attributes of (This is one of the major differences between ElementTree and "
"the Document Object Model; in the DOM there are many different types of "
"node, including :class:`TextNode`.)"
msgstr ""
#: whatsnew/2.5.rst:1778
2016-10-30 09:46:26 +00:00
msgid ""
"The most commonly used parsing function is :func:`parse`, that takes either "
"a string (assumed to contain a filename) or a file-like object and returns "
"an :class:`ElementTree` instance::"
msgstr ""
#: whatsnew/2.5.rst:1790
2016-10-30 09:46:26 +00:00
msgid ""
"Once you have an :class:`ElementTree` instance, you can call its :meth:"
"`getroot` method to get the root :class:`Element` node."
msgstr ""
#: whatsnew/2.5.rst:1793
2016-10-30 09:46:26 +00:00
msgid ""
"There's also an :func:`XML` function that takes a string literal and returns "
"an :class:`Element` node (not an :class:`ElementTree`). This function "
"provides a tidy way to incorporate XML fragments, approaching the "
"convenience of an XML literal::"
msgstr ""
#: whatsnew/2.5.rst:1803
2016-10-30 09:46:26 +00:00
msgid ""
"Each XML element supports some dictionary-like and some list-like access "
"methods. Dictionary-like operations are used to access attribute values, "
"and list-like operations are used to access child nodes."
msgstr ""
#: whatsnew/2.5.rst:1808
2016-10-30 09:46:26 +00:00
msgid "Operation"
msgstr "Opération"
#: whatsnew/2.5.rst:1808
2016-10-30 09:46:26 +00:00
msgid "Result"
msgstr "Résultat"
#: whatsnew/2.5.rst:1810
2016-10-30 09:46:26 +00:00
msgid "``elem[n]``"
msgstr "``elem[n]``"
#: whatsnew/2.5.rst:1810
2016-10-30 09:46:26 +00:00
msgid "Returns n'th child element."
msgstr ""
#: whatsnew/2.5.rst:1812
2016-10-30 09:46:26 +00:00
msgid "``elem[m:n]``"
msgstr "``elem[m:n]``"
#: whatsnew/2.5.rst:1812
2016-10-30 09:46:26 +00:00
msgid "Returns list of m'th through n'th child elements."
msgstr ""
#: whatsnew/2.5.rst:1815
2016-10-30 09:46:26 +00:00
msgid "``len(elem)``"
msgstr "``len(elem)``"
#: whatsnew/2.5.rst:1815
2016-10-30 09:46:26 +00:00
msgid "Returns number of child elements."
msgstr ""
#: whatsnew/2.5.rst:1817
2016-10-30 09:46:26 +00:00
msgid "``list(elem)``"
msgstr "``list(elem)``"
#: whatsnew/2.5.rst:1817
2016-10-30 09:46:26 +00:00
msgid "Returns list of child elements."
msgstr ""
#: whatsnew/2.5.rst:1819
2016-10-30 09:46:26 +00:00
msgid "``elem.append(elem2)``"
msgstr "``elem.append(elem2)``"
#: whatsnew/2.5.rst:1819
2016-10-30 09:46:26 +00:00
msgid "Adds *elem2* as a child."
msgstr ""
#: whatsnew/2.5.rst:1821
2016-10-30 09:46:26 +00:00
msgid "``elem.insert(index, elem2)``"
msgstr "``elem.insert(index, elem2)``"
#: whatsnew/2.5.rst:1821
2016-10-30 09:46:26 +00:00
msgid "Inserts *elem2* at the specified location."
msgstr ""
#: whatsnew/2.5.rst:1823
2016-10-30 09:46:26 +00:00
msgid "``del elem[n]``"
msgstr "``del elem[n]``"
#: whatsnew/2.5.rst:1823
2016-10-30 09:46:26 +00:00
msgid "Deletes n'th child element."
msgstr ""
#: whatsnew/2.5.rst:1825
2016-10-30 09:46:26 +00:00
msgid "``elem.keys()``"
msgstr "``elem.keys()``"
#: whatsnew/2.5.rst:1825
2016-10-30 09:46:26 +00:00
msgid "Returns list of attribute names."
msgstr ""
#: whatsnew/2.5.rst:1827
2016-10-30 09:46:26 +00:00
msgid "``elem.get(name)``"
msgstr "``elem.get(name)``"
#: whatsnew/2.5.rst:1827
2016-10-30 09:46:26 +00:00
msgid "Returns value of attribute *name*."
msgstr ""
#: whatsnew/2.5.rst:1829
2016-10-30 09:46:26 +00:00
msgid "``elem.set(name, value)``"
msgstr "``elem.set(name, value)``"
#: whatsnew/2.5.rst:1829
2016-10-30 09:46:26 +00:00
msgid "Sets new value for attribute *name*."
msgstr ""
#: whatsnew/2.5.rst:1831
2016-10-30 09:46:26 +00:00
msgid "``elem.attrib``"
msgstr "``elem.attrib``"
#: whatsnew/2.5.rst:1831
2016-10-30 09:46:26 +00:00
msgid "Retrieves the dictionary containing attributes."
msgstr ""
#: whatsnew/2.5.rst:1834
2016-10-30 09:46:26 +00:00
msgid "``del elem.attrib[name]``"
msgstr "``del elem.attrib[name]``"
#: whatsnew/2.5.rst:1834
2016-10-30 09:46:26 +00:00
msgid "Deletes attribute *name*."
msgstr "Supprime lattribut *name*."
#: whatsnew/2.5.rst:1837
2016-10-30 09:46:26 +00:00
msgid ""
"Comments and processing instructions are also represented as :class:"
"`Element` nodes. To check if a node is a comment or processing "
"instructions::"
msgstr ""
#: whatsnew/2.5.rst:1845
2016-10-30 09:46:26 +00:00
msgid ""
"To generate XML output, you should call the :meth:`ElementTree.write` "
"method. Like :func:`parse`, it can take either a string or a file-like "
"object::"
msgstr ""
#: whatsnew/2.5.rst:1855
2016-10-30 09:46:26 +00:00
msgid ""
"(Caution: the default encoding used for output is ASCII. For general XML "
"work, where an element's name may contain arbitrary Unicode characters, "
"ASCII isn't a very useful encoding because it will raise an exception if an "
"element's name contains any characters with values greater than 127. "
"Therefore, it's best to specify a different encoding such as UTF-8 that can "
"handle any Unicode character.)"
msgstr ""
#: whatsnew/2.5.rst:1862
2016-10-30 09:46:26 +00:00
msgid ""
"This section is only a partial description of the ElementTree interfaces. "
"Please read the package's official documentation for more details."
msgstr ""
#: whatsnew/2.5.rst:1868
2022-05-22 21:15:02 +00:00
msgid ""
"https://web.archive.org/web/20201124024954/http://effbot.org/zone/element-"
"index.htm"
2016-10-30 09:46:26 +00:00
msgstr ""
#: whatsnew/2.5.rst:1869
2016-10-30 09:46:26 +00:00
msgid "Official documentation for ElementTree."
msgstr ""
#: whatsnew/2.5.rst:1877
2016-10-30 09:46:26 +00:00
msgid "The hashlib package"
msgstr ""
#: whatsnew/2.5.rst:1879
2016-10-30 09:46:26 +00:00
msgid ""
"A new :mod:`hashlib` module, written by Gregory P. Smith, has been added to "
"replace the :mod:`md5` and :mod:`sha` modules. :mod:`hashlib` adds support "
"for additional secure hashes (SHA-224, SHA-256, SHA-384, and SHA-512). When "
"available, the module uses OpenSSL for fast platform optimized "
"implementations of algorithms."
msgstr ""
#: whatsnew/2.5.rst:1885
2016-10-30 09:46:26 +00:00
msgid ""
"The old :mod:`md5` and :mod:`sha` modules still exist as wrappers around "
"hashlib to preserve backwards compatibility. The new module's interface is "
"very close to that of the old modules, but not identical. The most "
"significant difference is that the constructor functions for creating new "
"hashing objects are named differently. ::"
msgstr ""
#: whatsnew/2.5.rst:1914
2016-10-30 09:46:26 +00:00
msgid ""
"Once a hash object has been created, its methods are the same as before: "
"``update(string)`` hashes the specified string into the current digest "
"state, :meth:`digest` and :meth:`hexdigest` return the digest value as a "
"binary string or a string of hex digits, and :meth:`copy` returns a new "
"hashing object with the same digest state."
msgstr ""
#: whatsnew/2.5.rst:1923
2016-10-30 09:46:26 +00:00
msgid "The documentation for the :mod:`hashlib` module."
msgstr ""
#: whatsnew/2.5.rst:1931
2016-10-30 09:46:26 +00:00
msgid "The sqlite3 package"
msgstr ""
#: whatsnew/2.5.rst:1933
2016-10-30 09:46:26 +00:00
msgid ""
"The pysqlite module (https://www.pysqlite.org), a wrapper for the SQLite "
2016-10-30 09:46:26 +00:00
"embedded database, has been added to the standard library under the package "
"name :mod:`sqlite3`."
msgstr ""
#: whatsnew/2.5.rst:1937
2016-10-30 09:46:26 +00:00
msgid ""
"SQLite is a C library that provides a lightweight disk-based database that "
"doesn't require a separate server process and allows accessing the database "
"using a nonstandard variant of the SQL query language. Some applications can "
"use SQLite for internal data storage. It's also possible to prototype an "
"application using SQLite and then port the code to a larger database such as "
"PostgreSQL or Oracle."
msgstr ""
2019-05-28 12:44:15 +00:00
"SQLite est une bibliothèque C qui fournit une base de données légère sur "
"disque ne nécessitant pas de processus serveur et qui utilise une variante "
"(non standard) du langage de requête SQL pour accéder aux données. Certaines "
"applications peuvent utiliser SQLite pour le stockage de données internes. "
"Il est également possible de créer une application prototype utilisant "
"SQLite, puis de modifier le code pour utiliser une base de données plus "
"robuste telle que PostgreSQL ou Oracle."
2016-10-30 09:46:26 +00:00
#: whatsnew/2.5.rst:1944
2016-10-30 09:46:26 +00:00
msgid ""
"pysqlite was written by Gerhard Häring and provides a SQL interface "
"compliant with the DB-API 2.0 specification described by :pep:`249`."
msgstr ""
#: whatsnew/2.5.rst:1947
2016-10-30 09:46:26 +00:00
msgid ""
"If you're compiling the Python source yourself, note that the source tree "
"doesn't include the SQLite code, only the wrapper module. You'll need to "
"have the SQLite libraries and headers installed before compiling Python, and "
"the build process will compile the module when the necessary headers are "
"available."
msgstr ""
#: whatsnew/2.5.rst:1952
2020-02-14 10:18:53 +00:00
#, fuzzy
2016-10-30 09:46:26 +00:00
msgid ""
"To use the module, you must first create a :class:`Connection` object that "
"represents the database. Here the data will be stored in the :file:`/tmp/"
"example` file::"
msgstr ""
2020-02-14 10:18:53 +00:00
"Pour utiliser le module, vous devez dabord créer une :class:`Connection` "
"qui représente la base de données. Dans cet exemple, les données sont "
"stockées dans le fichier :file:`example.db` ::"
2016-10-30 09:46:26 +00:00
#: whatsnew/2.5.rst:1958
2016-10-30 09:46:26 +00:00
msgid ""
"You can also supply the special name ``:memory:`` to create a database in "
"RAM."
msgstr ""
2019-05-28 12:44:15 +00:00
"Vous pouvez également fournir le nom spécial ``:memory:`` pour créer une "
"base de données dans la mémoire vive."
2016-10-30 09:46:26 +00:00
#: whatsnew/2.5.rst:1960
2020-02-14 10:18:53 +00:00
#, fuzzy
2016-10-30 09:46:26 +00:00
msgid ""
"Once you have a :class:`Connection`, you can create a :class:`Cursor` "
"object and call its :meth:`execute` method to perform SQL commands::"
msgstr ""
2020-02-14 10:18:53 +00:00
"Une fois que vous avez une instance de :class:`Connection`, vous pouvez "
"créer un objet :class:`Cursor` et appeler sa méthode :meth:`~Cursor.execute` "
"pour exécuter les commandes SQL ::"
2016-10-30 09:46:26 +00:00
#: whatsnew/2.5.rst:1974
2016-10-30 09:46:26 +00:00
msgid ""
"Usually your SQL operations will need to use values from Python variables. "
"You shouldn't assemble your query using Python's string operations because "
"doing so is insecure; it makes your program vulnerable to an SQL injection "
"attack."
msgstr ""
#: whatsnew/2.5.rst:1978
2020-02-14 10:18:53 +00:00
#, fuzzy
2016-10-30 09:46:26 +00:00
msgid ""
"Instead, use the DB-API's parameter substitution. Put ``?`` as a "
"placeholder wherever you want to use a value, and then provide a tuple of "
"values as the second argument to the cursor's :meth:`execute` method. "
"(Other database modules may use a different placeholder, such as ``%s`` or "
"``:1``.) For example::"
msgstr ""
2020-02-14 10:18:53 +00:00
"À la place, utilisez la capacité DB-API de substitution des paramètres. "
"Placez un ``?`` comme indicateur partout où vous voulez utiliser une valeur, "
"puis fournissez un *n*-uplet de valeurs comme second argument de la méthode :"
2020-02-14 10:18:53 +00:00
"meth:`~Cursor.execute`. D'autres modules de base de données peuvent utiliser "
"un espace réservé différent, tel que ``%s`` ou ``:1``. Par exemple ::"
2016-10-30 09:46:26 +00:00
#: whatsnew/2.5.rst:1998
2016-10-30 09:46:26 +00:00
msgid ""
"To retrieve data after executing a SELECT statement, you can either treat "
"the cursor as an iterator, call the cursor's :meth:`fetchone` method to "
"retrieve a single matching row, or call :meth:`fetchall` to get a list of "
"the matching rows."
msgstr ""
#: whatsnew/2.5.rst:2003
2016-10-30 09:46:26 +00:00
msgid "This example uses the iterator form::"
2019-05-28 12:44:15 +00:00
msgstr "Cet exemple utilise la forme itérateur ::"
2016-10-30 09:46:26 +00:00
#: whatsnew/2.5.rst:2016
2016-10-30 09:46:26 +00:00
msgid ""
"For more information about the SQL dialect supported by SQLite, see https://"
"www.sqlite.org."
msgstr ""
#: whatsnew/2.5.rst:2023
#, fuzzy
msgid "https://www.pysqlite.org"
msgstr "https://www.sqlite.org"
2016-10-30 09:46:26 +00:00
#: whatsnew/2.5.rst:2023
2016-10-30 09:46:26 +00:00
msgid "The pysqlite web page."
msgstr ""
#: whatsnew/2.5.rst:2027
2016-10-30 09:46:26 +00:00
msgid "https://www.sqlite.org"
2019-05-28 12:44:15 +00:00
msgstr "https://www.sqlite.org"
2016-10-30 09:46:26 +00:00
#: whatsnew/2.5.rst:2026
2016-10-30 09:46:26 +00:00
msgid ""
"The SQLite web page; the documentation describes the syntax and the "
"available data types for the supported SQL dialect."
msgstr ""
2019-05-28 12:44:15 +00:00
"Dans la page Web de SQLite, la documentation décrit la syntaxe et les types "
"de données disponibles qui sont pris en charge par cette variante SQL."
2016-10-30 09:46:26 +00:00
#: whatsnew/2.5.rst:2029
2016-10-30 09:46:26 +00:00
msgid "The documentation for the :mod:`sqlite3` module."
msgstr ""
#: whatsnew/2.5.rst:2031
2016-10-30 09:46:26 +00:00
msgid ":pep:`249` - Database API Specification 2.0"
2019-05-28 12:44:15 +00:00
msgstr ":pep:`249` — Spécifications de l'API 2.0 pour la base de données"
2016-10-30 09:46:26 +00:00
#: whatsnew/2.5.rst:2032
2016-10-30 09:46:26 +00:00
msgid "PEP written by Marc-André Lemburg."
2019-05-28 12:44:15 +00:00
msgstr "PEP écrite par Marc-André Lemburg."
2016-10-30 09:46:26 +00:00
#: whatsnew/2.5.rst:2040
2016-10-30 09:46:26 +00:00
msgid "The wsgiref package"
msgstr ""
#: whatsnew/2.5.rst:2042
2016-10-30 09:46:26 +00:00
msgid ""
"The Web Server Gateway Interface (WSGI) v1.0 defines a standard interface "
"between web servers and Python web applications and is described in :pep:"
"`333`. The :mod:`wsgiref` package is a reference implementation of the WSGI "
"specification."
msgstr ""
#: whatsnew/2.5.rst:2049
2016-10-30 09:46:26 +00:00
msgid ""
"The package includes a basic HTTP server that will run a WSGI application; "
"this server is useful for debugging but isn't intended for production use. "
"Setting up a server takes only a few lines of code::"
msgstr ""
#: whatsnew/2.5.rst:2069
msgid ""
"https://web.archive.org/web/20160331090247/http://wsgi.readthedocs.org/en/"
"latest/"
2016-10-30 09:46:26 +00:00
msgstr ""
#: whatsnew/2.5.rst:2069
2016-10-30 09:46:26 +00:00
msgid "A central web site for WSGI-related resources."
msgstr ""
#: whatsnew/2.5.rst:2071
2016-10-30 09:46:26 +00:00
msgid ":pep:`333` - Python Web Server Gateway Interface v1.0"
msgstr ""
#: whatsnew/2.5.rst:2072
2016-10-30 09:46:26 +00:00
msgid "PEP written by Phillip J. Eby."
msgstr ""
#: whatsnew/2.5.rst:2080
2016-10-30 09:46:26 +00:00
msgid "Build and C API Changes"
msgstr ""
#: whatsnew/2.5.rst:2082
2016-10-30 09:46:26 +00:00
msgid "Changes to Python's build process and to the C API include:"
msgstr ""
#: whatsnew/2.5.rst:2084
2016-10-30 09:46:26 +00:00
msgid ""
"The Python source tree was converted from CVS to Subversion, in a complex "
"migration procedure that was supervised and flawlessly carried out by Martin "
"von Löwis. The procedure was developed as :pep:`347`."
msgstr ""
#: whatsnew/2.5.rst:2088
2016-10-30 09:46:26 +00:00
msgid ""
"Coverity, a company that markets a source code analysis tool called Prevent, "
"provided the results of their examination of the Python source code. The "
"analysis found about 60 bugs that were quickly fixed. Many of the bugs "
"were refcounting problems, often occurring in error-handling code. See "
"https://scan.coverity.com for the statistics."
msgstr ""
#: whatsnew/2.5.rst:2094
2016-10-30 09:46:26 +00:00
msgid ""
"The largest change to the C API came from :pep:`353`, which modifies the "
"interpreter to use a :c:type:`Py_ssize_t` type definition instead of :c:expr:"
2016-10-30 09:46:26 +00:00
"`int`. See the earlier section :ref:`pep-353` for a discussion of this "
"change."
msgstr ""
#: whatsnew/2.5.rst:2099
2016-10-30 09:46:26 +00:00
msgid ""
"The design of the bytecode compiler has changed a great deal, no longer "
"generating bytecode by traversing the parse tree. Instead the parse tree is "
"converted to an abstract syntax tree (or AST), and it is the abstract "
"syntax tree that's traversed to produce the bytecode."
msgstr ""
#: whatsnew/2.5.rst:2104
2016-10-30 09:46:26 +00:00
msgid ""
"It's possible for Python code to obtain AST objects by using the :func:"
"`compile` built-in and specifying ``_ast.PyCF_ONLY_AST`` as the value of "
"the *flags* parameter::"
msgstr ""
#: whatsnew/2.5.rst:2117
2016-10-30 09:46:26 +00:00
msgid ""
"No official documentation has been written for the AST code yet, but :pep:"
"`339` discusses the design. To start learning about the code, read the "
"definition of the various AST nodes in :file:`Parser/Python.asdl`. A Python "
"script reads this file and generates a set of C structure definitions in :"
"file:`Include/Python-ast.h`. The :c:func:`PyParser_ASTFromString` and :c:"
"func:`PyParser_ASTFromFile`, defined in :file:`Include/pythonrun.h`, take "
"Python source as input and return the root of an AST representing the "
"contents. This AST can then be turned into a code object by :c:func:"
"`PyAST_Compile`. For more information, read the source code, and then ask "
"questions on python-dev."
msgstr ""
#: whatsnew/2.5.rst:2127
2016-10-30 09:46:26 +00:00
msgid ""
"The AST code was developed under Jeremy Hylton's management, and implemented "
"by (in alphabetical order) Brett Cannon, Nick Coghlan, Grant Edwards, John "
"Ehresman, Kurt Kaiser, Neal Norwitz, Tim Peters, Armin Rigo, and Neil "
"Schemenauer, plus the participants in a number of AST sprints at conferences "
"such as PyCon."
msgstr ""
#: whatsnew/2.5.rst:2136
2016-10-30 09:46:26 +00:00
msgid ""
"Evan Jones's patch to obmalloc, first described in a talk at PyCon DC 2005, "
"was applied. Python 2.4 allocated small objects in 256K-sized arenas, but "
"never freed arenas. With this patch, Python will free arenas when they're "
"empty. The net effect is that on some platforms, when you allocate many "
"objects, Python's memory usage may actually drop when you delete them and "
"the memory may be returned to the operating system. (Implemented by Evan "
"Jones, and reworked by Tim Peters.)"
msgstr ""
#: whatsnew/2.5.rst:2144
2016-10-30 09:46:26 +00:00
msgid ""
"Note that this change means extension modules must be more careful when "
"allocating memory. Python's API has many different functions for allocating "
"memory that are grouped into families. For example, :c:func:"
"`PyMem_Malloc`, :c:func:`PyMem_Realloc`, and :c:func:`PyMem_Free` are one "
"family that allocates raw memory, while :c:func:`PyObject_Malloc`, :c:func:"
"`PyObject_Realloc`, and :c:func:`PyObject_Free` are another family that's "
"supposed to be used for creating Python objects."
msgstr ""
#: whatsnew/2.5.rst:2152
2016-10-30 09:46:26 +00:00
msgid ""
"Previously these different families all reduced to the platform's :c:func:"
"`malloc` and :c:func:`free` functions. This meant it didn't matter if you "
"got things wrong and allocated memory with the :c:func:`PyMem` function but "
"freed it with the :c:func:`PyObject` function. With 2.5's changes to "
"obmalloc, these families now do different things and mismatches will "
"probably result in a segfault. You should carefully test your C extension "
"modules with Python 2.5."
msgstr ""
#: whatsnew/2.5.rst:2159
2016-10-30 09:46:26 +00:00
msgid ""
"The built-in set types now have an official C API. Call :c:func:`PySet_New` "
"and :c:func:`PyFrozenSet_New` to create a new set, :c:func:`PySet_Add` and :"
"c:func:`PySet_Discard` to add and remove elements, and :c:func:"
"`PySet_Contains` and :c:func:`PySet_Size` to examine the set's state. "
"(Contributed by Raymond Hettinger.)"
msgstr ""
#: whatsnew/2.5.rst:2165
2016-10-30 09:46:26 +00:00
msgid ""
"C code can now obtain information about the exact revision of the Python "
"interpreter by calling the :c:func:`Py_GetBuildInfo` function that returns "
"a string of build information like this: ``\"trunk:45355:45356M, Apr 13 "
"2006, 07:42:19\"``. (Contributed by Barry Warsaw.)"
msgstr ""
#: whatsnew/2.5.rst:2170
2016-10-30 09:46:26 +00:00
msgid ""
"Two new macros can be used to indicate C functions that are local to the "
"current file so that a faster calling convention can be used. "
"``Py_LOCAL(type)`` declares the function as returning a value of the "
"specified *type* and uses a fast-calling qualifier. "
"``Py_LOCAL_INLINE(type)`` does the same thing and also requests the function "
"be inlined. If :c:func:`PY_LOCAL_AGGRESSIVE` is defined before :file:"
"`python.h` is included, a set of more aggressive optimizations are enabled "
"for the module; you should benchmark the results to find out if these "
"optimizations actually make the code faster. (Contributed by Fredrik Lundh "
"at the NeedForSpeed sprint.)"
msgstr ""
#: whatsnew/2.5.rst:2181
2016-10-30 09:46:26 +00:00
msgid ""
"``PyErr_NewException(name, base, dict)`` can now accept a tuple of base "
"classes as its *base* argument. (Contributed by Georg Brandl.)"
msgstr ""
#: whatsnew/2.5.rst:2184
2016-10-30 09:46:26 +00:00
msgid ""
"The :c:func:`PyErr_Warn` function for issuing warnings is now deprecated in "
"favour of ``PyErr_WarnEx(category, message, stacklevel)`` which lets you "
"specify the number of stack frames separating this function and the caller. "
"A *stacklevel* of 1 is the function calling :c:func:`PyErr_WarnEx`, 2 is the "
"function above that, and so forth. (Added by Neal Norwitz.)"
msgstr ""
#: whatsnew/2.5.rst:2190
2016-10-30 09:46:26 +00:00
msgid ""
"The CPython interpreter is still written in C, but the code can now be "
"compiled with a C++ compiler without errors. (Implemented by Anthony "
"Baxter, Martin von Löwis, Skip Montanaro.)"
msgstr ""
#: whatsnew/2.5.rst:2194
2016-10-30 09:46:26 +00:00
msgid ""
"The :c:func:`PyRange_New` function was removed. It was never documented, "
"never used in the core code, and had dangerously lax error checking. In the "
"unlikely case that your extensions were using it, you can replace it by "
"something like the following::"
msgstr ""
#: whatsnew/2.5.rst:2208
2016-10-30 09:46:26 +00:00
msgid "Port-Specific Changes"
msgstr ""
#: whatsnew/2.5.rst:2210
2016-10-30 09:46:26 +00:00
msgid ""
"MacOS X (10.3 and higher): dynamic loading of modules now uses the :c:func:"
"`dlopen` function instead of MacOS-specific functions."
msgstr ""
#: whatsnew/2.5.rst:2213
2016-10-30 09:46:26 +00:00
msgid ""
2017-04-02 20:14:06 +00:00
"MacOS X: an :option:`!--enable-universalsdk` switch was added to the :"
"program:`configure` script that compiles the interpreter as a universal "
"binary able to run on both PowerPC and Intel processors. (Contributed by "
"Ronald Oussoren; :issue:`2573`.)"
2016-10-30 09:46:26 +00:00
msgstr ""
#: whatsnew/2.5.rst:2218
2016-10-30 09:46:26 +00:00
msgid ""
"Windows: :file:`.dll` is no longer supported as a filename extension for "
"extension modules. :file:`.pyd` is now the only filename extension that "
"will be searched for."
msgstr ""
#: whatsnew/2.5.rst:2228
2016-10-30 09:46:26 +00:00
msgid "Porting to Python 2.5"
msgstr "Portage vers Python 2.5"
#: whatsnew/2.5.rst:2230
2016-10-30 09:46:26 +00:00
msgid ""
"This section lists previously described changes that may require changes to "
"your code:"
msgstr ""
#: whatsnew/2.5.rst:2233
2016-10-30 09:46:26 +00:00
msgid ""
"ASCII is now the default encoding for modules. It's now a syntax error if "
"a module contains string literals with 8-bit characters but doesn't have an "
"encoding declaration. In Python 2.4 this triggered a warning, not a syntax "
"error."
msgstr ""
#: whatsnew/2.5.rst:2238
2016-10-30 09:46:26 +00:00
msgid ""
"Previously, the :attr:`gi_frame` attribute of a generator was always a frame "
"object. Because of the :pep:`342` changes described in section :ref:"
"`pep-342`, it's now possible for :attr:`gi_frame` to be ``None``."
msgstr ""
#: whatsnew/2.5.rst:2242
2016-10-30 09:46:26 +00:00
msgid ""
"A new warning, :class:`UnicodeWarning`, is triggered when you attempt to "
"compare a Unicode string and an 8-bit string that can't be converted to "
"Unicode using the default ASCII encoding. Previously such comparisons would "
"raise a :class:`UnicodeDecodeError` exception."
msgstr ""
#: whatsnew/2.5.rst:2247
2016-10-30 09:46:26 +00:00
msgid ""
"Library: the :mod:`csv` module is now stricter about multi-line quoted "
"fields. If your files contain newlines embedded within fields, the input "
"should be split into lines in a manner which preserves the newline "
"characters."
msgstr ""
#: whatsnew/2.5.rst:2251
2016-10-30 09:46:26 +00:00
msgid ""
"Library: the :mod:`locale` module's :func:`format` function's would "
"previously accept any string as long as no more than one %char specifier "
"appeared. In Python 2.5, the argument must be exactly one %char specifier "
"with no surrounding text."
msgstr ""
#: whatsnew/2.5.rst:2256
2016-10-30 09:46:26 +00:00
msgid ""
"Library: The :mod:`pickle` and :mod:`cPickle` modules no longer accept a "
"return value of ``None`` from the :meth:`__reduce__` method; the method must "
"return a tuple of arguments instead. The modules also no longer accept the "
"deprecated *bin* keyword parameter."
msgstr ""
#: whatsnew/2.5.rst:2261
2016-10-30 09:46:26 +00:00
msgid ""
"Library: The :mod:`SimpleXMLRPCServer` and :mod:`DocXMLRPCServer` classes "
"now have a :attr:`rpc_paths` attribute that constrains XML-RPC operations to "
"a limited set of URL paths; the default is to allow only ``'/'`` and ``'/"
"RPC2'``. Setting :attr:`rpc_paths` to ``None`` or an empty tuple disables "
"this path checking."
msgstr ""
#: whatsnew/2.5.rst:2267
2016-10-30 09:46:26 +00:00
msgid ""
"C API: Many functions now use :c:type:`Py_ssize_t` instead of :c:expr:`int` "
2016-10-30 09:46:26 +00:00
"to allow processing more data on 64-bit machines. Extension code may need "
"to make the same change to avoid warnings and to support 64-bit machines. "
"See the earlier section :ref:`pep-353` for a discussion of this change."
msgstr ""
#: whatsnew/2.5.rst:2272
2016-10-30 09:46:26 +00:00
msgid ""
"C API: The obmalloc changes mean that you must be careful to not mix usage "
"of the ``PyMem_*`` and ``PyObject_*`` families of functions. Memory "
"allocated with one family's ``*_Malloc`` must be freed with the "
"corresponding family's ``*_Free`` function."
2016-10-30 09:46:26 +00:00
msgstr ""
#: whatsnew/2.5.rst:2281
2016-10-30 09:46:26 +00:00
msgid "Acknowledgements"
msgstr "Remerciements"
2016-10-30 09:46:26 +00:00
#: whatsnew/2.5.rst:2283
2016-10-30 09:46:26 +00:00
msgid ""
"The author would like to thank the following people for offering "
"suggestions, corrections and assistance with various drafts of this article: "
"Georg Brandl, Nick Coghlan, Phillip J. Eby, Lars Gustäbel, Raymond "
2017-04-02 20:14:06 +00:00
"Hettinger, Ralf W. Grosse-Kunstleve, Kent Johnson, Iain Lowe, Martin von "
2016-10-30 09:46:26 +00:00
"Löwis, Fredrik Lundh, Andrew McNamara, Skip Montanaro, Gustavo Niemeyer, "
"Paul Prescod, James Pryor, Mike Rovner, Scott Weikart, Barry Warsaw, Thomas "
"Wouters."
msgstr ""