Apply suggestions from code review

Co-Authored-By: Christophe Nanteuil <35002064+christopheNan@users.noreply.github.com>
python · christopheNan · Sep 11, 2019 · Aug 23, 2019 · Sep 2, 2019 · Sep 2, 2019
commit a86ef87849e22ad3984eb18203a0972106e8fd77
diff --git a/howto/pyporting.po b/howto/pyporting.po
@@ -67,7 +67,7 @@ msgid ""
 "questions."
 msgstr ""
 "Vous pouvez solliciter par courriel l'aide de la liste de diffusion python-"
-"porting_ mailing avec vos questions liées au portage."
+"porting_  pour vos questions liées au portage."
 
 #: ../Doc/howto/pyporting.rst:27
 msgid "The Short Explanation"
@@ -90,7 +90,7 @@ msgid ""
 "Make sure you have good test coverage (coverage.py_ can help; ``pip install "
 "coverage``)"
 msgstr ""
-"S'assurer d'une bonne couverture de tests (coverage.py_ peut aider; ``pip "
+"S'assurer d'une bonne couverture des tests (coverage.py_ peut aider ; ``pip "
 "install coverage``)"
 
 #: ../Doc/howto/pyporting.rst:35 ../Doc/howto/pyporting.rst:116
@@ -119,8 +119,8 @@ msgid ""
 "Use caniusepython3_ to find out which of your dependencies are blocking your "
 "use of Python 3 (``pip install caniusepython3``)"
 msgstr ""
-"Utiliser caniusepython3_ pour déterminer quelles dépendances dont vous "
-"faites usage bloquent votre utilisation de Python 3 (``pip install "
+"Utiliser caniusepython3_ pour déterminer quelles sont, parmi les dépendances que vous utilisez, "
+"celles qui bloquent votre utilisation de Python 3 (``pip install "
 "caniusepython3``)"
 
 #: ../Doc/howto/pyporting.rst:41
@@ -131,7 +131,7 @@ msgid ""
 msgstr ""
 "Une fois que vos dépendances ne sont plus un obstacle, utiliser "
 "l'intégration continue pour s'assurer que votre code demeure compatible "
-"Python 2 & 3 (tox_ peut aider à tester les sources contre plusieurs versions "
+"Python 2 & 3 (tox_ peut aider à tester la comptabilité de sources avec plusieurs versions "
 "de Python; ``pip install tox``)"
 
 #: ../Doc/howto/pyporting.rst:44
@@ -140,7 +140,7 @@ msgid ""
 "works in both Python 2 & 3 (e.g. use mypy_ to check your typing under both "
 "Python 2 & Python 3)."
 msgstr ""
-"Envisagez l'utilisation d'un vérifieur de type statique afin de vous assurer "
+"Envisager l'utilisation d'un vérifieur de type statique afin de vous assurer "
 "que votre façon d'utiliser les types est compatible avec Python 2 et 3 (par "
 "exemple en utilisant mypy_ pour vérifier votre typage sous Python 2 et 3)."
 
@@ -156,12 +156,12 @@ msgid ""
 "3. Most changes required to support Python 3 lead to cleaner code using "
 "newer practices even in Python 2 code."
 msgstr ""
-"Un point critique du support simultané de Python 2 et 3 est qu'il vous est "
+"Un point clé du support simultané de Python 2 et 3 est qu'il vous est "
 "possible de commencer **dès aujourd'hui** ! Même si vos dépendances ne sont "
-"pas encore compatibles Python 3, cela ne signifie pas que vous ne pouvez pas "
+"pas encore compatibles Python 3, vous pouvez "
 "moderniser votre code **dès maintenant** pour gérer Python 3. La plupart des "
-"modifications nécessaires à la compatibilité Python 3 résultent en un code "
-"plus propre utilisant des pratiques plus récentes, même dans du code Python "
+"modifications nécessaires à la compatibilité Python 3 donnent un code "
+"plus propre utilisant une syntaxe plus récente, même dans du code Python "
 "2."
 
 #: ../Doc/howto/pyporting.rst:58
@@ -173,10 +173,10 @@ msgid ""
 "from the automated changes immediately."
 msgstr ""
 "Un autre point important est que la modernisation de votre code Python 2 "
