python-docs-fr/library/pprint.po

# Copyright (C) 2001-2018, Python Software Foundation
# For licence information, see README file.
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-03-23 18:39+0100\n"
"PO-Revision-Date: 2020-05-03 09:52+0200\n"
"Last-Translator: ZepmanBC <zepman@gmail.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.0.6\n"

#: library/pprint.rst:2
msgid ":mod:`pprint` --- Data pretty printer"
msgstr ":mod:`pprint` — L’affichage élégant de données"

#: library/pprint.rst:10
msgid "**Source code:** :source:`Lib/pprint.py`"
msgstr "**Code source :** :source:`Lib/pprint.py`"

#: library/pprint.rst:14
msgid ""
"The :mod:`pprint` module provides a capability to \"pretty-print\" arbitrary "
"Python data structures in a form which can be used as input to the "
"interpreter. If the formatted structures include objects which are not "
"fundamental Python types, the representation may not be loadable.  This may "
"be the case if objects such as files, sockets or classes are included, as "
"well as many other objects which are not representable as Python literals."
msgstr ""
"Le module :mod:`pprint` permet « d’afficher élégamment » des structures de "
"données Python arbitraires sous une forme qui peut être utilisée ensuite "
"comme une entrée dans l’interpréteur. Si les structures formatées incluent "
"des objets qui ne sont pas des types Python fondamentaux, leurs "
"représentations peuvent ne pas être acceptables en tant que telles par "
"l’interpréteur. Cela peut être le cas si des objets tels que des fichiers, "
"des interfaces de connexion (*sockets* en anglais) ou des classes sont "
"inclus, c’est aussi valable pour beaucoup d’autres types d’objets qui ne "
"peuvent être représentés sous forme littérale en Python."

#: library/pprint.rst:21
msgid ""
"The formatted representation keeps objects on a single line if it can, and "
"breaks them onto multiple lines if they don't fit within the allowed width. "
"Construct :class:`PrettyPrinter` objects explicitly if you need to adjust "
"the width constraint."
msgstr ""
"L’affichage formaté affiche, tant que possible, les objets sur une seule "
"ligne et les sépare sur plusieurs lignes s’ils dépassent la largeur "
"autorisée par l’interpréteur. Créez explicitement des objets :class:"
"`PrettyPrinter` si vous avez besoin de modifier les limites de largeur."

#: library/pprint.rst:26
msgid "Dictionaries are sorted by key before the display is computed."
msgstr ""
"Les dictionnaires sont classés par clés avant que l’affichage ne soit "
"calculé."

#: library/pprint.rst:28
msgid "Added support for pretty-printing :class:`types.SimpleNamespace`."
msgstr ""

#: library/pprint.rst:31
msgid "Added support for pretty-printing :class:`dataclasses.dataclass`."
msgstr ""

#: library/pprint.rst:34
msgid "The :mod:`pprint` module defines one class:"
msgstr "Le module :mod:`pprint` définit une seule classe :"

#: library/pprint.rst:44
msgid ""
"Construct a :class:`PrettyPrinter` instance.  This constructor understands "
"several keyword parameters."
msgstr ""

#: library/pprint.rst:47
msgid ""
"*stream* (default ``sys.stdout``) is a :term:`file-like object` to which the "
"output will be written by calling its :meth:`write` method. If both *stream* "
"and ``sys.stdout`` are ``None``, then :meth:`~PrettyPrinter.pprint` silently "
"returns."
msgstr ""

#: library/pprint.rst:52
msgid ""
"Other values configure the manner in which nesting of complex data "
"structures is displayed."
msgstr ""

#: library/pprint.rst:55
msgid ""
"*indent* (default 1) specifies the amount of indentation added for each "
"nesting level."
msgstr ""

#: library/pprint.rst:58
msgid ""
"*depth* controls the number of nesting levels which may be printed; if the "
"data structure being printed is too deep, the next contained level is "
"replaced by ``...``.  By default, there is no constraint on the depth of the "
"objects being formatted."
msgstr ""

