# Copyright (C) 2001-2020, Python Software Foundation

# This file is distributed under the same license as the Python package.

# Maintained by the python-doc-es workteam.

# docs-es@python.org /

# https://mail.python.org/mailman3/lists/docs-es.python.org/

# Check https://github.com/python/python-docs-es/blob/3.8/TRANSLATORS to

# get the list of volunteers

#

msgid ""

msgstr ""

"Project-Id-Version: Python 3.8\n"

"Report-Msgid-Bugs-To: \n"

"POT-Creation-Date: 2020-05-05 12:54+0200\n"

"PO-Revision-Date: 2020-08-15 22:56+0200\n"

"Language-Team: python-doc-es\n"

"MIME-Version: 1.0\n"

"Content-Type: text/plain; charset=UTF-8\n"

"Content-Transfer-Encoding: 8bit\n"

"Generated-By: Babel 2.8.0\n"

"Plural-Forms: nplurals=2; plural=(n != 1);\n"

"Last-Translator: Cristián Maureira-Fredes <cmaureirafredes@gmail.com>\n"

"Language: es\n"

"X-Generator: Poedit 2.3.1\n"

#: ../Doc/howto/clinic.rst:5

msgid "Argument Clinic How-To"

msgstr "*How-To* Argument Clinic"

#: ../Doc/howto/clinic.rst

msgid "author"

msgstr "autor"

#: ../Doc/howto/clinic.rst:7

msgid "Larry Hastings"

msgstr "*Larry Hastings*"

msgid "Abstract"

msgstr "Resumen"

#: ../Doc/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 es un preprocesador para archivos CPython C. Su propósito es "

"automatizar todo el texto estándar involucrado con la escritura de código de "

"análisis de argumentos para \"incorporados\". Este documento le muestra cómo "

"convertir su primera función C para que funcione con Argument Clinic y luego "

"presenta algunos temas avanzados sobre el uso de Argument Clinic."

#: ../Doc/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 ""

"Actualmente, Argument Clinic se considera solo interno para CPython. Su uso "

"no es compatible con archivos fuera de CPython y no se ofrecen garantías con "

"respecto a la compatibilidad con versiones anteriores. En otras palabras: si "

"mantiene una extensión C externa para CPython, puede experimentar con "

"Argument Clinic en su propio código. Pero la versión de Argument Clinic que "

"se envía con la próxima versión de CPython *podría* ser totalmente "

"incompatible y romper todo su código."

#: ../Doc/howto/clinic.rst:29

msgid "The Goals Of Argument Clinic"

msgstr "Los objetivos del Argument Clinic"

#: ../Doc/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 ""

"El objetivo principal de Argument Clinic es asumir la responsabilidad de "

"todo el código de análisis de argumentos dentro de CPython. Esto significa "

"que, cuando convierte una función para que funcione con Argument Clinic, esa "

"función ya no debería realizar ninguno de sus propios análisis de "

"argumentos; el código generado por Argument Clinic debería ser una \"caja "

"negra\" para usted, donde CPython llama al top, y su código se llama en la "

"parte inferior, con ``PyObject *args`` (y tal vez ``PyObject *kwargs``) "

"convertido mágicamente en las variables y tipos C que necesita."

#: ../Doc/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 ""

"Para que Argument Clinic logre su objetivo principal, debe ser fácil de "

"usar. Actualmente, trabajar con la biblioteca de análisis de argumentos de "

"CPython es una tarea ardua que requiere mantener información redundante en "

"un número sorprendente de lugares. Cuando usa Argument Clinic, no tiene que "

"repetirse."

#: ../Doc/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 ""

"Obviamente, si Argument Clinic no produjo ningún resultado, es porque "

"encontró un error en su entrada. Siga corrigiendo sus errores y vuelva a "

"intentarlo hasta que Argument Clinic procese su archivo sin quejas."

#: ../Doc/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 ""

"Además, Argument Clinic debe ser lo suficientemente flexible como para "

"trabajar con cualquier enfoque de análisis de argumentos. Python tiene "