-"pour le rendre compatible Python 3 est principalement automatique. Bien que "
-"vous soyez susceptibles de devoir effectuer des changements d'API compte-"
+"pour le rendre compatible Python 3 est pratiquement automatique. Bien qu'il "
+"soit possible d'avoir à effectuer des changements d'API compte-"
 "tenu de la clarification de la gestion des données textuelles et binaires "
-"dans Python 3, le travail bas niveau est en grande partie faite pour vous et "
+"dans Python 3, le travail de bas niveau est en grande partie fait pour vous et "
 "vous pouvez ainsi bénéficiez de ces modifications automatiques immédiatement."
 
 #: ../Doc/howto/pyporting.rst:64
@@ -190,7 +190,7 @@ msgstr ""
 
 #: ../Doc/howto/pyporting.rst:69
 msgid "Drop support for Python 2.6 and older"
-msgstr "Abandon de la compatibilité Python 2.6 et antérieur"
+msgstr "Abandon de la compatibilité Python 2.6 et antérieures"
 
 #: ../Doc/howto/pyporting.rst:71
 msgid ""
@@ -217,8 +217,8 @@ msgid ""
 msgstr ""
 "Si vous pouvez ignorer Python 2.5 et antérieur, les changements nécessaires "
 "à appliquer à votre code devraient encore ressembler à vos yeux à du code "
-"Python idiomatique. Dans le pire cas, vous aurez utilisé une fonction plutôt "
-"qu'une méthode dans certains cas, ou bien vous aurez dû importer une "
+"Python idiomatique. Dans le pire cas, vous devrez utiliser une fonction plutôt "
+"qu'une méthode dans certains cas, ou bien vous devrez importer une "
 "fonction plutôt qu'utiliser une fonction native, mais le reste du temps le "
 "code transformé devrait vous rester familier."
 
@@ -232,14 +232,14 @@ msgid ""
 "simply be easier for you if you only support the versions of Python that you "
 "have to support."
 msgstr ""
-"Mais vous devriez viser pour un support de Python 2.7 seulement. Python 2.6 "
+"Mais nous vous conseillons de viser seulement un support de Python 2.7. Python 2.6 "
 "n'est plus supporté gratuitement et par conséquent ne reçoit plus aucun "
 "correctif. Cela signifie que **vous** devrez trouver des solutions de "
 "contournement aux problèmes que vous rencontrez avec Python 2.6. Il existe "
 "en outre des outils mentionnés dans ce guide pratique qui ne supportent pas "
 "Python 2.6 (par exemple Pylint_), ce qui sera de plus en plus courant au fil "
 "du temps. Il est simplement plus facile pour vous de n'assurer une "
-"compatibilité qu'avec les versions de Python que vous devez gérer."
+"compatibilité qu'avec les versions de Python que vous avez l'obligation de gérer."
 
 #: ../Doc/howto/pyporting.rst:92
 msgid ""
@@ -283,10 +283,10 @@ msgstr ""
 "Python 2 que vous souhaitez, vous devez vous assurer que votre suite de test "
 "a une couverture suffisante. Une bonne règle empirique consiste à avoir "
 "suffisamment confiance en la suite de test pour qu'une erreur apparaissant "
-"après la réécriture du code par les outils automatiques soient des bogues de "
+"après la réécriture du code par les outils automatiques resulte de bogues de "
 "ces derniers et non de votre code. Si vous souhaitez une valeur cible, "
-"essayez de dépasser les 80% de couverture (et ne vous sentez pas coupable si "
-"vous trouvez difficile de faire mieux que 90% de couverture). Si vous ne "
+"essayez de dépasser les 80 % de couverture (et ne vous sentez pas coupable si "
+"vous trouvez difficile de faire mieux que 90 % de couverture). Si vous ne "
 "disposez pas encore d'un outil pour mesurer la couverture de code, coverage."
 "py_ est recommandé."
 
@@ -304,10 +304,10 @@ msgstr ""
 "portage vers Python 3 ! Mais afin de comprendre comment votre code va "
 "changer et à quoi s'intéresser spécifiquement pendant que vous codez, vous "
 "aurez sûrement envie de découvrir quels sont les changements introduits par "
-"Python 3 par rapport à Python 2. Les deux meilleurs moyens d'atteindre cet "
-"objectif sont de lire le document `\"What's New\"`_ de chaque version de "
+"Python 3 par rapport à Python 2. Pour atteindre cet objectif, les deux meilleurs moyens "
+"sont de lire le document `\"What's New\"`_ de chaque version de "
 "Python 3 et le livre `Porting to Python 3`_ (gratuit en ligne). Il y a "