#: library/pprint.rst:63
msgid ""
"*width* (default 80) specifies the desired maximum number of characters per "
"line in the output. If a structure cannot be formatted within the width "
"constraint, a best effort will be made."
msgstr ""

#: library/pprint.rst:67
msgid ""
"*compact* impacts the way that long sequences (lists, tuples, sets, etc) are "
"formatted. If *compact* is false (the default) then each item of a sequence "
"will be formatted on a separate line.  If *compact* is true, as many items "
"as will fit within the *width* will be formatted on each output line."
msgstr ""

#: library/pprint.rst:73
msgid ""
"If *sort_dicts* is true (the default), dictionaries will be formatted with "
"their keys sorted, otherwise they will display in insertion order."
msgstr ""

#: library/pprint.rst:76
msgid ""
"If *underscore_numbers* is true, integers will be formatted with the ``_`` "
"character for a thousands separator, otherwise underscores are not displayed "
"(the default)."
msgstr ""

#: library/pprint.rst:80
msgid "Added the *compact* parameter."
msgstr "Ajout du paramètre *compact*."

#: library/pprint.rst:83
msgid "Added the *sort_dicts* parameter."
msgstr "Ajout du paramètre *sort_dicts*."

#: library/pprint.rst:86
#, fuzzy
msgid "Added the *underscore_numbers* parameter."
msgstr "Ajout du paramètre *sort_dicts*."

#: library/pprint.rst:89
msgid "No longer attempts to write to ``sys.stdout`` if it is ``None``."
msgstr ""

#: library/pprint.rst:118
#, fuzzy
msgid ""
"Return the formatted representation of *object* as a string.  *indent*, "
"*width*, *depth*, *compact*, *sort_dicts* and *underscore_numbers* are "
"passed to the :class:`PrettyPrinter` constructor as formatting parameters "
"and their meanings are as described in its documentation above."
msgstr ""
"Renvoie une représentation formatée de *object* sous forme de chaîne de "
"caractères. *indent*, *width*, *depth* et *compact* sont passés au "
"constructeur de :class:`PrettyPrinter` comme paramètres de formatage."

#: library/pprint.rst:126
msgid ""
"Prints the formatted representation of *object* followed by a newline. If "
"*sort_dicts* is false (the default), dictionaries will be displayed with "
"their keys in insertion order, otherwise the dict keys will be sorted. "
"*args* and *kwargs* will be passed to :func:`pprint` as formatting "
"parameters."
msgstr ""
"Affiche la représentation formatée de *object* suivie d'une nouvelle ligne. "
"Si *sort_dicts* est ``False`` (la valeur par défaut), les dictionnaires "
"seront affichés avec leurs clés dans l'ordre d'insertion, sinon les clés des "
"dictionnaires seront ordonnées. *args* et *kwargs* seront passés à :func:"
"`pprint` comme paramètres de formatage."

#: library/pprint.rst:138
#, fuzzy
msgid ""
"Prints the formatted representation of *object* on *stream*, followed by a "
"newline.  If *stream* is ``None``, ``sys.stdout`` is used. This may be used "
"in the interactive interpreter instead of the :func:`print` function for "
"inspecting values (you can even reassign ``print = pprint.pprint`` for use "
"within a scope)."
msgstr ""
"Affiche la représentation formatée de *object* sur *stream*, suivie d’un "
"retour à la ligne. Si *stream* vaut ``None``, ``sys.stdout`` est alors "
"utilisé. Vous pouvez l’utiliser dans l’interpréteur interactif de Python au "
"lieu de la fonction :func:`print` pour inspecter les valeurs (vous pouvez "
"même réassigner ``print = pprint.pprint`` pour une utilisation au sein de sa "
"portée). *indent*, *width*, *depth*, *compact* et *sort_dicts* sont passés "
"au constructeur de classe :class:`PrettyPrinter` comme paramètres de "
"formatage."