"algunas funciones con algunos comportamientos de análisis muy extraños; el "

"objetivo de Argument Clinic es apoyarlos a todos."

#: ../Doc/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 ""

"Finalmente, la motivación original de Argument Clinic era proporcionar "

"\"signaturas\" de introspección para las incorporaciones de CPython. Solía "

"ser, las funciones de consulta de introspección lanzarían una excepción si "

"pasaba un archivo incorporado. ¡Con Argument Clinic, eso es cosa del pasado!"

#: ../Doc/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 ""

"Una idea que debe tener en cuenta al trabajar con Argument Clinic: cuanta "

"más información le dé, mejor será su trabajo. Argument Clinic es ciertamente "

"relativamente simple en este momento. Pero a medida que evolucione, se "

"volverá más sofisticado y debería poder hacer muchas cosas interesantes e "

"inteligentes con toda la información que le proporcione."

#: ../Doc/howto/clinic.rst:80

msgid "Basic Concepts And Usage"

msgstr "Conceptos básicos y uso"

#: ../Doc/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 se envía con CPython; lo encontrará en ``Tools/clinic/clinic."

"py``. Si ejecuta ese script, especificando un archivo C como argumento:"

#: ../Doc/howto/clinic.rst:89

msgid ""

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

"like this:"

msgstr ""

"Argument Clinic escaneará el archivo buscando líneas que se vean exactamente "

"así:"

#: ../Doc/howto/clinic.rst:96

msgid ""

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

"this:"

msgstr ""

"Cuando encuentra uno, lee todo hasta una línea que se ve exactamente así:"

#: ../Doc/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 ""

"Todo lo que se encuentra entre estas dos líneas es entrada para Argument "

"Clinic. Todas estas líneas, incluidas las líneas de comentarios iniciales y "

"finales, se denominan colectivamente un \"bloque\" de Argument Clinic."

#: ../Doc/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 ""

"Cuando Argument Clinic analiza uno de estos bloques, genera una salida. Esta "

"salida se reescribe en el archivo C inmediatamente después del bloque, "

"seguida de un comentario que contiene una suma de comprobación. El bloque "

"Argument Clinic ahora tiene este aspecto:"

#: ../Doc/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 ejecuta Argument Clinic en el mismo archivo por segunda vez, Argument "

"Clinic descartará la salida anterior y escribirá la nueva salida con una "

"nueva línea de suma de comprobación. Sin embargo, si la entrada no ha "

"cambiado, la salida tampoco cambiará."

#: ../Doc/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 ""

"Nunca debe modificar la parte de salida de un bloque de Argument Clinic. En "

"su lugar, cambie la entrada hasta que produzca la salida que desea. (Ese es "

"el propósito de la suma de comprobación: detectar si alguien cambió la "

"salida, ya que estas ediciones se perderían la próxima vez que Argument "

"Clinic escriba una salida nueva)."

#: ../Doc/howto/clinic.rst:129

msgid ""

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

"Clinic:"

msgstr ""

"En aras de la claridad, esta es la terminología que usaremos con Argument "

"Clinic:"

#: ../Doc/howto/clinic.rst:131

msgid ""

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

msgstr ""

"La primera línea del comentario (``/*[clinic input]``) es la *línea de "

"inicio*."

#: ../Doc/howto/clinic.rst:132

msgid ""

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

"is the *end line*."

msgstr ""

"La última línea del comentario inicial (``[clinic start generated code]*/``) "

"es la *línea final*."

#: ../Doc/howto/clinic.rst:133

msgid ""

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

"*checksum line*."

msgstr ""

"La última línea (``/*[clinic end generated code: checksum=...]*/``) es la "

"*línea de suma de comprobación* (*chemsum line*)."

#: ../Doc/howto/clinic.rst:134

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

msgstr "Entre la línea de inicio y la línea final está el *input*."

#: ../Doc/howto/clinic.rst:135

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

msgstr ""

"Entre la línea final y la línea de suma de comprobación se encuentra la "

"*output*."

