Howto Unicode : 3ème partie, suite et fin

Author: deronnax

howto/unicode.po

@@ -882,14 +882,18 @@ msgstr ""
 
 #: ../Doc/howto/unicode.rst:537
 msgid "Reading and Writing Unicode Data"
-msgstr ""
+msgstr "Lecture et écriture de données Unicode"
 
 #: ../Doc/howto/unicode.rst:539
 msgid ""
 "Once you've written some code that works with Unicode data, the next problem "
 "is input/output.  How do you get Unicode strings into your program, and how "
 "do you convert Unicode into a form suitable for storage or transmission?"
 msgstr ""
+"Une fois que vous avez écrit du code qui fonctionne avec des données "
+"Unicode, le problème suivant est les entrées/sorties. Comment obtenir des "
+"chaînes Unicode dans votre programme, et comment convertir les chaînes "
+"Unicode dans une forme appropriée pour le stockage ou la transmission ?"
 
 #: ../Doc/howto/unicode.rst:543
 msgid ""
@@ -899,6 +903,13 @@ msgid ""
 "Unicode data, for example.  Many relational databases also support Unicode-"
 "valued columns and can return Unicode values from an SQL query."
 msgstr ""
+"Il est possible que vous n'ayez rien à faire en fonction de vos sources "
+"d'entrée et de vos destinations de sortie ; vous devriez vérifier si les "
+"bibliothèques utilisées dans votre application supportent Unicode "
+"nativement. Par exemple, les analyseurs XML renvoient souvent des données "
+"Unicode. De nombreuses bases de données relationnelles prennent également en "
+"charge les colonnes encodées en Unicode et peuvent renvoyer des valeurs "
+"Unicode à partir d'une requête SQL."
 
 #: ../Doc/howto/unicode.rst:549
 msgid ""
@@ -908,6 +919,11 @@ msgid ""
 "bytes with ``bytes.decode(encoding)``.  However, the manual approach is not "
 "recommended."
 msgstr ""
+"Les données Unicode sont généralement converties en un encodage particulier "
+"avant d'être écrites sur le disque ou envoyées sur un connecteur réseau. Il "
+"est possible de faire tout le travail vous-même : ouvrir un fichier, lire un "
+"élément 8-bits, et convertir les octets avec ``bytes.decode(encoding)``. "
+"Cependant, l'approche manuelle n'est pas recommandée."
 
 #: ../Doc/howto/unicode.rst:554
 msgid ""
@@ -922,6 +938,17 @@ msgid ""
 "least a moment you'd need to have both the encoded string and its Unicode "
 "version in memory.)"
 msgstr ""
+"Un problème est la nature multi-octets des encodages ; un caractère Unicode "
+"peut être représenté par plusieurs octets. Si vous voulez lire le fichier en "
+"morceaux de taille arbitraire (disons 1024 ou 4096 octets), vous devez "
+"écrire un code de gestion des erreurs pour détecter le cas où une partie "
+"seulement des octets codant un seul caractère Unicode sont lus à la fin d'un "
+"morceau. Une solution serait de lire le fichier entier en mémoire et "
+"d'effectuer le décodage, mais cela vous empêche de travailler avec des "
+"fichiers extrêmement volumineux ; si vous avez besoin de lire un fichier de "
+"2 GiB, vous avez besoin de 2 GiB de RAM (plus que ça, en fait, puisque pour "
+"au moins un moment, vous aurez besoin d'avoir à la fois la chaîne encodée et "
+"sa version Unicode en mémoire)."
 
 #: ../Doc/howto/unicode.rst:564
 msgid ""
@@ -934,16 +961,27 @@ msgid ""
 "*encoding* and *errors* parameters which are interpreted just like those in :"
 "meth:`str.encode` and :meth:`bytes.decode`."
 msgstr ""
