forked from AFPy/python-docs-fr
398 lines
17 KiB
Plaintext
398 lines
17 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
||
# Copyright (C) 2001-2016, Python Software Foundation
|
||
# This file is distributed under the same license as the Python package.
|
||
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
|
||
#
|
||
#, fuzzy
|
||
msgid ""
|
||
msgstr ""
|
||
"Project-Id-Version: Python 3.5\n"
|
||
"Report-Msgid-Bugs-To: \n"
|
||
"POT-Creation-Date: 2016-10-30 10:42+0100\n"
|
||
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
||
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
||
"Language-Team: LANGUAGE <LL@li.org>\n"
|
||
"MIME-Version: 1.0\n"
|
||
"Content-Type: text/plain; charset=UTF-8\n"
|
||
"Content-Transfer-Encoding: 8bit\n"
|
||
|
||
#: ../Doc/library/timeit.rst:2
|
||
msgid ":mod:`timeit` --- Measure execution time of small code snippets"
|
||
msgstr ":mod:`timeit` — Mesurer le temps d'exécution de fragments de code"
|
||
|
||
#: ../Doc/library/timeit.rst:7
|
||
msgid "**Source code:** :source:`Lib/timeit.py`"
|
||
msgstr "**Code source :** :source:`Lib/timeit.py`"
|
||
|
||
#: ../Doc/library/timeit.rst:15
|
||
msgid ""
|
||
"This module provides a simple way to time small bits of Python code. It has "
|
||
"both a :ref:`timeit-command-line-interface` as well as a :ref:`callable "
|
||
"<python-interface>` one. It avoids a number of common traps for measuring "
|
||
"execution times. See also Tim Peters' introduction to the \"Algorithms\" "
|
||
"chapter in the *Python Cookbook*, published by O'Reilly."
|
||
msgstr ""
|
||
"Ce module fournit une façon simple de mesurer le temps d'exécution de "
|
||
"fragments de code Python. Il expose une :ref:`timeit-command-line-interface` "
|
||
"ainsi qu'une :ref:`interface Python <python-interface>`. Ce module permet "
|
||
"d'éviter un certain nombre de problèmes classiques liés à la mesure des "
|
||
"temps d'exécution. Voir par exemple à ce sujet l'introduction par Tim Peters "
|
||
"du chapitre « Algorithmes » dans le livre *Python Cookbook*, aux éditions "
|
||
"O'Reilly."
|
||
|
||
#: ../Doc/library/timeit.rst:23
|
||
msgid "Basic Examples"
|
||
msgstr "Exemples simples"
|
||
|
||
#: ../Doc/library/timeit.rst:25
|
||
msgid ""
|
||
"The following example shows how the :ref:`timeit-command-line-interface` can "
|
||
"be used to compare three different expressions:"
|
||
msgstr ""
|
||
"L'exemple suivant illustre l'utilisation de l':ref:`timeit-command-line-"
|
||
"interface` afin de comparer trois expressions différentes :"
|
||
|
||
#: ../Doc/library/timeit.rst:37
|
||
msgid "This can be achieved from the :ref:`python-interface` with::"
|
||
msgstr "L':ref:`python-interface` peut être utilisée aux mêmes fins avec : ::"
|
||
|
||
#: ../Doc/library/timeit.rst:48
|
||
msgid ""
|
||
"Note however that :mod:`timeit` will automatically determine the number of "
|
||
"repetitions only when the command-line interface is used. In the :ref:"
|
||
"`timeit-examples` section you can find more advanced examples."
|
||
msgstr ""
|
||
|
||
#: ../Doc/library/timeit.rst:56
|
||
msgid "Python Interface"
|
||
msgstr "Interface Python"
|
||
|
||
#: ../Doc/library/timeit.rst:58
|
||
msgid "The module defines three convenience functions and a public class:"
|
||
msgstr ""
|
||
"Ce module définit une classe publique ainsi que trois fonctions destinées à "
|
||
"simplifier son usage :"
|
||
|
||
#: ../Doc/library/timeit.rst:63
|
||
msgid ""
|
||
"Create a :class:`Timer` instance with the given statement, *setup* code and "
|
||
"*timer* function and run its :meth:`.timeit` method with *number* "
|
||
"executions. The optional *globals* argument specifies a namespace in which "
|
||
"to execute the code."
|
||
msgstr ""
|
||
"Crée une instance d'objet :class:`Timer` à partir de l'instruction donnée, "
|
||
"du code *setup* et de la fonction *timer*, puis exécute sa méthode :meth:`."
|
||
"timeit` à *number* reprises. L'argument optionnel *globals* spécifie un "
|
||
"espace de nommage dans lequel exécuter le code."
|
||
|
||
#: ../Doc/library/timeit.rst:68 ../Doc/library/timeit.rst:79
|
||
#: ../Doc/library/timeit.rst:113
|
||
msgid "The optional *globals* parameter was added."
|
||
msgstr "Le paramètre optionnel *globals* a été ajouté."
|
||
|
||
#: ../Doc/library/timeit.rst:74
|
||
msgid ""
|
||
"Create a :class:`Timer` instance with the given statement, *setup* code and "
|
||
"*timer* function and run its :meth:`.repeat` method with the given *repeat* "
|
||
"count and *number* executions. The optional *globals* argument specifies a "
|
||
"namespace in which to execute the code."
|
||
msgstr ""
|
||
"Crée une instance d'objet :class:`Timer` à partir de l'instruction donnée, "
|
||
"du code *setup* et de la fonction *timer*, puis exécute sa méthode :meth:`."
|
||
"repeat` à *number* reprises, *repeat* fois. L'argument optionnel *globals* "
|
||
"spécifie un espace de nommage dans lequel exécuter le code."
|
||
|
||
#: ../Doc/library/timeit.rst:84
|
||
msgid "The default timer, which is always :func:`time.perf_counter`."
|
||
msgstr "Le minuteur par défaut, qui est toujours :func:`time.perf_counter`."
|
||
|
||
#: ../Doc/library/timeit.rst:86
|
||
msgid ":func:`time.perf_counter` is now the default timer."
|
||
msgstr ":func:`time.perf_counter` est désormais le minuteur par défaut."
|
||
|
||
#: ../Doc/library/timeit.rst:92
|
||
msgid "Class for timing execution speed of small code snippets."
|
||
msgstr ""
|
||
"Classe permettant de mesurer le temps d'exécution de fragments de code."
|
||
|
||
#: ../Doc/library/timeit.rst:94
|
||
msgid ""
|
||
"The constructor takes a statement to be timed, an additional statement used "
|
||
"for setup, and a timer function. Both statements default to ``'pass'``; the "
|
||
"timer function is platform-dependent (see the module doc string). *stmt* and "
|
||
"*setup* may also contain multiple statements separated by ``;`` or newlines, "
|
||
"as long as they don't contain multi-line string literals. The statement "
|
||
"will by default be executed within timeit's namespace; this behavior can be "
|
||
"controlled by passing a namespace to *globals*."
|
||
msgstr ""
|
||
"Ce constructeur prend en argument une instruction dont le temps d'exécution "
|
||
"doit être mesuré, une instruction additionnelle de mise en place et une "
|
||
"fonction de chronométrage. Les deux instructions valent ``'pass'`` par "
|
||
"défaut; la fonction de chronométrage dépend de la plateforme d'exécution (se "
|
||
"référer au *doc string* du module). *stmt* et *setup* peuvent contenir "
|
||
"plusieurs instructions séparées par des ``;`` ou des sauts de lignes tant "
|
||
"qu'ils ne comportent pas de littéraux sur plusieurs lignes. L'instruction "
|
||
"est exécutée dans l'espace de nommage de *timeit* par défaut ; ce "
|
||
"comportement peut être modifié en passant un espace de nommage au paramètre "
|
||
"*globals*."
|
||
|
||
#: ../Doc/library/timeit.rst:102
|
||
msgid ""
|
||
"To measure the execution time of the first statement, use the :meth:`."
|
||
"timeit` method. The :meth:`.repeat` method is a convenience to call :meth:`."
|
||
"timeit` multiple times and return a list of results."
|
||
msgstr ""
|
||
|
||
#: ../Doc/library/timeit.rst:106
|
||
msgid ""
|
||
"The execution time of *setup* is excluded from the overall timed execution "
|
||
"run."
|
||
msgstr ""
|
||
"Le temps d'exécution de *setup* n'est pas pris en compte dans le temps "
|
||
"global d'exécution."
|
||
|
||
#: ../Doc/library/timeit.rst:108
|
||
msgid ""
|
||
"The *stmt* and *setup* parameters can also take objects that are callable "
|
||
"without arguments. This will embed calls to them in a timer function that "
|
||
"will then be executed by :meth:`.timeit`. Note that the timing overhead is "
|
||
"a little larger in this case because of the extra function calls."
|
||
msgstr ""
|
||
"Les paramètres *stmt* et *setup* peuvent également recevoir des objets "
|
||
"appelables sans argument. Ceci transforme alors les appels à ces objets en "
|
||
"fonction de chronométrage qui seront exécutées par :meth:`.timeit`. Notez "
|
||
"que le surcoût lié à la mesure du temps d'exécution dans ce cas est "
|
||
"légèrement supérieur en raisons des appels de fonction supplémentaires."
|
||
|
||
#: ../Doc/library/timeit.rst:118
|
||
msgid ""
|
||
"Time *number* executions of the main statement. This executes the setup "
|
||
"statement once, and then returns the time it takes to execute the main "
|
||
"statement a number of times, measured in seconds as a float. The argument is "
|
||
"the number of times through the loop, defaulting to one million. The main "
|
||
"statement, the setup statement and the timer function to be used are passed "
|
||
"to the constructor."
|
||
msgstr ""
|
||
"Mesure le temps *number* exécution de l'instruction principale. Ceci exécute "
|
||
"l'instruction de mise en place une seule fois puis renvoie un flottant "
|
||
"correspondant au temps nécessaire à l'exécution de l'instruction principale "
|
||
"à plusieurs reprises, mesuré en secondes. L'argument correspond au nombre "
|
||
"d'itérations dans la boucle, par défaut un million. L'instruction "
|
||
"principale, l'instruction de mise en place et la fonction de chronométrage "
|
||
"utilisée sont passées au constructeur."
|
||
|
||
#: ../Doc/library/timeit.rst:127
|
||
msgid ""
|
||
"By default, :meth:`.timeit` temporarily turns off :term:`garbage collection` "
|
||
"during the timing. The advantage of this approach is that it makes "
|
||
"independent timings more comparable. This disadvantage is that GC may be an "
|
||
"important component of the performance of the function being measured. If "
|
||
"so, GC can be re-enabled as the first statement in the *setup* string. For "
|
||
"example::"
|
||
msgstr ""
|
||
|
||
#: ../Doc/library/timeit.rst:139
|
||
msgid "Call :meth:`.timeit` a few times."
|
||
msgstr "Appelle :meth:`.timeit` plusieurs fois."
|
||
|
||
#: ../Doc/library/timeit.rst:141
|
||
msgid ""
|
||
"This is a convenience function that calls the :meth:`.timeit` repeatedly, "
|
||
"returning a list of results. The first argument specifies how many times to "
|
||
"call :meth:`.timeit`. The second argument specifies the *number* argument "
|
||
"for :meth:`.timeit`."
|
||
msgstr ""
|
||
"Cette fonction d'agrément appelle :meth:`.timeit` à plusieurs reprises et "
|
||
"renvoie une liste de résultats. Le premier argument spécifie le nombre "
|
||
"d'appels à :meth:`.timeit`. Le second argument spécifie l'argument *number* "
|
||
"de :meth:`.timeit`."
|
||
|
||
#: ../Doc/library/timeit.rst:148
|
||
msgid ""
|
||
"It's tempting to calculate mean and standard deviation from the result "
|
||
"vector and report these. However, this is not very useful. In a typical "
|
||
"case, the lowest value gives a lower bound for how fast your machine can run "
|
||
"the given code snippet; higher values in the result vector are typically not "
|
||
"caused by variability in Python's speed, but by other processes interfering "
|
||
"with your timing accuracy. So the :func:`min` of the result is probably the "
|
||
"only number you should be interested in. After that, you should look at the "
|
||
"entire vector and apply common sense rather than statistics."
|
||
msgstr ""
|
||
"Il est tentant de vouloir calculer la moyenne et l'écart-type des résultats "
|
||
"et notifier ces valeurs. Ce n'est cependant pas très utile. En pratique, la "
|
||
"valeur la plus basse donne une estimation basse de la vitesse maximale à "
|
||
"laquelle votre machine peut exécuter le fragment de code spécifié ; les "
|
||
"valeurs hautes de la liste sont typiquement provoquées non pas par une "
|
||
"variabilité de la vitesse d'exécution de Python, mais par d'autres processus "
|
||
"interférant avec la précision du chronométrage. Le :func:`min` du résultat "
|
||
"est probablement la seule valeur à laquelle vous devriez vous intéresser. "
|
||
"Pour aller plus loin, vous devriez regarder l'intégralité des résultats et "
|
||
"utiliser le bon sens plutôt que les statistiques."
|
||
|
||
#: ../Doc/library/timeit.rst:161
|
||
msgid "Helper to print a traceback from the timed code."
|
||
msgstr "Outil permettant d'afficher la trace du code chronométré."
|
||
|
||
#: ../Doc/library/timeit.rst:163
|
||
msgid "Typical use::"
|
||
msgstr "Usage typique : ::"
|
||
|
||
#: ../Doc/library/timeit.rst:171
|
||
msgid ""
|
||
"The advantage over the standard traceback is that source lines in the "
|
||
"compiled template will be displayed. The optional *file* argument directs "
|
||
"where the traceback is sent; it defaults to :data:`sys.stderr`."
|
||
msgstr ""
|
||
"L'avantage par rapport à la trace standard est que les lignes sources du "
|
||
"code compilé sont affichées. Le paramètre optionnel *file* définit l'endroit "
|
||
"où la trace est envoyée, par défaut :data:`sys.stderr`."
|
||
|
||
#: ../Doc/library/timeit.rst:179
|
||
msgid "Command-Line Interface"
|
||
msgstr "Interface en ligne de commande"
|
||
|
||
#: ../Doc/library/timeit.rst:181
|
||
msgid ""
|
||
"When called as a program from the command line, the following form is used::"
|
||
msgstr ""
|
||
"Lorsque le module est appelé comme un programme en ligne de commande, la "
|
||
"syntaxe suivante est utilisée : ::"
|
||
|
||
#: ../Doc/library/timeit.rst:185
|
||
msgid "Where the following options are understood:"
|
||
msgstr "Les options suivantes sont gérées :"
|
||
|
||
#: ../Doc/library/timeit.rst:191
|
||
msgid "how many times to execute 'statement'"
|
||
msgstr "nombre d'exécutions de l'instruction *statement*"
|
||
|
||
#: ../Doc/library/timeit.rst:195
|
||
msgid "how many times to repeat the timer (default 3)"
|
||
msgstr ""
|
||
|
||
#: ../Doc/library/timeit.rst:199
|
||
msgid "statement to be executed once initially (default ``pass``)"
|
||
msgstr ""
|
||
"instruction exécutée une seule fois à l'initialisation (``pass`` par défaut)"
|
||
|
||
#: ../Doc/library/timeit.rst:203
|
||
msgid ""
|
||
"measure process time, not wallclock time, using :func:`time.process_time` "
|
||
"instead of :func:`time.perf_counter`, which is the default"
|
||
msgstr ""
|
||
"mesure le temps au niveau du processus et non au niveau du système, en "
|
||
"utilisant :func:`time.process_time` plutôt que :func:`time.perf_counter` qui "
|
||
"est utilisée par défaut"
|
||
|
||
#: ../Doc/library/timeit.rst:210
|
||
msgid "use :func:`time.time` (deprecated)"
|
||
msgstr ""
|
||
|
||
#: ../Doc/library/timeit.rst:214
|
||
msgid "specify a time unit for timer output; can select usec, msec, or sec"
|
||
msgstr ""
|
||
|
||
#: ../Doc/library/timeit.rst:220
|
||
msgid "use :func:`time.clock` (deprecated)"
|
||
msgstr ""
|
||
|
||
#: ../Doc/library/timeit.rst:224
|
||
msgid "print raw timing results; repeat for more digits precision"
|
||
msgstr "affiche les temps d'exécutions bruts, répéter pour plus de précision"
|
||
|
||
#: ../Doc/library/timeit.rst:228
|
||
msgid "print a short usage message and exit"
|
||
msgstr "affiche un court message d'aide puis quitte"
|
||
|
||
#: ../Doc/library/timeit.rst:230
|
||
msgid ""
|
||
"A multi-line statement may be given by specifying each line as a separate "
|
||
"statement argument; indented lines are possible by enclosing an argument in "
|
||
"quotes and using leading spaces. Multiple :option:`-s` options are treated "
|
||
"similarly."
|
||
msgstr ""
|
||
"Une instruction sur plusieurs lignes peut être donnée en entrée en "
|
||
"spécifiant chaque ligne comme un argument séparé. Indenter une ligne est "
|
||
"possible en encadrant l'argument de guillemets et en le préfixant par des "
|
||
"espaces. Plusieurs :option:`-s` sont gérées de la même façon."
|
||
|
||
#: ../Doc/library/timeit.rst:235
|
||
msgid ""
|
||
"If :option:`-n` is not given, a suitable number of loops is calculated by "
|
||
"trying successive powers of 10 until the total time is at least 0.2 seconds."
|
||
msgstr ""
|
||
"Si :option:`-n` n'est pas donnée, le nombre de boucles adapté est déterminé "
|
||
"automatiquement en essayant les puissances de 10 successives jusqu'à ce que "
|
||
"le temps total d'exécution dépasse 0,2 secondes."
|
||
|
||
#: ../Doc/library/timeit.rst:238
|
||
msgid ""
|
||
":func:`default_timer` measurements can be affected by other programs running "
|
||
"on the same machine, so the best thing to do when accurate timing is "
|
||
"necessary is to repeat the timing a few times and use the best time. The :"
|
||
"option:`-r` option is good for this; the default of 3 repetitions is "
|
||
"probably enough in most cases. You can use :func:`time.process_time` to "
|
||
"measure CPU time."
|
||
msgstr ""
|
||
|
||
#: ../Doc/library/timeit.rst:246
|
||
msgid ""
|
||
"There is a certain baseline overhead associated with executing a pass "
|
||
"statement. The code here doesn't try to hide it, but you should be aware of "
|
||
"it. The baseline overhead can be measured by invoking the program without "
|
||
"arguments, and it might differ between Python versions."
|
||
msgstr ""
|
||
"Il existe un surcoût minimal associé à l'exécution de l'instruction `pass`. "
|
||
"Le code présenté ici ne tente pas de le masquer, mais vous devez être "
|
||
"conscient de son existence. Ce surcoût minimal peut être mesuré en invoquant "
|
||
"le programme sans argument ; il peut différer en fonction des versions de "
|
||
"Python."
|
||
|
||
#: ../Doc/library/timeit.rst:255
|
||
msgid "Examples"
|
||
msgstr "Exemples"
|
||
|
||
#: ../Doc/library/timeit.rst:257
|
||
msgid ""
|
||
"It is possible to provide a setup statement that is executed only once at "
|
||
"the beginning:"
|
||
msgstr ""
|
||
"Il est possible de fournir une instruction de mise en place exécutée une "
|
||
"seule fois au début du chronométrage :"
|
||
|
||
#: ../Doc/library/timeit.rst:274
|
||
msgid "The same can be done using the :class:`Timer` class and its methods::"
|
||
msgstr ""
|
||
"La même chose peut être réalisée en utilisant la classe :class:`Timer` et "
|
||
"ses méthodes : ::"
|
||
|
||
#: ../Doc/library/timeit.rst:284
|
||
msgid ""
|
||
"The following examples show how to time expressions that contain multiple "
|
||
"lines. Here we compare the cost of using :func:`hasattr` vs. :keyword:`try`/:"
|
||
"keyword:`except` to test for missing and present object attributes:"
|
||
msgstr ""
|
||
"Les exemples qui suivent montrent comment chronométrer des expressions sur "
|
||
"plusieurs lignes. Nous comparons ici le coût d'utilisation de :func:"
|
||
"`hasattr` par rapport à :keyword:`try`/:keyword:`except` pour tester la "
|
||
"présence ou l'absence d'attributs d'un objet :"
|
||
|
||
#: ../Doc/library/timeit.rst:330
|
||
msgid ""
|
||
"To give the :mod:`timeit` module access to functions you define, you can "
|
||
"pass a *setup* parameter which contains an import statement::"
|
||
msgstr ""
|
||
"Afin de permettre à :mod:`timeit` d'accéder aux fonctions que vous avez "
|
||
"définies, vous pouvez passer au paramètre *setup* une instruction "
|
||
"d'importation: ::"
|
||
|
||
#: ../Doc/library/timeit.rst:341
|
||
msgid ""
|
||
"Another option is to pass :func:`globals` to the *globals* parameter, which "
|
||
"will cause the code to be executed within your current global namespace. "
|
||
"This can be more convenient than individually specifying imports::"
|
||
msgstr ""
|
||
"Une autre possibilité est de passer :func:`globals` au paramètre *globals*, "
|
||
"ceci qui exécutera le code dans l'espace de nommage global courant. Cela "
|
||
"peut être plus pratique que de spécifier manuellement des importations: ::"
|