#: library/pprint.rst:144
#, fuzzy
msgid ""
"The configuration parameters *stream*, *indent*, *width*, *depth*, "
"*compact*, *sort_dicts* and *underscore_numbers* are passed to the :class:"
"`PrettyPrinter` constructor and their meanings are as described in its "
"documentation above."
msgstr ""
"Renvoie une représentation formatée de *object* sous forme de chaîne de "
"caractères. *indent*, *width*, *depth* et *compact* sont passés au "
"constructeur de :class:`PrettyPrinter` comme paramètres de formatage."

#: library/pprint.rst:164
msgid ""
"Determine if the formatted representation of *object* is \"readable\", or "
"can be used to reconstruct the value using :func:`eval`.  This always "
"returns ``False`` for recursive objects."
msgstr ""
"Détermine si la représentation formatée de *object* est « lisible », ou s’il "
"peut être utilisé pour recomposer sa valeur en utilisant la fonction :func:"
"`eval`. Cela renvoie toujours ``False`` pour les objets récursifs."

#: library/pprint.rst:174
msgid "Determine if *object* requires a recursive representation."
msgstr "Détermine si *object* requiert une représentation récursive."

#: library/pprint.rst:177
msgid "One more support function is also defined:"
msgstr "Une dernière fonction de support est définie ainsi :"

#: library/pprint.rst:181
msgid ""
"Return a string representation of *object*, protected against recursive data "
"structures.  If the representation of *object* exposes a recursive entry, "
"the recursive reference will be represented as ``<Recursion on typename with "
"id=number>``.  The representation is not otherwise formatted."
msgstr ""
"Renvoie une représentation de *object* sous forme de chaîne de caractère, "
"celle-ci est protégée contre les structures de données récursives. Si la "
"représentation de *object* présente une entrée récursive, celle-ci sera "
"représentée telle que ``<Recursion on typename with id=number>``. Par "
"ailleurs, la représentation de l’objet n’est pas formatée."

#: library/pprint.rst:193
msgid "PrettyPrinter Objects"
msgstr "Les Objets PrettyPrinter"

#: library/pprint.rst:195
msgid ":class:`PrettyPrinter` instances have the following methods:"
msgstr ""
"Les instances de la classe :class:`PrettyPrinter` ont les méthodes "
"suivantes :"

#: library/pprint.rst:200
msgid ""
"Return the formatted representation of *object*.  This takes into account "
"the options passed to the :class:`PrettyPrinter` constructor."
msgstr ""
"Renvoie la représentation formatée de *object*. Cela prend en compte les "
"options passées au constructeur de la classe :class:`PrettyPrinter`."

#: library/pprint.rst:206
msgid ""
"Print the formatted representation of *object* on the configured stream, "
"followed by a newline."
msgstr ""
"Affiche sur le flux configuré la représentation formatée de *object*, suivie "
"d’une fin de ligne."

#: library/pprint.rst:209
msgid ""
"The following methods provide the implementations for the corresponding "
"functions of the same names.  Using these methods on an instance is slightly "
"more efficient since new :class:`PrettyPrinter` objects don't need to be "
"created."
msgstr ""
"Les méthodes suivantes fournissent les implémentations pour les fonctions "
"correspondantes de mêmes noms. L’utilisation de ces méthodes sur une "
"instance est légèrement plus efficace, car les nouveaux objets :class:"
"`PrettyPrinter` n’ont pas besoin d’être créés."

#: library/pprint.rst:219
msgid ""
"Determine if the formatted representation of the object is \"readable,\" or "
"can be used to reconstruct the value using :func:`eval`.  Note that this "
"returns ``False`` for recursive objects.  If the *depth* parameter of the :"
"class:`PrettyPrinter` is set and the object is deeper than allowed, this "
"returns ``False``."
msgstr ""
"Détermine si la représentation formatée de *object* est « lisible », ou si "
"elle peut être utilisée pour recomposer sa valeur en utilisant la fonction :"
"func:`eval`. Cela renvoie toujours ``False`` pour les objets récursifs. Si "
"le paramètre *depth* de la classe :class:`PrettyPrinter` est initialisé et "
"que l’objet est plus « profond » que permis, cela renvoie ``False``."