#: ../Doc/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 ""

"Todo el texto colectivamente, desde la línea de inicio hasta la línea de "

"suma de verificación inclusive, es el *bloque*. (Un bloque que no ha sido "

"procesado con éxito por Argument Clinic todavía no tiene salida o una línea "

"de suma de verificación, pero aún se considera un bloque)."

#: ../Doc/howto/clinic.rst:143

msgid "Converting Your First Function"

msgstr "Convirtiendo su primera función"

#: ../Doc/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 mejor manera de tener una idea de cómo funciona Argument Clinic es "

"convertir una función para que funcione con ella. Aquí, entonces, están los "

"pasos mínimos que debe seguir para convertir una función para que funcione "

"con Argument Clinic. Tenga en cuenta que para el código que planea registrar "

"en CPython, realmente debería llevar la conversión más lejos, utilizando "

"algunos de los conceptos avanzados que verá más adelante en el documento "

"(como \"convertidores de retorno\" y \"convertidores automáticos\"). Pero lo "

"haremos simple para este tutorial para que pueda aprender."

#: ../Doc/howto/clinic.rst:154

msgid "Let's dive in!"

msgstr "¡Vamos a sumergirnos!"

#: ../Doc/howto/clinic.rst:156

msgid ""

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

"trunk."

msgstr ""

"Asegúrese de estar trabajando con una versión recién actualizada de CPython."

#: ../Doc/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 ""

"Busca un incorporado de Python que llame a :c:func:`PyArg_ParseTuple` o :c:"

"func:`PyArg_ParseTupleAndKeywords`, y que aún no se haya convertido para "

"funcionar con Argument Clinic. Para mi ejemplo, estoy usando ``_pickle."

"Pickler.dump()``."

#: ../Doc/howto/clinic.rst:164

msgid ""

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

"units:"

msgstr ""

"Si la llamada a la función ``PyArg_Parse`` usa cualquiera de las siguientes "

"unidades de formato:"

#: ../Doc/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 ""

"o si tiene múltiples llamadas a :c:func:`PyArg_ParseTuple`, debes elegir una "

"función diferente. Argument Clinic *sí* admite todos estos escenarios. Pero "

"estos son temas avanzados; hagamos algo más simple para su primera función."

#: ../Doc/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 ""

"Además, si la función tiene múltiples llamadas a :c:func:`PyArg_ParseTuple` "

"o :c:func:`PyArg_ParseTupleAndKeywords` donde admite diferentes tipos para "

"el mismo argumento, o si la función usa algo además de las funciones "

"PyArg_Parse para analizar sus argumentos, probablemente no sea adecuado para "

"la conversión a Argument Clinic. Argument Clinic no admite funciones "

"genéricas ni parámetros polimórficos."

#: ../Doc/howto/clinic.rst:188

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

msgstr ""

"Agrega la siguiente plantilla sobre la función, creando nuestro bloque ::"

#: ../Doc/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 ""

"Corta el docstring y lo pega entre las líneas ``[clinic]``, eliminando toda "

"la basura que la convierte en una cadena C entre comillas. Cuando haya "

"terminado, debería tener solo el texto, basado en el margen izquierdo, sin "

"una línea de más de 80 caracteres. (Argument Clinic conservará las sangrías "

"dentro del docstring)."

#: ../Doc/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 el docstring antiguo tenía una primera línea que parecía una firma de "

"función, elimine esa línea. (El docstring ya no la necesita; cuando use "

"``help()`` en su incorporado en el futuro, la primera línea se creará "

"automáticamente en función de la firma de la función)."

#: ../Doc/howto/clinic.rst:205 ../Doc/howto/clinic.rst:226

#: ../Doc/howto/clinic.rst:250 ../Doc/howto/clinic.rst:308

#: ../Doc/howto/clinic.rst:348 ../Doc/howto/clinic.rst:375

#: ../Doc/howto/clinic.rst:481 ../Doc/howto/clinic.rst:533

msgid "Sample::"

msgstr "Muestra::"

