# 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-10-18 15:46+0200\n"

"PO-Revision-Date: 2022-10-18 12:29+0200\n"

"Last-Translator: Mindiell <mindiell@mindiell.net>\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.2.1\n"

#: howto/clinic.rst:5

msgid "Argument Clinic How-To"

msgstr "Guide Argument Clinic"

#: howto/clinic.rst:0

msgid "author"

msgstr "auteur"

#: howto/clinic.rst:7

msgid "Larry Hastings"

msgstr "Larry Hastings"

#: howto/clinic.rst:None

msgid "Abstract"

msgstr "Résumé"

#: howto/clinic.rst:12

msgid ""

"Argument Clinic is a preprocessor for CPython C files. Its purpose is to "

"automate all the boilerplate involved with writing argument parsing code for "

"\"builtins\". This document shows you how to convert your first C function "

"to work with Argument Clinic, and then introduces some advanced topics on "

"Argument Clinic usage."

msgstr ""

"Argument Clinic est un préprocesseur pour les fichiers C de CPython. Il "

"permet d'automatiser les tâches répétitives lors de la rédaction du code "

"d'analyse d'arguments pour les modules natifs. Ce document vous montre "

"comment convertir votre première fonction C de façon à ce qu'elle fonctionne "

"avec Argument Clinic, avant d'introduire des usages plus avancés d'Argument "

"Clinic."

#: howto/clinic.rst:19

msgid ""

"Currently Argument Clinic is considered internal-only for CPython. Its use "

"is not supported for files outside CPython, and no guarantees are made "

"regarding backwards compatibility for future versions. In other words: if "

"you maintain an external C extension for CPython, you're welcome to "

"experiment with Argument Clinic in your own code. But the version of "

"Argument Clinic that ships with the next version of CPython *could* be "

"totally incompatible and break all your code."

msgstr ""

"Argument Clinic est pour le moment considéré comme un outil interne à "

"CPython. Il n'est pas conçu pour gérer des fichiers à l'extérieur de "

"CPython, et sa compatibilité ascendante n'est pas garantie pour les versions "

"futures. En d'autres termes, si vous êtes mainteneur d'une extension C pour "

"CPython, vous pouvez bien sûr expérimenter avec Argument Clinic sur votre "

"propre code. Mais la version d'Argument Clinic livrée avec la prochaine "

"version de CPython *pourrait* être totalement incompatible et casser tout "

"votre code."

#: howto/clinic.rst:29

msgid "The Goals Of Argument Clinic"

msgstr "Les objectifs d'Argument Clinic"

#: howto/clinic.rst:31

msgid ""

"Argument Clinic's primary goal is to take over responsibility for all "

"argument parsing code inside CPython. This means that, when you convert a "

"function to work with Argument Clinic, that function should no longer do any "

"of its own argument parsing—the code generated by Argument Clinic should be "

"a \"black box\" to you, where CPython calls in at the top, and your code "

"gets called at the bottom, with ``PyObject *args`` (and maybe ``PyObject "

"*kwargs``) magically converted into the C variables and types you need."

msgstr ""

"Le premier objectif d'Argument Clinic est de prendre en charge toute "

"l'analyse d'arguments à l'intérieur de CPython. Cela signifie que si vous "

"convertissez une fonction pour utiliser Argument Clinic, cette fonction n'a "

"plus du tout besoin d'analyser ses propres arguments. Le code généré par "

"Argument Clinic doit être une « boîte noire » avec en entrée l'appel de "

"CPython, et en sortie l'appel à votre code. Entre les deux, ``PyObject "

"*args`` (et éventuellement ``PyObject *kwargs``) sont convertis magiquement "

"dans les variables et types C dont vous avez besoin."

#: howto/clinic.rst:41

msgid ""

"In order for Argument Clinic to accomplish its primary goal, it must be easy "

"to use. Currently, working with CPython's argument parsing library is a "

"chore, requiring maintaining redundant information in a surprising number of "

"places. When you use Argument Clinic, you don't have to repeat yourself."

msgstr ""

"Pour que le premier objectif d'Argument Clinic soit atteint, il faut qu'il "

"soit facile à utiliser. Actuellement, travailler avec la bibliothèque "

"d'analyse d'arguments de CPython est une corvée. Il faut maintenir une "

"quantité surprenante d'informations redondantes. En utilisant Argument "

"Clinic, il n'est plus nécessaire de se répéter."

#: howto/clinic.rst:47

msgid ""

"Obviously, no one would want to use Argument Clinic unless it's solving "

"their problem—and without creating new problems of its own. So it's "

"paramount that Argument Clinic generate correct code. It'd be nice if the "

"code was faster, too, but at the very least it should not introduce a major "

"speed regression. (Eventually Argument Clinic *should* make a major speedup "

"possible—we could rewrite its code generator to produce tailor-made argument "

"parsing code, rather than calling the general-purpose CPython argument "

"parsing library. That would make for the fastest argument parsing possible!)"

msgstr ""

"Certainement, personne ne voudrait utiliser Argument Clinic s'il ne réglait "

"pas son problème sans en créer de nouveaux. Il est donc de la première "

"importance qu'Argument Clinic génère du code correct. Il est aussi "

"souhaitable que le code soit aussi plus rapide. Au minimum, il ne doit pas "

"introduire de régression significative sur la vitesse d'exécution. (Au bout "

"du compte, Argument Clinic *devrait* permettre une accélération importante, "

"on pourrait ré-écrire son générateur de code pour produire du code d'analyse "

"d'arguments adapté au mieux, plutôt que d'utiliser la bibliothèque d'analyse "

"d'arguments générique. On aurait ainsi l'analyse d'arguments la plus rapide "

"possible !)"

#: howto/clinic.rst:59

