python-docs-fr/library/warnings.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2016, Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.6\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2017-04-02 22:11+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language: fr\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#: ../Doc/library/warnings.rst:2
msgid ":mod:`warnings` --- Warning control"
msgstr ""

#: ../Doc/library/warnings.rst:7
msgid "**Source code:** :source:`Lib/warnings.py`"
msgstr "**Code source:** :source:`Lib/warnings.py`"

#: ../Doc/library/warnings.rst:13
msgid ""
"Warning messages are typically issued in situations where it is useful to "
"alert the user of some condition in a program, where that condition "
"(normally) doesn't warrant raising an exception and terminating the "
"program.  For example, one might want to issue a warning when a program uses "
"an obsolete module."
msgstr ""

#: ../Doc/library/warnings.rst:18
msgid ""
"Python programmers issue warnings by calling the :func:`warn` function "
"defined in this module.  (C programmers use :c:func:`PyErr_WarnEx`; see :ref:"
"`exceptionhandling` for details)."
msgstr ""

#: ../Doc/library/warnings.rst:22
msgid ""
"Warning messages are normally written to ``sys.stderr``, but their "
"disposition can be changed flexibly, from ignoring all warnings to turning "
"them into exceptions.  The disposition of warnings can vary based on the "
"warning category (see below), the text of the warning message, and the "
"source location where it is issued.  Repetitions of a particular warning for "
"the same source location are typically suppressed."
msgstr ""

#: ../Doc/library/warnings.rst:29
msgid ""
"There are two stages in warning control: first, each time a warning is "
"issued, a determination is made whether a message should be issued or not; "
"next, if a message is to be issued, it is formatted and printed using a user-"
"settable hook."
msgstr ""

#: ../Doc/library/warnings.rst:33
msgid ""
"The determination whether to issue a warning message is controlled by the "
"warning filter, which is a sequence of matching rules and actions. Rules can "
"be added to the filter by calling :func:`filterwarnings` and reset to its "
"default state by calling :func:`resetwarnings`."
msgstr ""

#: ../Doc/library/warnings.rst:38
msgid ""
"The printing of warning messages is done by calling :func:`showwarning`, "
"which may be overridden; the default implementation of this function formats "
"the message by calling :func:`formatwarning`, which is also available for "
"use by custom implementations."
msgstr ""

#: ../Doc/library/warnings.rst:44
msgid ""
":func:`logging.captureWarnings` allows you to handle all warnings with the "
"standard logging infrastructure."
msgstr ""

#: ../Doc/library/warnings.rst:51
msgid "Warning Categories"
msgstr ""

#: ../Doc/library/warnings.rst:53
msgid ""
"There are a number of built-in exceptions that represent warning categories. "
"This categorization is useful to be able to filter out groups of warnings.  "
"The following warnings category classes are currently defined:"
msgstr ""

#: ../Doc/library/warnings.rst:60
msgid "Class"
msgstr ""

#: ../Doc/library/warnings.rst:60
msgid "Description"
msgstr "Description"

#: ../Doc/library/warnings.rst:62
msgid ":exc:`Warning`"
msgstr ":exc:`Warning`"

#: ../Doc/library/warnings.rst:62
msgid ""
"This is the base class of all warning category classes.  It is a subclass "
"of :exc:`Exception`."
msgstr ""

#: ../Doc/library/warnings.rst:66
msgid ":exc:`UserWarning`"
msgstr ":exc:`UserWarning`"

#: ../Doc/library/warnings.rst:66
msgid "The default category for :func:`warn`."
msgstr ""

#: ../Doc/library/warnings.rst:68
msgid ":exc:`DeprecationWarning`"
msgstr ":exc:`DeprecationWarning`"

#: ../Doc/library/warnings.rst:68
msgid ""
"Base category for warnings about deprecated features (ignored by default)."
msgstr ""

#: ../Doc/library/warnings.rst:71
msgid ":exc:`SyntaxWarning`"
msgstr ":exc:`SyntaxWarning`"

#: ../Doc/library/warnings.rst:71
msgid "Base category for warnings about dubious syntactic features."
msgstr ""

#: ../Doc/library/warnings.rst:74
msgid ":exc:`RuntimeWarning`"
msgstr ":exc:`RuntimeWarning`"

