Traduction de library/graphlib.po

(cherry picked from commit 43af509)

Author: Jeff D

library/graphlib.po

@@ -7,7 +7,7 @@ msgstr ""
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2021-09-23 16:16+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
-"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Last-Translator: Jeffd <dev@zest-labs.fr>\n"
 "Language-Team: FRENCH <traductions@lists.afpy.org>\n"
 "Language: fr\n"
 "MIME-Version: 1.0\n"
@@ -16,15 +16,15 @@ msgstr ""
 
 #: library/graphlib.rst:2
 msgid ":mod:`graphlib` --- Functionality to operate with graph-like structures"
-msgstr ""
+msgstr ":mod:`graphlib` --- Fonctionnalités pour travailler avec des structures de type graphe"
 
 #: library/graphlib.rst:8
 msgid "**Source code:** :source:`Lib/graphlib.py`"
-msgstr ""
+msgstr "**Code-source:** :source:`Lib/graphlib.py`"
 
 #: library/graphlib.rst:20
 msgid "Provides functionality to topologically sort a graph of hashable nodes."
-msgstr ""
+msgstr "Fournit les fonctionnalités pour trier topologiquement un graphe de noeuds hashables."
 
 #: library/graphlib.rst:22
 msgid ""
@@ -37,6 +37,14 @@ msgid ""
 "topological ordering is possible if and only if the graph has no directed "
 "cycles, that is, if it is a directed acyclic graph."
 msgstr ""
+"L'ordre topologique est un ordre linéaire des sommets d'un graphe afin que "
+"pour chaque arête u -> v d'un sommet u à un sommet v, cet ordre "
+"va placer le sommet u avant le sommet v. Par exemple, les sommets d'un "
+"graphe pourraient représenter des tâches à faire et les arêtes pourraient "
+"représenter les contraintes d'une tâche qui doit être réalisée avant une "
+"autre. Dans cet exemple, un ordre topologique est simplement une sequence "
+"valide pour ces tâches. Cet ordre n'est possible si et seulement si le graphe "
+"n'a pas de circuit, c'est à dire si c'est un graphe orienté acyclique."
 
 #: library/graphlib.rst:31
 msgid ""
@@ -46,58 +54,81 @@ msgid ""
 "nodes that have edges that point to the value in the key). Additional nodes "
 "can be added to the graph using the :meth:`~TopologicalSorter.add` method."
 msgstr ""
+"Si l'argument optionnel *graph* est fournit, cela doit être un dictionnaire "
+"représentant un graphe acyclique avec comme clés les noeuds et comme "
+"valeur des itérables de tous les prédécesseurs de ce noeud dans le graphe "
+"(les noeuds qui ont des arêtes qui pointent vers la valeur de la clé). "
+"L'ajout de noeuds peut être fait en utilisant la méthode "
+":meth:`~TopologicalSorter.add`"
 
 #: library/graphlib.rst:37
 msgid ""
 "In the general case, the steps required to perform the sorting of a given "
 "graph are as follows:"
 msgstr ""
+"De manière générale, les étapes nécessaires pour trier un graphe donné "
+"sont les suivantes:"
 
 #: library/graphlib.rst:40
 msgid ""
 "Create an instance of the :class:`TopologicalSorter` with an optional "
 "initial graph."
-msgstr ""
+msgstr "Créer une instance de la classe :class:`TopologicalSorter` avec "
+"éventuellement un graphe de base."
 
 #: library/graphlib.rst:42
 msgid "Add additional nodes to the graph."
-msgstr ""
+msgstr "Ajouter un autre noeud au graphe."
 
 #: library/graphlib.rst:43
 msgid "Call :meth:`~TopologicalSorter.prepare` on the graph."
-msgstr ""
+msgstr "Appeler :meth:`~TopologicalSorter.prepare` sur le graphe."
 
 #: library/graphlib.rst:44
 msgid ""
 "While :meth:`~TopologicalSorter.is_active` is ``True``, iterate over the "
 "nodes returned by :meth:`~TopologicalSorter.get_ready` and process them. "
 "Call :meth:`~TopologicalSorter.done` on each node as it finishes processing."
 msgstr ""
+"Tant que :meth:`~TopologicalSorter.is_active` est à ``True``, on itère sur les "
+"noeuds retournés par :meth:`~TopologicalSorter.get_ready` pour les traiter. "
+"L'appel vers :meth:`~TopologicalSorter.done` sur chaque noeud permet de "
+"terminer le traitement."
 
 #: library/graphlib.rst:49
 msgid ""
 "In case just an immediate sorting of the nodes in the graph is required and "
 "no parallelism is involved, the convenience method :meth:`TopologicalSorter."
 "static_order` can be used directly:"
 msgstr ""
+"Dans le cas où un tri des noeuds du graphe est requis et qu'aucun "
+"parallélisme n'est impliqué, la méthode :meth:`TopologicalSorter.static_order` "
+"peut être utilisée directement:"
 
 #: library/graphlib.rst:60
 msgid ""
 "The class is designed to easily support parallel processing of the nodes as "
 "they become ready. For instance::"
 msgstr ""