msgid ""

"Additionally, Argument Clinic must be flexible enough to work with any "

"approach to argument parsing. Python has some functions with some very "

"strange parsing behaviors; Argument Clinic's goal is to support all of them."

msgstr ""

"De plus, Argument Clinic doit être suffisamment flexible pour s'accommoder "

"d'approches différentes de l'analyse d'arguments. Il y a des fonctions dans "

"Python dont le traitement des arguments est très étrange ; le but d'Argument "

"Clinic est de les gérer toutes."

#: howto/clinic.rst:64

msgid ""

"Finally, the original motivation for Argument Clinic was to provide "

"introspection \"signatures\" for CPython builtins. It used to be, the "

"introspection query functions would throw an exception if you passed in a "

"builtin. With Argument Clinic, that's a thing of the past!"

msgstr ""

"Finalement, la motivation première d'Argument Clinic était de fournir des "

"« signatures » pour l'introspection des composants natifs de CPython. "

"Précédemment, les fonctions d'introspection levaient une exception si vous "

"passiez un composant natif. Grâce à Argument Clinic, ce comportement "

"appartient au passé !"

#: howto/clinic.rst:70

msgid ""

"One idea you should keep in mind, as you work with Argument Clinic: the more "

"information you give it, the better job it'll be able to do. Argument Clinic "

"is admittedly relatively simple right now. But as it evolves it will get "

"more sophisticated, and it should be able to do many interesting and smart "

"things with all the information you give it."

msgstr ""

"En travaillant avec Argument Clinic, il faut garder à l'esprit que plus vous "

"lui donnez de détails, meilleur sera son boulot. Argument Clinic est bien "

"sûr assez simple pour le moment. Mais à mesure qu'il évoluera et deviendra "

"plus sophistiqué, il sera capable de faire beaucoup de choses intéressantes "

"et intelligentes à partir de l'information à sa disposition."

#: howto/clinic.rst:80

msgid "Basic Concepts And Usage"

msgstr "Concepts de base et utilisation"

#: howto/clinic.rst:82

msgid ""

"Argument Clinic ships with CPython; you'll find it in ``Tools/clinic/clinic."

"py``. If you run that script, specifying a C file as an argument:"

msgstr ""

"Argument Clinic est livré avec CPython ; vous le trouverez dans ``Tools/"

"clinic/clinic.py``. Si vous exécutez ce script, en spécifiant un fichier C "

"comme argument :"

#: howto/clinic.rst:89

msgid ""

"Argument Clinic will scan over the file looking for lines that look exactly "

"like this:"

msgstr "Argument Clinic va parcourir le fichier en cherchant cette ligne :"

#: howto/clinic.rst:96

msgid ""

"When it finds one, it reads everything up to a line that looks exactly like "

"this:"

msgstr ""

"Lorsqu'il en trouve une, il lit tout ce qui suit, jusqu'à cette ligne :"

#: howto/clinic.rst:103

msgid ""

"Everything in between these two lines is input for Argument Clinic. All of "

"these lines, including the beginning and ending comment lines, are "

"collectively called an Argument Clinic \"block\"."

msgstr ""

"Tout ce qui se trouve entre ces deux lignes est une entrée pour Argument "

"Clinic. Toutes ces lignes, en incluant les commentaires de début et de fin, "

"sont appelées collectivement un « bloc » d'Argument Clinic."

#: howto/clinic.rst:107

msgid ""

"When Argument Clinic parses one of these blocks, it generates output. This "

"output is rewritten into the C file immediately after the block, followed by "

"a comment containing a checksum. The Argument Clinic block now looks like "

"this:"

msgstr ""

"Lorsque *Argument Clinic* analyse l'un de ces blocs, il produit une sortie. "

"Cette sortie est réécrite dans le fichier C immédiatement après le bloc, "

"suivie par un commentaire contenant une somme de contrôle. Le bloc Argument "

"Clinic ressemble maintenant à cela :"

#: howto/clinic.rst:120

msgid ""

"If you run Argument Clinic on the same file a second time, Argument Clinic "

"will discard the old output and write out the new output with a fresh "

"checksum line. However, if the input hasn't changed, the output won't "

"change either."

msgstr ""

"Si vous exécutez de nouveau Argument Clinic sur ce même fichier, Argument "

"Clinic supprime la vieille sortie, et écrit la nouvelle sortie avec une "

"ligne de somme de contrôle mise à jour. Cependant, si l'entrée n'a pas "

"changé, la sortie ne change pas non plus."

#: howto/clinic.rst:124

msgid ""

"You should never modify the output portion of an Argument Clinic block. "

"Instead, change the input until it produces the output you want. (That's "

"the purpose of the checksum—to detect if someone changed the output, as "

"these edits would be lost the next time Argument Clinic writes out fresh "

"output.)"

msgstr ""

"Vous ne devez jamais modifier la sortie d'un bloc Argument Clinic. Changez "

"plutôt l'entrée jusqu'à obtenir la sortie souhaitée (c'est précisément le "

"but de la somme de contrôle, détecter si la sortie a été changée. En effet, "

"ces modifications seront perdues après que Argument Clinic a écrit une "

"nouvelle sortie)."

#: howto/clinic.rst:129

msgid ""

"For the sake of clarity, here's the terminology we'll use with Argument "

"Clinic:"

msgstr "Par souci de clarté, voilà la terminologie que nous emploierons :"

#: howto/clinic.rst:131

msgid ""

"The first line of the comment (``/*[clinic input]``) is the *start line*."

msgstr ""

"La première ligne du commentaire (``/*[clinic input]``) est la *ligne de "

"début*."

#: howto/clinic.rst:132

msgid ""

"The last line of the initial comment (``[clinic start generated code]*/``) "