#: ../Doc/library/warnings.rst:74
msgid "Base category for warnings about dubious runtime features."
msgstr ""

#: ../Doc/library/warnings.rst:77
msgid ":exc:`FutureWarning`"
msgstr ":exc:`FutureWarning`"

#: ../Doc/library/warnings.rst:77
msgid ""
"Base category for warnings about constructs that will change semantically in "
"the future."
msgstr ""

#: ../Doc/library/warnings.rst:80
msgid ":exc:`PendingDeprecationWarning`"
msgstr ":exc:`PendingDeprecationWarning`"

#: ../Doc/library/warnings.rst:80
msgid ""
"Base category for warnings about features that will be deprecated in the "
"future (ignored by default)."
msgstr ""

#: ../Doc/library/warnings.rst:84
msgid ":exc:`ImportWarning`"
msgstr ":exc:`ImportWarning`"

#: ../Doc/library/warnings.rst:84
msgid ""
"Base category for warnings triggered during the process of importing a "
"module (ignored by default)."
msgstr ""

#: ../Doc/library/warnings.rst:88
msgid ":exc:`UnicodeWarning`"
msgstr ":exc:`UnicodeWarning`"

#: ../Doc/library/warnings.rst:88
msgid "Base category for warnings related to Unicode."
msgstr ""

#: ../Doc/library/warnings.rst:91
msgid ":exc:`BytesWarning`"
msgstr ":exc:`BytesWarning`"

#: ../Doc/library/warnings.rst:91
msgid ""
"Base category for warnings related to :class:`bytes` and :class:`bytearray`."
msgstr ""

#: ../Doc/library/warnings.rst:94
msgid ":exc:`ResourceWarning`"
msgstr ":exc:`ResourceWarning`"

#: ../Doc/library/warnings.rst:94
msgid "Base category for warnings related to resource usage."
msgstr ""

#: ../Doc/library/warnings.rst:99
msgid ""
"While these are technically built-in exceptions, they are documented here, "
"because conceptually they belong to the warnings mechanism."
msgstr ""

#: ../Doc/library/warnings.rst:102
msgid ""
"User code can define additional warning categories by subclassing one of the "
"standard warning categories.  A warning category must always be a subclass "
"of the :exc:`Warning` class."
msgstr ""

#: ../Doc/library/warnings.rst:110
msgid "The Warnings Filter"
msgstr ""

#: ../Doc/library/warnings.rst:112
msgid ""
"The warnings filter controls whether warnings are ignored, displayed, or "
"turned into errors (raising an exception)."
msgstr ""

#: ../Doc/library/warnings.rst:115
msgid ""
"Conceptually, the warnings filter maintains an ordered list of filter "
"specifications; any specific warning is matched against each filter "
"specification in the list in turn until a match is found; the match "
"determines the disposition of the match.  Each entry is a tuple of the form "
"(*action*, *message*, *category*, *module*, *lineno*), where:"
msgstr ""

#: ../Doc/library/warnings.rst:121
msgid "*action* is one of the following strings:"
msgstr ""

#: ../Doc/library/warnings.rst:124
msgid "Value"
msgstr "Valeur"

#: ../Doc/library/warnings.rst:124
msgid "Disposition"
msgstr ""

#: ../Doc/library/warnings.rst:126
msgid "``\"error\"``"
msgstr "``\"error\"``"

#: ../Doc/library/warnings.rst:126
msgid "turn matching warnings into exceptions"
msgstr ""

#: ../Doc/library/warnings.rst:128
msgid "``\"ignore\"``"
msgstr "``\"ignore\"``"

#: ../Doc/library/warnings.rst:128
msgid "never print matching warnings"
msgstr ""

#: ../Doc/library/warnings.rst:130
msgid "``\"always\"``"
msgstr "``\"always\"``"

#: ../Doc/library/warnings.rst:130
msgid "always print matching warnings"
msgstr ""

#: ../Doc/library/warnings.rst:132
msgid "``\"default\"``"
msgstr "``\"default\"``"

#: ../Doc/library/warnings.rst:132
msgid ""
"print the first occurrence of matching warnings for each location where the "
"warning is issued"
msgstr ""

#: ../Doc/library/warnings.rst:136
msgid "``\"module\"``"
msgstr "``\"module\"``"

