1
0
Fork 0
python-docs-fr/library/test.po

1781 lines
54 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"
2023-04-14 11:20:40 +00:00
"POT-Creation-Date: 2023-04-14 13:19+0200\n"
2016-10-30 09:46:26 +00:00
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\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"
#: library/test.rst:2
2016-10-30 09:46:26 +00:00
msgid ":mod:`test` --- Regression tests package for Python"
msgstr ""
#: library/test.rst:10
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`test` package is meant for internal use by Python only. It is "
"documented for the benefit of the core developers of Python. Any use of this "
"package outside of Python's standard library is discouraged as code "
"mentioned here can change or be removed without notice between releases of "
"Python."
msgstr ""
#: library/test.rst:18
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`test` package contains all regression tests for Python as well as "
"the modules :mod:`test.support` and :mod:`test.regrtest`. :mod:`test."
"support` is used to enhance your tests while :mod:`test.regrtest` drives the "
"testing suite."
msgstr ""
#: library/test.rst:23
2016-10-30 09:46:26 +00:00
msgid ""
"Each module in the :mod:`test` package whose name starts with ``test_`` is a "
"testing suite for a specific module or feature. All new tests should be "
"written using the :mod:`unittest` or :mod:`doctest` module. Some older "
"tests are written using a \"traditional\" testing style that compares output "
"printed to ``sys.stdout``; this style of test is considered deprecated."
msgstr ""
#: library/test.rst:33
2016-10-30 09:46:26 +00:00
msgid "Module :mod:`unittest`"
msgstr ""
#: library/test.rst:33
2016-10-30 09:46:26 +00:00
msgid "Writing PyUnit regression tests."
msgstr ""
#: library/test.rst:35
2016-10-30 09:46:26 +00:00
msgid "Module :mod:`doctest`"
msgstr "Module :mod:`doctest`"
2016-10-30 09:46:26 +00:00
#: library/test.rst:36
2016-10-30 09:46:26 +00:00
msgid "Tests embedded in documentation strings."
msgstr ""
#: library/test.rst:42
2016-10-30 09:46:26 +00:00
msgid "Writing Unit Tests for the :mod:`test` package"
msgstr ""
#: library/test.rst:44
2016-10-30 09:46:26 +00:00
msgid ""
"It is preferred that tests that use the :mod:`unittest` module follow a few "
"guidelines. One is to name the test module by starting it with ``test_`` and "
"end it with the name of the module being tested. The test methods in the "
"test module should start with ``test_`` and end with a description of what "
"the method is testing. This is needed so that the methods are recognized by "
"the test driver as test methods. Also, no documentation string for the "
"method should be included. A comment (such as ``# Tests function returns "
"only True or False``) should be used to provide documentation for test "
"methods. This is done because documentation strings get printed out if they "
"exist and thus what test is being run is not stated."
msgstr ""
#: library/test.rst:55
2016-10-30 09:46:26 +00:00
msgid "A basic boilerplate is often used::"
msgstr ""
#: library/test.rst:88
2016-10-30 09:46:26 +00:00
msgid ""
"This code pattern allows the testing suite to be run by :mod:`test."
"regrtest`, on its own as a script that supports the :mod:`unittest` CLI, or "
"via the ``python -m unittest`` CLI."
msgstr ""
#: library/test.rst:92
2016-10-30 09:46:26 +00:00
msgid ""
"The goal for regression testing is to try to break code. This leads to a few "
"guidelines to be followed:"
msgstr ""
#: library/test.rst:95
2016-10-30 09:46:26 +00:00
msgid ""
"The testing suite should exercise all classes, functions, and constants. "
"This includes not just the external API that is to be presented to the "
"outside world but also \"private\" code."
msgstr ""
#: library/test.rst:99
2016-10-30 09:46:26 +00:00
msgid ""
"Whitebox testing (examining the code being tested when the tests are being "
"written) is preferred. Blackbox testing (testing only the published user "
"interface) is not complete enough to make sure all boundary and edge cases "
"are tested."
msgstr ""
#: library/test.rst:104
2016-10-30 09:46:26 +00:00
msgid ""
"Make sure all possible values are tested including invalid ones. This makes "
"sure that not only all valid values are acceptable but also that improper "
"values are handled correctly."
msgstr ""
#: library/test.rst:108
2016-10-30 09:46:26 +00:00
msgid ""
"Exhaust as many code paths as possible. Test where branching occurs and thus "
"tailor input to make sure as many different paths through the code are taken."
msgstr ""
#: library/test.rst:111
2016-10-30 09:46:26 +00:00
msgid ""
"Add an explicit test for any bugs discovered for the tested code. This will "
"make sure that the error does not crop up again if the code is changed in "
"the future."
msgstr ""
#: library/test.rst:115
2016-10-30 09:46:26 +00:00
msgid ""
"Make sure to clean up after your tests (such as close and remove all "
"temporary files)."
msgstr ""
#: library/test.rst:118
2016-10-30 09:46:26 +00:00
msgid ""
"If a test is dependent on a specific condition of the operating system then "
"verify the condition already exists before attempting the test."
msgstr ""
#: library/test.rst:121
2016-10-30 09:46:26 +00:00
msgid ""
"Import as few modules as possible and do it as soon as possible. This "
"minimizes external dependencies of tests and also minimizes possible "
"anomalous behavior from side-effects of importing a module."
msgstr ""
#: library/test.rst:125
2016-10-30 09:46:26 +00:00
msgid ""
"Try to maximize code reuse. On occasion, tests will vary by something as "
"small as what type of input is used. Minimize code duplication by "
"subclassing a basic test class with a class that specifies the input::"
msgstr ""
#: library/test.rst:145
2016-10-30 09:46:26 +00:00
msgid ""
"When using this pattern, remember that all classes that inherit from :class:"
"`unittest.TestCase` are run as tests. The :class:`Mixin` class in the "
"example above does not have any data and so can't be run by itself, thus it "
"does not inherit from :class:`unittest.TestCase`."
msgstr ""
#: library/test.rst:153
2016-10-30 09:46:26 +00:00
msgid "Test Driven Development"
msgstr ""
#: library/test.rst:154
2016-10-30 09:46:26 +00:00
msgid "A book by Kent Beck on writing tests before code."
msgstr ""
#: library/test.rst:160
2016-10-30 09:46:26 +00:00
msgid "Running tests using the command-line interface"
msgstr ""
#: library/test.rst:162
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`test` package can be run as a script to drive Python's regression "
"test suite, thanks to the :option:`-m` option: :program:`python -m test`. "
"Under the hood, it uses :mod:`test.regrtest`; the call :program:`python -m "
"test.regrtest` used in previous Python versions still works. Running the "
"script by itself automatically starts running all regression tests in the :"
"mod:`test` package. It does this by finding all modules in the package whose "
"name starts with ``test_``, importing them, and executing the function :func:"
"`test_main` if present or loading the tests via unittest.TestLoader."
"loadTestsFromModule if ``test_main`` does not exist. The names of tests to "
"execute may also be passed to the script. Specifying a single regression "
"test (:program:`python -m test test_spam`) will minimize output and only "
"print whether the test passed or failed."
msgstr ""
#: library/test.rst:175
2016-10-30 09:46:26 +00:00
msgid ""
"Running :mod:`test` directly allows what resources are available for tests "
"to use to be set. You do this by using the ``-u`` command-line option. "
"Specifying ``all`` as the value for the ``-u`` option enables all possible "
"resources: :program:`python -m test -uall`. If all but one resource is "
"desired (a more common case), a comma-separated list of resources that are "
"not desired may be listed after ``all``. The command :program:`python -m "
"test -uall,-audio,-largefile` will run :mod:`test` with all resources except "
"the ``audio`` and ``largefile`` resources. For a list of all resources and "
"more command-line options, run :program:`python -m test -h`."
msgstr ""
#: library/test.rst:186
2016-10-30 09:46:26 +00:00
msgid ""
"Some other ways to execute the regression tests depend on what platform the "
"tests are being executed on. On Unix, you can run :program:`make test` at "
"the top-level directory where Python was built. On Windows, executing :"
2018-06-28 13:32:56 +00:00
"program:`rt.bat` from your :file:`PCbuild` directory will run all regression "
2016-10-30 09:46:26 +00:00
"tests."
msgstr ""
#: library/test.rst:194
2016-10-30 09:46:26 +00:00
msgid ":mod:`test.support` --- Utilities for the Python test suite"
msgstr ""
#: library/test.rst:200
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`test.support` module provides support for Python's regression test "
"suite."
msgstr ""
#: library/test.rst:205
2016-10-30 09:46:26 +00:00
msgid ""
":mod:`test.support` is not a public module. It is documented here to help "
"Python developers write tests. The API of this module is subject to change "
"without backwards compatibility concerns between releases."
msgstr ""
#: library/test.rst:210
2020-02-14 10:18:53 +00:00
#, fuzzy
2016-10-30 09:46:26 +00:00
msgid "This module defines the following exceptions:"
msgstr "Ce module définit les fonctions suivantes :"
2016-10-30 09:46:26 +00:00
#: library/test.rst:214
2016-10-30 09:46:26 +00:00
msgid ""
"Exception to be raised when a test fails. This is deprecated in favor of :"
"mod:`unittest`\\ -based tests and :class:`unittest.TestCase`'s assertion "
"methods."
msgstr ""
#: library/test.rst:221
2016-10-30 09:46:26 +00:00
msgid ""
"Subclass of :exc:`unittest.SkipTest`. Raised when a resource (such as a "
"network connection) is not available. Raised by the :func:`requires` "
"function."
msgstr ""
#: library/test.rst:226
2016-10-30 09:46:26 +00:00
msgid "The :mod:`test.support` module defines the following constants:"
msgstr ""
#: library/test.rst:230
2016-10-30 09:46:26 +00:00
msgid ""
"``True`` when verbose output is enabled. Should be checked when more "
"detailed information is desired about a running test. *verbose* is set by :"
"mod:`test.regrtest`."
msgstr ""
#: library/test.rst:237
2016-10-30 09:46:26 +00:00
msgid "``True`` if the running interpreter is Jython."
msgstr ""
#: library/test.rst:242
2018-06-28 13:32:56 +00:00
msgid "``True`` if the system is Android."
msgstr ""
#: library/test.rst:247
2018-06-28 13:32:56 +00:00
msgid "Path for shell if not on Windows; otherwise ``None``."
msgstr ""
#: library/test.rst:252
2020-07-20 08:56:42 +00:00
msgid ""
"Timeout in seconds for tests using a network server listening on the network "
"local loopback interface like ``127.0.0.1``."
msgstr ""
#: library/test.rst:255
2020-07-20 08:56:42 +00:00
msgid ""
"The timeout is long enough to prevent test failure: it takes into account "
"that the client and the server can run in different threads or even "
"different processes."
msgstr ""
#: library/test.rst:259
2020-07-20 08:56:42 +00:00
msgid ""
"The timeout should be long enough for :meth:`~socket.socket.connect`, :meth:"
"`~socket.socket.recv` and :meth:`~socket.socket.send` methods of :class:"
"`socket.socket`."
msgstr ""
#: library/test.rst:263
2020-07-20 08:56:42 +00:00
msgid "Its default value is 5 seconds."
msgstr ""
#: library/test.rst:265
2020-07-20 08:56:42 +00:00
msgid "See also :data:`INTERNET_TIMEOUT`."
msgstr ""
#: library/test.rst:270
msgid "Timeout in seconds for network requests going to the internet."
2020-07-20 08:56:42 +00:00
msgstr ""
#: library/test.rst:272
2020-07-20 08:56:42 +00:00
msgid ""
"The timeout is short enough to prevent a test to wait for too long if the "
"internet request is blocked for whatever reason."
2020-07-20 08:56:42 +00:00
msgstr ""
#: library/test.rst:275
2020-07-20 08:56:42 +00:00
msgid ""
"Usually, a timeout using :data:`INTERNET_TIMEOUT` should not mark a test as "
"failed, but skip the test instead: see :func:`~test.support.socket_helper."
"transient_internet`."
msgstr ""
#: library/test.rst:279
2020-07-20 08:56:42 +00:00
msgid "Its default value is 1 minute."
2018-06-28 13:32:56 +00:00
msgstr ""
#: library/test.rst:281
2020-07-20 08:56:42 +00:00
msgid "See also :data:`LOOPBACK_TIMEOUT`."
msgstr ""
#: library/test.rst:286
2020-07-20 08:56:42 +00:00
msgid ""
"Timeout in seconds to mark a test as failed if the test takes \"too long\"."
msgstr ""
#: library/test.rst:288
2020-07-20 08:56:42 +00:00
msgid ""
"The timeout value depends on the regrtest ``--timeout`` command line option."
msgstr ""
#: library/test.rst:290
2020-07-20 08:56:42 +00:00
msgid ""
"If a test using :data:`SHORT_TIMEOUT` starts to fail randomly on slow "
"buildbots, use :data:`LONG_TIMEOUT` instead."
msgstr ""
#: library/test.rst:293
2020-07-20 08:56:42 +00:00
msgid "Its default value is 30 seconds."
msgstr ""
#: library/test.rst:298
2020-07-20 08:56:42 +00:00
msgid "Timeout in seconds to detect when a test hangs."
msgstr ""
#: library/test.rst:300
2020-07-20 08:56:42 +00:00
msgid ""
"It is long enough to reduce the risk of test failure on the slowest Python "
"buildbots. It should not be used to mark a test as failed if the test takes "
"\"too long\". The timeout value depends on the regrtest ``--timeout`` "
"command line option."
msgstr ""
#: library/test.rst:305
2020-07-20 08:56:42 +00:00
msgid "Its default value is 5 minutes."
msgstr ""
#: library/test.rst:307
2020-07-20 08:56:42 +00:00
msgid ""
"See also :data:`LOOPBACK_TIMEOUT`, :data:`INTERNET_TIMEOUT` and :data:"
"`SHORT_TIMEOUT`."
msgstr ""
#: library/test.rst:313
2018-06-28 13:32:56 +00:00
msgid "Set when tests can be skipped when they are not useful for PGO."
msgstr ""
#: library/test.rst:318
2018-06-28 13:32:56 +00:00
msgid ""
"A constant that is likely larger than the underlying OS pipe buffer size, to "
"make writes blocking."
msgstr ""
#: library/test.rst:324
2018-06-28 13:32:56 +00:00
msgid ""
"A constant that is likely larger than the underlying OS socket buffer size, "
"to make writes blocking."
msgstr ""
#: library/test.rst:330
2018-06-28 13:32:56 +00:00
msgid "Set to the top level directory that contains :mod:`test.support`."
msgstr ""
#: library/test.rst:335
2018-06-28 13:32:56 +00:00
msgid "Set to the top level directory for the test package."
msgstr ""
#: library/test.rst:340
2018-06-28 13:32:56 +00:00
msgid "Set to the ``data`` directory within the test package."
msgstr ""
#: library/test.rst:345
2018-06-28 13:32:56 +00:00
msgid "Set to :data:`sys.maxsize` for big memory tests."
msgstr ""
#: library/test.rst:350
2018-06-28 13:32:56 +00:00
msgid ""
"Set by :func:`set_memlimit` as the memory limit for big memory tests. "
"Limited by :data:`MAX_Py_ssize_t`."
msgstr ""
#: library/test.rst:356
2018-06-28 13:32:56 +00:00
msgid ""
"Set by :func:`set_memlimit` as the memory limit for big memory tests. Not "
"limited by :data:`MAX_Py_ssize_t`."
msgstr ""
#: library/test.rst:362
2018-06-28 13:32:56 +00:00
msgid ""
"Set to ``True`` if Python is built without docstrings (the :c:macro:"
"`WITH_DOC_STRINGS` macro is not defined). See the :option:`configure --"
"without-doc-strings <--without-doc-strings>` option."
2018-06-28 13:32:56 +00:00
msgstr ""
#: library/test.rst:366
msgid "See also the :data:`HAVE_DOCSTRINGS` variable."
2018-06-28 13:32:56 +00:00
msgstr ""
#: library/test.rst:371
msgid ""
"Set to ``True`` if function docstrings are available. See the :option:"
"`python -OO <-O>` option, which strips docstrings of functions implemented "
"in Python."
msgstr ""
#: library/test.rst:374
msgid "See also the :data:`MISSING_C_DOCSTRINGS` variable."
msgstr ""
#: library/test.rst:379
2019-03-20 08:02:55 +00:00
msgid "Define the URL of a dedicated HTTP server for the network tests."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/test.rst:384
2019-09-04 09:35:23 +00:00
msgid "Object that is equal to anything. Used to test mixed type comparison."
msgstr ""
#: library/test.rst:389
2020-07-20 08:56:42 +00:00
msgid ""
"Object that is not equal to anything (even to :data:`ALWAYS_EQ`). Used to "
"test mixed type comparison."
msgstr ""
#: library/test.rst:395
2019-09-04 09:35:23 +00:00
msgid ""
"Object that is greater than anything (except itself). Used to test mixed "
"type comparison."
msgstr ""
#: library/test.rst:401
2019-09-04 09:35:23 +00:00
msgid ""
"Object that is less than anything (except itself). Used to test mixed type "
"comparison."
msgstr ""
#: library/test.rst:405
2020-02-14 10:18:53 +00:00
#, fuzzy
2019-03-20 08:02:55 +00:00
msgid "The :mod:`test.support` module defines the following functions:"
2020-02-14 10:18:53 +00:00
msgstr "Le module :mod:`pty` expose les fonctions suivantes :"
2019-03-20 08:02:55 +00:00
#: library/test.rst:409
2016-10-30 09:46:26 +00:00
msgid ""
"Return ``True`` if *resource* is enabled and available. The list of "
"available resources is only set when :mod:`test.regrtest` is executing the "
"tests."
msgstr ""
#: library/test.rst:416
2018-06-28 13:32:56 +00:00
msgid "Return ``True`` if Python was not built with ``-O0`` or ``-Og``."
msgstr ""
#: library/test.rst:421
2018-06-28 13:32:56 +00:00
msgid "Return :data:`_testcapi.WITH_PYMALLOC`."
msgstr ""
#: library/test.rst:426
2016-10-30 09:46:26 +00:00
msgid ""
"Raise :exc:`ResourceDenied` if *resource* is not available. *msg* is the "
"argument to :exc:`ResourceDenied` if it is raised. Always returns ``True`` "
"if called by a function whose ``__name__`` is ``'__main__'``. Used when "
"tests are executed by :mod:`test.regrtest`."
msgstr ""
#: library/test.rst:434
2018-06-28 13:32:56 +00:00
msgid "Return a repr of *dict* with keys sorted."
msgstr ""
#: library/test.rst:439
2016-10-30 09:46:26 +00:00
msgid ""
"Return the path to the file named *filename*. If no match is found "
"*filename* is returned. This does not equal a failure since it could be the "
"path to the file."
msgstr ""
#: library/test.rst:443
2016-10-30 09:46:26 +00:00
msgid ""
"Setting *subdir* indicates a relative path to use to find the file rather "
"than looking directly in the path directories."
msgstr ""
#: library/test.rst:449
msgid ""
"Determine whether *test* matches the patterns set in :func:`set_match_tests`."
2018-06-28 13:32:56 +00:00
msgstr ""
#: library/test.rst:454
msgid ""
"Define match patterns on test filenames and test method names for filtering "
"tests."
2018-06-28 13:32:56 +00:00
msgstr ""
#: library/test.rst:459
2016-10-30 09:46:26 +00:00
msgid ""
"Execute :class:`unittest.TestCase` subclasses passed to the function. The "
"function scans the classes for methods starting with the prefix ``test_`` "
"and executes the tests individually."
msgstr ""
#: library/test.rst:463
2016-10-30 09:46:26 +00:00
msgid ""
"It is also legal to pass strings as parameters; these should be keys in "
"``sys.modules``. Each associated module will be scanned by ``unittest."
"TestLoader.loadTestsFromModule()``. This is usually seen in the following :"
"func:`test_main` function::"
msgstr ""
#: library/test.rst:471
2016-10-30 09:46:26 +00:00
msgid "This will run all tests defined in the named module."
msgstr ""
#: library/test.rst:476
2016-10-30 09:46:26 +00:00
msgid ""
"Run :func:`doctest.testmod` on the given *module*. Return ``(failure_count, "
"test_count)``."
msgstr ""
#: library/test.rst:479
2016-10-30 09:46:26 +00:00
msgid ""
"If *verbosity* is ``None``, :func:`doctest.testmod` is run with verbosity "
2018-06-28 13:32:56 +00:00
"set to :data:`verbose`. Otherwise, it is run with verbosity set to "
"``None``. *optionflags* is passed as ``optionflags`` to :func:`doctest."
"testmod`."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/test.rst:487
2018-06-28 13:32:56 +00:00
msgid ""
"Set the :func:`sys.setswitchinterval` to the given *interval*. Defines a "
"minimum interval for Android systems to prevent the system from hanging."
msgstr ""
#: library/test.rst:493
2018-06-28 13:32:56 +00:00
msgid ""
"Use this check to guard CPython's implementation-specific tests or to run "
"them only on the implementations guarded by the arguments. This function "
"returns ``True`` or ``False`` depending on the host platform. Example usage::"
2018-06-28 13:32:56 +00:00
msgstr ""
#: library/test.rst:505
2018-06-28 13:32:56 +00:00
msgid ""
"Set the values for :data:`max_memuse` and :data:`real_max_memuse` for big "
"memory tests."
msgstr ""
#: library/test.rst:511
2018-06-28 13:32:56 +00:00
msgid ""
"Store the value from *stdout*. It is meant to hold the stdout at the time "
"the regrtest began."
msgstr ""
#: library/test.rst:517
2018-06-28 13:32:56 +00:00
msgid ""
"Return the original stdout set by :func:`record_original_stdout` or ``sys."
"stdout`` if it's not set."
msgstr ""
#: library/test.rst:523
2018-06-28 13:32:56 +00:00
msgid ""
"Return a list of command line arguments reproducing the current settings in "
"``sys.flags`` and ``sys.warnoptions``."
msgstr ""
#: library/test.rst:529
2018-06-28 13:32:56 +00:00
msgid ""
"Return a list of command line arguments reproducing the current optimization "
"settings in ``sys.flags``."
msgstr ""
#: library/test.rst:537
2016-10-30 09:46:26 +00:00
msgid ""
"A context managers that temporarily replaces the named stream with :class:"
"`io.StringIO` object."
msgstr ""
#: library/test.rst:540
2016-10-30 09:46:26 +00:00
msgid "Example use with output streams::"
msgstr ""
#: library/test.rst:548
2016-10-30 09:46:26 +00:00
msgid "Example use with input stream::"
msgstr ""
#: library/test.rst:560
msgid "A context manager that temporary disables :mod:`faulthandler`."
2018-06-28 13:32:56 +00:00
msgstr ""
#: library/test.rst:565
2018-06-28 13:32:56 +00:00
msgid ""
"Force as many objects as possible to be collected. This is needed because "
"timely deallocation is not guaranteed by the garbage collector. This means "
"that ``__del__`` methods may be called later than expected and weakrefs may "
"remain alive for longer than expected."
msgstr ""
#: library/test.rst:573
2018-06-28 13:32:56 +00:00
msgid ""
"A context manager that disables the garbage collector on entry. On exit, the "
"garbage collector is restored to its prior state."
2018-06-28 13:32:56 +00:00
msgstr ""
#: library/test.rst:579
2018-06-28 13:32:56 +00:00
msgid "Context manager to swap out an attribute with a new object."
msgstr ""
#: library/test.rst:599 library/test.rst:1301
2018-06-28 13:32:56 +00:00
msgid "Usage::"
msgstr "Utilisation ::"
2018-06-28 13:32:56 +00:00
#: library/test.rst:586
2018-06-28 13:32:56 +00:00
msgid ""
"This will set ``obj.attr`` to 5 for the duration of the ``with`` block, "
"restoring the old value at the end of the block. If ``attr`` doesn't exist "
"on ``obj``, it will be created and then deleted at the end of the block."
msgstr ""
#: library/test.rst:609
2018-06-28 13:32:56 +00:00
msgid ""
"The old value (or ``None`` if it doesn't exist) will be assigned to the "
"target of the \"as\" clause, if there is one."
msgstr ""
#: library/test.rst:597
2018-06-28 13:32:56 +00:00
msgid "Context manager to swap out an item with a new object."
msgstr ""
#: library/test.rst:604
2018-06-28 13:32:56 +00:00
msgid ""
"This will set ``obj[\"item\"]`` to 5 for the duration of the ``with`` block, "
"restoring the old value at the end of the block. If ``item`` doesn't exist "
"on ``obj``, it will be created and then deleted at the end of the block."
msgstr ""
#: library/test.rst:615
2020-07-20 08:56:42 +00:00
msgid ""
2022-03-23 17:40:12 +00:00
"Call the ``flush()`` method on :data:`sys.stdout` and then on :data:`sys."
"stderr`. It can be used to make sure that the logs order is consistent "
"before writing into stderr."
2020-07-20 08:56:42 +00:00
msgstr ""
#: library/test.rst:624
2020-07-20 08:56:42 +00:00
msgid ""
2022-03-23 17:40:12 +00:00
"Print a warning into :data:`sys.__stderr__`. Format the message as: "
"``f\"Warning -- {msg}\"``. If *msg* is made of multiple lines, add "
"``\"Warning -- \"`` prefix to each line."
msgstr ""
#: library/test.rst:633
2022-03-23 17:40:12 +00:00
msgid ""
2020-07-20 08:56:42 +00:00
"Wait until process *pid* completes and check that the process exit code is "
"*exitcode*."
msgstr ""
#: library/test.rst:636
2020-07-20 08:56:42 +00:00
msgid ""
"Raise an :exc:`AssertionError` if the process exit code is not equal to "
"*exitcode*."
msgstr ""
#: library/test.rst:639
2020-07-20 08:56:42 +00:00
msgid ""
"If the process runs longer than *timeout* seconds (:data:`SHORT_TIMEOUT` by "
"default), kill the process and raise an :exc:`AssertionError`. The timeout "
"feature is not available on Windows."
msgstr ""
#: library/test.rst:648
2018-06-28 13:32:56 +00:00
msgid ""
"Return the size of the :c:type:`PyObject` whose structure members are "
"defined by *fmt*. The returned value includes the size of the Python object "
"header and alignment."
2018-06-28 13:32:56 +00:00
msgstr ""
#: library/test.rst:654
2018-06-28 13:32:56 +00:00
msgid ""
"Return the size of the :c:type:`PyVarObject` whose structure members are "
"defined by *fmt*. The returned value includes the size of the Python object "
"header and alignment."
2018-06-28 13:32:56 +00:00
msgstr ""
#: library/test.rst:660
2018-06-28 13:32:56 +00:00
msgid ""
"For testcase *test*, assert that the ``sys.getsizeof`` for *o* plus the GC "
"header size equals *size*."
msgstr ""
#: library/test.rst:666
2016-10-30 09:46:26 +00:00
msgid ""
"A decorator to conditionally mark tests with :func:`unittest."
"expectedFailure`. Any use of this decorator should have an associated "
"comment identifying the relevant tracker issue."
msgstr ""
#: library/test.rst:673
msgid ""
"A decorator that skips the decorated test on TLS certification validation "
"failures."
msgstr ""
#: library/test.rst:678
2016-10-30 09:46:26 +00:00
msgid ""
"A decorator for running a function in a different locale, correctly "
"resetting it after it has finished. *catstr* is the locale category as a "
"string (for example ``\"LC_ALL\"``). The *locales* passed will be tried "
"sequentially, and the first valid locale will be used."
msgstr ""
#: library/test.rst:686
2018-06-28 13:32:56 +00:00
msgid ""
"A decorator for running a function in a specific timezone, correctly "
"resetting it after it has finished."
msgstr ""
#: library/test.rst:692
2018-06-28 13:32:56 +00:00
msgid ""
"Decorator for the minimum version when running test on FreeBSD. If the "
"FreeBSD version is less than the minimum, the test is skipped."
2018-06-28 13:32:56 +00:00
msgstr ""
#: library/test.rst:698
2018-06-28 13:32:56 +00:00
msgid ""
"Decorator for the minimum version when running test on Linux. If the Linux "
"version is less than the minimum, the test is skipped."
2018-06-28 13:32:56 +00:00
msgstr ""
#: library/test.rst:704
2018-06-28 13:32:56 +00:00
msgid ""
"Decorator for the minimum version when running test on macOS. If the macOS "
"version is less than the minimum, the test is skipped."
2018-06-28 13:32:56 +00:00
msgstr ""
#: library/test.rst:710
2018-06-28 13:32:56 +00:00
msgid "Decorator for skipping tests on non-IEEE 754 platforms."
msgstr ""
#: library/test.rst:715
2018-06-28 13:32:56 +00:00
msgid "Decorator for skipping tests if :mod:`zlib` doesn't exist."
msgstr ""
#: library/test.rst:720
2018-06-28 13:32:56 +00:00
msgid "Decorator for skipping tests if :mod:`gzip` doesn't exist."
msgstr ""
#: library/test.rst:725
2018-06-28 13:32:56 +00:00
msgid "Decorator for skipping tests if :mod:`bz2` doesn't exist."
msgstr ""
#: library/test.rst:730
2018-06-28 13:32:56 +00:00
msgid "Decorator for skipping tests if :mod:`lzma` doesn't exist."
msgstr ""
#: library/test.rst:735
2018-06-28 13:32:56 +00:00
msgid "Decorator for skipping tests if *resource* is not available."
msgstr ""
#: library/test.rst:740
2018-06-28 13:32:56 +00:00
msgid "Decorator for only running the test if :data:`HAVE_DOCSTRINGS`."
msgstr ""
#: library/test.rst:745
2018-06-28 13:32:56 +00:00
msgid "Decorator for tests only applicable to CPython."
msgstr ""
#: library/test.rst:750
2018-06-28 13:32:56 +00:00
msgid ""
"Decorator for invoking :func:`check_impl_detail` on *guards*. If that "
"returns ``False``, then uses *msg* as the reason for skipping the test."
msgstr ""
#: library/test.rst:756
2018-06-28 13:32:56 +00:00
msgid "Decorator to temporarily turn off tracing for the duration of the test."
msgstr ""
#: library/test.rst:761
2018-06-28 13:32:56 +00:00
msgid ""
"Decorator for tests which involve reference counting. The decorator does "
"not run the test if it is not run by CPython. Any trace function is unset "
"for the duration of the test to prevent unexpected refcounts caused by the "
"trace function."
msgstr ""
#: library/test.rst:769
2018-06-28 13:32:56 +00:00
msgid "Decorator for bigmem tests."
msgstr ""
#: library/test.rst:771
2018-06-28 13:32:56 +00:00
msgid ""
"*size* is a requested size for the test (in arbitrary, test-interpreted "
"units.) *memuse* is the number of bytes per unit for the test, or a good "
"estimate of it. For example, a test that needs two byte buffers, of 4 GiB "
"each, could be decorated with ``@bigmemtest(size=_4G, memuse=2)``."
msgstr ""
#: library/test.rst:776
2018-06-28 13:32:56 +00:00
msgid ""
"The *size* argument is normally passed to the decorated test method as an "
"extra argument. If *dry_run* is ``True``, the value passed to the test "
"method may be less than the requested value. If *dry_run* is ``False``, it "
"means the test doesn't support dummy runs when ``-M`` is not specified."
msgstr ""
#: library/test.rst:784
msgid "Decorator for tests that fill the address space."
2018-06-28 13:32:56 +00:00
msgstr ""
#: library/test.rst:789
2018-06-28 13:32:56 +00:00
msgid ""
"Test for syntax errors in *statement* by attempting to compile *statement*. "
"*testcase* is the :mod:`unittest` instance for the test. *errtext* is the "
2019-09-04 09:35:23 +00:00
"regular expression which should match the string representation of the "
"raised :exc:`SyntaxError`. If *lineno* is not ``None``, compares to the "
"line of the exception. If *offset* is not ``None``, compares to the offset "
"of the exception."
2018-06-28 13:32:56 +00:00
msgstr ""
#: library/test.rst:799
msgid "Open *url*. If open fails, raises :exc:`TestFailed`."
msgstr ""
#: library/test.rst:804
2018-06-28 13:32:56 +00:00
msgid ""
"Use this at the end of ``test_main`` whenever sub-processes are started. "
"This will help ensure that no extra children (zombies) stick around to hog "
"resources and create problems when looking for refleaks."
msgstr ""
#: library/test.rst:811
2018-06-28 13:32:56 +00:00
msgid ""
"Get an attribute, raising :exc:`unittest.SkipTest` if :exc:`AttributeError` "
"is raised."
msgstr ""
#: library/test.rst:817
2019-09-04 09:35:23 +00:00
msgid ""
"Context manager catching unraisable exception using :func:`sys."
"unraisablehook`."
msgstr ""
#: library/test.rst:820
2019-09-04 09:35:23 +00:00
msgid ""
"Storing the exception value (``cm.unraisable.exc_value``) creates a "
"reference cycle. The reference cycle is broken explicitly when the context "
"manager exits."
msgstr ""
#: library/test.rst:824
2019-09-04 09:35:23 +00:00
msgid ""
"Storing the object (``cm.unraisable.object``) can resurrect it if it is set "
"to an object which is being finalized. Exiting the context manager clears "
"the stored object."
msgstr ""
#: library/test.rst:845
2016-10-30 09:46:26 +00:00
msgid ""
"Generic implementation of the :mod:`unittest` ``load_tests`` protocol for "
"use in test packages. *pkg_dir* is the root directory of the package; "
"*loader*, *standard_tests*, and *pattern* are the arguments expected by "
"``load_tests``. In simple cases, the test package's ``__init__.py`` can be "
"the following::"
msgstr ""
#: library/test.rst:860
2016-10-30 09:46:26 +00:00
msgid ""
"Returns the set of attributes, functions or methods of *ref_api* not found "
"on *other_api*, except for a defined list of items to be ignored in this "
"check specified in *ignore*."
msgstr ""
#: library/test.rst:864
2016-10-30 09:46:26 +00:00
msgid ""
"By default this skips private attributes beginning with '_' but includes all "
"magic methods, i.e. those starting and ending in '__'."
msgstr ""
#: library/test.rst:872
2018-06-28 13:32:56 +00:00
msgid ""
"Override *object_to_patch.attr_name* with *new_value*. Also add cleanup "
"procedure to *test_instance* to restore *object_to_patch* for *attr_name*. "
"The *attr_name* should be a valid attribute for *object_to_patch*."
msgstr ""
#: library/test.rst:880
2018-06-28 13:32:56 +00:00
msgid ""
"Run *code* in subinterpreter. Raise :exc:`unittest.SkipTest` if :mod:"
"`tracemalloc` is enabled."
msgstr ""
#: library/test.rst:886
msgid "Assert instances of *cls* are deallocated after iterating."
2018-06-28 13:32:56 +00:00
msgstr ""
#: library/test.rst:891
2018-06-28 13:32:56 +00:00
msgid ""
"Check for the existence of the compiler executables whose names are listed "
"in *cmd_names* or all the compiler executables when *cmd_names* is empty and "
"return the first missing executable or ``None`` when none is found missing."
msgstr ""
#: library/test.rst:899
2016-10-30 09:46:26 +00:00
msgid ""
"Assert that the ``__all__`` variable of *module* contains all public names."
msgstr ""
#: library/test.rst:901
2016-10-30 09:46:26 +00:00
msgid ""
"The module's public names (its API) are detected automatically based on "
"whether they match the public name convention and were defined in *module*."
msgstr ""
#: library/test.rst:905
2016-10-30 09:46:26 +00:00
msgid ""
"The *name_of_module* argument can specify (as a string or tuple thereof) "
2018-06-28 13:32:56 +00:00
"what module(s) an API could be defined in order to be detected as a public "
"API. One case for this is when *module* imports part of its public API from "
"other modules, possibly a C backend (like ``csv`` and its ``_csv``)."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/test.rst:910
2016-10-30 09:46:26 +00:00
msgid ""
"The *extra* argument can be a set of names that wouldn't otherwise be "
"automatically detected as \"public\", like objects without a proper "
"``__module__`` attribute. If provided, it will be added to the automatically "
"detected ones."
msgstr ""
#: library/test.rst:914
2016-10-30 09:46:26 +00:00
msgid ""
"The *not_exported* argument can be a set of names that must not be treated "
"as part of the public API even though their names indicate otherwise."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/test.rst:1550
#, fuzzy
msgid "Example use::"
msgstr "Exemple d'utilisation ::"
2016-10-30 09:46:26 +00:00
#: library/test.rst:940
2016-10-30 09:46:26 +00:00
msgid ""
"Skip tests if the :mod:`multiprocessing.synchronize` module is missing, if "
"there is no available semaphore implementation, or if creating a lock raises "
"an :exc:`OSError`."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/test.rst:949
msgid "Assert that type *tp* cannot be instantiated using *args* and *kwds*."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/test.rst:956
msgid ""
"This function returns a context manager that will change the global :func:"
"`sys.set_int_max_str_digits` setting for the duration of the context to "
"allow execution of test code that needs a different limit on the number of "
"digits when converting between an integer and string."
msgstr ""
#: library/test.rst:964
msgid "The :mod:`test.support` module defines the following classes:"
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/test.rst:969
2016-10-30 09:46:26 +00:00
msgid ""
"A context manager used to try to prevent crash dialog popups on tests that "
"are expected to crash a subprocess."
msgstr ""
#: library/test.rst:972
2016-10-30 09:46:26 +00:00
msgid ""
"On Windows, it disables Windows Error Reporting dialogs using `SetErrorMode "
"<https://msdn.microsoft.com/en-us/library/windows/desktop/ms680621.aspx>`_."
msgstr ""
#: library/test.rst:975
2016-10-30 09:46:26 +00:00
msgid ""
"On UNIX, :func:`resource.setrlimit` is used to set :attr:`resource."
"RLIMIT_CORE`'s soft limit to 0 to prevent coredump file creation."
msgstr ""
#: library/test.rst:979
2016-10-30 09:46:26 +00:00
msgid "On both platforms, the old value is restored by :meth:`__exit__`."
msgstr ""
#: library/test.rst:984
2018-06-28 13:32:56 +00:00
msgid ""
"Class to save and restore signal handlers registered by the Python signal "
"handler."
msgstr ""
#: library/test.rst:989
msgid ""
"Save the signal handlers to a dictionary mapping signal numbers to the "
"current signal handler."
msgstr ""
#: library/test.rst:994
msgid ""
"Set the signal numbers from the :meth:`save` dictionary to the saved handler."
msgstr ""
#: library/test.rst:1002
2018-06-28 13:32:56 +00:00
msgid "Try to match a single dict with the supplied arguments."
msgstr ""
#: library/test.rst:1007
2018-06-28 13:32:56 +00:00
msgid "Try to match a single stored value (*dv*) with a supplied value (*v*)."
msgstr ""
#: library/test.rst:1014
2018-06-28 13:32:56 +00:00
msgid "Run *test* and return the result."
msgstr ""
#: library/test.rst:1018
2020-07-20 08:56:42 +00:00
msgid ":mod:`test.support.socket_helper` --- Utilities for socket tests"
msgstr ""
#: library/test.rst:1024
2020-07-20 08:56:42 +00:00
#, fuzzy
msgid ""
"The :mod:`test.support.socket_helper` module provides support for socket "
"tests."
msgstr "Le module :mod:`pty` expose les fonctions suivantes :"
#: library/test.rst:1031
2020-07-20 08:56:42 +00:00
msgid "Set to ``True`` if IPv6 is enabled on this host, ``False`` otherwise."
msgstr ""
#: library/test.rst:1036
2020-07-20 08:56:42 +00:00
msgid ""
"Returns an unused port that should be suitable for binding. This is "
"achieved by creating a temporary socket with the same family and type as the "
"``sock`` parameter (default is :const:`~socket.AF_INET`, :const:`~socket."
"SOCK_STREAM`), and binding it to the specified host address (defaults to "
"``0.0.0.0``) with the port set to 0, eliciting an unused ephemeral port from "
"the OS. The temporary socket is then closed and deleted, and the ephemeral "
"port is returned."
msgstr ""
#: library/test.rst:1045
2020-07-20 08:56:42 +00:00
msgid ""
"Either this method or :func:`bind_port` should be used for any tests where a "
"server socket needs to be bound to a particular port for the duration of the "
"test. Which one to use depends on whether the calling code is creating a "
"Python socket, or if an unused port needs to be provided in a constructor or "
"passed to an external program (i.e. the ``-accept`` argument to openssl's "
"s_server mode). Always prefer :func:`bind_port` over :func:"
"`find_unused_port` where possible. Using a hard coded port is discouraged "
"since it can make multiple instances of the test impossible to run "
"simultaneously, which is a problem for buildbots."
msgstr ""
#: library/test.rst:1059
2020-07-20 08:56:42 +00:00
msgid ""
"Bind the socket to a free port and return the port number. Relies on "
"ephemeral ports in order to ensure we are using an unbound port. This is "
"important as many tests may be running simultaneously, especially in a "
"buildbot environment. This method raises an exception if the ``sock."
"family`` is :const:`~socket.AF_INET` and ``sock.type`` is :const:`~socket."
"SOCK_STREAM`, and the socket has :const:`~socket.SO_REUSEADDR` or :const:"
"`~socket.SO_REUSEPORT` set on it. Tests should never set these socket "
"options for TCP/IP sockets. The only case for setting these options is "
"testing multicasting via multiple UDP sockets."
msgstr ""
#: library/test.rst:1070
2020-07-20 08:56:42 +00:00
msgid ""
"Additionally, if the :const:`~socket.SO_EXCLUSIVEADDRUSE` socket option is "
"available (i.e. on Windows), it will be set on the socket. This will "
"prevent anyone else from binding to our host/port for the duration of the "
"test."
msgstr ""
#: library/test.rst:1078
2020-07-20 08:56:42 +00:00
msgid ""
"Bind a Unix socket, raising :exc:`unittest.SkipTest` if :exc:"
2020-07-20 08:56:42 +00:00
"`PermissionError` is raised."
msgstr ""
#: library/test.rst:1084
2020-07-20 08:56:42 +00:00
msgid ""
"A decorator for running tests that require a functional ``bind()`` for Unix "
"sockets."
msgstr ""
#: library/test.rst:1090
2020-07-20 08:56:42 +00:00
msgid ""
"A context manager that raises :exc:`~test.support.ResourceDenied` when "
"various issues with the internet connection manifest themselves as "
"exceptions."
msgstr ""
#: library/test.rst:1096
2018-06-28 13:32:56 +00:00
msgid ""
":mod:`test.support.script_helper` --- Utilities for the Python execution "
"tests"
msgstr ""
#: library/test.rst:1102
2018-06-28 13:32:56 +00:00
msgid ""
"The :mod:`test.support.script_helper` module provides support for Python's "
"script execution tests."
msgstr ""
#: library/test.rst:1107
2018-06-28 13:32:56 +00:00
msgid ""
"Return ``True`` if ``sys.executable interpreter`` requires environment "
"variables in order to be able to run at all."
msgstr ""
#: library/test.rst:1110
2018-06-28 13:32:56 +00:00
msgid ""
"This is designed to be used with ``@unittest.skipIf()`` to annotate tests "
"that need to use an ``assert_python*()`` function to launch an isolated mode "
"(``-I``) or no environment mode (``-E``) sub-interpreter process."
msgstr ""
#: library/test.rst:1114
2018-06-28 13:32:56 +00:00
msgid ""
"A normal build & test does not run into this situation but it can happen "
"when trying to run the standard library test suite from an interpreter that "
"doesn't have an obvious home with Python's current home finding logic."
msgstr ""
#: library/test.rst:1118
2018-06-28 13:32:56 +00:00
msgid ""
"Setting :envvar:`PYTHONHOME` is one way to get most of the testsuite to run "
"in that situation. :envvar:`PYTHONPATH` or :envvar:`PYTHONUSERSITE` are "
"other common environment variables that might impact whether or not the "
"interpreter can start."
msgstr ""
#: library/test.rst:1126
2018-06-28 13:32:56 +00:00
msgid ""
"Set up the environment based on *env_vars* for running the interpreter in a "
"subprocess. The values can include ``__isolated``, ``__cleanenv``, "
"``__cwd``, and ``TERM``."
msgstr ""
#: library/test.rst:1146 library/test.rst:1158
2020-07-20 08:56:42 +00:00
msgid "The function no longer strips whitespaces from *stderr*."
msgstr ""
#: library/test.rst:1136
2018-06-28 13:32:56 +00:00
msgid ""
"Assert that running the interpreter with *args* and optional environment "
"variables *env_vars* succeeds (``rc == 0``) and return a ``(return code, "
"stdout, stderr)`` tuple."
msgstr ""
#: library/test.rst:1140
2018-06-28 13:32:56 +00:00
msgid ""
"If the *__cleanenv* keyword-only parameter is set, *env_vars* is used as a "
"fresh environment."
2018-06-28 13:32:56 +00:00
msgstr ""
#: library/test.rst:1143
2018-06-28 13:32:56 +00:00
msgid ""
"Python is started in isolated mode (command line option ``-I``), except if "
"the *__isolated* keyword-only parameter is set to ``False``."
2018-06-28 13:32:56 +00:00
msgstr ""
#: library/test.rst:1152
2018-06-28 13:32:56 +00:00
msgid ""
"Assert that running the interpreter with *args* and optional environment "
"variables *env_vars* fails (``rc != 0``) and return a ``(return code, "
"stdout, stderr)`` tuple."
msgstr ""
#: library/test.rst:1156
2018-06-28 13:32:56 +00:00
msgid "See :func:`assert_python_ok` for more options."
msgstr ""
#: library/test.rst:1164
2018-06-28 13:32:56 +00:00
msgid "Run a Python subprocess with the given arguments."
msgstr ""
#: library/test.rst:1166
2018-06-28 13:32:56 +00:00
msgid ""
"*kw* is extra keyword args to pass to :func:`subprocess.Popen`. Returns a :"
"class:`subprocess.Popen` object."
msgstr ""
#: library/test.rst:1172
2018-06-28 13:32:56 +00:00
msgid ""
"Run the given :class:`subprocess.Popen` process until completion and return "
"stdout."
msgstr ""
#: library/test.rst:1178
2018-06-28 13:32:56 +00:00
msgid ""
"Create script containing *source* in path *script_dir* and "
"*script_basename*. If *omit_suffix* is ``False``, append ``.py`` to the "
"name. Return the full script path."
msgstr ""
#: library/test.rst:1185
2018-06-28 13:32:56 +00:00
msgid ""
"Create zip file at *zip_dir* and *zip_basename* with extension ``zip`` which "
"contains the files in *script_name*. *name_in_zip* is the archive name. "
"Return a tuple containing ``(full path, full path of archive name)``."
msgstr ""
#: library/test.rst:1192
2018-06-28 13:32:56 +00:00
msgid ""
"Create a directory named *pkg_dir* containing an ``__init__`` file with "
"*init_source* as its contents."
msgstr ""
#: library/test.rst:1199
2018-06-28 13:32:56 +00:00
msgid ""
"Create a zip package directory with a path of *zip_dir* and *zip_basename* "
"containing an empty ``__init__`` file and a file *script_basename* "
"containing the *source*. If *compiled* is ``True``, both source files will "
"be compiled and added to the zip package. Return a tuple of the full zip "
"path and the archive name for the zip file."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/test.rst:1207
2020-07-20 08:56:42 +00:00
msgid ""
":mod:`test.support.bytecode_helper` --- Support tools for testing correct "
"bytecode generation"
msgstr ""
#: library/test.rst:1212
2020-07-20 08:56:42 +00:00
msgid ""
"The :mod:`test.support.bytecode_helper` module provides support for testing "
"and inspecting bytecode generation."
msgstr ""
#: library/test.rst:1217
2020-07-20 08:56:42 +00:00
#, fuzzy
msgid "The module defines the following class:"
msgstr "Ce module définit les fonctions suivantes :"
2020-07-20 08:56:42 +00:00
#: library/test.rst:1221
2020-07-20 08:56:42 +00:00
msgid "This class has custom assertion methods for inspecting bytecode."
msgstr ""
#: library/test.rst:1225
2020-07-20 08:56:42 +00:00
msgid "Return the disassembly of *co* as string."
msgstr ""
#: library/test.rst:1230
2020-07-20 08:56:42 +00:00
msgid ""
"Return instr if *opname* is found, otherwise throws :exc:`AssertionError`."
msgstr ""
#: library/test.rst:1235
2020-07-20 08:56:42 +00:00
msgid "Throws :exc:`AssertionError` if *opname* is found."
msgstr ""
#: library/test.rst:1239
#, fuzzy
msgid ":mod:`test.support.threading_helper` --- Utilities for threading tests"
msgstr "Le module :mod:`pty` expose les fonctions suivantes :"
#: library/test.rst:1244
#, fuzzy
msgid ""
"The :mod:`test.support.threading_helper` module provides support for "
"threading tests."
msgstr "Le module :mod:`pty` expose les fonctions suivantes :"
#: library/test.rst:1251
msgid ""
"Join a *thread* within *timeout*. Raise an :exc:`AssertionError` if thread "
"is still alive after *timeout* seconds."
msgstr ""
#: library/test.rst:1257
msgid "Decorator to ensure the threads are cleaned up even if the test fails."
msgstr ""
#: library/test.rst:1262
msgid ""
"Context manager to start *threads*, which is a sequence of threads. *unlock* "
"is a function called after the threads are started, even if an exception was "
"raised; an example would be :meth:`threading.Event.set`. ``start_threads`` "
"will attempt to join the started threads upon exit."
msgstr ""
#: library/test.rst:1270
msgid ""
"Cleanup up threads not specified in *original_values*. Designed to emit a "
"warning if a test leaves running threads in the background."
msgstr ""
#: library/test.rst:1276
msgid "Return current thread count and copy of dangling threads."
msgstr ""
#: library/test.rst:1281
msgid ""
"Context manager to wait until all threads created in the ``with`` statement "
"exit."
msgstr ""
#: library/test.rst:1287
msgid ""
"Context manager catching :class:`threading.Thread` exception using :func:"
"`threading.excepthook`."
msgstr ""
#: library/test.rst:1290
msgid "Attributes set when an exception is caught:"
msgstr ""
#: library/test.rst:1292
msgid "``exc_type``"
msgstr ""
#: library/test.rst:1293
msgid "``exc_value``"
msgstr ""
#: library/test.rst:1294
msgid "``exc_traceback``"
msgstr ""
#: library/test.rst:1295
msgid "``thread``"
msgstr ""
#: library/test.rst:1297
msgid "See :func:`threading.excepthook` documentation."
msgstr ""
#: library/test.rst:1299
msgid "These attributes are deleted at the context manager exit."
msgstr ""
#: library/test.rst:1319
#, fuzzy
msgid ":mod:`test.support.os_helper` --- Utilities for os tests"
msgstr "Le module :mod:`pty` expose les fonctions suivantes :"
#: library/test.rst:1324
#, fuzzy
msgid "The :mod:`test.support.os_helper` module provides support for os tests."
msgstr "Le module :mod:`pty` expose les fonctions suivantes :"
#: library/test.rst:1331
msgid "A non-ASCII character encodable by :func:`os.fsencode`."
msgstr ""
#: library/test.rst:1336
msgid "Set to :func:`os.getcwd`."
msgstr ""
#: library/test.rst:1341
msgid ""
"Set to a name that is safe to use as the name of a temporary file. Any "
"temporary file that is created should be closed and unlinked (removed)."
msgstr ""
#: library/test.rst:1347
msgid ""
"Set to a filename containing the :data:`FS_NONASCII` character, if it "
"exists. This guarantees that if the filename exists, it can be encoded and "
"decoded with the default filesystem encoding. This allows tests that require "
"a non-ASCII filename to be easily skipped on platforms where they can't work."
msgstr ""
#: library/test.rst:1355
msgid ""
"Set to a filename (str type) that should not be able to be encoded by file "
"system encoding in strict mode. It may be ``None`` if it's not possible to "
"generate such a filename."
msgstr ""
#: library/test.rst:1362
msgid ""
"Set to a filename (bytes type) that should not be able to be decoded by file "
"system encoding in strict mode. It may be ``None`` if it's not possible to "
"generate such a filename."
msgstr ""
#: library/test.rst:1369
msgid "Set to a non-ASCII name for a temporary file."
msgstr ""
#: library/test.rst:1374
msgid ""
"Class used to temporarily set or unset environment variables. Instances can "
"be used as a context manager and have a complete dictionary interface for "
"querying/modifying the underlying ``os.environ``. After exit from the "
"context manager all changes to environment variables done through this "
"instance will be rolled back."
msgstr ""
#: library/test.rst:1380
msgid "Added dictionary interface."
msgstr ""
#: library/test.rst:1386
msgid ""
"Simple :term:`path-like object`. It implements the :meth:`__fspath__` "
"method which just returns the *path* argument. If *path* is an exception, "
"it will be raised in :meth:`!__fspath__`."
msgstr ""
#: library/test.rst:1393
msgid ""
"Temporarily set the environment variable ``envvar`` to the value of "
"``value``."
msgstr ""
#: library/test.rst:1399
msgid "Temporarily unset the environment variable ``envvar``."
msgstr ""
#: library/test.rst:1404
msgid "Return ``True`` if the OS supports symbolic links, ``False`` otherwise."
msgstr ""
#: library/test.rst:1410
msgid "Return ``True`` if the OS supports xattr, ``False`` otherwise."
msgstr ""
#: library/test.rst:1416
msgid ""
"A context manager that temporarily changes the current working directory to "
"*path* and yields the directory."
msgstr ""
#: library/test.rst:1419
msgid ""
"If *quiet* is ``False``, the context manager raises an exception on error. "
"Otherwise, it issues only a warning and keeps the current working directory "
"the same."
msgstr ""
#: library/test.rst:1426
msgid ""
"Create an empty file with *filename*. If it already exists, truncate it."
msgstr ""
#: library/test.rst:1431
msgid "Count the number of open file descriptors."
msgstr ""
#: library/test.rst:1436
msgid "Return ``True`` if the file system for *directory* is case-insensitive."
msgstr ""
#: library/test.rst:1441
msgid ""
"Create an invalid file descriptor by opening and closing a temporary file, "
"and returning its descriptor."
msgstr ""
#: library/test.rst:1447
msgid ""
"Call :func:`os.rmdir` on *filename*. On Windows platforms, this is wrapped "
"with a wait loop that checks for the existence of the file, which is needed "
"due to antivirus programs that can hold files open and prevent deletion."
msgstr ""
#: library/test.rst:1455
msgid ""
"Call :func:`shutil.rmtree` on *path* or call :func:`os.lstat` and :func:`os."
"rmdir` to remove a path and its contents. As with :func:`rmdir`, on Windows "
"platforms this is wrapped with a wait loop that checks for the existence of "
"the files."
msgstr ""
#: library/test.rst:1463
msgid "A decorator for running tests that require support for symbolic links."
msgstr ""
#: library/test.rst:1468
msgid "A decorator for running tests that require support for xattr."
msgstr ""
#: library/test.rst:1473
msgid ""
"A context manager that temporarily creates a new directory and changes the "
"current working directory (CWD)."
msgstr ""
#: library/test.rst:1476
msgid ""
"The context manager creates a temporary directory in the current directory "
"with name *name* before temporarily changing the current working directory. "
"If *name* is ``None``, the temporary directory is created using :func:"
"`tempfile.mkdtemp`."
msgstr ""
#: library/test.rst:1481
msgid ""
"If *quiet* is ``False`` and it is not possible to create or change the CWD, "
"an error is raised. Otherwise, only a warning is raised and the original "
"CWD is used."
msgstr ""
#: library/test.rst:1488
msgid ""
"A context manager that creates a temporary directory at *path* and yields "
"the directory."
msgstr ""
#: library/test.rst:1491
msgid ""
"If *path* is ``None``, the temporary directory is created using :func:"
"`tempfile.mkdtemp`. If *quiet* is ``False``, the context manager raises an "
"exception on error. Otherwise, if *path* is specified and cannot be "
"created, only a warning is issued."
msgstr ""
#: library/test.rst:1499
msgid "A context manager that temporarily sets the process umask."
msgstr ""
#: library/test.rst:1504
msgid ""
"Call :func:`os.unlink` on *filename*. As with :func:`rmdir`, on Windows "
"platforms, this is wrapped with a wait loop that checks for the existence of "
"the file."
msgstr ""
#: library/test.rst:1510
#, fuzzy
msgid ":mod:`test.support.import_helper` --- Utilities for import tests"
msgstr "Le module :mod:`pty` expose les fonctions suivantes :"
#: library/test.rst:1515
#, fuzzy
msgid ""
"The :mod:`test.support.import_helper` module provides support for import "
"tests."
msgstr "Le module :mod:`pty` expose les fonctions suivantes :"
#: library/test.rst:1522
msgid ""
"Remove the module named *module_name* from ``sys.modules`` and delete any "
"byte-compiled files of the module."
msgstr ""
#: library/test.rst:1528
msgid ""
"This function imports and returns a fresh copy of the named Python module by "
"removing the named module from ``sys.modules`` before doing the import. Note "
"that unlike :func:`reload`, the original module is not affected by this "
"operation."
msgstr ""
#: library/test.rst:1533
msgid ""
"*fresh* is an iterable of additional module names that are also removed from "
"the ``sys.modules`` cache before doing the import."
msgstr ""
#: library/test.rst:1536
msgid ""
"*blocked* is an iterable of module names that are replaced with ``None`` in "
"the module cache during the import to ensure that attempts to import them "
"raise :exc:`ImportError`."
msgstr ""
#: library/test.rst:1540
msgid ""
"The named module and any modules named in the *fresh* and *blocked* "
"parameters are saved before starting the import and then reinserted into "
"``sys.modules`` when the fresh import is complete."
msgstr ""
#: library/test.rst:1544
msgid ""
"Module and package deprecation messages are suppressed during this import if "
"*deprecated* is ``True``."
msgstr ""
#: library/test.rst:1547
msgid ""
"This function will raise :exc:`ImportError` if the named module cannot be "
"imported."
msgstr ""
#: library/test.rst:1564
msgid ""
"This function imports and returns the named module. Unlike a normal import, "
"this function raises :exc:`unittest.SkipTest` if the module cannot be "
"imported."
msgstr ""
#: library/test.rst:1568
msgid ""
"Module and package deprecation messages are suppressed during this import if "
"*deprecated* is ``True``. If a module is required on a platform but "
"optional for others, set *required_on* to an iterable of platform prefixes "
"which will be compared against :data:`sys.platform`."
msgstr ""
#: library/test.rst:1578
msgid "Return a copy of :data:`sys.modules`."
msgstr ""
#: library/test.rst:1583
msgid ""
"Remove modules except for *oldmodules* and ``encodings`` in order to "
"preserve internal cache."
msgstr ""
#: library/test.rst:1589
msgid "Delete *name* from ``sys.modules``."
msgstr ""
#: library/test.rst:1594
msgid ""
"Move a :pep:`3147`/:pep:`488` pyc file to its legacy pyc location and return "
"the file system path to the legacy pyc file. The *source* value is the file "
"system path to the source file. It does not need to exist, however the PEP "
"3147/488 pyc file must exist."
msgstr ""
#: library/test.rst:1602
msgid ""
"A context manager to force import to return a new module reference. This is "
"useful for testing module-level behaviors, such as the emission of a :exc:"
"`DeprecationWarning` on import. Example usage::"
msgstr ""
#: library/test.rst:1612
msgid "A context manager to temporarily add directories to :data:`sys.path`."
msgstr ""
#: library/test.rst:1614
msgid ""
"This makes a copy of :data:`sys.path`, appends any directories given as "
"positional arguments, then reverts :data:`sys.path` to the copied settings "
"when the context ends."
msgstr ""
#: library/test.rst:1618
msgid ""
"Note that *all* :data:`sys.path` modifications in the body of the context "
"manager, including replacement of the object, will be reverted at the end of "
"the block."
msgstr ""
#: library/test.rst:1624
#, fuzzy
msgid ":mod:`test.support.warnings_helper` --- Utilities for warnings tests"
msgstr "Le module :mod:`pty` expose les fonctions suivantes :"
#: library/test.rst:1629
#, fuzzy
msgid ""
"The :mod:`test.support.warnings_helper` module provides support for warnings "
"tests."
msgstr "Le module :mod:`pty` expose les fonctions suivantes :"
#: library/test.rst:1636
msgid ""
2023-04-14 11:20:40 +00:00
"Suppress warnings that are instances of *category*, which must be :exc:"
"`Warning` or a subclass. Roughly equivalent to :func:`warnings."
"catch_warnings` with :meth:`warnings.simplefilter('ignore', "
"category=category) <warnings.simplefilter>`. For example::"
msgstr ""
#: library/test.rst:1651
msgid ""
"Context manager to check that no :exc:`ResourceWarning` was raised. You "
"must remove the object which may emit :exc:`ResourceWarning` before the end "
"of the context manager."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/test.rst:1658
msgid ""
"Test for syntax warning in *statement* by attempting to compile *statement*. "
"Test also that the :exc:`SyntaxWarning` is emitted only once, and that it "
"will be converted to a :exc:`SyntaxError` when turned into error. *testcase* "
"is the :mod:`unittest` instance for the test. *errtext* is the regular "
"expression which should match the string representation of the emitted :exc:"
"`SyntaxWarning` and raised :exc:`SyntaxError`. If *lineno* is not ``None``, "
"compares to the line of the warning and exception. If *offset* is not "
"``None``, compares to the offset of the exception."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/test.rst:1672
msgid ""
"A convenience wrapper for :func:`warnings.catch_warnings()` that makes it "
"easier to test that a warning was correctly raised. It is approximately "
"equivalent to calling ``warnings.catch_warnings(record=True)`` with :meth:"
"`warnings.simplefilter` set to ``always`` and with the option to "
"automatically validate the results that are recorded."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/test.rst:1678
msgid ""
"``check_warnings`` accepts 2-tuples of the form ``(\"message regexp\", "
"WarningCategory)`` as positional arguments. If one or more *filters* are "
"provided, or if the optional keyword argument *quiet* is ``False``, it "
"checks to make sure the warnings are as expected: each specified filter "
"must match at least one of the warnings raised by the enclosed code or the "
"test fails, and if any warnings are raised that do not match any of the "
"specified filters the test fails. To disable the first of these checks, set "
"*quiet* to ``True``."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/test.rst:1687
msgid "If no arguments are specified, it defaults to::"
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/test.rst:1691
msgid "In this case all warnings are caught and no errors are raised."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/test.rst:1693
msgid ""
"On entry to the context manager, a :class:`WarningRecorder` instance is "
"returned. The underlying warnings list from :func:`~warnings.catch_warnings` "
"is available via the recorder object's :attr:`warnings` attribute. As a "
"convenience, the attributes of the object representing the most recent "
"warning can also be accessed directly through the recorder object (see "
"example below). If no warning has been raised, then any of the attributes "
"that would otherwise be expected on an object representing a warning will "
"return ``None``."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/test.rst:1702
msgid ""
"The recorder object also has a :meth:`reset` method, which clears the "
"warnings list."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/test.rst:1705
msgid "The context manager is designed to be used like this::"
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/test.rst:1712
msgid ""
"In this case if either warning was not raised, or some other warning was "
"raised, :func:`check_warnings` would raise an error."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/test.rst:1715
msgid ""
"When a test needs to look more deeply into the warnings, rather than just "
"checking whether or not they occurred, code like this can be used::"
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/test.rst:1729
msgid ""
"Here all warnings will be caught, and the test code tests the captured "
"warnings directly."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/test.rst:1732
msgid "New optional arguments *filters* and *quiet*."
msgstr ""
2023-04-14 11:20:40 +00:00
#: library/test.rst:1738
msgid ""
"Class used to record warnings for unit tests. See documentation of :func:"
"`check_warnings` above for more details."
msgstr ""