Traduction de library/configparser.po

dmerejkowsky · dmerejkowsky · commit ffb52b189e85 · 2021-05-16T14:39:04.000+02:00
diff --git a/library/configparser.po b/library/configparser.po
@@ -6,17 +6,19 @@ 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 <EMAIL@ADDRESS>\n"
+"PO-Revision-Date: 2021-05-05 17:39+0200\n"
 "Language-Team: FRENCH <traductions@lists.afpy.org>\n"
 "Language: fr\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
+"Last-Translator: Dimitri Merejkowsky <dimitri@dmerej.info>\n"
+"X-Generator: Poedit 2.4.1\n"
 
 #: library/configparser.rst:2
 msgid ":mod:`configparser` --- Configuration file parser"
 msgstr ""
+":mod:`configparser` --- Lecture et écriture de fichiers de configuration"
 
 #: library/configparser.rst:14
 msgid "**Source code:** :source:`Lib/configparser.py`"
@@ -29,40 +31,55 @@ msgid ""
 "found in Microsoft Windows INI files.  You can use this to write Python "
 "programs which can be customized by end users easily."
 msgstr ""
+"Ce module fournit la classe :class:`ConfigParser`. Cette classe implémente "
+"un langage de configuration basique, proche de ce que l'on peut trouver dans "
+"les fichiers INI de Microsoft Windows. Vous pouvez utiliser ce module pour "
+"écrire des programmes Python qui sont facilement configurables par "
+"l'utilisateur final."
 
 #: library/configparser.rst:31
 msgid ""
 "This library does *not* interpret or write the value-type prefixes used in "
 "the Windows Registry extended version of INI syntax."
 msgstr ""
+"Ce module *n'implémente pas* la version étendue de la syntaxe INI qui permet "
+"de lire ou d'écrire des valeurs dans la base de registre Windows en "
+"utilisant divers préfixes."
 
 #: library/configparser.rst:38
 msgid "Module :mod:`shlex`"
-msgstr ""
+msgstr "Module :mod:`shlex`"
 
 #: library/configparser.rst:37
 msgid ""
 "Support for creating Unix shell-like mini-languages which can be used as an "
 "alternate format for application configuration files."
 msgstr ""
+"Ce module fournit les outils permettant de créer des mini-langages de "
+"programmation ressemblant au shell Unix, qui peuvent être utilisés comme "
+"alternative pour les fichiers de configuration d'une application."
 
 #: library/configparser.rst:41
 msgid "Module :mod:`json`"
-msgstr ""
+msgstr "Module :mod:`json`"
 
 #: library/configparser.rst:41
 msgid ""
 "The json module implements a subset of JavaScript syntax which can also be "
 "used for this purpose."
 msgstr ""
+"Le module json implémente un sous-ensemble de la syntaxe JavaScript, qui "
+"peut aussi être utilisée à cet effet."
 
 #: library/configparser.rst:51
 msgid "Quick Start"
-msgstr ""
+msgstr "Premiers pas"
 
 #: library/configparser.rst:53
 msgid "Let's take a very basic configuration file that looks like this:"
 msgstr ""
+"Prenons pour exemple un fichier de configuration très simple ressemblant à "
+"ceci :"
 
 #: library/configparser.rst:70
 msgid ""
@@ -72,19 +89,32 @@ msgid ""
 "classes can read and write such files.  Let's start by creating the above "
 "configuration file programmatically."
 msgstr ""
+"La structure des finchiers INI est décrite dans la `section suivante "
+"<#supported-ini-file-structure>`_. En bref,  chaque fichier est constitué de "
+"sections, chacune des sections comprenant des clés associées à des valeurs. "
+"Les classes du module :mod:`configparser` peuvent écrire et lire de tels "
+"fichiers. Commençons par le code qui permet de générer le fichier ci-dessus."
 
 #: library/configparser.rst:94
 msgid ""
 "As you can see, we can treat a config parser much like a dictionary. There "
 "are differences, `outlined later <#mapping-protocol-access>`_, but the "
 "behavior is very close to what you would expect from a dictionary."
 msgstr ""