+"La solution serait d'utiliser l'interface de décodage de bas-niveau pour "
+"intercepter le cas des séquences d'encodage incomplètes.  Le travail "
+"d'implémenter cela a déjà été fait pour vous : la fonction native :func:"
+"`open` peut retourner un objet de type fichier qui suppose que le contenu du "
+"fichier est dans un encodage spécifié et accepte les paramètres Unicode pour "
+"des méthodes telles que :meth:`~io.TextIOBase.read` et :meth:`~io.TextIOBase."
+"write`.  Ceci fonctionne grâce aux paramètres *encoding* et *errors* de :"
+"func:`open` qui sont interprétés comme ceux de :meth:`str.encode` et :meth:"
+"`bytes.decode`."
 
 #: ../Doc/howto/unicode.rst:573
 msgid "Reading Unicode from a file is therefore simple::"
-msgstr ""
+msgstr "Lire de l'Unicode à partir d'un fichier est donc simple ::"
 
 #: ../Doc/howto/unicode.rst:579
 msgid ""
 "It's also possible to open files in update mode, allowing both reading and "
 "writing::"
 msgstr ""
+"Il est également possible d'ouvrir des fichiers en mode « mise à jour », "
+"permettant à la fois la lecture et l'écriture ::"
 
 #: ../Doc/howto/unicode.rst:587
 msgid ""
@@ -957,6 +995,16 @@ msgid ""
 "endian encodings, that specify one particular byte ordering and don't skip "
 "the BOM."
 msgstr ""
+"Le caractère Unicode ``U+FEFFF`` est utilisé comme une marque d'ordre "
+"d'octet (*byte-order mark* en anglais, *BOM*), et est souvent écrit comme le "
+"premier caractère d'un fichier afin d'aider à l'auto-détection de l'ordre "
+"des octets du fichier.  Certains encodages, comme UTF-16, s'attendent à ce "
+"qu'une BOM soit présente au début d'un fichier ; lorsqu'un tel encodage est "
+"utilisé, la BOM sera automatiquement écrite comme premier caractère et sera "
+"silencieusement retirée lorsque le fichier sera lu.  Il existe des variantes "
+"de ces encodages, comme ``utf-16-le`` et ``utf-16-be`` pour les encodages "
+"little-endian et big-endian, qui spécifient un ordre d'octets donné et ne "
+"sautent pas la BOM."
 
 #: ../Doc/howto/unicode.rst:596
 msgid ""
@@ -966,10 +1014,15 @@ msgid ""
 "reading such files, use the 'utf-8-sig' codec to automatically skip the mark "
 "if present."
 msgstr ""
+"Dans certaines cas, il est également d'usage d'utiliser une *BOM* au début "
+"des fichiers encodés en UTF-8 ; le nom est trompeur puisque l'UTF-8 ne "
+"dépend pas de l'ordre des octets. La marque annonce simplement que le "
+"fichier est encodé en UTF-8.  Pour lire ces fichiers, utilisez le codec "
+"``utf-8-sig`` pour sauter automatiquement la marque si présente."
 
 #: ../Doc/howto/unicode.rst:603
 msgid "Unicode filenames"
-msgstr ""
+msgstr "Noms de fichiers Unicode"
 
 #: ../Doc/howto/unicode.rst:605
 msgid ""
@@ -982,6 +1035,15 @@ msgid ""
 "if you've set the ``LANG`` or ``LC_CTYPE`` environment variables; if you "
 "haven't, the default encoding is again UTF-8."
 msgstr ""
+"La plupart des systèmes d'exploitation couramment utilisés aujourd'hui "
+"prennent en charge les noms de fichiers qui contiennent des caractères "
+"Unicode arbitraires.  Habituellement, ceci est implémenté en convertissant "
+"la chaîne Unicode en un encodage qui varie en fonction du système.  "
+"Aujourd'hui, Python converge vers l'utilisation d'UTF-8 : Python sous MacOS "
+"a utilisé UTF-8 depuis plusieurs versions, et Python 3.6 est passé à UTF-8 "
+"sous Windows également.  Sur les systèmes Unix, il n'y aura un encodage du "
+"système de fichiers que si vous avez défini les variables d'environnement "
+"``LANG`` ou ``LC_CTYPE`` ; sinon, l'encodage par défaut est UTF-8."
 
 #: ../Doc/howto/unicode.rst:615
 msgid ""
@@ -991,12 +1053,20 @@ msgid ""
 "writing, you can usually just provide the Unicode string as the filename, "
 "and it will be automatically converted to the right encoding for you::"
 msgstr ""