#: library/pprint.rst:228
msgid "Determine if the object requires a recursive representation."
msgstr "Détermine si l’objet nécessite une représentation récursive."

#: library/pprint.rst:230
msgid ""
"This method is provided as a hook to allow subclasses to modify the way "
"objects are converted to strings.  The default implementation uses the "
"internals of the :func:`saferepr` implementation."
msgstr ""
"Cette méthode est fournie sous forme de point d’entrée ou méthode (à "
"déclenchement) automatique (*hook* en anglais) pour permettre aux sous-"
"classes de modifier la façon dont les objets sont convertis en chaînes. "
"L’implémentation par défaut est celle de la fonction :func:`saferepr`."

#: library/pprint.rst:237
msgid ""
"Returns three values: the formatted version of *object* as a string, a flag "
"indicating whether the result is readable, and a flag indicating whether "
"recursion was detected.  The first argument is the object to be presented.  "
"The second is a dictionary which contains the :func:`id` of objects that are "
"part of the current presentation context (direct and indirect containers for "
"*object* that are affecting the presentation) as the keys; if an object "
"needs to be presented which is already represented in *context*, the third "
"return value should be ``True``.  Recursive calls to the :meth:`.format` "
"method should add additional entries for containers to this dictionary.  The "
"third argument, *maxlevels*, gives the requested limit to recursion; this "
"will be ``0`` if there is no requested limit.  This argument should be "
"passed unmodified to recursive calls. The fourth argument, *level*, gives "
"the current level; recursive calls should be passed a value less than that "
"of the current call."
msgstr ""
"Renvoie trois valeurs : la version formatée de *object* sous forme de chaîne "
"de caractères, une option indiquant si le résultat est « lisible », et une "
"option indiquant si une récursion a été détectée. Le premier argument est "
"l’objet à représenter. Le deuxième est un dictionnaire qui contient l'\\ :"
"func:`id` des objets (conteneurs directs ou indirects de *objet* qui "
"affectent sa représentation) qui font partie du contexte de représentation "
"courant tel que les clés; si un objet doit être représenté, mais l’a déjà "
"été dans ce contexte, le troisième argument renvoie ``True``. Des appels "
"récursifs à la méthode :meth:`.format` doivent ajouter des entrés "
"additionnelles aux conteneurs de ce dictionnaire. Le troisième argument "
"*maxlevels*, donne la limite maximale de récursivité; la valeur par défaut "
"est ``0``. Cet argument doit être passé non modifié pour des appels non "
"récursifs. Le quatrième argument, *level*, donne le niveau de récursivité "
"courant; les appels récursifs doivent être passés à une valeur inférieure à "
"celle de l’appel courant."

#: library/pprint.rst:255
msgid "Example"
msgstr "Exemple"

#: library/pprint.rst:257
msgid ""
"To demonstrate several uses of the :func:`pprint` function and its "
"parameters, let's fetch information about a project from `PyPI <https://pypi."
"org>`_::"
msgstr ""
"Pour illustrer quelques cas pratiques de l’utilisation de la fonction :func:"
"`pprint` et de ses paramètres, allons chercher des informations sur un "
"projet `PyPI <https://pypi.org>`_ ::"

#: library/pprint.rst:266
msgid "In its basic form, :func:`pprint` shows the whole object::"
msgstr ""
"Dans sa forme basique, la fonction :func:`pprint` affiche l’intégralité de "
"l’objet ::"

#: library/pprint.rst:322
msgid ""
"The result can be limited to a certain *depth* (ellipsis is used for deeper "
"contents)::"
msgstr ""
"Le résultat peut être limité à une certaine profondeur en initialisant "
"*depth*. ( ``…`` est utilisé pour des contenus plus « profonds ») ::"