+"Comme vous pouvez le voir, nous pouvons manipuler l'instance retournée par "
+"l'analyse du fichier de configuration comme s'il s'agissait d'un "
+"dictionnaire. Il y a des différences, comme `explicité ci-dessous <#mapping-"
+"protocol-access>`_, mais le comportement de l'instance est très proche de ce "
+"que vous pourriez attendre d'un dictionnaire."
 
 #: library/configparser.rst:98
 msgid ""
 "Now that we have created and saved a configuration file, let's read it back "
 "and explore the data it holds."
 msgstr ""
+"Nous venons de créer et sauvegarder un fichier de configuration. Voyons "
+"maintenant comment nous pouvons le lire et accéder aux données qu'il "
+"contient."
 
 #: library/configparser.rst:133
 msgid ""
@@ -93,17 +123,26 @@ msgid ""
 "other sections [1]_.  Note also that keys in sections are case-insensitive "
 "and stored in lowercase [1]_."
 msgstr ""
+"Comme vous le voyez, l'API est assez simple à utiliser. La seule partie un "
+"peu magique concerne la section ``DEFAULT``, qui fournit les valeurs par "
+"défaut pour toutes les autres sections [1]_. Notez également que les clés à "
+"l’intérieur des sections ne sont pas sensibles à la casse et qu'elles sont "
+"stockées en minuscules. [1]_."
 
 #: library/configparser.rst:140
 msgid "Supported Datatypes"
-msgstr ""
+msgstr "Types de données prises en charge"
 
 #: library/configparser.rst:142
 msgid ""
 "Config parsers do not guess datatypes of values in configuration files, "
 "always storing them internally as strings.  This means that if you need "
 "other datatypes, you should convert on your own:"
 msgstr ""
+"Les lecteurs de configuration n'essayent jamais de deviner le type des "
+"valeur présentes dans les fichiers de configuration, et elles sont toujours "
+"stockées en tant que chaînes de caractères. Ainsi, si vous avez besoin d'un "
+"type différent, vous devez effectuer la conversion vous-même :"
 
 #: library/configparser.rst:153
 msgid ""
@@ -115,6 +154,16 @@ msgid ""
 "and recognizes Boolean values from ``'yes'``/``'no'``, ``'on'``/``'off'``, "
 "``'true'``/``'false'`` and ``'1'``/``'0'`` [1]_.  For example:"
 msgstr ""
+"Puisque que cette tâche doit être fréquemment accomplie, les lecteurs de "
+"configurations fournissent un ensemble d'accesseurs permettant de gérer les "
+"entiers, les flottants et les booléens plus facilement. Le cas des booléens "
+"est le plus pertinent. En effet, vous ne pouvez pas vous contenter "
+"d'utiliser la fonction ``bool()`` directement puisque ``bool('False')`` "
+"renvoie ``True``. C'est pourquoi les lecteurs fournissent également la "
+"méthode :meth:`~ConfigParser.getboolean`. Cette méthode n'est pas sensible à "
+"la casse et interprète correctement les valeurs booléennes associées aux "
+"chaînes de caractères comme ``'yes'``/``'no'``, ``'on'``/``'off'``, "
+"``'true'``/``'false'`` et ``'1'``/``'0'`` [1]_. Par exemple :"
 
 #: library/configparser.rst:170
 msgid ""
@@ -123,16 +172,22 @@ msgid ""
 "methods.  You can register your own converters and customize the provided "
 "ones. [1]_"
 msgstr ""
+"En plus de :meth:`~ConfigParser.getboolean`, les lecteurs de configurations "
+"fournissent également des méthodes similaires comme :meth:`~ConfigParser."
+"getint` et :meth:`~ConfigParser.getfloat`. Vous pouvez enregistrer vos "
+"propres convertisseurs et personnaliser ceux déjà fournis. [1]_gim"
 
 #: library/configparser.rst:176
 msgid "Fallback Values"
-msgstr ""
+msgstr "Valeurs de substitution"
 
 #: library/configparser.rst:178
 msgid ""
 "As with a dictionary, you can use a section's :meth:`get` method to provide "
 "fallback values:"
 msgstr ""
+"Comme pour un dictionnaire, vous pouvez utilise la méthode :meth:`get` d'une "
+"section en spécifiant une valeur de substitution :"
 
 #: library/configparser.rst:191
 msgid ""