#: ../Doc/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 su cadena de documentos no tiene una línea de \"resumen\", Argument "

"Clinic se quejará. Así que asegurémonos de que tenga uno. La línea de "

"\"resumen\" debe ser un párrafo que consta de una sola línea de 80 columnas "

"al comienzo de la cadena de documentos."

#: ../Doc/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 ""

"(Nuestro docstring de ejemplo consiste únicamente en una línea de resumen, "

"por lo que el código de muestra no tiene que cambiar para este paso.)"

#: ../Doc/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 ""

"Sobre el docstring, ingrese el nombre de la función, seguido de una línea en "

"blanco. Este debería ser el nombre de Python de la función, y debería ser la "

"ruta de puntos completa a la función; debería comenzar con el nombre del "

"módulo, incluir cualquier submódulo y, si la función es un método en una "

"clase, debe incluir el nombre de la clase también."

#: ../Doc/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 es la primera vez que ese módulo o clase se utiliza con Argument Clinic "

"en este archivo C, debe declarar el módulo o la clase. La higiene de la "

"clínica de argumentos apropiados prefiere declararlos en un bloque separado "

"en algún lugar cerca de la parte superior del archivo C, de la misma manera "

"que los archivos de inclusión y las estadísticas van en la parte superior. "

"(En nuestro código de muestra, solo mostraremos los dos bloques uno al lado "

"del otro)."

#: ../Doc/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 ""

"El nombre de la clase y el módulo debe ser el mismo que el visto por Python. "

"Compruebe el nombre definido en :c:type:`PyModuleDef` o :c:type:"

"`PyTypeObject` según corresponda."

#: ../Doc/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 ""

"Cuando declaras una clase, también debes especificar dos aspectos de su tipo "

"en C: la declaración de tipo que usarías para un puntero a una instancia de "

"esta clase y un puntero a :c:type:`PyTypeObject` para esto clase."

#: ../Doc/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 ""

"Declare cada uno de los parámetros a la función. Cada parámetro debe tener "

"su propia línea. Todas las líneas de parámetros deben tener sangría del "

"nombre de la función y el docstring."

#: ../Doc/howto/clinic.rst:270

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

msgstr "La forma general de estas líneas de parámetros es la siguiente:"

#: ../Doc/howto/clinic.rst:276

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

msgstr ""

"Si el parámetro tiene un valor predeterminado, agréguelo después del "

"convertidor:"

#: ../Doc/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 ""

"El soporte de Argument Clinic para \"valores predeterminados\" es bastante "

"sofisticado; por favor vea :ref:`la sección a continuación sobre valores "

"predeterminados <default_values>` para más información."

#: ../Doc/howto/clinic.rst:287

msgid "Add a blank line below the parameters."

msgstr "Agrega una línea en blanco debajo de los parámetros."

#: ../Doc/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 ""

"¿Qué es un \"convertidor\"? Establece tanto el tipo de variable utilizada en "

"C como el método para convertir el valor de Python en un valor de C en "

"tiempo de ejecución. Por ahora, va a utilizar lo que se llama un "

"\"convertidor heredado\", una sintaxis conveniente destinada a facilitar la "

"migración del código antiguo a Argument Clinic."

#: ../Doc/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 ""

"Para cada parámetro, copie la \"unidad de formato\" para ese parámetro del "

"argumento de formato ``PyArg_Parse()`` y especifique *eso* como su "

"convertidor, como una cadena entre comillas. (\"unidad de formato\" es el "

"nombre formal de la subcadena de caracteres de uno a tres caracteres del "

"parámetro ``format`` que le dice a la función de análisis de argumentos cuál "

"es el tipo de variable y cómo convertirla. Para más información sobre las "

"unidades de formato por favor vea :ref:`arg-parsing`.)"

#: ../Doc/howto/clinic.rst:305

msgid ""

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

"character string."

msgstr ""

"Para unidades de formato de caracteres múltiples como ``z#``, use la cadena "

"completa de dos o tres caracteres."

#: ../Doc/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 su función tiene ``|`` en la cadena de formato, lo que significa que "

