From 1377f31aab3752e28f5aab6cd686ac148931d31f Mon Sep 17 00:00:00 2001 From: Nicolas Audebert Date: Tue, 20 Aug 2019 18:11:00 +0200 Subject: [PATCH 1/7] Draft translate library/timeit.po --- library/timeit.po | 169 ++++++++++++++++++++++++++++++++++++++++------ 1 file changed, 150 insertions(+), 19 deletions(-) diff --git a/library/timeit.po b/library/timeit.po index 4b5ddf79c..abc3e1102 100644 --- a/library/timeit.po +++ b/library/timeit.po @@ -6,17 +6,19 @@ msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2019-05-23 16:48+0200\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME \n" +"PO-Revision-Date: 2019-08-20 18:10+0200\n" "Language-Team: FRENCH \n" "Language: fr\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" +"Last-Translator: \n" +"X-Generator: Poedit 2.0.6\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 courts fragments de code" #: ../Doc/library/timeit.rst:7 msgid "**Source code:** :source:`Lib/timeit.py`" @@ -30,24 +32,34 @@ msgid "" "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 chronométrer l'exécution de petits " +"fragments de code Python. Il expose une :ref:`timeit-command-line-interface` " +"ainsi qu'une :ref:`interface Python `. Ce module contourne " +"un certain nombre de problèmes liés au chronométrage 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 "" +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 "" +msgstr "L':ref:`python-interface` peut être utilisée aux mêmes fins avec : ::" #: ../Doc/library/timeit.rst:47 msgid "A callable can also be passed from the :ref:`python-interface`::" msgstr "" +"Un objet appelable peut également être passé en argument à l':ref:`python-" +"interface`: ::" #: ../Doc/library/timeit.rst:52 msgid "" @@ -55,14 +67,18 @@ msgid "" "repetitions only when the command-line interface is used. In the :ref:" "`timeit-examples` section you can find more advanced examples." msgstr "" +"Notez cependant que :func:`.timeit` détermine automatiquement le nombre de " +"répétitions seulement lorsque l'interface en ligne de commande est utilisée. " +"Vous pouvez trouver des exemples d'usages avancés dans la section :ref:" +"`timeit-examples`." #: ../Doc/library/timeit.rst:60 msgid "Python Interface" -msgstr "" +msgstr "Interface Python" #: ../Doc/library/timeit.rst:62 msgid "The module defines three convenience functions and a public class:" -msgstr "" +msgstr "Ce module définit trois fonctions pratiques et une classe publique :" #: ../Doc/library/timeit.rst:67 msgid "" @@ -71,11 +87,15 @@ msgid "" "executions. The optional *globals* argument specifies a namespace in which " "to execute the code." msgstr "" +"Créé une instance d'objet :class:`Timer` à partir de l'instruction donnée, " +"du code *setup* et de la fonction *timer* et exécute sa méthode :meth:`." +"timeit` à *number* reprises. L'argument optionel *globals* spécifie un " +"espace de nommage dans lequel exécuter le code." #: ../Doc/library/timeit.rst:72 ../Doc/library/timeit.rst:83 #: ../Doc/library/timeit.rst:120 msgid "The optional *globals* parameter was added." -msgstr "" +msgstr "Le paramètre optionel *globals* a été ajouté." #: ../Doc/library/timeit.rst:78 msgid "" @@ -84,22 +104,28 @@ msgid "" "count and *number* executions. The optional *globals* argument specifies a " "namespace in which to execute the code." msgstr "" +"Créé une instance d'objet :class:`Timer` à partir de l'instruction donnée, " +"du code *setup* et de la fonction *timer* et 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:86 ../Doc/library/timeit.rst:181 msgid "Default value of *repeat* changed from 3 to 5." -msgstr "" +msgstr "La valeur par défaut de *repeat* est passée de 3 à 5." #: ../Doc/library/timeit.rst:91 msgid "The default timer, which is always :func:`time.perf_counter`." -msgstr "" +msgstr "Le chronomètre par défaut, qui est toujours :func:`time.perf_counter`." #: ../Doc/library/timeit.rst:93 msgid ":func:`time.perf_counter` is now the default timer." -msgstr "" +msgstr ":func:`time.perf_counter` est désormais le chronomètre par défaut." #: ../Doc/library/timeit.rst:99 msgid "Class for timing execution speed of small code snippets." msgstr "" +"Classe permettant de chronométrer le temps d'exécution de petits fragments " +"de code." #: ../Doc/library/timeit.rst:101 msgid "" @@ -111,6 +137,15 @@ msgid "" "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 devant être chronométrée, " +"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:109 msgid "" @@ -118,20 +153,32 @@ msgid "" "timeit` method. The :meth:`.repeat` and :meth:`.autorange` methods are " "convenience methods to call :meth:`.timeit` multiple times." msgstr "" +"Pour mesurer le temps d'exécution de la première instruction, utilisez la " +"méthode :meth:`.timeit`. Les méthodes :meth:`.repeat` et :meth:`.autorange` " +"sont des méthodes de confort permettant d'appeler :meth:`.timeit` à " +"plusieurs reprises." #: ../Doc/library/timeit.rst:113 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:115 +#, fuzzy 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 arguments. 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 du chronométrage dans ce cas est légèrement supérieur dû aux " +"appels de fonction supplémentaires." #: ../Doc/library/timeit.rst:125 msgid "" @@ -142,6 +189,13 @@ msgid "" "statement, the setup statement and the timer function to be used are passed " "to the constructor." msgstr "" +"Chronomètre *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 le 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és au constructeur." #: ../Doc/library/timeit.rst:134 msgid "" @@ -152,10 +206,17 @@ msgid "" "so, GC can be re-enabled as the first statement in the *setup* string. For " "example::" msgstr "" +"Par défaut, :meth:`.timeit` éteint temporairement le :term:`garbage " +"collection` pendant le chronométrage. Cette approche a l'avantage de " +"permettre de comparer des chronométrages indépendants. L'inconvénient de " +"cette méthode est que le ramasse-miettes peut avoir un impact significatif " +"sur les performances de la fonction chronométrée. Dans ce cas, le ramasse-" +"miettes peut être réactivé en première instruction de la chaîne *setup*. Par " +"example: ::" #: ../Doc/library/timeit.rst:146 msgid "Automatically determine how many times to call :meth:`.timeit`." -msgstr "" +msgstr "Détermine automatiquement combien de fois appeler :meth:`.timeit`." #: ../Doc/library/timeit.rst:148 msgid "" @@ -165,16 +226,25 @@ msgid "" "numbers from the sequence 1, 2, 5, 10, 20, 50, ... until the time taken is " "at least 0.2 second." msgstr "" +"Cette fonction de commodité appelle :meth:`.timeit` à plusieurs reprises " +"jusqu'à ce que le temps total écoulé soit supérieur à 0,2 secondes et " +"renvoie le couple (nombre de boucles, temps nécessaire pour exécuter ce " +"nombre de boucles). Elle appelle :meth:`.timeit` avec un nombre d'itérations " +"croissant selon la séquence 1, 2, 5, 10, 20, 50, … jusqu'à ce que le temps " +"d'exécution dépasse 0,2 secondes." #: ../Doc/library/timeit.rst:154 msgid "" "If *callback* is given and is not ``None``, it will be called after each " "trial with two arguments: ``callback(number, time_taken)``." msgstr "" +"Si *callback* est spécifié et n'est pas ``None``, il est appelé après chaque " +"itération avec deux arguments (numéro de l'itération et temps écoulé) : " +"``callback(number, time_taken)``." #: ../Doc/library/timeit.rst:162 msgid "Call :meth:`.timeit` a few times." -msgstr "" +msgstr "Appelle :meth:`.timeit` plusieurs fois." #: ../Doc/library/timeit.rst:164 msgid "" @@ -183,6 +253,10 @@ msgid "" "call :meth:`.timeit`. The second argument specifies the *number* argument " "for :meth:`.timeit`." msgstr "" +"Cette fonction de commodité 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:171 msgid "" @@ -195,21 +269,36 @@ msgid "" "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. Cependant, ceci n'est 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:187 +#, fuzzy msgid "Helper to print a traceback from the timed code." -msgstr "" +msgstr "Outil permettant d'afficher la trace du code chronométré." #: ../Doc/library/timeit.rst:189 msgid "Typical use::" -msgstr "" +msgstr "Usage typique : ::" #: ../Doc/library/timeit.rst:197 +#, fuzzy 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és . Le paramètre optionnel *file* définit l'endroit " +"où la trace est envoyé, par défaut :data:`sys.stderr`." #: ../Doc/library/timeit.rst:205 msgid "Command-Line Interface" @@ -219,41 +308,50 @@ msgstr "Interface en ligne de commande" 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:211 msgid "Where the following options are understood:" -msgstr "" +msgstr "Les options suivantes sont gérées :" #: ../Doc/library/timeit.rst:217 msgid "how many times to execute 'statement'" -msgstr "" +msgstr "nombre d'exécutions de l'instruction 'statement'" #: ../Doc/library/timeit.rst:221 msgid "how many times to repeat the timer (default 5)" -msgstr "" +msgstr "nombre de répétitions du chronomètre (5 par défaut)" #: ../Doc/library/timeit.rst:225 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:229 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:236 msgid "" "specify a time unit for timer output; can select nsec, usec, msec, or sec" msgstr "" +"spécifie l'unité de temps utilisée pour la sortie du chronomètre (parmi " +"*nsec*, *usec*, *msec* ou *sec*)" #: ../Doc/library/timeit.rst:242 +#, fuzzy msgid "print raw timing results; repeat for more digits precision" -msgstr "" +msgstr "affiche les temps d'exécutions bruts, répéter pour plus de précision" #: ../Doc/library/timeit.rst:246 msgid "print a short usage message and exit" -msgstr "" +msgstr "affiche un court message d'aide puis quitte" #: ../Doc/library/timeit.rst:248 msgid "" @@ -262,12 +360,19 @@ msgid "" "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és de la même façon." #: ../Doc/library/timeit.rst:253 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é, 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:256 msgid "" @@ -278,6 +383,13 @@ msgid "" "probably enough in most cases. You can use :func:`time.process_time` to " "measure CPU time." msgstr "" +"Les mesures de :func:`default_timer` peuvent être altérées par d'autres " +"programmes s'exécutant sur la même machine. La meilleure approche lorsqu'un " +"chronométrage exact est nécessaire est de répéter celui-ci à plusieurs " +"reprises et considérer le meilleur temps. L'option :option:`-r` est adaptée " +"à ce fonctionnement, les cinq répétitions par défaut suffisent probablement " +"dans la plupart des cas. Vous pouvez utiliser :func:`time.process_time` pour " +"mesurer le temps processeur." #: ../Doc/library/timeit.rst:264 msgid "" @@ -286,6 +398,11 @@ msgid "" "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 ici présent ne tente pas de le masquer, mais vous devriez être " +"conscient de son existence. Ce surcoût minimal peut être mesuré en invoquant " +"le programme sans arguments; il peut différer en fonction des versions de " +"Python." #: ../Doc/library/timeit.rst:273 msgid "Examples" @@ -296,10 +413,14 @@ 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:292 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:302 msgid "" @@ -307,12 +428,19 @@ msgid "" "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 dé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:348 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:359 msgid "" @@ -320,3 +448,6 @@ msgid "" "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: ::" From 17c5b028e282074019ee5de070f874fb3e3c41d8 Mon Sep 17 00:00:00 2001 From: Nicolas Date: Thu, 22 Aug 2019 11:42:22 +0200 Subject: [PATCH 2/7] Apply suggestions from code review Co-Authored-By: Christophe Nanteuil <35002064+christopheNan@users.noreply.github.com> Co-Authored-By: Julien Palard --- library/timeit.po | 54 +++++++++++++++++++++++------------------------ 1 file changed, 27 insertions(+), 27 deletions(-) diff --git a/library/timeit.po b/library/timeit.po index abc3e1102..4e63b89b6 100644 --- a/library/timeit.po +++ b/library/timeit.po @@ -34,8 +34,8 @@ msgid "" msgstr "" "Ce module fournit une façon simple de chronométrer l'exécution de petits " "fragments de code Python. Il expose une :ref:`timeit-command-line-interface` " -"ainsi qu'une :ref:`interface Python `. Ce module contourne " -"un certain nombre de problèmes liés au chronométrage des temps d'exécution. " +"ainsi qu'une :ref:`interface Python `. 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." @@ -59,7 +59,7 @@ msgstr "L':ref:`python-interface` peut être utilisée aux mêmes fins avec : :: msgid "A callable can also be passed from the :ref:`python-interface`::" msgstr "" "Un objet appelable peut également être passé en argument à l':ref:`python-" -"interface`: ::" +"interface` ::" #: ../Doc/library/timeit.rst:52 msgid "" @@ -87,15 +87,15 @@ msgid "" "executions. The optional *globals* argument specifies a namespace in which " "to execute the code." msgstr "" -"Créé une instance d'objet :class:`Timer` à partir de l'instruction donnée, " -"du code *setup* et de la fonction *timer* et exécute sa méthode :meth:`." +"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 optionel *globals* spécifie un " "espace de nommage dans lequel exécuter le code." #: ../Doc/library/timeit.rst:72 ../Doc/library/timeit.rst:83 #: ../Doc/library/timeit.rst:120 msgid "The optional *globals* parameter was added." -msgstr "Le paramètre optionel *globals* a été ajouté." +msgstr "Le paramètre optionnel *globals* a été ajouté." #: ../Doc/library/timeit.rst:78 msgid "" @@ -104,9 +104,9 @@ msgid "" "count and *number* executions. The optional *globals* argument specifies a " "namespace in which to execute the code." msgstr "" -"Créé une instance d'objet :class:`Timer` à partir de l'instruction donnée, " -"du code *setup* et de la fonction *timer* et exécute sa méthode :meth:`." -"repeat` à *number* reprises *repeat* fois. L'argument optionnel *globals* " +"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:86 ../Doc/library/timeit.rst:181 @@ -137,14 +137,14 @@ msgid "" "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 devant être chronométrée, " +"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 " +"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:109 @@ -175,7 +175,7 @@ msgid "" "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 arguments. Ceci transforme alors les appels à ces objets en " +"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 du chronométrage dans ce cas est légèrement supérieur dû aux " "appels de fonction supplémentaires." @@ -192,10 +192,10 @@ msgstr "" "Chronomètre *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 le nombre " +"à 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és au constructeur." +"utilisée sont passées au constructeur." #: ../Doc/library/timeit.rst:134 msgid "" @@ -206,13 +206,13 @@ msgid "" "so, GC can be re-enabled as the first statement in the *setup* string. For " "example::" msgstr "" -"Par défaut, :meth:`.timeit` éteint temporairement le :term:`garbage " -"collection` pendant le chronométrage. Cette approche a l'avantage de " +"Par défaut, :meth:`.timeit` désactive temporairement le :term:`ramasse-miettes` " +"pendant le chronométrage. Cette approche a l'avantage de " "permettre de comparer des chronométrages indépendants. L'inconvénient de " "cette méthode est que le ramasse-miettes peut avoir un impact significatif " "sur les performances de la fonction chronométrée. Dans ce cas, le ramasse-" "miettes peut être réactivé en première instruction de la chaîne *setup*. Par " -"example: ::" +"exemple: ::" #: ../Doc/library/timeit.rst:146 msgid "Automatically determine how many times to call :meth:`.timeit`." @@ -238,7 +238,7 @@ msgid "" "If *callback* is given and is not ``None``, it will be called after each " "trial with two arguments: ``callback(number, time_taken)``." msgstr "" -"Si *callback* est spécifié et n'est pas ``None``, il est appelé après chaque " +"Si *callback* est spécifié et n'est pas ``None``, elle est appelée après chaque " "itération avec deux arguments (numéro de l'itération et temps écoulé) : " "``callback(number, time_taken)``." @@ -270,9 +270,9 @@ msgid "" "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. Cependant, ceci n'est pas très utile. En pratique, " +"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 " +"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 " @@ -297,8 +297,8 @@ msgid "" "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és . Le paramètre optionnel *file* définit l'endroit " -"où la trace est envoyé, par défaut :data:`sys.stderr`." +"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:205 msgid "Command-Line Interface" @@ -363,14 +363,14 @@ 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és de la même façon." +"espaces. Plusieurs :option:`-s`sont gérées de la même façon." #: ../Doc/library/timeit.rst:253 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é, le nombre de boucles adapté est déterminé " +"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." @@ -399,9 +399,9 @@ msgid "" "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 ici présent ne tente pas de le masquer, mais vous devriez être " +"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 arguments; il peut différer en fonction des versions de " +"le programme sans argument ; il peut différer en fonction des versions de " "Python." #: ../Doc/library/timeit.rst:273 @@ -428,7 +428,7 @@ msgid "" "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 démontrent comment chronométrer des expressions sur " +"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 :" From 908306cf675cc5aef61091e270fe97693b0461e7 Mon Sep 17 00:00:00 2001 From: Nicolas Audebert Date: Thu, 22 Aug 2019 11:51:10 +0200 Subject: [PATCH 3/7] Courts fragments -> fragments --- library/timeit.po | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/library/timeit.po b/library/timeit.po index 4e63b89b6..81c12d69a 100644 --- a/library/timeit.po +++ b/library/timeit.po @@ -17,8 +17,7 @@ msgstr "" #: ../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 courts fragments de code" +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`" @@ -124,8 +123,7 @@ msgstr ":func:`time.perf_counter` est désormais le chronomètre par défaut." #: ../Doc/library/timeit.rst:99 msgid "Class for timing execution speed of small code snippets." msgstr "" -"Classe permettant de chronométrer le temps d'exécution de petits fragments " -"de code." +"Classe permettant de mesurer le temps d'exécution de fragments de code." #: ../Doc/library/timeit.rst:101 msgid "" From c8216235cdda1a232d60a943f0de9edcf4faced2 Mon Sep 17 00:00:00 2001 From: Nicolas Audebert Date: Thu, 22 Aug 2019 11:52:16 +0200 Subject: [PATCH 4/7] =?UTF-8?q?Lexique=20li=C3=A9=20=C3=A0=20la=20mesure?= =?UTF-8?q?=20du=20temps?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- library/timeit.po | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/library/timeit.po b/library/timeit.po index 81c12d69a..1871f4684 100644 --- a/library/timeit.po +++ b/library/timeit.po @@ -31,12 +31,13 @@ msgid "" "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 chronométrer l'exécution de petits " +"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 `. 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." +"ainsi qu'une :ref:`interface Python `. 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" @@ -114,11 +115,11 @@ msgstr "La valeur par défaut de *repeat* est passée de 3 à 5." #: ../Doc/library/timeit.rst:91 msgid "The default timer, which is always :func:`time.perf_counter`." -msgstr "Le chronomètre par défaut, qui est toujours :func:`time.perf_counter`." +msgstr "Le minuteur par défaut, qui est toujours :func:`time.perf_counter`." #: ../Doc/library/timeit.rst:93 msgid ":func:`time.perf_counter` is now the default timer." -msgstr ":func:`time.perf_counter` est désormais le chronomètre par défaut." +msgstr ":func:`time.perf_counter` est désormais le minuteur par défaut." #: ../Doc/library/timeit.rst:99 msgid "Class for timing execution speed of small code snippets." @@ -165,7 +166,6 @@ msgstr "" "global d'exécution." #: ../Doc/library/timeit.rst:115 -#, fuzzy 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 " @@ -175,8 +175,8 @@ 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 du chronométrage dans ce cas est légèrement supérieur dû aux " -"appels de fonction supplémentaires." +"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:125 msgid "" @@ -187,7 +187,7 @@ msgid "" "statement, the setup statement and the timer function to be used are passed " "to the constructor." msgstr "" -"Chronomètre *number* exécution de l'instruction principale. Ceci exécute " +"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 " From ca2e11aa649ba8fe699fe034fa899bc8ad91f6c4 Mon Sep 17 00:00:00 2001 From: Nicolas Audebert Date: Thu, 22 Aug 2019 11:52:50 +0200 Subject: [PATCH 5/7] =?UTF-8?q?Convenience=20->=20agr=C3=A9ment?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- library/timeit.po | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/library/timeit.po b/library/timeit.po index 1871f4684..e2953f421 100644 --- a/library/timeit.po +++ b/library/timeit.po @@ -78,7 +78,9 @@ msgstr "Interface Python" #: ../Doc/library/timeit.rst:62 msgid "The module defines three convenience functions and a public class:" -msgstr "Ce module définit trois fonctions pratiques et une classe publique :" +msgstr "" +"Ce module définit une classe publique ainsi que trois fonctions destinées à " +"simplifier son usage :" #: ../Doc/library/timeit.rst:67 msgid "" @@ -154,7 +156,7 @@ msgid "" msgstr "" "Pour mesurer le temps d'exécution de la première instruction, utilisez la " "méthode :meth:`.timeit`. Les méthodes :meth:`.repeat` et :meth:`.autorange` " -"sont des méthodes de confort permettant d'appeler :meth:`.timeit` à " +"sont des méthodes d'agrément permettant d'appeler :meth:`.timeit` à " "plusieurs reprises." #: ../Doc/library/timeit.rst:113 @@ -224,7 +226,7 @@ msgid "" "numbers from the sequence 1, 2, 5, 10, 20, 50, ... until the time taken is " "at least 0.2 second." msgstr "" -"Cette fonction de commodité appelle :meth:`.timeit` à plusieurs reprises " +"Cette fonction d'agrément appelle :meth:`.timeit` à plusieurs reprises " "jusqu'à ce que le temps total écoulé soit supérieur à 0,2 secondes et " "renvoie le couple (nombre de boucles, temps nécessaire pour exécuter ce " "nombre de boucles). Elle appelle :meth:`.timeit` avec un nombre d'itérations " @@ -251,7 +253,7 @@ msgid "" "call :meth:`.timeit`. The second argument specifies the *number* argument " "for :meth:`.timeit`." msgstr "" -"Cette fonction de commodité appelle :meth:`.timeit` à plusieurs reprises et " +"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`." From 3b1a70194336379ef08d55f4c7a2c141c454a1a6 Mon Sep 17 00:00:00 2001 From: Nicolas Audebert Date: Thu, 22 Aug 2019 11:53:05 +0200 Subject: [PATCH 6/7] Rewrap library/timeit.po --- library/timeit.po | 46 +++++++++++++++++++++++----------------------- 1 file changed, 23 insertions(+), 23 deletions(-) diff --git a/library/timeit.po b/library/timeit.po index e2953f421..2f05c6c26 100644 --- a/library/timeit.po +++ b/library/timeit.po @@ -138,15 +138,16 @@ msgid "" "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*." +"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:109 msgid "" @@ -206,13 +207,12 @@ msgid "" "so, GC can be re-enabled as the first statement in the *setup* string. For " "example::" msgstr "" -"Par défaut, :meth:`.timeit` désactive temporairement le :term:`ramasse-miettes` " -"pendant le chronométrage. Cette approche a l'avantage de " -"permettre de comparer des chronométrages indépendants. L'inconvénient de " -"cette méthode est que le ramasse-miettes peut avoir un impact significatif " -"sur les performances de la fonction chronométrée. Dans ce cas, le ramasse-" -"miettes peut être réactivé en première instruction de la chaîne *setup*. Par " -"exemple: ::" +"Par défaut, :meth:`.timeit` désactive temporairement le :term:`ramasse-" +"miettes` pendant le chronométrage. Cette approche a l'avantage de permettre " +"de comparer des mesures indépendantes. L'inconvénient de cette méthode est " +"que le ramasse-miettes peut avoir un impact significatif sur les " +"performances de la fonction étudiée. Dans ce cas, le ramasse-miettes peut " +"être réactivé en première instruction de la chaîne *setup*. Par exemple: ::" #: ../Doc/library/timeit.rst:146 msgid "Automatically determine how many times to call :meth:`.timeit`." @@ -238,9 +238,9 @@ msgid "" "If *callback* is given and is not ``None``, it will be called after each " "trial with two arguments: ``callback(number, time_taken)``." msgstr "" -"Si *callback* est spécifié et n'est pas ``None``, elle est appelée après chaque " -"itération avec deux arguments (numéro de l'itération et temps écoulé) : " -"``callback(number, time_taken)``." +"Si *callback* est spécifié et n'est pas ``None``, elle est appelée après " +"chaque itération avec deux arguments (numéro de l'itération et temps " +"écoulé) : ``callback(number, time_taken)``." #: ../Doc/library/timeit.rst:162 msgid "Call :meth:`.timeit` a few times." @@ -270,8 +270,8 @@ msgid "" "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 à " +"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 " @@ -297,8 +297,8 @@ msgid "" "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`." +"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:205 msgid "Command-Line Interface" From b9f300a237f60d6be6f0c3132ca4e741389ea9d2 Mon Sep 17 00:00:00 2001 From: Nicolas Audebert Date: Thu, 22 Aug 2019 14:34:18 +0200 Subject: [PATCH 7/7] Fix syntax --- library/timeit.po | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/library/timeit.po b/library/timeit.po index 2f05c6c26..4c2ff397a 100644 --- a/library/timeit.po +++ b/library/timeit.po @@ -91,7 +91,7 @@ msgid "" 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 optionel *globals* spécifie un " +"timeit` à *number* reprises. L'argument optionnel *globals* spécifie un " "espace de nommage dans lequel exécuter le code." #: ../Doc/library/timeit.rst:72 ../Doc/library/timeit.rst:83 @@ -317,7 +317,7 @@ msgstr "Les options suivantes sont gérées :" #: ../Doc/library/timeit.rst:217 msgid "how many times to execute 'statement'" -msgstr "nombre d'exécutions de l'instruction 'statement'" +msgstr "nombre d'exécutions de l'instruction *statement*" #: ../Doc/library/timeit.rst:221 msgid "how many times to repeat the timer (default 5)" @@ -363,7 +363,7 @@ 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." +"espaces. Plusieurs :option:`-s` sont gérées de la même façon." #: ../Doc/library/timeit.rst:253 msgid ""