# SOME DESCRIPTIVE TITLE. # Copyright (C) 2001-2016, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , 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 \n" "Language-Team: LANGUAGE \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 " "`. 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 " "`. 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 ""