"is the *end line*."

msgstr ""

"La dernière ligne du commentaire initial (``[clinic start generated code]*/"

"``) est la *ligne de fin*."

#: howto/clinic.rst:133

msgid ""

"The last line (``/*[clinic end generated code: checksum=...]*/``) is the "

"*checksum line*."

msgstr ""

"La dernière ligne (``/*[clinic end generated code: checksum=...]*/``) est la "

"*ligne de contrôle*."

#: howto/clinic.rst:134

msgid "In between the start line and the end line is the *input*."

msgstr ""

"On appelle *entrée* ce qui se trouve entre la ligne de début et la ligne de "

"fin."

#: howto/clinic.rst:135

msgid "In between the end line and the checksum line is the *output*."

msgstr ""

"Et on appelle *sortie* ce qui se trouve entre la ligne de fin et la ligne de "

"contrôle."

#: howto/clinic.rst:136

msgid ""

"All the text collectively, from the start line to the checksum line "

"inclusively, is the *block*. (A block that hasn't been successfully "

"processed by Argument Clinic yet doesn't have output or a checksum line, but "

"it's still considered a block.)"

msgstr ""

"L'ensemble du texte, depuis la ligne de début jusqu'à la ligne de contrôle "

"incluse s'appelle le *bloc*. (Un bloc qui n'a pas encore été traité avec "

"succès par Argument Clinic n'a pas encore de sortie ni de ligne de contrôle "

"mais est quand même considéré comme un bloc)"

#: howto/clinic.rst:143

msgid "Converting Your First Function"

msgstr "Convertissez votre première fonction"

#: howto/clinic.rst:145

msgid ""

"The best way to get a sense of how Argument Clinic works is to convert a "

"function to work with it. Here, then, are the bare minimum steps you'd need "

"to follow to convert a function to work with Argument Clinic. Note that for "

"code you plan to check in to CPython, you really should take the conversion "

"farther, using some of the advanced concepts you'll see later on in the "

"document (like \"return converters\" and \"self converters\"). But we'll "

"keep it simple for this walkthrough so you can learn."

msgstr ""

"La meilleure manière de comprendre le fonctionnement d'Argument Clinic est "

"de convertir une fonction. Voici donc les étapes minimales que vous devez "

"suivre pour convertir une fonction de manière à ce qu'elle fonctionne avec "

"Argument Clinic. Remarquez que pour du code que vous comptez inclure dans "

"CPython, vous devrez certainement pousser plus loin la conversion, en "

"utilisant les concepts avancés que nous verrons plus loin dans ce document "

"(comme ``return converters`` et ``self converters``). Mais concentrons nous "

"pour le moment sur les choses simples."

#: howto/clinic.rst:154

msgid "Let's dive in!"

msgstr "En route !"

#: howto/clinic.rst:156

msgid ""

"Make sure you're working with a freshly updated checkout of the CPython "

"trunk."

msgstr ""

"Assurez-vous que vous travaillez sur une copie récemment mise à jour du code "

"de CPython."

#: howto/clinic.rst:159

msgid ""

"Find a Python builtin that calls either :c:func:`PyArg_ParseTuple` or :c:"

"func:`PyArg_ParseTupleAndKeywords`, and hasn't been converted to work with "

"Argument Clinic yet. For my example I'm using ``_pickle.Pickler.dump()``."

msgstr ""

"Trouvez une fonction native de Python qui fait appel à :c:func:"

"`PyArg_ParseTuple` ou :c:func:`PyArg_ParseTupleAndKeywords`, et n'a pas "

"encore été convertie par Argument Clinic. Pour cet exemple, j'utilise "

"``_pickle.Pickler.dump()``."

#: howto/clinic.rst:164

msgid ""

"If the call to the ``PyArg_Parse`` function uses any of the following format "

"units:"

msgstr "Si l'appel à ``PyArg_Parse`` utilise l'un des formats suivants :"

#: howto/clinic.rst:176

msgid ""

"or if it has multiple calls to :c:func:`PyArg_ParseTuple`, you should choose "

"a different function. Argument Clinic *does* support all of these "

"scenarios. But these are advanced topics—let's do something simpler for "

"your first function."

msgstr ""

"ou s'il y a de multiples appels à :c:func:`PyArg_ParseTuple`, choisissez une "

"fonction différente. Argument Clinic gère tous ces scénarios, mais ce sont "

"des sujets trop avancés pour notre première fonction."

#: howto/clinic.rst:181

msgid ""

"Also, if the function has multiple calls to :c:func:`PyArg_ParseTuple` or :c:"

"func:`PyArg_ParseTupleAndKeywords` where it supports different types for the "

"same argument, or if the function uses something besides PyArg_Parse "

"functions to parse its arguments, it probably isn't suitable for conversion "

"to Argument Clinic. Argument Clinic doesn't support generic functions or "

"polymorphic parameters."

msgstr ""

"Par ailleurs, si la fonction a des appels multiples à :c:func:"

"`PyArg_ParseTuple` ou :c:func:`PyArg_ParseTupleAndKeywords` dans lesquels "

"elle permet différents types pour les mêmes arguments, il n'est probablement "

"pas possible de la convertir pour Argument Clinic. Argument Clinic ne gère "

"pas les fonctions génériques ou les paramètres polymorphes."

#: howto/clinic.rst:188

msgid "Add the following boilerplate above the function, creating our block::"

msgstr ""

"Ajoutez les lignes standard suivantes au-dessus de votre fonction pour créer "

"notre bloc ::"

#: howto/clinic.rst:193

msgid ""

"Cut the docstring and paste it in between the ``[clinic]`` lines, removing "

"all the junk that makes it a properly quoted C string. When you're done you "