-"également une `cheat sheet`_ très pratique du projet Python-Future."
+"également une `anti-sèche <cheat sheet>`_ très pratique du projet Python-Future."
 
 #: ../Doc/howto/pyporting.rst:128
 msgid "Update your code"
@@ -354,7 +354,7 @@ msgid ""
 "translation failure."
 msgstr ""
 "Indépendamment de l'outil sur lequel se porte votre choix, celui-ci mettra à "
-"jour votre code afin qu'il puisse être exécuter par Python 3 tout en "
+"jour votre code afin qu'il puisse être exécuté par Python 3 tout en "
 "maintenant sa compatibilité avec la version de Python 2 dont vous êtes "
 "parti. En fonction du niveau de prudence que vous visez, vous pouvez "
 "exécuter l'outil sur votre suite de test d'abord puis inspecter visuellement "
@@ -423,7 +423,7 @@ msgid ""
 "division or continue using ``/`` and expect a float"
 msgstr ""
 "Remplacer tous les opérateurs de division par ``//`` pour la division "
-"entière, le cas échant, ou utiliser ``/`` et s'attendre à un résultat "
+"entière, le cas échant, ou utiliser ``/`` et vous attendre à un résultat "
 "flottant"
 
 #: ../Doc/howto/pyporting.rst:176
@@ -435,7 +435,7 @@ msgid ""
 msgstr ""
 "La raison pour laquelle  ``/`` n'est pas simplement remplacé par ``//`` "
 "automatiquement est que si un objet définit une méthode ``__truediv__`` mais "
-"pas de méthode ``__floordiv__``, alors votre code pourrait résultat en une "
+"pas de méthode ``__floordiv__``, alors votre code pourrait produire une "
 "erreur (par exemple, une classe définie par l'utilisateur qui utilise ``/`` "
 "pour définir une opération quelconque mais pour laquelle ``//`` n'a pas du "
 "tout la même signification, voire n'est pas utilisé du tout)."
@@ -458,7 +458,7 @@ msgstr ""
 "Dans Python 2, il était possible d'utiliser le type ``str`` pour du texte et "
 "pour des données binaires. Malheureusement cet amalgame entre deux concepts "
 "différents peut conduire à du code fragile pouvant parfois fonctionner pour "
-"les deux types de données et parfois non. Cela a également pu résulter en "
+"les deux types de données et parfois non. Cela a également conduit à "
 "des API confuses si les auteurs ne déclaraient pas explicitement que quelque "
 "chose qui acceptait ``str`` était compatible avec du texte ou des données "
 "binaires et pas un seul des deux types. Cela a compliqué la situation pour "
@@ -480,12 +480,12 @@ msgstr ""
 "Afin de rendre la distinction entre texte et données binaires claire et "
 "prononcée, Python 3 a suivi la voie pavée par la plupart des langages créés "
 "à l'ère d'Internet et a séparé les types texte et données binaires de telle "
-"sorte à ce qu'il ne soit plus possible de les confondre (Python est "
+"sorte qu'il ne soit plus possible de les confondre (Python est "
 "antérieur à la démocratisation de l'accès à Internet). Cette séparation ne "
 "pose pas de problème pour du code ne gérant soit que du texte, soit que des "
 "données binaires. Cependant un code source devant gérer les deux doit "
 "désormais se préoccuper du type des données manipulées, ce qui explique que "
-"ce processus ne peut être entièrement automatisé."
+"ce processus ne peut pas être entièrement automatisé."
 
 #: ../Doc/howto/pyporting.rst:203
 msgid ""
@@ -515,14 +515,14 @@ msgstr ""
 "le type ``bytes`` de Python 3 (qui est un sous-ensemble de ``str`` dans "
 "Python 2 et opère comme un alias du type ``bytes`` de Python 2). En général, "
 "le principal problème consiste à inventorier quelles méthodes existent et "
-"opèrent sur quelle type dans Python & 3 simultanément (pour le texte, il "
+"opèrent sur quel type dans Python & 3 simultanément (pour le texte, il "
 "s'agit de ``unicode`` dans Python 2 et ``str`` dans Python 3, pour le "
 "binaire il s'agit de ``str``/``bytes`` dans Python 2 et ``bytes`` dans "