@@ -142,6 +197,11 @@ msgid ""
 "``'topsecret.server.com'``, we will always get the default, even if we "
 "specify a fallback:"
 msgstr ""
+"Notez que les valeurs par défaut sont prioritaires par rapport aux valeurs "
+"de substitution. Dans note exemple, la valeur de la clé ``CompressionLevel`` "
+"était spécifiée uniquement dans la section. ``DEFAULT``. Si nous essayons de "
+"la récupérer depuis la section ``'topsecret.server.com'``, nous obtenons la "
+"valeur par défaut, même en ayant spécifié une valeur de substitution :"
 
 #: library/configparser.rst:202
 msgid ""
@@ -150,17 +210,24 @@ msgid ""
 "compatibility.  When using this method, a fallback value can be provided via "
 "the ``fallback`` keyword-only argument:"
 msgstr ""
+"Il est important de savoir que la méthode :meth:`get` fournie une interface "
+"particulière et plus complexe, qui est maintenue pour des raisons de "
+"rétrocompatibilité. Vous pouvez fournir une valeur de substitution via "
+"l'argument obligatoirement nommé ``fallback``:"
 
 #: library/configparser.rst:213
 msgid ""
 "The same ``fallback`` argument can be used with the :meth:`~ConfigParser."
 "getint`, :meth:`~ConfigParser.getfloat` and :meth:`~ConfigParser.getboolean` "
 "methods, for example:"
 msgstr ""
+"L'argument ``fallback`` peut être utilisé de la même façon avec les "
+"méthodes :meth:`~ConfigParser.getint`, :meth:`~ConfigParser.getfloat` et :"
+"meth:`~ConfigParser.getboolean`. Par exemple :"
 
 #: library/configparser.rst:229
 msgid "Supported INI File Structure"
-msgstr ""
+msgstr "Structure des fichiers INI prise en change"
 
 #: library/configparser.rst:231
 msgid ""
@@ -173,28 +240,46 @@ msgid ""
 "indented deeper than the first line of the value.  Depending on the parser's "
 "mode, blank lines may be treated as parts of multiline values or ignored."
 msgstr ""
+"Un fichier de configuration est constitué de sections. Chacune des sections "
+"commence par un en-tête ``[section]`, suivi d'une liste de définitions clés/"
+"valeurs séparées par une chaîne de caractères spécifique (``=`` ou ``:`` par "
+"défaut [1]_). Par défaut, les noms des sections sont sensibles à la casse "
+"mais pas les clés [1]_. Les caractères d'espacement en début et en fin des "
+"clés et des valeurs sont supprimés. Les valeurs peuvent être absentes, "
+"auquel cas il est possible d'omettre le délimiteur entre clé et valeur. Les "
+"valeurs peuvent s'étendre sur plusieurs lignes, à partir du moment où les "
+"lignes supplémentaires sont plus indentées que la première ligne. Les lignes "
+"vides peuvent être considérées comme faisant partie des valeurs multi "
+"lignes, en fonction du mode de lecture utilisé."
 
 #: library/configparser.rst:240
 msgid ""
 "Configuration files may include comments, prefixed by specific characters "
 "(``#`` and ``;`` by default [1]_).  Comments may appear on their own on an "
 "otherwise empty line, possibly indented. [1]_"
 msgstr ""
+"Les fichiers de configuration peuvent contenir des commentaires, préfixés "
+"par des caractères spécifiques (``#`` et ``;`` par défaut [1]_). Les "
+"commentaires peuvent apparaître en remplacement d'une ligne vide, et peuvent "
+"aussi être indentés. [1]_"
 
 #: library/configparser.rst:307
 msgid "For example:"
 msgstr "Par exemple :"
 
 #: library/configparser.rst:292
 msgid "Interpolation of values"
-msgstr ""
+msgstr "Interpolation des valeurs"
 
 #: library/configparser.rst:294
 msgid ""
 "On top of the core functionality, :class:`ConfigParser` supports "
 "interpolation.  This means values can be preprocessed before returning them "
 "from ``get()`` calls."
 msgstr ""
+"La classe :class:`ConfigParser` prend en charge l’interpolation, en plus des "
+"fonctionnalités de base. Cela signifie que les valeurs peuvent être traitées "
+"avant d'être retournées par les appels aux méthodes ``get()``."
 
 #: library/configparser.rst:302
 msgid ""