"should have just the text, based at the left margin, with no line wider than "

"80 characters. (Argument Clinic will preserve indents inside the docstring.)"

msgstr ""

"Coupez la *docstring* et collez-la entre les lignes commençant par "

"``[clinic]``, en enlevant tout le bazar qui en fait une chaîne de caractères "

"correcte en C. Une fois que c'est fait, vous devez avoir seulement le texte, "

"aligné à gauche, sans ligne plus longue que 80 caractères (Argument Clinic "

"préserve l'indentation à l'intérieur de la *docstring*)."

#: howto/clinic.rst:199

msgid ""

"If the old docstring had a first line that looked like a function signature, "

"throw that line away. (The docstring doesn't need it anymore—when you use "

"``help()`` on your builtin in the future, the first line will be built "

"automatically based on the function's signature.)"

msgstr ""

"Si l'ancienne *docstring* commençait par une ligne qui ressemble à une "

"signature de fonction, supprimez cette ligne. (Elle n'est plus nécessaire "

"pour la *docstring*. Dans le futur, quand vous utiliserez ``help()`` pour "

"une fonction native, la première ligne sera construite automatiquement à "

"partir de la signature de la fonction.)"

#: howto/clinic.rst:226 howto/clinic.rst:308 howto/clinic.rst:375

#: howto/clinic.rst:533

msgid "Sample::"

msgstr "Échantillon ::"

#: howto/clinic.rst:211

msgid ""

"If your docstring doesn't have a \"summary\" line, Argument Clinic will "

"complain. So let's make sure it has one. The \"summary\" line should be a "

"paragraph consisting of a single 80-column line at the beginning of the "

"docstring."

msgstr ""

"Si votre *docstring* ne contient pas de ligne « résumé », Argument Clinic va "

"se plaindre. Assurons-nous donc qu'il y en a une. La ligne « résumé » doit "

"être un paragraphe consistant en une seule ligne de 80 colonnes au début de "

"la *docstring*."

#: howto/clinic.rst:216

msgid ""

"(Our example docstring consists solely of a summary line, so the sample code "

"doesn't have to change for this step.)"

msgstr ""

"Dans notre exemple, la *docstring* est seulement composée d'une ligne de "

"résumé, donc le code ne change pas à cette étape."

#: howto/clinic.rst:219

msgid ""

"Above the docstring, enter the name of the function, followed by a blank "

"line. This should be the Python name of the function, and should be the "

"full dotted path to the function—it should start with the name of the "

"module, include any sub-modules, and if the function is a method on a class "

"it should include the class name too."

msgstr ""

"Au-dessus de la *docstring*, entrez le nom de la fonction, suivi d'une ligne "

"vide. Ce doit être le nom de la fonction en Python et être le chemin complet "

"jusqu'à la fonction. Il doit commencer par le nom du module, suivi de tous "

"les sous-modules, puis, si la fonction est une méthode de classe, inclure "

"aussi le nom de la classe."

#: howto/clinic.rst:234

msgid ""

"If this is the first time that module or class has been used with Argument "

"Clinic in this C file, you must declare the module and/or class. Proper "

"Argument Clinic hygiene prefers declaring these in a separate block "

"somewhere near the top of the C file, in the same way that include files and "

"statics go at the top. (In our sample code we'll just show the two blocks "

"next to each other.)"

msgstr ""

"Si c'est la première fois que ce module ou cette classe est utilisée avec "

"Argument Clinic dans ce fichier C, vous devez déclarer votre module et/ou "

"votre classe. Pour suivre de bonnes pratiques avec Argument Clinic, il vaut "

"mieux faire ces déclarations quelque part en tête du fichier C, comme les "

"fichiers inclus et les statiques (dans cet extrait, nous montrons les deux "

"blocs à côté l'un de l'autre)."

#: howto/clinic.rst:242

msgid ""

"The name of the class and module should be the same as the one seen by "

"Python. Check the name defined in the :c:type:`PyModuleDef` or :c:type:"

"`PyTypeObject` as appropriate."

msgstr ""

"Le nom de la classe et du module doivent être les mêmes que ceux vus par "

"Python. Selon le cas, référez-vous à :c:type:`PyModuleDef` ou :c:type:"

"`PyTypeObject`"

#: howto/clinic.rst:246

msgid ""

"When you declare a class, you must also specify two aspects of its type in "

"C: the type declaration you'd use for a pointer to an instance of this "

"class, and a pointer to the :c:type:`PyTypeObject` for this class."

msgstr ""

"Quand vous déclarez une classe, vous devez aussi spécifier deux aspects de "

"son type en C : la déclaration de type que vous utiliseriez pour un pointeur "

"vers une instance de cette classe et un pointeur vers le :c:type:"

"`PyTypeObject` de cette classe."

#: howto/clinic.rst:266

msgid ""

"Declare each of the parameters to the function. Each parameter should get "

"its own line. All the parameter lines should be indented from the function "

"name and the docstring."

msgstr ""

"Déclarez chacun des paramètres de la fonction. Chaque paramètre doit être "

"sur une ligne séparée. Tous les paramètres doivent être indentés par rapport "

"au nom de la fonction et à la *docstring*."

#: howto/clinic.rst:270

msgid "The general form of these parameter lines is as follows:"

msgstr "La forme générale de ces paramètres est la suivante :"

#: howto/clinic.rst:276

msgid "If the parameter has a default value, add that after the converter:"

msgstr ""

"Si le paramètre a une valeur par défaut, ajoutez ceci après le "

"convertisseur :"

#: howto/clinic.rst:283

msgid ""

"Argument Clinic's support for \"default values\" is quite sophisticated; "

"please see :ref:`the section below on default values <default_values>` for "

"more information."

msgstr ""

