traduction 100% de library/dataclasses.po (#1749)

lythari · web-flow · commit 8acf233c16b0 · 2021-10-29T15:11:03.000+02:00
diff --git a/library/dataclasses.po b/library/dataclasses.po
@@ -6,14 +6,14 @@ msgstr ""
 "Project-Id-Version: Python 3\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2021-09-23 16:16+0200\n"
-"PO-Revision-Date: 2021-09-21 09:00+0200\n"
-"Last-Translator: Jean Abou Samra <jean@abou-samra.fr>\n"
+"PO-Revision-Date: 2021-10-28 11:44+0200\n"
+"Last-Translator: David GIRAUD <davidgiraud@protonmail.com>\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"
-"X-Generator: Poedit 2.4.1\n"
+"X-Generator: Poedit 3.0\n"
 
 #: library/dataclasses.rst:2
 msgid ":mod:`dataclasses` --- Data Classes"
@@ -46,7 +46,7 @@ msgstr ""
 #: library/dataclasses.rst:34
 msgid "will add, among other things, a :meth:`__init__` that looks like::"
 msgstr ""
-"Ce code ajoute à la classe, entre autres choses, une méthode :meth:"
+"ce code ajoute à la classe, entre autres choses, une méthode :meth:"
 "`__init__` qui ressemble à ::"
 
 #: library/dataclasses.rst:41
@@ -59,7 +59,7 @@ msgstr ""
 
 #: library/dataclasses.rst:47
 msgid "Module contents"
-msgstr ""
+msgstr "Classe de données"
 
 #: library/dataclasses.rst:51
 msgid ""
@@ -306,6 +306,11 @@ msgid ""
 "If false, or if ``__match_args__`` is already defined in the class, then "
 "``__match_args__`` will not be generated."
 msgstr ""
+"*match_args* : si vrai (``True`` est la valeur par défaut), le *n*-uplet "
+"``__match_args__`` est créé automatiquement depuis la liste des paramètres "
+"de la méthode :meth:`__init__` générée (même si :meth:`__init__` n'est pas "
+"générée, voir ci-dessus). Si faux ou si ``__match_args__`` est déjà défini "
+"dans la classe alors ``__match_args__`` n'est pas créé."
 
 #: library/dataclasses.rst:173
 msgid ""
@@ -317,20 +322,26 @@ msgid ""
 "term:`parameter` glossary entry for details.  Also see the :const:`KW_ONLY` "
 "section."
 msgstr ""
+"*kw_only* : si vrai (``False`` est la valeur par défaut) alors tous les "
+"champs sont marqués comme exclusivement nommés. Si un champ est marqué comme "
+"exclusivement nommé, le seul impact est que le champ de la méthode :meth:"
+"`__init__` générée devra être explicitement nommé lors de l'appel de la "
+"méthode :meth:`__init__`. Il n'y a aucun autre effet dans les autres aspects "
+"des classes de données. Voir l'entrée :term:`paramètre <parameter>` du "
+"glossaire pour plus d'informations. Voir également la section :const:"
+"`KW_ONLY`."
 
 #: library/dataclasses.rst:184
-#, fuzzy
 msgid ""
 "``slots``: If true (the default is ``False``), :attr:`__slots__` attribute "
 "will be generated and new class will be returned instead of the original "
 "one. If :attr:`__slots__` is already defined in the class, then :exc:"
 "`TypeError` is raised."
 msgstr ""
-"*frozen* : si vrai (faux par défaut), assigner une valeur à un champ lève "
-"une exception.  Cela simule le comportement des instances figées en lecture "
-"seule.  Si la méthode :meth:`__setattr__` ou :meth:`__delattr__` est définie "
-"sur la classe, alors une :exc:`TypeError` est levée.  Voir la discussion ci-"
-"dessous."
+"*slot* : si vrai (``False`` est la valeur par défaut), l'attribut :attr:"
+"`__slots__` est généré et une nouvelle classe est renvoyée à la place de "
+"celle d'origine. Si :attr:`__slots__` est déjà défini dans la classe alors "
+"une :exc:`TypeError` est levée."
 
 #: library/dataclasses.rst:191
 msgid ""
@@ -373,19 +384,18 @@ msgstr ""
 "`field` à la place de la valeur par défaut, comme dans cet exemple :"
 
 #: library/dataclasses.rst:223
-#, fuzzy
 msgid ""
 "As shown above, the :const:`MISSING` value is a sentinel object used to "
 "detect if some parameters are provided by the user. This sentinel is used "
 "because ``None`` is a valid value for some parameters with a distinct "
 "meaning.  No code should directly use the :const:`MISSING` value."
 msgstr ""
-"Comme le montre la signature, la valeur ``MISSING`` est une valeur "
-"sentinelle. Elle permet de déterminer si les paramètres ``default`` et "
-"``default_factory`` ont été passés explicitement ou non. ``None`` ne "
-"conviendrait pas puisque c'est une valeur possible pour ``default``. La "
-"sentinelle ``MISSING`` est interne au module et ne doit pas être utilisée "
-"dans vos programmes."
+"Comme le montre la signature, la constante :const:`MISSING` est une valeur "
+"sentinelle pour déterminer si des paramètres ont été fournis par "
+"l'utilisateur. ``None`` ne conviendrait pas puisque c'est une valeur avec un "
+"sens qui peut être différent pour certains paramètres. La sentinelle :const:"
+"`MISSING` est interne au module et ne doit pas être utilisée dans vos "
+"programmes."
 
 #: library/dataclasses.rst:228
 msgid "The parameters to :func:`field` are:"
@@ -489,6 +499,9 @@ msgid ""
 "``kw_only``: If true, this field will be marked as keyword-only. This is "
 "used when the generated :meth:`__init__` method's parameters are computed."
 msgstr ""
+"``kw_only`` : Si vrai ce champ est marqué comme exclusivement nommé. Cela "
+"est utilisé lors du traitement des paramètres de la méthode :meth:`__init__` "
+"générée."
 
 #: library/dataclasses.rst:277
 msgid ""
@@ -532,22 +545,21 @@ msgstr ""
 
 #: library/dataclasses.rst:304
 msgid "``name``: The name of the field."
-msgstr "*name* : le nom du champ ;"
+msgstr "*name* : le nom du champ  ;"
 
 #: library/dataclasses.rst:306
 msgid "``type``: The type of the field."
-msgstr "*type* : le type associé au champ par l'annotation ;"
+msgstr "*type* : le type associé au champ par l'annotation  ;"
 
 #: library/dataclasses.rst:308
-#, fuzzy
 msgid ""
 "``default``, ``default_factory``, ``init``, ``repr``, ``hash``, ``compare``, "
 "``metadata``, and ``kw_only`` have the identical meaning and values as they "
 "do in the :func:`field` function."
 msgstr ""
-"*default*, *default_factory*, *init*, *repr*, *hash*, *compare* et "
-"*metadata*, qui correspondent aux paramètres de :func:`field` et en prennent "
-"les valeurs."
+"*default*, *default_factory*, *init*, *repr*, *hash*, *compare*, *metadata* "
+"et *kw_only* qui correspondent aux paramètres de :func:`field` et en "
+"prennent les valeurs."
 
 #: library/dataclasses.rst:312
 msgid ""
@@ -606,7 +618,6 @@ msgid "Continuing from the previous example::"
 msgstr "Pour continuer l'exemple précédent :"
 
 #: library/dataclasses.rst:362
-#, fuzzy
 msgid ""
 "Creates a new dataclass with name ``cls_name``, fields as defined in "
 "``fields``, base classes as given in ``bases``, and initialized with a "
@@ -623,8 +634,9 @@ msgstr ""
 "forme la plus générale d'un élément de *fields* est un triplet ``(nom, type, "
 "objet_Field)``. Le troisième élément peut être omis. On peut aussi passer un "
 "simple nom, auquel cas le type sera ``typing.Any``. Les paramètres restants, "
-"à savoir *init*, *repr*, *eq*, *order*, *unsafe_hash* et *frozen*, sont les "
-"mêmes que dans :func:`dataclass`."
+"à savoir *init*, *repr*, *eq*, *order*, *unsafe_hash*, *frozen*, "
+"*march_args*, *kw_only* et *slots*, sont les mêmes que dans :func:"
+"`dataclass`."
 
 #: library/dataclasses.rst:372
 msgid ""
@@ -640,7 +652,7 @@ msgstr ""
 
 #: library/dataclasses.rst:384
 msgid "Is equivalent to::"
-msgstr "est équivalent à :"
+msgstr "est équivalent à ::"
 
 #: library/dataclasses.rst:397
 msgid ""
@@ -717,11 +729,13 @@ msgid ""
 msgstr ""
 "Pour vérifier qu'un objet *obj* est une instance d'une classe de données, et "
 "non pas lui-même une classe de données, ajoutez le test ``not "
-"isinstance(obj, type)``."
+"isinstance(obj, type)`` ::"
 
 #: library/dataclasses.rst:437
 msgid "A sentinel value signifying a missing default or default_factory."
 msgstr ""
+"Une valeur sentinelle pour dénoter l'absence de *default* ou "
+"*default_factory*."
 
 #: library/dataclasses.rst:441
 msgid ""
@@ -733,18 +747,29 @@ msgid ""
 "meth:`__init__` parameters that must be specified as keywords when the class "
 "is instantiated."
 msgstr ""
+"Une valeur sentinelle utilisée en tant qu'annotation de type. Chaque "
+"attribut situé après un pseudo-champ ayant pour type la constante :const:"
+"`KW_ONLY` est marqué comme champ exclusivement nommé. Notez que le pseudo-"
+"champ ayant pour type la constante :const:`KW_ONLY` est par ailleurs "
+"complètement ignoré. Par convention le nom ``_`` est utilisé pour "
+"l'attribut :const:`KW_ONLY`. Les paramètres de la méthode :meth:`__init__` "
+"exclusivement nommés doivent être spécifiés par leur nom lors de "
+"l'instanciation de la classe."
 
 #: library/dataclasses.rst:450
 msgid ""
 "In this example, the fields ``y`` and ``z`` will be marked as keyword-only "
 "fields::"
 msgstr ""
+"Dans cette exemple ``y`` et ``z`` sont marqués comme exclusivement nommés ::"
 
 #: library/dataclasses.rst:461
 msgid ""
 "In a single dataclass, it is an error to specify more than one field whose "
 "type is :const:`KW_ONLY`."
 msgstr ""
+"Une erreur est levée s'il y a plus d'un champ de type :const:`KW_ONLY` dans "
+"une unique classe de données."
 
 #: library/dataclasses.rst:466
 msgid ""
@@ -945,6 +970,7 @@ msgstr "La méthode :meth:`__init__` générée pour ``C`` ressemble à :"
 #: library/dataclasses.rst:604
 msgid "Re-ordering of keyword-only parameters in :meth:`__init__`"
 msgstr ""
+"Réarrangement des paramètres exclusivement nommés dans :meth:`__init__`"
 
 #: library/dataclasses.rst:606
 msgid ""
@@ -953,30 +979,42 @@ msgid ""
 "parameters.  This is a requirement of how keyword-only parameters are "
 "implemented in Python: they must come after non-keyword-only parameters."
 msgstr ""
+"Lorsque les paramètres requis pour :meth:`__init__` sont préparés, tout ceux "
+"marqués comme exclusivement nommé sont déplacés pour être positionnés après "
+"tous ceux non exclusivement nommés. Ceci est un prérequis de la façon dont "
+"les paramètres exclusivement nommés sont implémentés en Python : ils sont "
+"après les paramètres non exclusivement nommés."
 
 #: library/dataclasses.rst:612
 msgid ""
 "In this example, ``Base.y``, ``Base.w``, and ``D.t`` are keyword-only "
 "fields, and ``Base.x`` and ``D.z`` are regular fields::"
 msgstr ""
+"Dans cet exemple, ``Base.y``, ``Base.w``, et ``D.t`` sont des champs "
+"exclusivement nommés alors que``Base.x`` et ``D.z`` sont des champs "
+"normaux ::"
 
 #: library/dataclasses.rst:627
-#, fuzzy
 msgid "The generated :meth:`__init__` method for ``D`` will look like::"
-msgstr "La méthode :meth:`__init__` générée pour ``C`` ressemble à :"
+msgstr "La méthode :meth:`__init__` générée pour ``D`` ressemble à  ::"
 
 #: library/dataclasses.rst:631
 msgid ""
 "Note that the parameters have been re-ordered from how they appear in the "
 "list of fields: parameters derived from regular fields are followed by "
 "parameters derived from keyword-only fields."
 msgstr ""
+"Les paramètres ont été réarrangés par rapport à leur ordre d'apparition dans "
+"la liste des champs : les paramètres provenant des attributs normaux sont "
+"suivis par les paramètres qui proviennent des attributs exclusivement nommés."
 
 #: library/dataclasses.rst:635
 msgid ""
 "The relative ordering of keyword-only parameters is maintained in the re-"
 "ordered :meth:`__init__` parameter list."
 msgstr ""
+"L'ordre relatif des paramètres exclusivement nommés est conservé par le "
+"réarrangement des paramètres d'\\ :meth:`__init__`."
 
 #: library/dataclasses.rst:640
 msgid "Default factory functions"
@@ -1033,7 +1071,6 @@ msgid "it would generate code similar to::"
 msgstr "il générerait un code équivalent à :"
 
 #: library/dataclasses.rst:694
-#, fuzzy
 msgid ""
 "This has the same issue as the original example using class ``C``. That is, "
 "two instances of class ``D`` that do not specify a value for ``x`` when "
@@ -1047,13 +1084,13 @@ msgid ""
 msgstr ""
 "On se retrouve avec le même problème qu'au premier exemple avec la classe "
 "``C``. Les classes de données étant créées comme toutes les autres classes "
-"Python, leur comportement est identique. Ainsi, deux instances séparées de "
-"``D`` où l'attribut ``x`` a été laissé à sa valeur par défaut partagent le "
-"même objet dans cet attribut. Il n'y a aucun moyen pour les classes de "
-"données de détecter cette situation en général. C'est pourquoi la "
-"construction d'une classe de données lève :exc:`TypeError` si une valeur par "
-"défaut est de type ``list``, ``dict`` ou ``set``. Cette solution n'est pas "
-"parfaite, mais permet d'éviter la majorité des erreurs."
+"Python, leur comportement est identique. Ainsi, deux instances distinctes de "
+"``D`` où l'attribut ``x`` a été laissé à sa valeur par défaut partagent la "
+"même copie de l'objet ``x``. Il n'y a aucun moyen commun de détecter cette "
+"situation. C'est pourquoi le décorateur :func:`dataclass` lève :exc:"
+"`TypeError` si une valeur par défaut est de type ``list``, ``dict`` ou "
+"``set`` est détectée. Cette solution n'est pas parfaite, mais permet "
+"d'éviter la majorité des erreurs."
 
 #: library/dataclasses.rst:705
 msgid ""
