diff --git a/library/py_compile.po b/library/py_compile.po index 200fb57a..75bd0586 100644 --- a/library/py_compile.po +++ b/library/py_compile.po @@ -6,17 +6,18 @@ msgstr "" "Project-Id-Version: Python 3\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2020-10-01 16:00+0200\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME \n" +"PO-Revision-Date: 2021-05-04 00:17+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: Jean Abou Samra \n" +"X-Generator: Poedit 2.4.1\n" #: library/py_compile.rst:2 msgid ":mod:`py_compile` --- Compile Python source files" -msgstr "" +msgstr ":mod:`py_compile` — Compilation de sources Python" #: library/py_compile.rst:10 msgid "**Source code:** :source:`Lib/py_compile.py`" @@ -28,6 +29,9 @@ msgid "" "file from a source file, and another function used when the module source " "file is invoked as a script." msgstr "" +"Le module :mod:`py_compile` définit une fonction principale qui génère un " +"fichier de code intermédiaire à partir d'un fichier source. Il exporte " +"également la fonction qu'il exécute quand il est lancé en tant que script." #: library/py_compile.rst:20 msgid "" @@ -35,11 +39,15 @@ msgid "" "for shared use, especially if some of the users may not have permission to " "write the byte-code cache files in the directory containing the source code." msgstr "" +"Bien que ce module ne soit pas d'usage fréquent, il peut servir lors de " +"l'installation de bibliothèques partagées, notamment dans le cas où tous les " +"utilisateurs n'ont pas les privilèges d'écriture dans l'emplacement " +"d'installation." #: library/py_compile.rst:27 msgid "" "Exception raised when an error occurs while attempting to compile the file." -msgstr "" +msgstr "Exception levée quand une erreur se produit à la compilation." #: library/py_compile.rst:32 msgid "" @@ -55,6 +63,20 @@ msgid "" "exception is raised. This function returns the path to byte-compiled file, " "i.e. whatever *cfile* value was used." msgstr "" +"Compile un fichier source en un fichier de code intermédiaire, mis en cache. " +"Le code source est lu dans le fichier *file*. Par défaut, le code " +"intermédiaire est écrit dans l'emplacement prescrit par la :pep:`3147`, avec " +"l'extension ``.pyc``. Par exemple, si *file* est ``/ga/bu/zo/meu.py``, le " +"code intermédiaire ira dans ``/ga/bu/zo/__pycache__/meu.cpython-32.pyc`` " +"(pour l'interpréteur Python 3.2). La destination peut être modifiée à l'aide " +"du paramètre *cfile*. Si *dfile* est fourni, il est utilisé comme nom du " +"fichier source dans les messages d'erreur à la place de *file*. Si *doraise* " +"est vrai, une exception de type :exc:`PyCompileError` est levée dans le cas " +"où la compilation de la source produit une erreur. Sinon (comportement par " +"défaut), l'erreur est affichée dans ``sys.stderr``, mais l'exécution se " +"poursuit normalement. Cette fonction renvoie le chemin du fichier de code " +"intermédiaire, c'est-à-dire l'emplacement choisi automatiquement, ou bien " +"*cfile* s'il est précisé." #: library/py_compile.rst:45 msgid "" @@ -65,6 +87,13 @@ msgid "" "`PyCompileError` is raised instead. However if *quiet* is 2, no message is " "written, and *doraise* has no effect." msgstr "" +"Plus précisément, ce sont les arguments *doraise* et *quiet* qui déterminent " +"la stratégie de gestion des erreurs. En effet, si *quiet* vaut 0 ou 1, et " +"*doraise* est faux, le comportement par défaut s'applique : un message " +"d'erreur est affiché dans ``sys.stderr``, et la fonction renvoie ``None`` au " +"lieu d'un chemin. Au contraire, si *doraise* est vrai, une exception :exc:" +"`PyCompileError` est levée, sauf si *quiet* vaut 2. Dans ce dernier cas, " +"aucun message n'est émis, et *doraise* reste sans effet." #: library/py_compile.rst:52 msgid "" @@ -75,6 +104,14 @@ msgid "" "a side-effect of import using file renaming to place the final byte-compiled " "file into place to prevent concurrent file writing issues." msgstr "" +"Si le chemin de destination, explicité par *cfile* ou choisi " +"automatiquement, est un lien symbolique, ou n'est pas un véritable fichier, " +"une exception de type :exc:`FileExistsError` est levée. Ceci, dans le but de " +"vous avertir que le système d'importation changera ces chemins en fichiers " +"s'il est autorisé à y écrire des fichiers de code intermédiaire. En effet, " +"les importations passent par un renommage final du fichier de code " +"intermédiaire vers sa destination, afin d'éviter les problèmes liés à " +"l'écriture simultanée d'un même fichier par plusieurs processus." #: library/py_compile.rst:59 msgid "" @@ -82,6 +119,10 @@ msgid "" "func:`compile` function. The default of ``-1`` selects the optimization " "level of the current interpreter." msgstr "" +"*optimize* règle le niveau d'optimisation. Ce paramètre est passé " +"directement à la fonction native :func:`compile`. Avec la valeur par défaut " +"de ``-1``, le code intermédiaire hérite du niveau d'optimisation de " +"l'interpréteur courant." #: library/py_compile.rst:63 msgid "" @@ -91,6 +132,11 @@ msgid "" "envvar:`SOURCE_DATE_EPOCH` environment variable is set, otherwise the " "default is :attr:`PycInvalidationMode.TIMESTAMP`." msgstr "" +"*invalidation_mode* précise la manière dont le code intermédiaire produit " +"est invalidé à son exécution. Il doit être un membre de l'énumération :class:" +"`PycInvalidationMode`. La valeur par défaut est :attr:`PycInvalidationMode." +"TIMESTAMP`. Elle passe toutefois à :attr:`PycInvalidationMode.CHECKED_HASH` " +"si la variable d'environnement :envvar:`SOURCE_DATE_EPOCH` est définie." #: library/py_compile.rst:69 msgid "" @@ -98,6 +144,10 @@ msgid "" "default was *file* + ``'c'`` (``'o'`` if optimization was enabled). Also " "added the *optimize* parameter." msgstr "" +"la méthode de choix de destination a changé au profit de celle décrite dans " +"la :pep:`3147`. Auparavant, le nom du fichier de code intermédiaire était " +"*file* + ``'c'`` (ou ``'o'`` lorsque les optimisations étaient actives). Le " +"paramètre *optimize* a été ajouté." #: library/py_compile.rst:74 msgid "" @@ -107,6 +157,12 @@ msgid "" "that :exc:`FileExistsError` is raised if *cfile* is a symlink or non-regular " "file." msgstr "" +"le code a été modifié pour faire appel à :mod:`importlib` dans les " +"opérations d'écriture du code intermédiaire. Ce module se comporte donc " +"exactement comme :mod:`importlib` en ce qui concerne, par exemple, les " +"permissions, ou le renommage final qui garantit une opération atomique. :exc:" +"`FileExistsError` est désormais levée si la destination est un lien " +"symbolique ou n'est pas un véritable fichier." #: library/py_compile.rst:81 msgid "" @@ -115,6 +171,10 @@ msgid "" "*invalidation_mode* will be forced to :attr:`PycInvalidationMode." "CHECKED_HASH`." msgstr "" +"le paramètre *invalidation_mode* a été ajouté comme requis par la :pep:" +"`552`. Si la variable d'environnement :envvar:`SOURCE_DATE_EPOCH` est " +"définie, *invalidation_mode* est ignoré, et :attr:`PycInvalidationMode." +"CHECKED_HASH` s'applique dans tous les cas." #: library/py_compile.rst:87 msgid "" @@ -122,11 +182,13 @@ msgid "" "value of the *invalidation_mode* argument, and determines its default value " "instead." msgstr "" +"La variable d'environnement :envvar:`SOURCE_DATE_EPOCH` n'a plus préséance " +"sur le paramètre *invalidation_mode*, mais détermine seulement le " +"comportement par défaut lorsque ce paramètre n'est pas passé." #: library/py_compile.rst:92 -#, fuzzy msgid "The *quiet* parameter was added." -msgstr "Ajout du paramètre *exit*." +msgstr "ajout du paramètre *quiet*." #: library/py_compile.rst:98 msgid "" @@ -136,6 +198,12 @@ msgid "" "invalidation` for more information on how Python invalidates ``.pyc`` files " "at runtime." msgstr "" +"Énumération des méthodes que l'interpréteur est susceptible d'appliquer afin " +"de déterminer si un fichier de code intermédiaire est périmé par rapport à " +"sa source. Les fichiers ``.pyc`` portent le mode d'invalidation désiré dans " +"leur en-tête. Veuillez-vous référer à :ref:`pyc-invalidation` pour plus " +"d'informations sur la manière dont Python invalide les fichiers ``.pyc`` à " +"l'exécution." #: library/py_compile.rst:108 msgid "" @@ -143,6 +211,9 @@ msgid "" "Python will compare against the metadata of the source file at runtime to " "determine if the ``.pyc`` file needs to be regenerated." msgstr "" +"Le fichier ``.pyc`` contient l'horodatage et la taille de la source. " +"L'interpréteur inspecte les métadonnées du fichier source au moment de " +"l'exécution, et régénère le fichier ``.pyc`` si elles ont changé." #: library/py_compile.rst:114 msgid "" @@ -150,6 +221,9 @@ msgid "" "will compare against the source at runtime to determine if the ``.pyc`` file " "needs to be regenerated." msgstr "" +"Le fichier ``.pyc`` porte une empreinte du code source. À l'exécution, elle " +"est recalculée à partir de la source éventuellement modifiée, et le fichier " +"``.pyc`` est régénéré si les deux empreintes sont différentes." #: library/py_compile.rst:120 msgid "" @@ -157,12 +231,17 @@ msgid "" "file content. However, Python will at runtime assume the ``.pyc`` file is up " "to date and not validate the ``.pyc`` against the source file at all." msgstr "" +"Le principe est le même que :attr:`CHECKED_HASH`, mais à l'exécution, " +"l'interpréteur considère systématiquement que le fichier ``.pyc`` est à " +"jour, sans regarder la source." #: library/py_compile.rst:124 msgid "" "This option is useful when the ``.pycs`` are kept up to date by some system " "external to Python like a build system." msgstr "" +"Cette option est utile lorsque les fichiers ``.pyc`` sont maintenus par un " +"outil externe, comme un système d'intégration." #: library/py_compile.rst:130 msgid "" @@ -173,10 +252,16 @@ msgid "" "If ``'-'`` is the only parameter in args, the list of files is taken from " "standard input." msgstr "" +"Compile et met en cache tous les fichiers de la séquence *args*, ou ceux " +"passés comme arguments en ligne de commande si *args* est ``None``. Cette " +"fonction n'effectue aucune recherche des fichiers sources dans des dossiers. " +"Elle compile simplement les fichiers nommés un par un. Si ``'-'`` est le " +"seul paramètre dans *args*, la liste des fichiers est lue sur l'entrée " +"standard." #: library/py_compile.rst:137 msgid "Added support for ``'-'``." -msgstr "" +msgstr "prise en charge de ``'-'``." #: library/py_compile.rst:140 msgid "" @@ -184,11 +269,15 @@ msgid "" "the files named on the command line. The exit status is nonzero if one of " "the files could not be compiled." msgstr "" +"Lorsque ce module est exécuté en tant que script, la fonction :func:`main` " +"compile tous les fichiers passés comme arguments sur la ligne de commande. " +"Le code de retour vaut zéro si tous ont été compilés sans erreur." #: library/py_compile.rst:147 msgid "Module :mod:`compileall`" -msgstr "" +msgstr "Module :mod:`compileall`" #: library/py_compile.rst:148 msgid "Utilities to compile all Python source files in a directory tree." msgstr "" +"Utilitaires pour compiler des fichiers source Python dans une arborescence"