"Argument Clinic peut traiter les « valeurs par défaut » de manière assez "

"sophistiquée ; voyez :ref:`la section ci-dessous sur les valeurs par défaut "

"<default_values>` pour plus de détails."

#: howto/clinic.rst:287

msgid "Add a blank line below the parameters."

msgstr "Ajoutez une ligne vide sous les paramètres."

#: howto/clinic.rst:289

msgid ""

"What's a \"converter\"? It establishes both the type of the variable used "

"in C, and the method to convert the Python value into a C value at runtime. "

"For now you're going to use what's called a \"legacy converter\"—a "

"convenience syntax intended to make porting old code into Argument Clinic "

"easier."

msgstr ""

"Que fait le « convertisseur » ? Il établit à la fois le type de variable "

"utilisé en C et la méthode pour convertir la valeur Python en valeur C lors "

"de l'exécution. Pour le moment, vous allez utiliser ce qui s'appelle un "

"« convertisseur hérité », une syntaxe de convenance qui facilite le portage "

"de vieux code dans Argument Clinic."

#: howto/clinic.rst:296

msgid ""

"For each parameter, copy the \"format unit\" for that parameter from the "

"``PyArg_Parse()`` format argument and specify *that* as its converter, as a "

"quoted string. (\"format unit\" is the formal name for the one-to-three "

"character substring of the ``format`` parameter that tells the argument "

"parsing function what the type of the variable is and how to convert it. "

"For more on format units please see :ref:`arg-parsing`.)"

msgstr ""

"Pour chaque paramètre, copiez la « spécification de format » de ce paramètre "

"à partir de l'argument de ``PyArg_Parse()`` et spécifiez *ça* comme "

"convertisseur, entre guillemets. (la « spécification de format » est le nom "

"formel pour la partie du paramètre ``format``, de un à trois caractères, qui "

"indique à la fonction d'analyse d'arguments quel est le type de la variable "

"et comment la convertir. Pour plus d'information sur les spécifications de "

"format, voyez :ref:`arg-parsing`.)"

#: howto/clinic.rst:305

msgid ""

"For multicharacter format units like ``z#``, use the entire two-or-three "

"character string."

msgstr ""

"Pour des spécifications de format de plusieurs caractères, comme ``z#``, "

"utilisez l'ensemble des 2 ou 3 caractères de la chaîne."

#: howto/clinic.rst:323

msgid ""

"If your function has ``|`` in the format string, meaning some parameters "

"have default values, you can ignore it. Argument Clinic infers which "

"parameters are optional based on whether or not they have default values."

msgstr ""

"Si votre fonction a le caractère ``|`` dans son format, parce que certains "

"paramètres ont des valeurs par défaut, vous pouvez l'ignorer. Argument "

"Clinic infère quels paramètres sont optionnels selon s'ils ont ou non une "

"valeur par défaut."

#: howto/clinic.rst:328

msgid ""

"If your function has ``$`` in the format string, meaning it takes keyword-"

"only arguments, specify ``*`` on a line by itself before the first keyword-"

"only argument, indented the same as the parameter lines."

msgstr ""

"Si votre fonction a le caractère ``$`` dans son format, parce qu'elle "

"n'accepte que des arguments nommés, spécifiez ``*`` sur une ligne à part, "

"avant le premier argument nommé, avec la même indentation que les lignes de "

"paramètres."

#: howto/clinic.rst:333

msgid "(``_pickle.Pickler.dump`` has neither, so our sample is unchanged.)"

msgstr ""

"(``_pickle.Pickler.dump`` n'a ni l'un ni l'autre, donc notre exemple est "

"inchangé.)"

#: howto/clinic.rst:336

msgid ""

"If the existing C function calls :c:func:`PyArg_ParseTuple` (as opposed to :"

"c:func:`PyArg_ParseTupleAndKeywords`), then all its arguments are positional-"

"only."

msgstr ""

"Si la fonction C existante appelle :c:func:`PyArg_ParseTuple` (et pas :c:"

"func:`PyArg_ParseTupleAndKeywords`), alors tous ses arguments sont "

"uniquement positionnels."

#: howto/clinic.rst:340

msgid ""

"To mark all parameters as positional-only in Argument Clinic, add a ``/`` on "

"a line by itself after the last parameter, indented the same as the "

"parameter lines."

msgstr ""

"Pour marquer tous les paramètres comme uniquement positionnels dans Argument "

"Clinic, ajoutez ``/`` sur une ligne à part après le dernier paramètre, avec "

"la même indentation que les lignes de paramètres."

#: howto/clinic.rst:344

msgid ""

"Currently this is all-or-nothing; either all parameters are positional-only, "

"or none of them are. (In the future Argument Clinic may relax this "

"restriction.)"

msgstr ""

"Pour le moment, c'est tout ou rien ; soit tous les paramètres sont "

"uniquement positionnels, ou aucun ne l'est. (Dans le futur, Argument Clinic "

"supprimera peut-être cette restriction.)"

#: howto/clinic.rst:364

msgid ""

"It's helpful to write a per-parameter docstring for each parameter. But per-"

"parameter docstrings are optional; you can skip this step if you prefer."

msgstr ""

"Il est utile d'ajouter une *docstring* pour chaque paramètre, mais c'est "

"optionnel ; vous pouvez passer cette étape si vous préférez."

#: howto/clinic.rst:368

msgid ""

"Here's how to add a per-parameter docstring. The first line of the per-"

"parameter docstring must be indented further than the parameter definition. "

"The left margin of this first line establishes the left margin for the whole "

"per-parameter docstring; all the text you write will be outdented by this "

"amount. You can write as much text as you like, across multiple lines if "

"you wish."

msgstr ""