#: ../Doc/library/warnings.rst:136
msgid ""
"print the first occurrence of matching warnings for each module where the "
"warning is issued"
msgstr ""

#: ../Doc/library/warnings.rst:140
msgid "``\"once\"``"
msgstr "``\"once\"``"

#: ../Doc/library/warnings.rst:140
msgid ""
"print only the first occurrence of matching warnings, regardless of location"
msgstr ""

#: ../Doc/library/warnings.rst:144
msgid ""
"*message* is a string containing a regular expression that the start of the "
"warning message must match.  The expression is compiled to always be case-"
"insensitive."
msgstr ""

#: ../Doc/library/warnings.rst:148
msgid ""
"*category* is a class (a subclass of :exc:`Warning`) of which the warning "
"category must be a subclass in order to match."
msgstr ""

#: ../Doc/library/warnings.rst:151
msgid ""
"*module* is a string containing a regular expression that the module name "
"must match.  The expression is compiled to be case-sensitive."
msgstr ""

#: ../Doc/library/warnings.rst:154
msgid ""
"*lineno* is an integer that the line number where the warning occurred must "
"match, or ``0`` to match all line numbers."
msgstr ""

#: ../Doc/library/warnings.rst:157
msgid ""
"Since the :exc:`Warning` class is derived from the built-in :exc:`Exception` "
"class, to turn a warning into an error we simply raise ``category(message)``."
msgstr ""

#: ../Doc/library/warnings.rst:160
msgid ""
"The warnings filter is initialized by :option:`-W` options passed to the "
"Python interpreter command line.  The interpreter saves the arguments for "
"all :option:`-W` options without interpretation in ``sys.warnoptions``; the :"
"mod:`warnings` module parses these when it is first imported (invalid "
"options are ignored, after printing a message to ``sys.stderr``)."
msgstr ""

#: ../Doc/library/warnings.rst:168
msgid "Default Warning Filters"
msgstr ""

#: ../Doc/library/warnings.rst:170
msgid ""
"By default, Python installs several warning filters, which can be overridden "
"by the command-line options passed to :option:`-W` and calls to :func:"
"`filterwarnings`."
msgstr ""

#: ../Doc/library/warnings.rst:174
msgid ""
":exc:`DeprecationWarning` and :exc:`PendingDeprecationWarning`, and :exc:"
"`ImportWarning` are ignored."
msgstr ""

#: ../Doc/library/warnings.rst:177
msgid ""
":exc:`BytesWarning` is ignored unless the :option:`-b` option is given once "
"or twice; in this case this warning is either printed (``-b``) or turned "
"into an exception (``-bb``)."
msgstr ""

#: ../Doc/library/warnings.rst:181
msgid ""
":exc:`ResourceWarning` is ignored unless Python was built in debug mode."
msgstr ""

#: ../Doc/library/warnings.rst:183
msgid ""
":exc:`DeprecationWarning` is now ignored by default in addition to :exc:"
"`PendingDeprecationWarning`."
msgstr ""

#: ../Doc/library/warnings.rst:191
msgid "Temporarily Suppressing Warnings"
msgstr ""

#: ../Doc/library/warnings.rst:193
msgid ""
"If you are using code that you know will raise a warning, such as a "
"deprecated function, but do not want to see the warning, then it is possible "
"to suppress the warning using the :class:`catch_warnings` context manager::"
msgstr ""

#: ../Doc/library/warnings.rst:206
msgid ""
"While within the context manager all warnings will simply be ignored. This "
"allows you to use known-deprecated code without having to see the warning "
"while not suppressing the warning for other code that might not be aware of "
"its use of deprecated code.  Note: this can only be guaranteed in a single-"
"threaded application. If two or more threads use the :class:`catch_warnings` "
"context manager at the same time, the behavior is undefined."
msgstr ""

#: ../Doc/library/warnings.rst:218
msgid "Testing Warnings"
msgstr ""

#: ../Doc/library/warnings.rst:220
msgid ""
"To test warnings raised by code, use the :class:`catch_warnings` context "
"manager. With it you can temporarily mutate the warnings filter to "
"facilitate your testing. For instance, do the following to capture all "
"raised warnings to check::"
msgstr ""

