forked from AFPy/python-docs-fr
690 lines
24 KiB
Plaintext
690 lines
24 KiB
Plaintext
# Copyright (C) 2001-2018, Python Software Foundation
|
|
# For licence information, see README file.
|
|
#
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: Python 3.6\n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2018-06-28 15:29+0200\n"
|
|
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
|
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
|
"Language-Team: FRENCH <traductions@lists.afpy.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."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:56
|
|
msgid ""
|
|
"While these are technically :ref:`built-in exceptions <warning-categories-as-"
|
|
"exceptions>`, they are documented here, because conceptually they belong to "
|
|
"the warnings mechanism."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:60
|
|
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:64
|
|
msgid "The following warnings category classes are currently defined:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:69
|
|
msgid "Class"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:69
|
|
msgid "Description"
|
|
msgstr "Description"
|
|
|
|
#: ../Doc/library/warnings.rst:71
|
|
msgid ":exc:`Warning`"
|
|
msgstr ":exc:`Warning`"
|
|
|
|
#: ../Doc/library/warnings.rst:71
|
|
msgid ""
|
|
"This is the base class of all warning category classes. It is a subclass "
|
|
"of :exc:`Exception`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:75
|
|
msgid ":exc:`UserWarning`"
|
|
msgstr ":exc:`UserWarning`"
|
|
|
|
#: ../Doc/library/warnings.rst:75
|
|
msgid "The default category for :func:`warn`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:77
|
|
msgid ":exc:`DeprecationWarning`"
|
|
msgstr ":exc:`DeprecationWarning`"
|
|
|
|
#: ../Doc/library/warnings.rst:77
|
|
msgid ""
|
|
"Base category for warnings about deprecated features when those warnings are "
|
|
"intended for other Python developers (ignored by default, unless triggered "
|
|
"by code in ``__main__``)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:82
|
|
msgid ":exc:`SyntaxWarning`"
|
|
msgstr ":exc:`SyntaxWarning`"
|
|
|
|
#: ../Doc/library/warnings.rst:82
|
|
msgid "Base category for warnings about dubious syntactic features."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:85
|
|
msgid ":exc:`RuntimeWarning`"
|
|
msgstr ":exc:`RuntimeWarning`"
|
|
|
|
#: ../Doc/library/warnings.rst:85
|
|
msgid "Base category for warnings about dubious runtime features."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:88
|
|
msgid ":exc:`FutureWarning`"
|
|
msgstr ":exc:`FutureWarning`"
|
|
|
|
#: ../Doc/library/warnings.rst:88
|
|
msgid ""
|
|
"Base category for warnings about deprecated features when those warnings are "
|
|
"intended for end users of applications that are written in Python."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:93
|
|
msgid ":exc:`PendingDeprecationWarning`"
|
|
msgstr ":exc:`PendingDeprecationWarning`"
|
|
|
|
#: ../Doc/library/warnings.rst:93
|
|
msgid ""
|
|
"Base category for warnings about features that will be deprecated in the "
|
|
"future (ignored by default)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:97
|
|
msgid ":exc:`ImportWarning`"
|
|
msgstr ":exc:`ImportWarning`"
|
|
|
|
#: ../Doc/library/warnings.rst:97
|
|
msgid ""
|
|
"Base category for warnings triggered during the process of importing a "
|
|
"module (ignored by default)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:101
|
|
msgid ":exc:`UnicodeWarning`"
|
|
msgstr ":exc:`UnicodeWarning`"
|
|
|
|
#: ../Doc/library/warnings.rst:101
|
|
msgid "Base category for warnings related to Unicode."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:104
|
|
msgid ":exc:`BytesWarning`"
|
|
msgstr ":exc:`BytesWarning`"
|
|
|
|
#: ../Doc/library/warnings.rst:104
|
|
msgid ""
|
|
"Base category for warnings related to :class:`bytes` and :class:`bytearray`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:107
|
|
msgid ":exc:`ResourceWarning`"
|
|
msgstr ":exc:`ResourceWarning`"
|
|
|
|
#: ../Doc/library/warnings.rst:107
|
|
msgid "Base category for warnings related to resource usage."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:111
|
|
msgid ""
|
|
"Previously :exc:`DeprecationWarning` and :exc:`FutureWarning` were "
|
|
"distinguished based on whether a feature was being removed entirely or "
|
|
"changing its behaviour. They are now distinguished based on their intended "
|
|
"audience and the way they're handled by the default warnings filters."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:122
|
|
msgid "The Warnings Filter"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:124
|
|
msgid ""
|
|
"The warnings filter controls whether warnings are ignored, displayed, or "
|
|
"turned into errors (raising an exception)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:127
|
|
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 filter "
|
|
"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:133
|
|
msgid "*action* is one of the following strings:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:136
|
|
msgid "Value"
|
|
msgstr "Valeur"
|
|
|
|
#: ../Doc/library/warnings.rst:136
|
|
msgid "Disposition"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:138
|
|
msgid "``\"default\"``"
|
|
msgstr "``\"default\"``"
|
|
|
|
#: ../Doc/library/warnings.rst:138
|
|
msgid ""
|
|
"print the first occurrence of matching warnings for each location (module + "
|
|
"line number) where the warning is issued"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:142
|
|
msgid "``\"error\"``"
|
|
msgstr "``\"error\"``"
|
|
|
|
#: ../Doc/library/warnings.rst:142
|
|
msgid "turn matching warnings into exceptions"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:144
|
|
msgid "``\"ignore\"``"
|
|
msgstr "``\"ignore\"``"
|
|
|
|
#: ../Doc/library/warnings.rst:144
|
|
msgid "never print matching warnings"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:146
|
|
msgid "``\"always\"``"
|
|
msgstr "``\"always\"``"
|
|
|
|
#: ../Doc/library/warnings.rst:146
|
|
msgid "always print matching warnings"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:148
|
|
msgid "``\"module\"``"
|
|
msgstr "``\"module\"``"
|
|
|
|
#: ../Doc/library/warnings.rst:148
|
|
msgid ""
|
|
"print the first occurrence of matching warnings for each module where the "
|
|
"warning is issued (regardless of line number)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:152
|
|
msgid "``\"once\"``"
|
|
msgstr "``\"once\"``"
|
|
|
|
#: ../Doc/library/warnings.rst:152
|
|
msgid ""
|
|
"print only the first occurrence of matching warnings, regardless of location"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:156
|
|
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:160
|
|
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:163
|
|
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:166
|
|
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:169
|
|
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:172
|
|
msgid ""
|
|
"If a warning is reported and doesn't match any registered filter then the "
|
|
"\"default\" action is applied (hence its name)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:179
|
|
msgid "Describing Warning Filters"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:181
|
|
msgid ""
|
|
"The warnings filter is initialized by :option:`-W` options passed to the "
|
|
"Python interpreter command line and the :envvar:`PYTHONWARNINGS` environment "
|
|
"variable. The interpreter saves the arguments for all supplied entries "
|
|
"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:188
|
|
msgid ""
|
|
"Individual warnings filters are specified as a sequence of fields separated "
|
|
"by colons::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:193
|
|
msgid ""
|
|
"The meaning of each of these fields is as described in :ref:`warning-"
|
|
"filter`. When listing multiple filters on a single line (as for :envvar:"
|
|
"`PYTHONWARNINGS`), the individual filters are separated by commas,and the "
|
|
"filters listed later take precedence over those listed before them (as "
|
|
"they're applied left-to-right, and the most recently applied filters take "
|
|
"precedence over earlier ones)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:200
|
|
msgid ""
|
|
"Commonly used warning filters apply to either all warnings, warnings in a "
|
|
"particular category, or warnings raised by particular modules or packages. "
|
|
"Some examples::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:217
|
|
msgid "Default Warning Filter"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:219
|
|
msgid ""
|
|
"By default, Python installs several warning filters, which can be overridden "
|
|
"by the :option:`-W` command-line option, the :envvar:`PYTHONWARNINGS` "
|
|
"environment variable and calls to :func:`filterwarnings`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:223
|
|
msgid ""
|
|
"In regular release builds, the default warning filter has the following "
|
|
"entries (in order of precedence)::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:232
|
|
msgid "In debug builds, the list of default warning filters is empty."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:234
|
|
msgid ""
|
|
":exc:`DeprecationWarning` is now ignored by default in addition to :exc:"
|
|
"`PendingDeprecationWarning`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:238
|
|
msgid ""
|
|
":exc:`DeprecationWarning` is once again shown by default when triggered "
|
|
"directly by code in ``__main__``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:242
|
|
msgid ""
|
|
":exc:`BytesWarning` no longer appears in the default filter list and is "
|
|
"instead configured via :data:`sys.warnoptions` when :option:`-b` is "
|
|
"specified twice."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:251
|
|
msgid "Overriding the default filter"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:253
|
|
msgid ""
|
|
"Developers of applications written in Python may wish to hide *all* Python "
|
|
"level warnings from their users by default, and only display them when "
|
|
"running tests or otherwise working on the application. The :data:`sys."
|
|
"warnoptions` attribute used to pass filter configurations to the interpreter "
|
|
"can be used as a marker to indicate whether or not warnings should be "
|
|
"disabled::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:265
|
|
msgid ""
|
|
"Developers of test runners for Python code are advised to instead ensure "
|
|
"that *all* warnings are displayed by default for the code under test, using "
|
|
"code like::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:276
|
|
msgid ""
|
|
"Finally, developers of interactive shells that run user code in a namespace "
|
|
"other than ``__main__`` are advised to ensure that :exc:`DeprecationWarning` "
|
|
"messages are made visible by default, using code like the following (where "
|
|
"``user_ns`` is the module used to execute code entered interactively)::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:289
|
|
msgid "Temporarily Suppressing Warnings"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:291
|
|
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 (even when warnings "
|
|
"have been explicitly configured via the command line), then it is possible "
|
|
"to suppress the warning using the :class:`catch_warnings` context manager::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:305
|
|
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:317
|
|
msgid "Testing Warnings"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:319
|
|
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:339
|
|
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:345
|
|
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:353
|
|
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:364
|
|
msgid "Updating Code For New Versions of Dependencies"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:366
|
|
msgid ""
|
|
"Warning categories that are primarily of interest to Python developers "
|
|
"(rather than end users of applications written in Python) are ignored by "
|
|
"default."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:369
|
|
msgid ""
|
|
"Notably, this \"ignored by default\" list includes :exc:`DeprecationWarning` "
|
|
"(for every module except ``__main__``), which means developers should make "
|
|
"sure to test their code with typically ignored warnings made visible in "
|
|
"order to receive timely notifications of future breaking API changes "
|
|
"(whether in the standard library or third party packages)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:375
|
|
msgid ""
|
|
"In the ideal case, the code will have a suitable test suite, and the test "
|
|
"runner will take care of implicitly enabling all warnings when running tests "
|
|
"(the test runner provided by the :mod:`unittest` module does this)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:379
|
|
msgid ""
|
|
"In less ideal cases, applications can be checked for use of deprecated "
|
|
"interfaces by passing :option:`-Wd <-W>` to the Python interpreter (this is "
|
|
"shorthand for :option:`!-W default`) or setting ``PYTHONWARNINGS=default`` "
|
|
"in the environment. This enables default handling for all warnings, "
|
|
"including those that are ignored by default. To change what action is taken "
|
|
"for encountered warnings you can 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:392
|
|
msgid "Available Functions"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:397
|
|
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:409
|
|
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:413 ../Doc/library/warnings.rst:436
|
|
msgid ""
|
|
"*source*, if supplied, is the destroyed object which emitted a :exc:"
|
|
"`ResourceWarning`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:416
|
|
msgid "Added *source* parameter."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:422
|
|
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:431
|
|
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:439
|
|
msgid "Add the *source* parameter."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:445
|
|
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:456
|
|
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:465
|
|
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:477
|
|
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:486
|
|
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:492
|
|
msgid "Available Context Managers"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/warnings.rst:496
|
|
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:505
|
|
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:512
|
|
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 ""
|