"Voici comment ajouter la *docstring* d'un paramètre. La première ligne doit "

"être plus indentée que la définition du paramètre. La marge gauche de cette "

"première ligne établit la marge gauche pour l'ensemble de la *docstring* de "

"ce paramètre ; tout le texte que vous écrivez sera indenté de cette "

"quantité. Vous pouvez écrire autant de texte que vous le souhaitez, sur "

"plusieurs lignes."

#: howto/clinic.rst:392

msgid ""

"Save and close the file, then run ``Tools/clinic/clinic.py`` on it. With "

"luck everything worked---your block now has output, and a ``.c.h`` file has "

"been generated! Reopen the file in your text editor to see::"

msgstr ""

"Enregistrez puis fermez le fichier, puis exécutez ``Tools/clinic/clinic.py`` "

"dessus. Avec un peu de chance tout a fonctionné, votre bloc a maintenant une "

"sortie, et un fichier ``.c.h`` a été généré ! Ré-ouvrez le fichier dans "

"votre éditeur pour voir ::"

#: howto/clinic.rst:411

msgid ""

"Obviously, if Argument Clinic didn't produce any output, it's because it "

"found an error in your input. Keep fixing your errors and retrying until "

"Argument Clinic processes your file without complaint."

msgstr ""

"Bien sûr, si Argument Clinic n'a pas produit de sortie, c'est qu'il a "

"rencontré une erreur dans votre entrée. Corrigez vos erreurs et réessayez "

"jusqu'à ce qu'Argument Clinic traite votre fichier sans problème."

#: howto/clinic.rst:415

msgid ""

"For readability, most of the glue code has been generated to a ``.c.h`` "

"file. You'll need to include that in your original ``.c`` file, typically "

"right after the clinic module block::"

msgstr ""

"Pour plus de visibilité, la plupart du code a été écrit dans un fichier ``.c."

"h``. Vous devez l'inclure dans votre fichier ``.c`` original, typiquement "

"juste après le bloc du module *clinic* ::"

#: howto/clinic.rst:421

msgid ""

"Double-check that the argument-parsing code Argument Clinic generated looks "

"basically the same as the existing code."

msgstr ""

"Vérifiez bien que le code d'analyse d'arguments généré par Argument Clinic "

"ressemble bien au code existant."

#: howto/clinic.rst:424

msgid ""

"First, ensure both places use the same argument-parsing function. The "

"existing code must call either :c:func:`PyArg_ParseTuple` or :c:func:"

"`PyArg_ParseTupleAndKeywords`; ensure that the code generated by Argument "

"Clinic calls the *exact* same function."

msgstr ""

"Assurez vous premièrement que les deux codes utilisent la même fonction pour "

"analyser les arguments. Le code existant doit appeler soit :c:func:"

"`PyArg_ParseTuple` soit :c:func:`PyArg_ParseTupleAndKeywords` ; assurez vous "

"que le code généré par Argument Clinic appelle *exactement* la même fonction."

#: howto/clinic.rst:430

msgid ""

"Second, the format string passed in to :c:func:`PyArg_ParseTuple` or :c:func:"

"`PyArg_ParseTupleAndKeywords` should be *exactly* the same as the hand-"

"written one in the existing function, up to the colon or semi-colon."

msgstr ""

"Deuxièmement, la chaîne de caractère du format passée dans :c:func:"

"`PyArg_ParseTuple` ou :c:func:`PyArg_ParseTupleAndKeywords` doit être "

"*exactement* la même que celle écrite à la main, jusqu'aux deux points ou au "

"point virgule."

#: howto/clinic.rst:435

msgid ""

"(Argument Clinic always generates its format strings with a ``:`` followed "

"by the name of the function. If the existing code's format string ends with "

"``;``, to provide usage help, this change is harmless—don't worry about it.)"

msgstr ""

"(Argument Clinic génère toujours ses chaînes de format avec ``:`` suivi du "

"nom de la fonction. Si la chaîne de format du code existant termine par ``;"

"``, pour fournir une aide sur l'utilisation, ce changement n'a aucun effet, "

"ne vous en souciez pas.)"

#: howto/clinic.rst:440

msgid ""

"Third, for parameters whose format units require two arguments (like a "

"length variable, or an encoding string, or a pointer to a conversion "

"function), ensure that the second argument is *exactly* the same between the "

"two invocations."

msgstr ""

"Troisièmement, pour des paramètres dont la spécification de format nécessite "

"deux arguments (comme une variable de longueur, ou une chaîne d'encodage, ou "

"un pointeur vers une fonction de conversion), assurez vous que ce deuxième "

"argument est *exactement* le même entre les deux invocations."

#: howto/clinic.rst:445

msgid ""

"Fourth, inside the output portion of the block you'll find a preprocessor "

"macro defining the appropriate static :c:type:`PyMethodDef` structure for "

"this builtin::"

msgstr ""

"Quatrièmement, à l'intérieur de la section sortie du bloc, vous trouverez "

"une macro pré-processeur qui définit les structures statiques :c:type:"

"`PyMethodDef` appropriées pour ce module natif ::"

#: howto/clinic.rst:452

msgid ""

"This static structure should be *exactly* the same as the existing static :c:"

"type:`PyMethodDef` structure for this builtin."

msgstr ""

"Cette structure statique doit être *exactement* la même que la structure "

"statique :c:type:`PyMethodDef` existante pour ce module natif."

#: howto/clinic.rst:455

msgid ""

"If any of these items differ in *any way*, adjust your Argument Clinic "

"function specification and rerun ``Tools/clinic/clinic.py`` until they *are* "

"the same."

msgstr ""

"Si l'un de ces éléments diffère *de quelque façon que se soit*, ajustez la "

"spécification de fonction d'Argument Clinic et exécutez de nouveau ``Tools/"