+"La fonction :func:`sys.getfilesystemencoding` renvoie l'encodage à utiliser "
+"sur votre système actuel, au cas où vous voudriez faire l'encodage "
+"manuellement, mais il n'y a pas vraiment de raisons de s'embêter avec ça.  "
+"Lors de l'ouverture d'un fichier pour la lecture ou l'écriture, vous pouvez "
+"généralement simplement fournir la chaîne Unicode comme nom de fichier, et "
+"il sera automatiquement converti à l'encodage qui convient ::"
 
 #: ../Doc/howto/unicode.rst:625
 msgid ""
 "Functions in the :mod:`os` module such as :func:`os.stat` will also accept "
 "Unicode filenames."
 msgstr ""
+"Les fonctions du module :mod:`os` telles que :func:`os.stat` acceptent "
+"également les noms de fichiers Unicode."
 
 #: ../Doc/howto/unicode.rst:628
 msgid ""
@@ -1010,16 +1080,29 @@ msgid ""
 "assuming the default filesystem encoding is UTF-8, running the following "
 "program::"
 msgstr ""
+"La fonction :func:`os.listdir` renvoie des noms de fichiers, ce qui soulève "
+"un problème : doit-elle renvoyer la version Unicode des noms de fichiers, ou "
+"doit-elle renvoyer des chaînes d'octets contenant les versions encodées ? :"
+"func:`os.listdir` peut faire les deux, selon que vous avez fourni le chemin "
+"du répertoire en chaîne d'octets ou une chaîne Unicode.  Si vous passez une "
+"chaîne Unicode comme chemin d'accès, les noms de fichiers seront décodés en "
+"utilisant l'encodage du système de fichiers et une liste de chaînes Unicode "
+"sera renvoyée, tandis que passer un chemin d'accès en chaîne d'octets "
+"retournera les noms de fichiers comme octets.  Par exemple, en supposant que "
+"l'encodage par défaut du système de fichiers est UTF-8, exécutez le "
+"programme suivant: :"
 
 #: ../Doc/howto/unicode.rst:646
 msgid "will produce the following output:"
-msgstr ""
+msgstr "produira la sortie suivante:"
 
 #: ../Doc/howto/unicode.rst:654
 msgid ""
 "The first list contains UTF-8-encoded filenames, and the second list "
 "contains the Unicode versions."
 msgstr ""
+"La première liste contient les noms de fichiers encodés en UTF-8 et la "
+"seconde contient les versions Unicode."
 
 #: ../Doc/howto/unicode.rst:657
 msgid ""
@@ -1028,26 +1111,36 @@ msgid ""
 "undecodable file names can be present; that's pretty much only Unix systems "
 "now."
 msgstr ""
+"Notez que dans la plupart des cas, vous devriez vous en tenir à "
+"l'utilisation d'Unicode avec ces APIs.  Les API d'octets ne devraient être "
+"utilisées que sur les systèmes où des noms de fichiers non décodables "
+"peuvent être présents. C'est à peu près seulement le cas des systèmes Unix "
+"maintenant."
 
 #: ../Doc/howto/unicode.rst:664
 msgid "Tips for Writing Unicode-aware Programs"
-msgstr ""
+msgstr "Conseils pour écrire des programmes compatibles Unicode"
 
 #: ../Doc/howto/unicode.rst:666
 msgid ""
 "This section provides some suggestions on writing software that deals with "
 "Unicode."
 msgstr ""
+"Cette section fournit quelques suggestions sur l'écriture de logiciels qui "
+"traitent de l'Unicode."
 
 #: ../Doc/howto/unicode.rst:669
 msgid "The most important tip is:"
-msgstr ""
+msgstr "Le conseil le plus important est:"
 
 #: ../Doc/howto/unicode.rst:671
 msgid ""
 "Software should only work with Unicode strings internally, decoding the "
 "input data as soon as possible and encoding the output only at the end."
 msgstr ""
+"Le logiciel ne devrait fonctionner qu'avec des chaînes Unicode en interne, "
+"décodant les données d'entrée dès que possible et encodant la sortie "
+"uniquement à la fin."
 
 #: ../Doc/howto/unicode.rst:674
 msgid ""