#: ../Doc/library/warnings.rst:240
msgid ""
"One can also cause all warnings to be exceptions by using ``error`` instead "
"of ``always``. One thing to be aware of is that if a warning has already "
"been raised because of a ``once``/``default`` rule, then no matter what "
"filters are set the warning will not be seen again unless the warnings "
"registry related to the warning has been cleared."
msgstr ""

#: ../Doc/library/warnings.rst:246
msgid ""
"Once the context manager exits, the warnings filter is restored to its state "
"when the context was entered. This prevents tests from changing the warnings "
"filter in unexpected ways between tests and leading to indeterminate test "
"results. The :func:`showwarning` function in the module is also restored to "
"its original value.  Note: this can only be guaranteed in a single-threaded "
"application. If two or more threads use the :class:`catch_warnings` context "
"manager at the same time, the behavior is undefined."
msgstr ""

#: ../Doc/library/warnings.rst:254
msgid ""
"When testing multiple operations that raise the same kind of warning, it is "
"important to test them in a manner that confirms each operation is raising a "
"new warning (e.g. set warnings to be raised as exceptions and check the "
"operations raise exceptions, check that the length of the warning list "
"continues to increase after each operation, or else delete the previous "
"entries from the warnings list before each new operation)."
msgstr ""

#: ../Doc/library/warnings.rst:265
msgid "Updating Code For New Versions of Python"
msgstr ""

#: ../Doc/library/warnings.rst:267
msgid ""
"Warnings that are only of interest to the developer are ignored by default. "
"As such you should make sure to test your code with typically ignored "
"warnings made visible. You can do this from the command-line by passing :"
"option:`-Wd <-W>` to the interpreter (this is shorthand for :option:`!-W "
"default`).  This enables default handling for all warnings, including those "
"that are ignored by default. To change what action is taken for encountered "
"warnings you simply change what argument is passed to :option:`-W`, e.g. :"
"option:`!-W error`. See the :option:`-W` flag for more details on what is "
"possible."
msgstr ""

#: ../Doc/library/warnings.rst:276
msgid "To programmatically do the same as :option:`!-Wd`, use::"
msgstr ""

#: ../Doc/library/warnings.rst:280
msgid ""
"Make sure to execute this code as soon as possible. This prevents the "
"registering of what warnings have been raised from unexpectedly influencing "
"how future warnings are treated."
msgstr ""

#: ../Doc/library/warnings.rst:284
msgid ""
"Having certain warnings ignored by default is done to prevent a user from "
"seeing warnings that are only of interest to the developer. As you do not "
"necessarily have control over what interpreter a user uses to run their "
"code, it is possible that a new version of Python will be released between "
"your release cycles.  The new interpreter release could trigger new warnings "
"in your code that were not there in an older interpreter, e.g. :exc:"
"`DeprecationWarning` for a module that you are using. While you as a "
"developer want to be notified that your code is using a deprecated module, "
"to a user this information is essentially noise and provides no benefit to "
"them."
msgstr ""

#: ../Doc/library/warnings.rst:294
msgid ""
"The :mod:`unittest` module has been also updated to use the ``'default'`` "
"filter while running tests."
msgstr ""

#: ../Doc/library/warnings.rst:301
msgid "Available Functions"
msgstr ""

#: ../Doc/library/warnings.rst:306
msgid ""
"Issue a warning, or maybe ignore it or raise an exception.  The *category* "
"argument, if given, must be a warning category class (see above); it "
"defaults to :exc:`UserWarning`.  Alternatively *message* can be a :exc:"
"`Warning` instance, in which case *category* will be ignored and ``message."
"__class__`` will be used. In this case the message text will be "
"``str(message)``. This function raises an exception if the particular "
"warning issued is changed into an error by the warnings filter see above.  "
"The *stacklevel* argument can be used by wrapper functions written in "
"Python, like this::"
msgstr ""

#: ../Doc/library/warnings.rst:318
msgid ""
"This makes the warning refer to :func:`deprecation`'s caller, rather than to "
"the source of :func:`deprecation` itself (since the latter would defeat the "
"purpose of the warning message)."
msgstr ""

#: ../Doc/library/warnings.rst:322 ../Doc/library/warnings.rst:345
msgid ""
"*source*, if supplied, is the destroyed object which emitted a :exc:"
"`ResourceWarning`."
msgstr ""