"algunos parámetros tienen valores predeterminados, puede ignorarlo. Argument "

"Clinic infiere qué parámetros son opcionales en función de si tienen o no "

"valores predeterminados."

#: ../Doc/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 su función tiene ``$`` en la cadena de caracteres de formato, lo que "

"significa que toma argumentos de solo palabras clave, especifique ``*`` en "

"una línea antes del primer argumento de solo palabras clave, con la misma "

"indentación que las líneas de parámetros."

#: ../Doc/howto/clinic.rst:333

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

msgstr ""

"(``_pickle.Pickler.dump`` no tiene ninguno, por lo que nuestro ejemplo no ha "

"cambiado.)"

#: ../Doc/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 función C existente llama a :c:func:`PyArg_ParseTuple` (a diferencia "

"de :c:func:`PyArg_ParseTupleAndKeywords`), entonces todos sus argumentos son "

"solo posicionales."

#: ../Doc/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 ""

"Para marcar todos los parámetros como solo posicionales en Argument Clinic, "

"agregue un ``/`` en una línea después del último parámetro, con la misma "

"sangría que las líneas de parámetros."

#: ../Doc/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 ""

"Actualmente esto es todo o nada; o todos los parámetros son solo "

"posicionales o ninguno de ellos lo es. (En el futuro, Argument Clinic puede "

"relajar esta restricción)."

#: ../Doc/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 ""

"Es útil escribir una cadena de documentos por parámetro para cada parámetro. "

"Pero los docstrings por parámetro son opcionales; puede omitir este paso si "

"lo prefiere."

#: ../Doc/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 ""

"A continuación, se explica cómo agregar un docstring por parámetro. La "

"primera línea del docstring por parámetro debe tener más sangría que la "

"definición del parámetro. El margen izquierdo de esta primera línea "

"establece el margen izquierdo para todo el docstring por parámetro; todo el "

"texto que escriba se verá afectado por esta cantidad. Puede escribir todo el "

"texto que desee, en varias líneas si lo desea."

#: ../Doc/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 ""

"Guarde y cierre el archivo, luego ejecute ``Tools/clinic/clinic.py`` en él. "

"¡Con suerte, todo funcionó --- su bloque ahora tiene salida y se ha generado "

"un archivo ``.c.h`` ! Vuelva a abrir el archivo en su editor de texto para "

"ver:"

#: ../Doc/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 ""

"Obviamente, si Argument Clinic no produjo ningún resultado, es porque "

"encontró un error en su entrada. Siga corrigiendo sus errores y vuelva a "

"intentarlo hasta que Argument Clinic procese su archivo sin quejas."

#: ../Doc/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 ""

"Para facilitar la lectura, la mayor parte del código de pegamento se ha "

"generado en un archivo ``.c.h``. Deberá incluir eso en su archivo ``.c`` "

"original, generalmente justo después del bloque del módulo de la clínica:"

#: ../Doc/howto/clinic.rst:421

msgid ""

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

"basically the same as the existing code."

msgstr ""

"Vuelva a verificar que el código de análisis de argumentos generado por "

"Argument Clinic se ve básicamente igual al código existente."

#: ../Doc/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 ""

"Primero, asegúrese de que ambos lugares usen la misma función de análisis de "

"argumentos. El código existente debe llamar a :c:func:`PyArg_ParseTuple` o :"

"c:func:`PyArg_ParseTupleAndKeywords`; asegúrese de que el código generado "

"por Argument Clinic llame a la misma *exacta* función."

#: ../Doc/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 ""

"En segundo lugar, la cadena de formato pasada a :c:func:`PyArg_ParseTuple` "

"o :c:func:`PyArg_ParseTupleAndKeywords` debe ser *exactamente* la misma que "

"la escrita a mano en la función existente, hasta los dos puntos o punto y "

"coma."

#: ../Doc/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 siempre genera sus cadenas de caracteres de formato con un "

"``:`` seguido del nombre de la función. Si la cadena de caracteres de "