@@ -1057,6 +1150,11 @@ msgid ""
 "or decoding: if you do e.g. ``str + bytes``, a :exc:`TypeError` will be "
 "raised."
 msgstr ""
+"Si vous essayez d'écrire des fonctions de traitement qui acceptent à la fois "
+"les chaînes Unicode et les chaînes d'octets, vous rendrez votre programme "
+"vulnérable aux bogues partout où vous combinez les deux types de chaînes "
+"différentes.  Il n'y a pas d'encodage ou de décodage automatique : si vous "
+"faites par exemple ``str + octets``, une :exc:`TypeError` sera levée."
 
 #: ../Doc/howto/unicode.rst:679
 msgid ""
@@ -1069,27 +1167,45 @@ msgid ""
 "true if the input data also specifies the encoding, since the attacker can "
 "then choose a clever way to hide malicious text in the encoded bytestream."
 msgstr ""
+"Lors de l'utilisation de données provenant d'un navigateur Web ou d'une "
+"autre source non fiable, une technique courante consiste à vérifier la "
+"présence de caractères illégaux dans une chaîne de caractères avant de "
+"l'utiliser dans une ligne de commande générée ou de la stocker dans une base "
+"de données.  Si vous faites cela, faites attention à vérifier la chaîne "
+"décodée, pas les données d'octets codés ; certains encodages peuvent avoir "
+"des propriétés intéressantes, comme ne pas être bijective ou ne pas être "
+"entièrement compatibles ASCII.  Ceci est particulièrement vrai si les "
+"données d'entrée spécifient également l'encodage, puisque l'attaquant peut "
+"alors choisir un moyen intelligent de cacher le texte malveillant dans le "
+"flux de données encodé."
 
 #: ../Doc/howto/unicode.rst:690
 msgid "Converting Between File Encodings"
-msgstr ""
+msgstr "Conversion entre les encodages de fichiers"
 
 #: ../Doc/howto/unicode.rst:692
 msgid ""
 "The :class:`~codecs.StreamRecoder` class can transparently convert between "
 "encodings, taking a stream that returns data in encoding #1 and behaving "
 "like a stream returning data in encoding #2."
 msgstr ""
+"La classe :class:`~codecs.StreamRecoder` peut convertir de manière "
+"transparente entre les encodages, en prenant un flux qui renvoie des données "
+"dans l'encodage #1 et en se comportant comme un flux qui renvoie des données "
+"dans l'encodage #2."
 
 #: ../Doc/howto/unicode.rst:696
 msgid ""
 "For example, if you have an input file *f* that's in Latin-1, you can wrap "
 "it with a :class:`~codecs.StreamRecoder` to return bytes encoded in UTF-8::"
 msgstr ""
+"Par exemple, si vous avez un fichier d'entrée *f* qui est en Latin-1, vous "
+"pouvez l'encapsuler avec un :class:`~codecs.StreamRecoder` pour retourner "
+"des octets encodés en UTF-8 ::"
 
 #: ../Doc/howto/unicode.rst:710
 msgid "Files in an Unknown Encoding"
-msgstr ""
+msgstr "Fichiers dans un encodage inconnu"
 
 #: ../Doc/howto/unicode.rst:712
 msgid ""
@@ -1098,6 +1214,11 @@ msgid ""
 "to examine or modify the ASCII parts, you can open the file with the "
 "``surrogateescape`` error handler::"
 msgstr ""
+"Que pouvez-vous faire si vous avez besoin de modifier un fichier, mais que "
+"vous ne connaissez pas l'encodage du fichier ?  Si vous savez que l'encodage "
+"est compatible ASCII et que vous voulez seulement examiner ou modifier les "
+"parties ASCII, vous pouvez ouvrir le fichier avec le gestionnaire d'erreurs "
+"``surrogateescape`` ::"
 
 #: ../Doc/howto/unicode.rst:726
 msgid ""
@@ -1106,13 +1227,22 @@ msgid ""
 "points will then turn back into the same bytes when the ``surrogateescape`` "
 "error handler is used to encode the data and write it back out."
 msgstr ""