-"Python 3). Le tableau ci-dessous liste les méthodes **uniques** à chaque "
+"Python 3). Le tableau ci-dessous liste les méthodes **spécifiques** à chaque "
 "type de données dans Python 2 et 3 (par exemple, la méthode ``decode()`` "
 "peut être utilisée sur des données binaires équivalentes en Python 2 et 3, "
 "mais ne peut pas être utilisée de la même façon sur le type texte en Python "
-"2 et 3 car le type ``str`` ne de Python 3 ne possède pas de telle méthode). "
+"2 et 3 car le type ``str``  de Python 3 ne possède pas de telle méthode). "
 "Notez que depuis Python 3.5, la méthode ``__mod__`` a été ajoutée au type "
 "*bytes*."
 
@@ -567,9 +567,9 @@ msgid ""
 "possible. This allows your code to work with only text internally and thus "
 "eliminates having to keep track of what type of data you are working with."
 msgstr ""
-"Vous pouvez rendre la distinction plus simple à gérer en réalisant les "
-"opérations d'encodage et de décodage entre données binaires et texte à la "
-"limite de votre code. Cela signifie que lorsque vous recevez du texte dans "
+"Vous pouvez rendre le problème plus simple à gérer en réalisant les "
+"opérations d'encodage et de décodage entre données binaires et texte aux "
+"extrémités de votre code. Cela signifie que lorsque vous recevez du texte dans "
 "un format binaire, vous devez immédiatement le décoder. À l'inverse si votre "
 "code doit transmettre du texte sous forme binaire, encodez-le le plus tard "
 "possible. Cela vous permet de ne manipuler que du texte à l'intérieur de "
@@ -611,21 +611,21 @@ msgid ""
 "`codecs.open` as that's only necessary for keeping compatibility with Python "
 "2.5."
 msgstr ""
-"En conséquence de cette dichotomie, vous devez en outre être prudents lors "
+"Une conséquence de cette dichotomie est que vous devez être prudents lors "
 "de l'ouverture d'un fichier. À moins que vous travailliez sous Windows, il y "
 "a des chances pour que vous ne vous soyez jamais préoccupé de spécifier le "
 "mode ``b`` lorsque vous ouvrez des fichiers binaires (par exemple ``rb`` "
 "pour lire un fichier binaire). Sous Python 3, les fichiers binaire et texte "
 "sont distincts et mutuellement incompatibles ; se référer au module :mod:"
 "`io` pour plus de détails. Ainsi vous **devez** décider lorsque vous ouvrez "
-"un fichier si celui-ci sera accéder en mode binaire (ce qui permet de lire "
+"un fichier si vous y accéderez en mode binaire (ce qui permet de lire "
 "et écrire des données binaires) ou en mode texte (ce qui permet de lire et "
 "écrire du texte). Vous devez également utiliser :func:`io.open` pour ouvrir "
 "des fichiers plutôt que la fonction native :func:`open` étant donné que le "
 "module :mod:`io` est cohérent de Python 2 à 3, ce qui n'est pas vrai pour la "
 "fonction :func:`open` (en Python 3, il s'agit en réalité de :func:`io."
 "open`). Ne cherchez pas à appliquer l'ancienne pratique consistant à "
-"utiliser :func:`codes.open` qui n'est nécessaire que pour préserver une "
+"utiliser :func:`codecs.open` qui n'est nécessaire que pour préserver une "
 "compatibilité avec Python 2.5."
 
 #: ../Doc/howto/pyporting.rst:261
@@ -642,7 +642,7 @@ msgid ""
 msgstr ""
 "Les constructeurs des types ``str`` et ``bytes`` possèdent une sémantique "
 "différente pour les mêmes arguments sous Python 2 et 3. Passer un entier à "
-"``bytes`` sous Python 2 produit une représentation de cette entier en chaîne "
+"``bytes`` sous Python 2 produit une représentation de cet entier en chaîne "
 "de caractères : ``bytes(3) == '3'``. Mais sous Python 3, fournir un argument "
 "entier à ``bytes`` produit un objet *bytes* de la longueur de l'entier "
 "spécifié, rempli par des octets nuls : ``bytes(3) == b'\\x00\\x00\\x00'``. "
@@ -792,7 +792,7 @@ msgid ""
 "you from actually running under Python 3 at the moment."
 msgstr ""
 "Une fois votre code traduit pour être compatible avec Python 3, vous devez "