"formato del código existente termina con ``;``, para proporcionar ayuda de "

"uso, este cambio es inofensivo; no se preocupe)"

#: ../Doc/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 ""

"En tercer lugar, para los parámetros cuyas unidades de formato requieren dos "

"argumentos (como una variable de longitud, una cadena de codificación o un "

"puntero a una función de conversión), asegúrese de que el segundo argumento "

"sea *exactamente* el mismo entre las dos invocaciones."

#: ../Doc/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 ""

"En cuarto lugar, dentro de la parte de salida del bloque, encontrará una "

"macro de preprocesador que define la estructura static :c:type:`PyMethodDef` "

"apropiada para este incorporado::"

#: ../Doc/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 ""

"Esta estructura estática debe ser *exactamente* la misma que la estructura "

"estática existente :c:type:`PyMethodDef` para este incorporado."

#: ../Doc/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 alguno de estos elementos difiere *de alguna manera*, ajuste la "

"especificación de la función de Argument Clinic y vuelva a ejecutar ``Tools/"

"clinic/clinic.py`` hasta que *sean* iguales."

#: ../Doc/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 ""

"Observe que la última línea de su salida es la declaración de su función "

"\"impl\". Aquí es donde va la implementación incorporada. Elimine el "

"prototipo existente de la función que está modificando, pero deje la llave "

"de apertura. Ahora elimine su código de análisis de argumentos y las "

"declaraciones de todas las variables en las que vierte los argumentos. "

"Observe cómo los argumentos de Python ahora son argumentos para esta función "

"implícita; si la implementación usó nombres diferentes para estas variables, "

"corríjalo."

#: ../Doc/howto/clinic.rst:468

msgid ""

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

"like this::"

msgstr ""

"Reiteremos, solo porque es un poco extraño. Su código ahora debería verse "

"así:"

#: ../Doc/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 generó la línea de suma de comprobación y el prototipo de "

"función justo encima de ella. Debe escribir las llaves de apertura (y "

"cierre) para la función y la implementación en el interior."

#: ../Doc/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 ""

"¿Recuerda la macro con la estructura :c:type:`PyMethodDef` para esta "

"función? Busque la estructura existente :c:type:`PyMethodDef` para esta "

"función y la reemplaza con una referencia a la macro. (Si el incorporado "

"está en el alcance del módulo, esto probablemente estará muy cerca del final "

"del archivo; si el incorporado es un método de clase, probablemente estará "

"debajo pero relativamente cerca de la implementación)."

#: ../Doc/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 ""

"Tenga en cuenta que el cuerpo de la macro contiene una coma al final. "

"Entonces, cuando reemplace la estructura static :c:type:`PyMethodDef` "

"existente con la macro, *no* agregue una coma al final."

#: ../Doc/howto/clinic.rst:542

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 ""

"Compile y luego ejecute las partes relevantes del conjunto de pruebas de "

"regresión. Este cambio no debería introducir nuevas advertencias o errores "

"en tiempo de compilación, y no debería haber ningún cambio visible desde el "

"exterior en el comportamiento de Python."

#: ../Doc/howto/clinic.rst:546

msgid ""

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

"function should now provide a valid signature!"

msgstr ""

"Bueno, excepto por una diferencia: ``inspect.signature()`` ejecutar en su "

"función ahora debería proporcionar una firma válida!"

#: ../Doc/howto/clinic.rst:549

msgid ""

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

"Clinic!"

msgstr ""

"¡Felicitaciones, ha adaptado su primera función para trabajar con Argument "

"Clinic!"

#: ../Doc/howto/clinic.rst:552

msgid "Advanced Topics"

msgstr "Temas avanzados"

#: ../Doc/howto/clinic.rst:554

msgid ""

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

"for some advanced topics."

msgstr ""

"Ahora que ha tenido algo de experiencia trabajando con Argument Clinic, es "

"hora de algunos temas avanzados."

#: ../Doc/howto/clinic.rst:559

msgid "Symbolic default values"

msgstr "Valores predeterminados simbólicos"