"clinic/clinic.py`` jusqu'à ce qu'elles soient identiques."

#: howto/clinic.rst:460

msgid ""

"Notice that the last line of its output is the declaration of your \"impl\" "

"function. This is where the builtin's implementation goes. Delete the "

"existing prototype of the function you're modifying, but leave the opening "

"curly brace. Now delete its argument parsing code and the declarations of "

"all the variables it dumps the arguments into. Notice how the Python "

"arguments are now arguments to this impl function; if the implementation "

"used different names for these variables, fix it."

msgstr ""

"Notez que la dernière ligne de cette sortie est la déclaration de votre "

"fonction ``impl``. C'est là que se trouve l'implémentation de la fonction "

"native. Supprimez le prototype de la fonction que vous modifiez, mais "

"laissez l'accolade ouverte. Maintenant, supprimez tout le code d'analyse "

"d'arguments et les déclarations de toutes les variables auxquelles il "

"assigne les arguments. Vous voyez que désormais les arguments Python sont "

"ceux de cette fonction ``impl`` ; si l'implémentation utilise des noms "

"différents pour ces variables, corrigez-les."

#: howto/clinic.rst:468

msgid ""

"Let's reiterate, just because it's kind of weird. Your code should now look "

"like this::"

msgstr ""

"Comme c'est un peu bizarre, ça vaut la peine de répéter. Votre fonction doit "

"ressembler à ça ::"

#: howto/clinic.rst:477

msgid ""

"Argument Clinic generated the checksum line and the function prototype just "

"above it. You should write the opening (and closing) curly braces for the "

"function, and the implementation inside."

msgstr ""

"Argument Clinic génère une ligne de contrôle et la fonction prototype juste "

"au-dessus. Vous devez écrire les accolades d'ouverture (et de fermeture) "

"pour la fonction, et l’implémentation à l'intérieur."

#: howto/clinic.rst:522

msgid ""

"Remember the macro with the :c:type:`PyMethodDef` structure for this "

"function? Find the existing :c:type:`PyMethodDef` structure for this "

"function and replace it with a reference to the macro. (If the builtin is "

"at module scope, this will probably be very near the end of the file; if the "

"builtin is a class method, this will probably be below but relatively near "

"to the implementation.)"

msgstr ""

"Vous vous souvenez de la macro avec la structure :c:type:`PyMethodDef` pour "

"cette fonction ? Trouvez la structure :c:type:`PyMethodDef` existante pour "

"cette fonction et remplacez là par une référence à cette macro. (Si la "

"fonction native est définie au niveau d'un module, vous le trouverez "

"certainement vers la fin du fichier ; s'il s'agit d'une méthode de classe, "

"se sera sans doute plus bas, mais relativement près de l'implémentation.)"

#: howto/clinic.rst:529

msgid ""

"Note that the body of the macro contains a trailing comma. So when you "

"replace the existing static :c:type:`PyMethodDef` structure with the macro, "

"*don't* add a comma to the end."

msgstr ""

"Notez que le corps de la macro contient une virgule finale. Donc, lorsque "

"vous remplacez la structure statique :c:type:`PyMethodDef` par la macro, "

"*n'ajoutez pas* de virgule à la fin."

#: howto/clinic.rst:542

#, fuzzy

msgid ""

"Compile, then run the relevant portions of the regression-test suite. This "

"change should not introduce any new compile-time warnings or errors, and "

"there should be no externally visible change to Python's behavior."

msgstr ""

"Compilez, puis faites tourner les portions idoines de la suite de tests de "

"régressions. Ce changement ne doit introduire aucun nouveau message d'erreur "

"ou avertissement à la compilation, et il ne devrait y avoir aucun changement "

"visible de l'extérieur au comportement de Python."

#: howto/clinic.rst:546

msgid ""

"Well, except for one difference: ``inspect.signature()`` run on your "

"function should now provide a valid signature!"

msgstr ""

"Enfin, à part pour une différence : si vous exécutez ``inspect.signature()`` "

"sur votre fonction, vous obtiendrez maintenant une signature valide !"

#: howto/clinic.rst:549

msgid ""

"Congratulations, you've ported your first function to work with Argument "

"Clinic!"

msgstr ""

"Félicitations, vous avez adapté votre première fonction pour qu'elle utilise "

"Argument Clinic !"

#: howto/clinic.rst:552

msgid "Advanced Topics"

msgstr "Sujets avancés"

#: howto/clinic.rst:554

msgid ""

"Now that you've had some experience working with Argument Clinic, it's time "

"for some advanced topics."

msgstr ""

"Maintenant que vous avez un peu d'expérience avec Argument Clinic, c'est le "

"moment pour des sujets avancés."

#: howto/clinic.rst:559

msgid "Symbolic default values"

msgstr "Valeurs par défaut"

#: howto/clinic.rst:561

msgid ""

"The default value you provide for a parameter can't be any arbitrary "

"expression. Currently the following are explicitly supported:"

msgstr ""

"La valeur par défaut que vous fournissez pour un paramètre ne peut pas être "

"n'importe quelle expression. Actuellement, ce qui est géré :"

#: howto/clinic.rst:564

msgid "Numeric constants (integer and float)"

msgstr "Constantes numériques (entier ou nombre flottant)"

#: howto/clinic.rst:565

msgid "String constants"

msgstr "Chaînes constantes"

#: howto/clinic.rst:566

msgid "``True``, ``False``, and ``None``"

msgstr "``True``, ``False`` et ``None``"

#: howto/clinic.rst:567

msgid ""

"Simple symbolic constants like ``sys.maxsize``, which must start with the "

"name of the module"

msgstr ""

"Constantes symboliques simples comme ``sys.maxsize``, qui doivent commencer "