#: ../Doc/library/warnings.rst:325
msgid "Added *source* parameter."
msgstr ""

#: ../Doc/library/warnings.rst:331
msgid ""
"This is a low-level interface to the functionality of :func:`warn`, passing "
"in explicitly the message, category, filename and line number, and "
"optionally the module name and the registry (which should be the "
"``__warningregistry__`` dictionary of the module).  The module name defaults "
"to the filename with ``.py`` stripped; if no registry is passed, the warning "
"is never suppressed. *message* must be a string and *category* a subclass "
"of :exc:`Warning` or *message* may be a :exc:`Warning` instance, in which "
"case *category* will be ignored."
msgstr ""

#: ../Doc/library/warnings.rst:340
msgid ""
"*module_globals*, if supplied, should be the global namespace in use by the "
"code for which the warning is issued.  (This argument is used to support "
"displaying source for modules found in zipfiles or other non-filesystem "
"import sources)."
msgstr ""

#: ../Doc/library/warnings.rst:348
msgid "Add the *source* parameter."
msgstr ""

#: ../Doc/library/warnings.rst:354
msgid ""
"Write a warning to a file.  The default implementation calls "
"``formatwarning(message, category, filename, lineno, line)`` and writes the "
"resulting string to *file*, which defaults to ``sys.stderr``.  You may "
"replace this function with any callable by assigning to ``warnings."
"showwarning``. *line* is a line of source code to be included in the warning "
"message; if *line* is not supplied, :func:`showwarning` will try to read the "
"line specified by *filename* and *lineno*."
msgstr ""

#: ../Doc/library/warnings.rst:365
msgid ""
"Format a warning the standard way.  This returns a string which may contain "
"embedded newlines and ends in a newline.  *line* is a line of source code to "
"be included in the warning message; if *line* is not supplied, :func:"
"`formatwarning` will try to read the line specified by *filename* and "
"*lineno*."
msgstr ""

#: ../Doc/library/warnings.rst:374
msgid ""
"Insert an entry into the list of :ref:`warnings filter specifications "
"<warning-filter>`.  The entry is inserted at the front by default; if "
"*append* is true, it is inserted at the end.  This checks the types of the "
"arguments, compiles the *message* and *module* regular expressions, and "
"inserts them as a tuple in the list of warnings filters.  Entries closer to "
"the front of the list override entries later in the list, if both match a "
"particular warning.  Omitted arguments default to a value that matches "
"everything."
msgstr ""

#: ../Doc/library/warnings.rst:386
msgid ""
"Insert a simple entry into the list of :ref:`warnings filter specifications "
"<warning-filter>`.  The meaning of the function parameters is as for :func:"
"`filterwarnings`, but regular expressions are not needed as the filter "
"inserted always matches any message in any module as long as the category "
"and line number match."
msgstr ""

#: ../Doc/library/warnings.rst:395
msgid ""
"Reset the warnings filter.  This discards the effect of all previous calls "
"to :func:`filterwarnings`, including that of the :option:`-W` command line "
"options and calls to :func:`simplefilter`."
msgstr ""

#: ../Doc/library/warnings.rst:401
msgid "Available Context Managers"
msgstr ""

#: ../Doc/library/warnings.rst:405
msgid ""
"A context manager that copies and, upon exit, restores the warnings filter "
"and the :func:`showwarning` function. If the *record* argument is :const:"
"`False` (the default) the context manager returns :class:`None` on entry. If "
"*record* is :const:`True`, a list is returned that is progressively "
"populated with objects as seen by a custom :func:`showwarning` function "
"(which also suppresses output to ``sys.stdout``). Each object in the list "
"has attributes with the same names as the arguments to :func:`showwarning`."
msgstr ""

#: ../Doc/library/warnings.rst:414
msgid ""
"The *module* argument takes a module that will be used instead of the module "
"returned when you import :mod:`warnings` whose filter will be protected. "
"This argument exists primarily for testing the :mod:`warnings` module itself."
msgstr ""

#: ../Doc/library/warnings.rst:421
msgid ""
"The :class:`catch_warnings` manager works by replacing and then later "
"restoring the module's :func:`showwarning` function and internal list of "
"filter specifications.  This means the context manager is modifying global "
"state and therefore is not thread-safe."
msgstr ""