#: ../Doc/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 ""

"El valor predeterminado que proporcione para un parámetro no puede ser una "

"expresión arbitraria. Actualmente, lo siguiente se admite explícitamente:"

#: ../Doc/howto/clinic.rst:564

msgid "Numeric constants (integer and float)"

msgstr "Constantes numéricas (enteros y flotantes)"

#: ../Doc/howto/clinic.rst:565

msgid "String constants"

msgstr "Constantes de cadena de caracteres"

#: ../Doc/howto/clinic.rst:566

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

msgstr "``True``, ``False``, y ``None``"

#: ../Doc/howto/clinic.rst:567

msgid ""

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

"name of the module"

msgstr ""

"Constantes simbólicas simples como ``sys.maxsize``, que debe comenzar con el "

"nombre del módulo"

#: ../Doc/howto/clinic.rst:570

msgid ""

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

"inspect.py``."

msgstr ""

"En caso de que tenga curiosidad, esto se implementa en ``from_builtin()`` en "

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

#: ../Doc/howto/clinic.rst:573

msgid ""

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

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

msgstr ""

"(En el futuro, esto puede necesitar ser aún más elaborado, para permitir "

"expresiones completas como ``CONSTANT - 1``.)"

#: ../Doc/howto/clinic.rst:578

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

msgstr ""

"Cambiar el nombre de las funciones y variables C generadas por Argument "

"Clinic"

#: ../Doc/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 nombra automáticamente las funciones que genera para usted. "

"Ocasionalmente, esto puede causar un problema, si el nombre generado choca "

"con el nombre de una función C existente. Hay una solución sencilla: anule "

"los nombres utilizados para las funciones de C. Simplemente agregue la "

"palabra clave ``\"as\"`` a la línea de declaración de su función, seguida "

"del nombre de la función que desea usar. Argument Clinic usará ese nombre de "

"función para la función base (generada), luego agregará ``\"_impl\"`` al "

"final y lo usará para el nombre de la función impl."

#: ../Doc/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 ""

"Por ejemplo, si quisiéramos cambiar el nombre de las funciones de C "

"generadas para ``pickle.Pickler.dump``, se vería así:"

#: ../Doc/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 función base ahora se llamaría ``pickler_dumper()``, y la función "

"implícita ahora se llamaría ``pickler_dumper_impl()``."

#: ../Doc/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 manera similar, es posible que tenga un problema en el que desee asignar "

"un nombre específico de Python a un parámetro, pero ese nombre puede ser "

"inconveniente en C. Argument Clinic le permite asignar nombres diferentes a "

"un parámetro en Python y en C, usando el mismo ``\"as\"`` como sintaxis::"

#: ../Doc/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 ""

"Aquí, el nombre usado en Python (en la firma y el arreglo de ``keywords``) "

"sería ``file``, pero la variable C se llamaría ``file_obj``."

#: ../Doc/howto/clinic.rst:617

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

msgstr ""

"¡También puede usar esto para cambiar el nombre del parámetro ``self``!"

#: ../Doc/howto/clinic.rst:621

msgid "Converting functions using PyArg_UnpackTuple"

msgstr "Convirtiendo funciones usando PyArg_UnpackTuple"

#: ../Doc/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 ""

"Para convertir una función que analiza sus argumentos con :c:func:"

"`PyArg_UnpackTuple`, simplemente escribe todos los argumentos, especificando "

"cada uno como un ``object``. Puede especificar el argumento ``type`` para "

"convertir el tipo según corresponda. Todos los argumentos deben estar "

"marcados como solo posicionales (agregue un ``/`` en una línea después del "

"último argumento)."

#: ../Doc/howto/clinic.rst:629

msgid ""

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

"will change soon."

msgstr ""

"Actualmente, el código generado usará :c:func:`PyArg_ParseTuple`, pero esto "

"cambiará pronto."

#: ../Doc/howto/clinic.rst:633

msgid "Optional Groups"

msgstr "Grupos opcionales"

#: ../Doc/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 "