-"vous assurer que votre code n'a pas régressé et ne fonctionne plus sous "
+"vous assurer que votre code n'a pas régressé ou qu'il ne fonctionne pas sous "
 "Python 3. Ceci est particulièrement important si une de vos dépendances vous "
 "empêche de réellement exécuter le code sous Python 3 pour le moment."
 
@@ -801,8 +801,8 @@ msgid ""
 "To help with staying compatible, any new modules you create should have at "
 "least the following block of code at the top of it::"
 msgstr ""
-"Afin de vous aider à maintenir la compatibilité, tous les nouveaux modules "
-"que vous créez devraient avoir au moins le bloc de code suivant en en-"
+"Afin de vous aider à maintenir la compatibilité, nous préconisons que tous les nouv
F9C4
eaux modules "
+"que vous créez aient au moins le bloc de code suivant en en-"
 "tête : ::"
 
 #: ../Doc/howto/pyporting.rst:354
@@ -812,8 +812,8 @@ msgid ""
 "warnings into errors with ``-Werror`` then you can make sure that you don't "
 "accidentally miss a warning."
 msgstr ""
-"Vous avez également lancer Python 2 avec le paramètre ``-3`` afin d'être "
-"alerté en cas de divers problèmes de compatibilités que votre code déclenche "
+"Vous pouvez également lancer Python 2 avec le paramètre ``-3`` afin d'être "
+"alerté en cas de divers problèmes de compatibilité que votre code déclenche "
 "durant son exécution. Si vous transformez les avertissements en erreur avec "
 "``-Werror``, vous pouvez être certain que ne passez pas accidentellement à "
 "côté d'un avertissement."
@@ -831,7 +831,7 @@ msgstr ""
 "afin de modifier votre code pour recevoir des avertissements lorsque celui-"
 "ci dévie de la compatibilité Python 3. Cela vous évite par ailleurs "
 "d'appliquer Modernize_ ou Futurize_ sur votre code régulièrement pour "
-"détecter des régressions de compatibilité. Cependant cela nécessite de votre "
+"détecter des régressions liées à la compatibilité. Cependant cela nécessite de votre "
 "part le support de Python 2.7 et Python 3.4 ou ultérieur étant donné qu'il "
 "s'agit de la version minimale gérée par Pylint."
 
@@ -849,7 +849,7 @@ msgid ""
 "caniusepython3.com."
 msgstr ""
 "**Après** avoir rendu votre code compatible avec Python 3, vous devez "
-"commencer à vous intéressez au portage de vos dépendances. Le projet "
+"commencer à vous intéresser au portage de vos dépendances. Le projet "
 "caniusepython3_ a été créé afin de vous aider à déterminer quels projets "
 "sont bloquants dans votre support de Python 3, directement ou indirectement. "
 "Il existe un outil en ligne de commande ainsi qu'une interface web : https://"
@@ -905,7 +905,7 @@ msgstr ""
 "Une fois que vous êtes en mesure d'exécuter votre code sous Python 3, vous "
 "devrez vous assurer que celui-ci fonctionne toujours pour Python 2 & 3. tox_ "
 "est vraisemblablement le meilleur outil pour exécuter vos tests avec "
-"plusieurs interpréteurs Python. Vous pouvez alors intégrer tox_ votre "
+"plusieurs interpréteurs Python. Vous pouvez alors intégrer tox_ à votre "
 "système d'intégration continue afin de ne jamais accidentellement casser "
 "votre gestion de Python 2 ou 3."
 
@@ -924,11 +924,11 @@ msgstr ""
 "afin de déclencher une exception lorsque vous comparez des *bytes* à des "
 "chaînes de caractères ou à un entier (cette deuxième possibilité est "
 "disponible à partir de Python 3.5). Par défaut, des comparaisons entre types "
-"différents renvoie simplement ``False`` mais si vous avez fait une erreur "
+"différents renvoient simplement ``False`` mais si vous avez fait une erreur "
 "dans votre séparation de la gestion texte/données binaires ou votre indiçage "
 "des *bytes*, vous ne trouverez pas facilement le bogue. Ce drapeau lève une "
-"exception lorsque ce genre de comparaison apparaît, facilitant ainsi leur "
-"identification et leur localisation."
+"exception lorsque ce genre de comparaison apparaît, facilitant ainsi sa "
+"identification et sa localisation."
 
 #: ../Doc/howto/pyporting.rst:410
 msgid ""