"par le nom du module"

#: howto/clinic.rst:570

msgid ""

"In case you're curious, this is implemented in ``from_builtin()`` in ``Lib/"

"inspect.py``."

msgstr ""

"Si par curiosité vous voulez lire l'implémentation, c'est ``from_builtin()`` "

"dans ``Lib/inspect.py``."

#: howto/clinic.rst:573

msgid ""

"(In the future, this may need to get even more elaborate, to allow full "

"expressions like ``CONSTANT - 1``.)"

msgstr ""

"(Dans le futur, il est possible que l'on ait besoin de l'améliorer, pour "

"autoriser les expressions complètes comme ``CONSTANT - 1``.)"

#: howto/clinic.rst:578

msgid "Renaming the C functions and variables generated by Argument Clinic"

msgstr "Renommer les fonctions et variables C générées par Argument Clinic"

#: howto/clinic.rst:580

msgid ""

"Argument Clinic automatically names the functions it generates for you. "

"Occasionally this may cause a problem, if the generated name collides with "

"the name of an existing C function. There's an easy solution: override the "

"names used for the C functions. Just add the keyword ``\"as\"`` to your "

"function declaration line, followed by the function name you wish to use. "

"Argument Clinic will use that function name for the base (generated) "

"function, then add ``\"_impl\"`` to the end and use that for the name of the "

"impl function."

msgstr ""

"Argument Clinic nomme automatiquement les fonctions qu'il génère. Parfois, "

"cela peut poser des problèmes, si le nom généré entre en collision avec le "

"nom d'une fonction C existante. Il y a une solution simple : surcharger les "

"noms utilisés par les fonctions C. Ajoutez simplement le mot clef ``\"as\"`` "

"sur la ligne de la déclaration de la fonction, suivi par le nom de la "

"fonction que vous souhaitez utiliser. Argument Clinic utilisera ce nom de "

"fonction pour la fonction de base (celle générée), et ajoutera ``\"_impl\"`` "

"à la fin et utilisera ce nom pour la fonction ``impl``."

#: howto/clinic.rst:588

msgid ""

"For example, if we wanted to rename the C function names generated for "

"``pickle.Pickler.dump``, it'd look like this::"

msgstr ""

"Par exemple, si nous voulons renommer les noms de fonction C générés pour "

"``pickle.Pickler.dump``, ça ressemblerait à ça ::"

#: howto/clinic.rst:596

msgid ""

"The base function would now be named ``pickler_dumper()``, and the impl "

"function would now be named ``pickler_dumper_impl()``."

msgstr ""

"La fonction de base sera maintenant nommée ``pickler_dumper()``, et la "

"fonction ``impl`` sera maintenant nommée ``pickler_dumper_impl()``."

#: howto/clinic.rst:600

msgid ""

"Similarly, you may have a problem where you want to give a parameter a "

"specific Python name, but that name may be inconvenient in C. Argument "

"Clinic allows you to give a parameter different names in Python and in C, "

"using the same ``\"as\"`` syntax::"

msgstr ""

"De même, vous pouvez avoir un problème quand vous souhaiterez donner à un "

"paramètre un nom spécifique à Python, mais ce nom peut être gênant en C. "

"Argument Clinic vous permet de donner à un paramètre des noms différents en "

"Python et en C ::"

#: howto/clinic.rst:614

msgid ""

"Here, the name used in Python (in the signature and the ``keywords`` array) "

"would be ``file``, but the C variable would be named ``file_obj``."

msgstr ""

"Ici, le nom utilisé en Python (dans la signature ainsi que le tableau des "

"``keywords``) sera ``file``, et la variable C s'appellera ``file_obj``."

#: howto/clinic.rst:617

msgid "You can use this to rename the ``self`` parameter too!"

msgstr "Vous pouvez utiliser ceci pour renommer aussi le paramètre ``self``"

#: howto/clinic.rst:621

msgid "Converting functions using PyArg_UnpackTuple"

msgstr "Conversion des fonctions en utilisant *PyArg_UnpackTuple*"

#: howto/clinic.rst:623

msgid ""

"To convert a function parsing its arguments with :c:func:"

"`PyArg_UnpackTuple`, simply write out all the arguments, specifying each as "

"an ``object``. You may specify the ``type`` argument to cast the type as "

"appropriate. All arguments should be marked positional-only (add a ``/`` on "

"a line by itself after the last argument)."

msgstr ""

"Afin de convertir une fonction analysant ses arguments via :c:func:"

"`PyArg_UnpackTuple`, écrivez simplement tous les arguments, en les "

"spécifiant comme des ``object``. Vous pouvez spécifier également le ``type`` "

"d'argument afin de le forcer au type approprié. Tous les arguments devraient "

"être marqués comme seulement positionnels (ajoutez un ``/`` seul sur la "

"ligne après le dernier argument)."

#: howto/clinic.rst:629

msgid ""

"Currently the generated code will use :c:func:`PyArg_ParseTuple`, but this "

"will change soon."

msgstr ""

"Actuellement, le code généré utilise :c:func:`PyArg_ParseTuple`, mais cela "

"va bientôt changer."

#: howto/clinic.rst:633

msgid "Optional Groups"

msgstr "Groupes optionnels"

#: howto/clinic.rst:635

msgid ""

"Some legacy functions have a tricky approach to parsing their arguments: "

"they count the number of positional arguments, then use a ``switch`` "

"statement to call one of several different :c:func:`PyArg_ParseTuple` calls "

"depending on how many positional arguments there are. (These functions "

"cannot accept keyword-only arguments.) This approach was used to simulate "

"optional arguments back before :c:func:`PyArg_ParseTupleAndKeywords` was "

"created."

msgstr ""