+"La classe est conçue afin de supporter facilement le traitement en parallele "
+"des noeuds quand ils deviennent disponibles. Par exemple ::"
 
 #: library/graphlib.rst:87
 msgid ""
 "Add a new node and its predecessors to the graph. Both the *node* and all "
 "elements in *predecessors* must be hashable."
 msgstr ""
+"Ajoute un nouveau noeud et son prédécesseur dans le graphe. Le *noeud* "
+"ainsi que tous les élements dans *predecessors* doivent être hashables."
 
 #: library/graphlib.rst:90
 msgid ""
 "If called multiple times with the same node argument, the set of "
 "dependencies will be the union of all dependencies passed in."
 msgstr ""
+"Si il est appelé plusieurs fois avec le même noeud en tant qu'argument,"
+"le set de dépendances sera l'union de toute les dépendances qui auront "
+"été transmises."
 
 #: library/graphlib.rst:93
 msgid ""
@@ -106,11 +137,16 @@ msgid ""
 "provided before is included among *predecessors* it will be automatically "
 "added to the graph with no predecessors of its own."
 msgstr ""
+"Il est possible d'ajouter un noeud sans dépendance (*predecessors* n'est "
+"pas fournit) ou de fournir une dépendance deux fois. Si un noeud qui n'a "
+"jamais été fournit auparavant est inclu dans *predecessors* il sera "
+"automatiquement ajouté au graphe sans prédecesseur lui-même."
 
 #: library/graphlib.rst:98
 msgid ""
 "Raises :exc:`ValueError` if called after :meth:`~TopologicalSorter.prepare`."
 msgstr ""
+"Lève une :exc:`ValueError` si c'est apellé après :meth:`~TopologicalSorter.prepare`."
 
 #: library/graphlib.rst:102
 msgid ""
@@ -121,39 +157,60 @@ msgid ""
 "be modified, and therefore no more nodes can be added using :meth:"
 "`~TopologicalSorter.add`."
 msgstr ""
+"Indique que le graphe est terminé et vérifie les circuits du graphes. Si un "
+"circuit est détecté, une :exc:`CycleError` sera levée mais :meth:"
+"`~TopologicalSorter.get_ready` peut encore être utilisée pour obtenir autant "
+"de noeud que possible avant que les circuits bloquent la progression."
+"Apres un appel de cette fonction, le graphe ne peut pas être modifié, et donc "
+"aucun noeud ne pourra être ajouté avec `~TopologicalSorter.add`."
 
 #: library/graphlib.rst:111
 msgid ""
 "Returns ``True`` if more progress can be made and ``False`` otherwise. "
-"Progress can be made if cycles do not block the resolution and either there "
+"Progress can be made if cycles do not block the resolution antd either there "
 "are still nodes ready that haven't yet been returned by :meth:"
 "`TopologicalSorter.get_ready` or the number of nodes marked :meth:"
 "`TopologicalSorter.done` is less than the number that have been returned by :"
 "meth:`TopologicalSorter.get_ready`."
 msgstr ""
+"Retourne ``True`` si des une progression peut être faite et ``False`` dans "
+"le cas contraire. La progression est possible si des circuits ne bloquent pas "
+"la résolution ou qu'il reste des noeuds prêts qui n'ont pas encore été "
+"retournés par :meth:`TopologicalSorter.get_ready` ou que le nombre de noeuds "
+"marqués :meth:`TopologicalSorter.done` est inférieur au nombre qui a été "
+"retourné par :meth:`TopologicalSorter.get_ready`."
+
 
 #: library/graphlib.rst:118
 msgid ""
 "The :meth:`~TopologicalSorter.__bool__` method of this class defers to this "
 "function, so instead of::"
 msgstr ""
+"La méthode :meth:`~TopologicalSorter.__bool__` de cette classe renvoie à "
+"cette function donc au lieu de::"
 
 #: library/graphlib.rst:124
 msgid "it is possible to simply do::"
-msgstr ""
+msgstr "il est plus simple de faire::"
 
 #: library/graphlib.rst:152
 msgid ""
 "Raises :exc:`ValueError` if called without calling :meth:`~TopologicalSorter."
 "prepare` previously."
 msgstr ""
+"Lève une :exc:`ValueError` si l'appel de :meth:`~TopologicalSorter.prepare` "
+"n'a pas été fait au préalable."
 
 #: library/graphlib.rst:134
 msgid ""
 "Marks a set of nodes returned by :meth:`TopologicalSorter.get_ready` as "
 "processed, unblocking any successor of each node in *nodes* for being "
 "returned in the future by a call to :meth:`TopologicalSorter.get_ready`."
 msgstr ""
