clinic.po

# 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: 2022-10-25 19:47+0200\n"
"PO-Revision-Date: 2021-11-26 15:23+0100\n"
"Last-Translator: Cristián Maureira-Fredes <cmaureirafredes@gmail.com>\n"
"Language: es\n"
"Language-Team: python-doc-es\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.10.3\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
#, 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 ""
"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 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:575
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:577
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:585
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:593
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:597
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:611
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:614
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:618
msgid "Converting functions using PyArg_UnpackTuple"
msgstr "Convirtiendo funciones usando PyArg_UnpackTuple"

#: ../Doc/howto/clinic.rst:620
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:626
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:630
msgid "Optional Groups"
msgstr "Grupos opcionales"

#: ../Doc/howto/clinic.rst:632
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 ""
"Algunas funciones heredadas tienen un enfoque complicado para analizar sus "
"argumentos: cuentan el número de argumentos posicionales, luego usan una "
"instrucción ``switch`` para llamar a una de varias llamadas diferentes :c:"
"func:`PyArg_ParseTuple` dependiendo de cuántos argumentos posicionales "
"existen. (Estas funciones no pueden aceptar argumentos de solo palabras "
"clave). Este enfoque se usó para simular argumentos opcionales antes de que "