+"Le gestionnaire d'erreurs ``surrogateescape`` décodera tous les octets non-"
+"ASCII comme points de code dans une plage spéciale allant de ``U+DC80`` à ``U"
+"+DCFF``.  Ces points de code redeviendront alors les mêmes octets lorsque le "
+"gestionnaire d'erreurs ``surrogateescape`` sera utilisé pour encoder les "
+"données et les réécrire."
 
 #: ../Doc/howto/unicode.rst:736
 msgid ""
 "One section of `Mastering Python 3 Input/Output <http://pyvideo.org/"
 "video/289/pycon-2010--mastering-python-3-i-o>`_, a PyCon 2010 talk by David "
 "Beazley, discusses text processing and binary data handling."
 msgstr ""
+"Une section de `Mastering Python 3 Input/Output <http://pyvideo.org/"
+"video/289/pycon-2010--mastering-python-3-i-o>`_, une conférence PyCon 2010 "
+"de David Beazley, parle du traitement de texte et du traitement des données "
+"binaires."
 
 #: ../Doc/howto/unicode.rst:740
 msgid ""
@@ -1122,13 +1252,22 @@ msgid ""
 "character encodings as well as how to internationalize and localize an "
 "application.  These slides cover Python 2.x only."
 msgstr ""
+"Le `PDF du diaporama de la présentation de Marc-André Lemburg \"Writing "
+"Unicodeaware Applications in Python\" <https://downloads.egenix.com/python/"
+"LSM2005-Developing-Unicode-aware-applications-in-Python.pdf>`_ traite des "
+"questions d'encodage de caractères ainsi que de l'internationalisation et de "
+"la localisation d'une application.  Ces diapositives ne couvrent que Python "
+"2.x."
 
 #: ../Doc/howto/unicode.rst:746
 msgid ""
 "`The Guts of Unicode in Python <http://pyvideo.org/video/1768/the-guts-of-"
 "unicode-in-python>`_ is a PyCon 2013 talk by Benjamin Peterson that "
 "discusses the internal Unicode representation in Python 3.3."
 msgstr ""
+"`The Guts of Unicode in Python <http://pyvideo.org/video/1768/the-guts-of-"
+"unicode-in-python>`_ est une conférence PyCon 2013 par Benjamin Peterson qui "
+"traite de la représentation interne Unicode en Python 3.3."
 
 #: ../Doc/howto/unicode.rst:753
 msgid "Acknowledgements"
@@ -1140,6 +1279,9 @@ msgid ""
 "since been revised further by Alexander Belopolsky, Georg Brandl, Andrew "
 "Kuchling, and Ezio Melotti."
 msgstr ""
+"La première ébauche de ce document a été rédigée par Andrew Kuchling. Il a "
+"depuis été révisé par Alexander Belopolsky, Georg Brandl, Andrew Kuchling et "
+"Ezio Melotti."
 
 #: ../Doc/howto/unicode.rst:759
 msgid ""
@@ -1148,6 +1290,11 @@ msgid ""
 "Gedminas, Kent Johnson, Ken Krugler, Marc-André Lemburg, Martin von Löwis, "
 "Terry J. Reedy, Serhiy Storchaka, Eryk Sun, Chad Whitacre, Graham Wideman."
 msgstr ""
+"Merci aux personnes suivantes qui ont noté des erreurs ou qui ont fait des "
+"suggestions sur cet article : Éric Araujo, Nicholas Bastin, Nick Coghlan, "
+"Marius Gedminas, Kent Johnson, Ken Krugler, Marc-André Lemburg, Martin von "
+"Löwis, Terry J. Reedy, Serhiy Storchaka, Eryk Sun, Chad Whitacre, Graham "
+"Wideman."
 
 #~ msgid "History of Character Codes"
 #~ msgstr "Histoire des codes de caractères"

library/functions.po

@@ -1910,8 +1910,8 @@ msgid ""
 "platform-independent."
 msgstr ""
 "Python ne dépend pas de l'éventuelle notion de fichier texte du système sous-"
-"jacent, tout est effectué par Python lui même, et ainsi indépendant de la "
-"plateforme."
+"jacent, tout le traitement est effectué par Python lui même, et est ainsi "
+"indépendant de la plateforme."
 
 #: ../Doc/library/functions.rst:1031
 msgid ""