+"Marque un ensemble de noeuds retourné par :meth:`TopologicalSorter.get_ready` "
+"en tant que traité, débloquant tout successeur de chaque noeud de *nodes* "
+"d'être retourné dans le futur lors de l'appel à :meth:`~TopologicalSorter."
+"get_ready`."
 
 #: library/graphlib.rst:138
 msgid ""
@@ -163,6 +220,12 @@ msgid ""
 "meth:`~TopologicalSorter.prepare` or if node has not yet been returned by :"
 "meth:`~TopologicalSorter.get_ready`."
 msgstr ""
+"Lève une :exc:`ValueError` si n'importe quel noeud dans *nodes* a déja "
+"été marqué comme traité par un précedent appel à cette méthode ou si un "
+"noeud n'a pas été ajouté au graphe en utilisant :meth:`TopologicalSorter "
+".add`, si l'appel est fait sans appel à meth:`~TopologicalSorter.prepare` "
+"ou si le noeud n'a pas encore été retourné par meth:`~TopologicalSorter."
+"get_ready`."
 
 #: library/graphlib.rst:146
 msgid ""
@@ -172,20 +235,31 @@ msgid ""
 "nodes that have all their predecessors already processed. Once no more "
 "progress can be made, empty tuples are returned."
 msgstr ""
+"Retourne un ``tuple`` avec tous les noeuds prêts. Retourne initiallement "
+"tous les noeuds sans prédécesseurs, et une fois marqués comme traités avec "
+"un appel de :meth:`TopologicalSorter.done`, les autres appels retournent "
+"tous les nouveaux noeuds qui ont tous leurs prédecesseurs déjà traités. Une "
+"fois que la progression n'est plus possible, des tuples vides sont retournés."
 
 #: library/graphlib.rst:157
+#, fuzzy
 msgid ""
 "Returns an iterator object which will iterate over nodes in a topological "
 "order. When using this method, :meth:`~TopologicalSorter.prepare` and :meth:"
 "`~TopologicalSorter.done` should not be called. This method is equivalent "
 "to::"
-msgstr ""
+"Retourne un iterable contenant les noeuds dans un ordre topologique. "
+"L'utilisation de cette méthode permet d'éviter l'appel à "
+":meth:`TopologicalSorter.prepare` ou :meth:`TopologicalSorter.done` "
+"Cette méthode est équivalente à::"
 
 #: library/graphlib.rst:169
 msgid ""
 "The particular order that is returned may depend on the specific order in "
 "which the items were inserted in the graph. For example:"
 msgstr ""
+"L'ordre particulier qui est returné peut dépendre de l'ordre spécifique "
+"dans lequel les élements ont étés ajoutés dans le graphe. Par exemple:"
 
 #: library/graphlib.rst:186
 msgid ""
@@ -194,25 +268,32 @@ msgid ""
 "`~TopologicalSorter.get_ready`) and the order between them is determined by "
 "the order of insertion."
 msgstr ""
+"Ceci est dû au fait que \"0\" and \"2\" sont au même niveau dans le graphe "
+"(ils auraient été retournés dans le même appel à :meth:"
+"`~TopologicalSorter.get_ready`) et l'ordre entre eux est determiné par "
+"l'ordre lors de l'insertion."
 
 #: library/graphlib.rst:192
 msgid "If any cycle is detected, :exc:`CycleError` will be raised."
-msgstr ""
+msgstr "Si un cycle est détecté alors une :exc:`CycleError` sera levée.`"
 
 #: library/graphlib.rst:198
 msgid "Exceptions"
 msgstr "Exceptions"
 
 #: library/graphlib.rst:199
 msgid "The :mod:`graphlib` module defines the following exception classes:"
-msgstr ""
+msgstr "Le module :mod:`graphlib` definit les classes d'exceptions suivantes:"
 
 #: library/graphlib.rst:203
 msgid ""
 "Subclass of :exc:`ValueError` raised by :meth:`TopologicalSorter.prepare` if "
 "cycles exist in the working graph. If multiple cycles exist, only one "
 "undefined choice among them will be reported and included in the exception."
 msgstr ""
+"Un classe enfant de of :exc:`ValueError`  est levée par :meth:`TopologicalSorter.prepare` si "
+"un cycle existe dans le graphe courant. Si de multiples cycles existent, seulement une "
+"sélection aléatoire de ceux-ci seront indiqués et inclus dans l'exception."
 
 #: library/graphlib.rst:207
 msgid ""
@@ -222,3 +303,10 @@ msgid ""
 "predecessor of the next node in the list. In the reported list, the first "
 "and the last node will be the same, to make it clear that it is cyclic."
 msgstr ""
+""
+"On peut accèder au cycle détecté via le second élément de l'attribut "
+"`~CycleError.args` de l'instance de l'exception. Cet attribut sera une "
+"liste de noeuds de telle manière que chaque noeud sera, dans le graphe, un "
+"prédécesseur immédiat du noeud suivant de cette liste. Dans la liste "
+"renvoyée, le premier et le dernier noeud seront le même afin de bien "
+"indiquer que c'est cyclique."