#: library/pprint.rst:368
msgid ""
"Additionally, maximum character *width* can be suggested. If a long object "
"cannot be split, the specified width will be exceeded::"
msgstr ""
"De plus, une valeur maximale de caractères sur une ligne peut être définie "
"en initialisant le paramètre *width*. Si un long objet ne peut être scindé, "
"la valeur donnée à *width* sera outrepassée ::"

#~ msgid "The :mod:`pprint` module also provides several shortcut functions:"
#~ msgstr ""
#~ "Le module :mod:`pprint` fournit aussi quelques fonctions de raccourcis :"

#~ msgid ""
#~ "Construct a :class:`PrettyPrinter` instance.  This constructor "
#~ "understands several keyword parameters.  An output stream may be set "
#~ "using the *stream* keyword; the only method used on the stream object is "
#~ "the file protocol's :meth:`write` method.  If not specified, the :class:"
#~ "`PrettyPrinter` adopts ``sys.stdout``.  The amount of indentation added "
#~ "for each recursive level is specified by *indent*; the default is one.  "
#~ "Other values can cause output to look a little odd, but can make nesting "
#~ "easier to spot.  The number of levels which may be printed is controlled "
#~ "by *depth*; if the data structure being printed is too deep, the next "
#~ "contained level is replaced by ``...``.  By default, there is no "
#~ "constraint on the depth of the objects being formatted.  The desired "
#~ "output width is constrained using the *width* parameter; the default is "
#~ "80 characters.  If a structure cannot be formatted within the constrained "
#~ "width, a best effort will be made.  If *compact* is false (the default) "
#~ "each item of a long sequence will be formatted on a separate line.  If "
#~ "*compact* is true, as many items as will fit within the *width* will be "
#~ "formatted on each output line. If *sort_dicts* is true (the default), "
#~ "dictionaries will be formatted with their keys sorted, otherwise they "
#~ "will display in insertion order."
#~ msgstr ""
#~ "Crée une instance de :class:`PrettyPrinter`.  Ce constructeur accepte "
#~ "plusieurs paramètres nommés.  Un flux de sortie peut être défini par le "
#~ "mot clé *stream*; la seule méthode utilisée sur l’objet *stream* est la "
#~ "méthode :meth:`write` du protocole de fichiers.  Si rien n’est spécifié, "
#~ "la classe :class:`PrettyPrinter` utilise ``sys.stdout``.  La taille de "
#~ "l’indentation ajoutée à chaque niveau récursif est spécifiée par "
#~ "*indent*; la valeur par défaut est *1*.  D’autres valeurs pourraient "
#~ "donner des résultats surprenants, mais peuvent aider à mieux visualiser "
#~ "les imbrications.  Le nombre de niveaux qui peuvent être affichés est "
#~ "contrôlé par *depth*; si la structure de données est trop profonde, le "
#~ "niveau suivant est remplacé par ``…``.  Par défaut il n’y a pas de "
#~ "contraintes sur la profondeur des objets formatés.  Vous pouvez limiter "
#~ "la largeur de la sortie à l’aide du paramètre *width*; la valeur par "
#~ "défaut est de 80 caractères. Si une structure ne peut pas être formatée "
#~ "dans les limites de la largeur contrainte, le module fait au mieux.  Si "
#~ "*compact* est initialisé à *False* (la valeur par défaut), chaque élément "
#~ "d’une longue séquence est formaté sur une ligne séparée.  Si *compact* "
#~ "est initialisé à *True*, tous les éléments qui peuvent tenir dans la "
#~ "largeur définie sont formatés sur chaque ligne de sortie.  Si "
#~ "*sort_dicts* est *True* (la valeur par défaut), les dictionnaires sont "
#~ "formatés avec leurs clés triées, sinon ils sont affichés dans l'ordre "
#~ "d'insertion."