@@ -203,6 +288,11 @@ msgid ""
 "or values in the special default section [1]_.  Additional default values "
 "can be provided on initialization."
 msgstr ""
+"L'implémentation par défaut utilisée par la classe :class:`ConfigParser`. "
+"Celle-ci permet aux valeurs de contenir des chaînes de formatage se référant "
+"à d'autres valeurs dans la même section, ou bien à des valeurs dans la "
+"section spéciale par défaut [1]_. D'autres valeurs par défaut peuvent être "
+"fournies au moment de l'initialisation de cette classe."
 
 #: library/configparser.rst:319
 msgid ""
@@ -213,13 +303,23 @@ msgid ""
 "keys used in the chain of references do not have to be specified in any "
 "specific order in the configuration file."
 msgstr ""
+"Dans l'exemple ci-dessus, une classe :class:`Configparser` dont l'attribut "
+"*interpolation* vaudrait ``BasicInterpolation()`` interpréterait la chaîne "
+"de caractère``%(home_dirs)`` en utilisant la valeur de la clé ``home_dir`` "
+"(``/Users`` dans ce cas). ``%(my_dir)s`` serait interprétée comme ``/Users/"
+"lumberjack.``. Les interpolations sont effectuées à la volée. Ainsi, les "
+"clés utilisées comme référence à l’intérieur des chaîne de formatage peuvent "
+"être définies dans le fichier de configuration dans n'importe quel ordre."
 
 #: library/configparser.rst:326
 msgid ""
 "With ``interpolation`` set to ``None``, the parser would simply return ``"
 "%(my_dir)s/Pictures`` as the value of ``my_pictures`` and ``%(home_dir)s/"
 "lumberjack`` as the value of ``my_dir``."
 msgstr ""
+"Si l'attribut ``interpolation`` valait ``None``, le lecteur retournerait ``"
+"%(my_dir)s/Pictures`` comme valeur pour ``my_pictures`` et ``%(home_dir)s/"
+"lumberjack`` comme valeur pour ``my_dir``."
 
 #: library/configparser.rst:334
 msgid ""
@@ -230,16 +330,26 @@ msgid ""
 "`` part is omitted, interpolation defaults to the current section (and "
 "possibly the default values from the special section)."
 msgstr ""
+"Une autre façon de gérer l'interpolation utilisant une syntaxe plus avancée, "
+"utilisée par exemple par ``zc.buildout``. Cette syntaxe étendue utilise la "
+"chaîne de formatage ``{section:option}}`` pour désigner une valeur "
+"appartenant à une autre section. L'interpolation peut s'étendre sur "
+"plusieurs niveaux. Par commodité, si la partie ``{section}`` est absente, "
+"l'interpolation utilise la section courante par défaut (et le cas échéant, "
+"les valeurs de la section par défaut spéciale)."
 
 #: library/configparser.rst:341
 msgid ""
 "For example, the configuration specified above with basic interpolation, "
 "would look like this with extended interpolation:"
 msgstr ""
+"Voici comment transformer la configuration ci-dessus avec la syntaxe "
+"d'interpolation étendue :"
 
 #: library/configparser.rst:354
 msgid "Values from other sections can be fetched as well:"
 msgstr ""
+"Vous pouvez également récupérer des valeurs appartenant aux autres sections :"
 
 #: library/configparser.rst:376
 msgid "Mapping Protocol Access"
@@ -570,6 +680,12 @@ msgid ""
 "``'off'``.  You can override this by specifying a custom dictionary of "
 "strings and their Boolean outcomes. For example:"
 msgstr ""
+"Par défaut, la méthode :meth:`~ConfigParser.getboolean` considère les "
+"valeurs suivantes comme vraies : `'1'``, ``'yes'``, ``'true'``, ``'on'``, et "
+"les valeurs suivantes comme fausses : ``'0'``, ``'no'``, ``'false'``, "
+"``'off'``. Vous pouvez changer ce comportement en spécifiant votre propre "
+"dictionnaire associant des chaînes de caractères à des valeurs booléennes. "
+"Par exemple :"
 
 #: library/configparser.rst:695
 msgid ""
