# 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: 2023-10-12 19:43+0200\n"
"PO-Revision-Date: 2024-02-02 00:07+0100\n"
"Last-Translator: Carlos Mena Prez \n"
"Language-Team: python-doc-es\n"
"Language: es\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
"Generated-By: Babel 2.13.0\n"
"X-Generator: Poedit 3.4.2\n"

#: ../Doc/library/doctest.rst:2
msgid ":mod:`doctest` --- Test interactive Python examples"
msgstr ":mod:`doctest` -- Prueba ejemplos interactivos de Python"

#: ../Doc/library/doctest.rst:12
msgid "**Source code:** :source:`Lib/doctest.py`"
msgstr "**Cdigo fuente:** :source:`Lib/doctest.py`"

#: ../Doc/library/doctest.rst:16
msgid ""
"The :mod:`doctest` module searches for pieces of text that look like "
"interactive Python sessions, and then executes those sessions to verify that "
"they work exactly as shown.  There are several common ways to use doctest:"
msgstr ""
"El mdulo :mod:`doctest` busca pedazos de texto que lucen como sesiones "
"interactivas de Python, y entonces ejecuta esas sesiones para verificar que "
"funcionen exactamente como son mostradas. Hay varias maneras de usar doctest:"

#: ../Doc/library/doctest.rst:20
msgid ""
"To check that a module's docstrings are up-to-date by verifying that all "
"interactive examples still work as documented."
msgstr ""
"Para revisar que los docstrings de un mdulo estn al da al verificar que "
"todos los ejemplos interactivos todava trabajan como est documentado."

#: ../Doc/library/doctest.rst:23
msgid ""
"To perform regression testing by verifying that interactive examples from a "
"test file or a test object work as expected."
msgstr ""
"Para realizar pruebas de regresin al verificar que los ejemplos "
"interactivos de un archivo de pruebas o un objeto de pruebas trabaje como "
"sea esperado."

#: ../Doc/library/doctest.rst:26
msgid ""
"To write tutorial documentation for a package, liberally illustrated with "
"input-output examples.  Depending on whether the examples or the expository "
"text are emphasized, this has the flavor of \"literate testing\" or "
"\"executable documentation\"."
msgstr ""
"Para escribir documentacin de tutorial para un paquete, generosamente "
"ilustrado con ejemplos de entrada-salida. Dependiendo si los ejemplos o el "
"texto expositivo son enfatizados, tiene el sabor de \"pruebas literarias\" o "
"\"documentacin ejecutable\"."

#: ../Doc/library/doctest.rst:31
msgid "Here's a complete but small example module::"
msgstr "Aqu hay un mdulo de ejemplo completo pero pequeo::"

#: ../Doc/library/doctest.rst:88
msgid ""
"If you run :file:`example.py` directly from the command line, :mod:`doctest` "
"works its magic:"
msgstr ""
"Si ejecutas :file:`example.py` directamente desde la lnea de comandos, :mod:"
"`doctest` har su magia:"

#: ../Doc/library/doctest.rst:96
msgid ""
"There's no output!  That's normal, and it means all the examples worked.  "
"Pass ``-v`` to the script, and :mod:`doctest` prints a detailed log of what "
"it's trying, and prints a summary at the end:"
msgstr ""
"No hay salida! Eso es normal, y significa que todos los ejemplos "
"funcionaron. Pasa ``-v`` al script, y :mod:`doctest` imprime un registro "
"detallado de lo que est intentando, e imprime un resumen al final:"

#: ../Doc/library/doctest.rst:114
msgid "And so on, eventually ending with:"
msgstr "Y dems, eventualmente terminando con:"

#: ../Doc/library/doctest.rst:133
msgid ""
"That's all you need to know to start making productive use of :mod:"
"`doctest`! Jump in.  The following sections provide full details.  Note that "
"there are many examples of doctests in the standard Python test suite and "
"libraries. Especially useful examples can be found in the standard test "
"file :file:`Lib/test/test_doctest.py`."
msgstr ""
"Eso es todo lo que necesitas saber para empezar a hacer uso productivo de :"
"mod:`doctest`! Lnzate. Las siguientes secciones proporcionan detalles "
"completos. Note que hay muchos ejemplos de doctests en el conjunto de "
"pruebas estndar de Python y bibliotecas. Especialmente ejemplos tiles se "
"pueden encontrar en el archivo de pruebas estndar :file:`Lib/test/"
"test_doctest.py`."

#: ../Doc/library/doctest.rst:143
msgid "Simple Usage: Checking Examples in Docstrings"
msgstr "Uso simple: verificar ejemplos en docstrings"

#: ../Doc/library/doctest.rst:145
msgid ""
"The simplest way to start using doctest (but not necessarily the way you'll "
"continue to do it) is to end each module :mod:`M` with::"
msgstr ""
"La forma ms simple para empezar a usar doctest (pero no necesariamente la "
"forma que continuars usndolo) es terminar cada mdulo :mod:`M` con::"

#: ../Doc/library/doctest.rst:152
msgid ":mod:`doctest` then examines docstrings in module :mod:`M`."
msgstr ":mod:`doctest` entonces examina docstrings en el mdulo :mod:`M`."

#: ../Doc/library/doctest.rst:154
msgid ""
"Running the module as a script causes the examples in the docstrings to get "
"executed and verified::"
msgstr ""
"Ejecutar el mdulo como un script causa que los ejemplos en los docstrings "
"se ejecuten y sean verificados::"

#: ../Doc/library/doctest.rst:159
msgid ""
"This won't display anything unless an example fails, in which case the "
"failing example(s) and the cause(s) of the failure(s) are printed to stdout, "
"and the final line of output is ``***Test Failed*** N failures.``, where *N* "
"is the number of examples that failed."
msgstr ""
"No mostrar nada a menos que un ejemplo falle, en cuyo caso el ejemplo "
"fallido o ejemplos fallidos y sus causas de la falla son imprimidas a "
"stdout, y la lnea final de salida es ``***Test Failed*** N failures.``, "
"donde *N* es el nmero de ejemplos que fallaron."

#: ../Doc/library/doctest.rst:164
msgid "Run it with the ``-v`` switch instead::"
msgstr "Ejectalo con el modificador ``-v`` en su lugar::"

#: ../Doc/library/doctest.rst:168
msgid ""
"and a detailed report of all examples tried is printed to standard output, "
"along with assorted summaries at the end."
msgstr ""
"y un reporte detallado de todos los ejemplos intentados es impreso a la "
"salida estndar, junto con resmenes clasificados  al final."

#: ../Doc/library/doctest.rst:171
msgid ""
"You can force verbose mode by passing ``verbose=True`` to :func:`testmod`, "
"or prohibit it by passing ``verbose=False``.  In either of those cases, "
"``sys.argv`` is not examined by :func:`testmod` (so passing ``-v`` or not "
"has no effect)."
msgstr ""
"Puedes forzar el modo verboso al pasar ``verbose=True`` a :func:`testmod`, o "
"prohibirlo al pasarlo ``verbose=False``. En cualquiera de estas casos, ``sys."
"argv`` no es examinado por :func:`testmod` (por lo que pasar o no ``-v``, no "
"tiene efecto)."

#: ../Doc/library/doctest.rst:176
msgid ""
"There is also a command line shortcut for running :func:`testmod`.  You can "
"instruct the Python interpreter to run the doctest module directly from the "
"standard library and pass the module name(s) on the command line::"
msgstr ""
"Tambin hay un atajo de lnea de comandos para ejecutar :func:`testmod`. "
"Puedes instruir al intrprete de Python para ejecutar el mdulo doctest "
"directamente de la biblioteca estndar y pasar los nombres del mdulo en la "
"lnea de comandos::"

#: ../Doc/library/doctest.rst:182
msgid ""
"This will import :file:`example.py` as a standalone module and run :func:"
"`testmod` on it.  Note that this may not work correctly if the file is part "
"of a package and imports other submodules from that package."
msgstr ""
"Esto importar :file:`example.py` como un mdulo independiente y ejecutar "
"a :func:`testmod`. Note que esto puede no funcionar correctamente si el "
"archivo es parte de un paquete e importa otros submdulos de ese paquete."

#: ../Doc/library/doctest.rst:186
msgid ""
"For more information on :func:`testmod`, see section :ref:`doctest-basic-"
"api`."
msgstr ""
"Para ms informacin de :func:`testmod`, consulte la seccin :ref:`doctest-"
"basic-api`."

#: ../Doc/library/doctest.rst:192
msgid "Simple Usage: Checking Examples in a Text File"
msgstr "Uso Simple: Verificar ejemplos en un Archivo de Texto"

#: ../Doc/library/doctest.rst:194
msgid ""
"Another simple application of doctest is testing interactive examples in a "
"text file.  This can be done with the :func:`testfile` function::"
msgstr ""
"Otra simple aplicacin de doctest es probar ejemplos interactivos en un "
"archivo de texto.  Esto puede ser hecho con la funcin :func:`testfile`::"

#: ../Doc/library/doctest.rst:200
msgid ""
"That short script executes and verifies any interactive Python examples "
"contained in the file :file:`example.txt`.  The file content is treated as "
"if it were a single giant docstring; the file doesn't need to contain a "
"Python program!   For example, perhaps :file:`example.txt` contains this:"
msgstr ""
"Este script corto ejecuta y verifica cualquier ejemplo interactivo de Python "
"contenido en el archivo :file:`example.txt`. El contenido del archivo es "
"tratado como si fuese un solo gran docstring; el archivo no necesita "
"contener un programa de Python! Por ejemplo, tal vez :file:`example.txt` "
"contenga esto:"

#: ../Doc/library/doctest.rst:223
msgid ""
"Running ``doctest.testfile(\"example.txt\")`` then finds the error in this "
"documentation::"
msgstr ""
"Ejecutar ``doctest.testfile(\"example.txt\")`` entonces encuentra el error "
"en esta documentacin::"

#: ../Doc/library/doctest.rst:234
msgid ""
"As with :func:`testmod`, :func:`testfile` won't display anything unless an "
"example fails.  If an example does fail, then the failing example(s) and the "
"cause(s) of the failure(s) are printed to stdout, using the same format as :"
"func:`testmod`."
msgstr ""
"Como con :func:`testmod`, :func:`testfile` no mostrar nada a menos que un "
"ejemplo falle. Si un ejemplo no falla, entonces los ejemplos fallidos y sus "
"causas son impresas a stdout, usando el mismo formato como :func:`testmod`."

#: ../Doc/library/doctest.rst:239
msgid ""
"By default, :func:`testfile` looks for files in the calling module's "
"directory. See section :ref:`doctest-basic-api` for a description of the "
"optional arguments that can be used to tell it to look for files in other "
"locations."
msgstr ""
"Por defecto, :func:`testfile` busca archivos en el directorio del mdulo al "
"que se llama. Vase la seccin :ref:`doctest-basic-api` para una descripcin "
"de los argumentos opcionales que pueden ser usados para decirle que busque "
"archivos en otros lugares."

#: ../Doc/library/doctest.rst:243
msgid ""
"Like :func:`testmod`, :func:`testfile`'s verbosity can be set with the ``-"
"v`` command-line switch or with the optional keyword argument *verbose*."
msgstr ""
"Como :func:`testmod`, la verbosidad de :func:`testfile` puede ser "
"establecida con el modificador de la lnea de comandos ``-v`` o con el "
"argumento por palabra clave opcional *verbose*."

#: ../Doc/library/doctest.rst:247
msgid ""
"There is also a command line shortcut for running :func:`testfile`.  You can "
"instruct the Python interpreter to run the doctest module directly from the "
"standard library and pass the file name(s) on the command line::"
msgstr ""
"Tambin hay un atajo de lnea de comandos para ejecutar :func:`testfile`. "
"Puedes indicar al intrprete de Python para correr el mdulo doctest "
"directamente desde la biblioteca estndar y pasar el nombre de los archivos "
"en la lnea de comandos::"

#: ../Doc/library/doctest.rst:253
msgid ""
"Because the file name does not end with :file:`.py`, :mod:`doctest` infers "
"that it must be run with :func:`testfile`, not :func:`testmod`."
msgstr ""
"Porque el nombre del archivo no termina con :file:`.py`, :mod:`doctest` "
"infiere que se debe ejecutar con :func:`testfile`, no :func:`testmod`."

#: ../Doc/library/doctest.rst:256
msgid ""
"For more information on :func:`testfile`, see section :ref:`doctest-basic-"
"api`."
msgstr ""
"Para ms informacin en :func:`testfile`, vase la seccin :ref:`doctest-"
"basic-api`."

#: ../Doc/library/doctest.rst:262
msgid "How It Works"
msgstr "Cmo funciona"

#: ../Doc/library/doctest.rst:264
msgid ""
"This section examines in detail how doctest works: which docstrings it looks "
"at, how it finds interactive examples, what execution context it uses, how "
"it handles exceptions, and how option flags can be used to control its "
"behavior. This is the information that you need to know to write doctest "
"examples; for information about actually running doctest on these examples, "
"see the following sections."
msgstr ""
"Esta seccin examina en detalle cmo funciona doctest: qu docstrings "
"revisa, cmo encuentra ejemplos interactivos, qu contexto de ejecucin usa, "
"cmo maneja las excepciones, y cmo las banderas pueden ser usadas para "
"controlar su comportamiento. Esta es la informacin que necesitas saber para "
"escribir ejemplos de doctest; para informacin sobre ejecutar doctest en "
"estos ejemplos, vase las siguientes secciones."

#: ../Doc/library/doctest.rst:275
msgid "Which Docstrings Are Examined?"
msgstr "Qu docstrings son examinados?"

#: ../Doc/library/doctest.rst:277
msgid ""
"The module docstring, and all function, class and method docstrings are "
"searched.  Objects imported into the module are not searched."
msgstr ""
"Se busca en el docstring del mdulo, y todos los docstrings de las "
"funciones, clases, y mtodos.  Los objetos importados en el mdulo no se "
"buscan."

#: ../Doc/library/doctest.rst:280
msgid ""
"In addition, if ``M.__test__`` exists and \"is true\", it must be a dict, "
"and each entry maps a (string) name to a function object, class object, or "
"string. Function and class object docstrings found from ``M.__test__`` are "
"searched, and strings are treated as if they were docstrings.  In output, a "
"key ``K`` in ``M.__test__`` appears with name ::"
msgstr ""
"Adems, si ``M.__test__`` existe y \"es verdaderos\", debe ser un "
"diccionario, y cada entrada mapea un nombre (cadena de caracteres) a un "
"objeto de funcin, objeto de clase, o cadena de caracteres. Se buscan los "
"docstrings de los objetos de funcin o de clase encontrados de ``M."
"__test__``, y las cadenas de caracteres son tratadas como si fueran "
"docstrings. En la salida, una clave ``K`` en ``M.__test__`` aparece con el "
"nombre::"

#: ../Doc/library/doctest.rst:288
msgid ""
"Any classes found are recursively searched similarly, to test docstrings in "
"their contained methods and nested classes."
msgstr ""
"Todas las clases encontradas se buscan recursivamente de manera similar, "
"para probar docstrings en sus mtodos contenidos y clases anidadas."

#: ../Doc/library/doctest.rst:295
msgid "How are Docstring Examples Recognized?"
msgstr "Cmo se reconocen los ejemplos de docstring?"

#: ../Doc/library/doctest.rst:297
msgid ""
"In most cases a copy-and-paste of an interactive console session works fine, "
"but doctest isn't trying to do an exact emulation of any specific Python "
"shell."
msgstr ""
"En la mayora de los casos un copiar y pegar de una sesin de consola "
"interactiva funciona bien, pero doctest no est intentando hacer una "
"emulacin exacta de ningn shell especfico de Python."

#: ../Doc/library/doctest.rst:322
msgid ""
"Any expected output must immediately follow the final ``'>>> '`` or ``'... "
"'`` line containing the code, and the expected output (if any) extends to "
"the next ``'>>> '`` or all-whitespace line."
msgstr ""
"Cualquier salida esperada debe seguir inmediatamente el final de la lnea "
"``'>>>'`` o ``'...'`` conteniendo el cdigo, y la salida esperada (si la "
"hubiera) se extiende hasta el siguiente ``'>>>'`` o la lnea en blanco."

#: ../Doc/library/doctest.rst:326
msgid "The fine print:"
msgstr "La letra pequea:"

#: ../Doc/library/doctest.rst:328
msgid ""
"Expected output cannot contain an all-whitespace line, since such a line is "
"taken to signal the end of expected output.  If expected output does contain "
"a blank line, put ```` in your doctest example each place a blank "
"line is expected."
msgstr ""
"La salida esperada no puede contener una lnea de espacios en blanco, ya que "
"ese tipo de lnea se toma para indicar el fin de la salida esperada. Si la "
"salida esperada de verdad contiene una lnea en blanco, pon ```` "
"en tu ejemplo de doctest en cada lugar donde una lnea en blanco sea "
"esperada."

#: ../Doc/library/doctest.rst:333
msgid ""
"All hard tab characters are expanded to spaces, using 8-column tab stops. "
"Tabs in output generated by the tested code are not modified.  Because any "
"hard tabs in the sample output *are* expanded, this means that if the code "
"output includes hard tabs, the only way the doctest can pass is if the :"
"const:`NORMALIZE_WHITESPACE` option or :ref:`directive ` "
"is in effect. Alternatively, the test can be rewritten to capture the output "
"and compare it to an expected value as part of the test.  This handling of "
"tabs in the source was arrived at through trial and error, and has proven to "
"be the least error prone way of handling them.  It is possible to use a "
"different algorithm for handling tabs by writing a custom :class:"
"`DocTestParser` class."
msgstr ""
"Todos los caracteres de tabulacin se expanden a espacios, usando paradas de "
"tabulacin de 8 -columnas. Las tabulaciones generadas por el cdigo en "
"pruebas no son modificadas. Ya que todas las tabulaciones en la salida de "
"prueba *son* expandidas, significa que si el cdigo de salida incluye "
"tabulaciones, la nica manera de que el doctest pueda pasar es si la opcin :"
"const:`NORMALIZE_WHITESPACE` o :ref:`directive ` est en "
"efecto. Alternativamente, la prueba puede ser reescrita para capturar la "
"salida y compararla a un valor esperado como parte de la prueba. Se lleg a "
"este tratamiento de tabulaciones en la fuente a travs de prueba y error, y "
"ha demostrado ser la manera menos propensa a errores de manejarlos. Es "
"posible usar un algoritmo diferente para manejar tabulaciones al escribir "
"una clase :class:`DocTestParser` personalizada."

#: ../Doc/library/doctest.rst:345
msgid ""
"Output to stdout is captured, but not output to stderr (exception tracebacks "
"are captured via a different means)."
msgstr ""
"La salida a stdout es capturada, pero no la salida a stderr (los rastreos de "
"la excepcin son capturados a travs de maneras diferentes)."

#: ../Doc/library/doctest.rst:348
msgid ""
"If you continue a line via backslashing in an interactive session, or for "
"any other reason use a backslash, you should use a raw docstring, which will "
"preserve your backslashes exactly as you type them::"
msgstr ""
"Si continuas una lnea poniendo una barra invertida en una sesin "
"interactiva, o por cualquier otra razn usas una barra invertida, debes usar "
"un docstring crudo, que preservar tus barras invertidas exactamente como "
"las escribes::"

#: ../Doc/library/doctest.rst:358
msgid ""
"Otherwise, the backslash will be interpreted as part of the string. For "
"example, the ``\\n`` above would be interpreted as a newline character.  "
"Alternatively, you can double each backslash in the doctest version (and not "
"use a raw string)::"
msgstr ""
"De otra manera, la barra invertida ser interpretada como parte de una "
"cadena. Por ejemplo, el ``\\n`` arriba sera interpretado como un carcter "
"de nueva lnea. Alternativamente, puedes duplicar cada barra invertida en  "
"la versin de doctest (y no usar una cadena de caracteres cruda)::"

#: ../Doc/library/doctest.rst:368
msgid "The starting column doesn't matter::"
msgstr "La columna inicial no importa::"

#: ../Doc/library/doctest.rst:375
msgid ""
"and as many leading whitespace characters are stripped from the expected "
"output as appeared in the initial ``'>>> '`` line that started the example."
msgstr ""
"y tantos espacios en blanco al principio se eliminan de la salida esperada "
"como aparece en la lnea ``'>>>'`` inicial que empez el ejemplo."

#: ../Doc/library/doctest.rst:382
msgid "What's the Execution Context?"
msgstr "Cul es el contexto de ejecucin?"

#: ../Doc/library/doctest.rst:384
msgid ""
"By default, each time :mod:`doctest` finds a docstring to test, it uses a "
"*shallow copy* of :mod:`M`'s globals, so that running tests doesn't change "
"the module's real globals, and so that one test in :mod:`M` can't leave "
"behind crumbs that accidentally allow another test to work.  This means "
"examples can freely use any names defined at top-level in :mod:`M`, and "
"names defined earlier in the docstring being run. Examples cannot see names "
"defined in other docstrings."
msgstr ""
"Por defecto, cada vez que un :mod:`doctest` encuentre un docstring para "
"probar, usa una *copia superficial*  de los globales de :mod:`M`, por lo que "
"ejecutar pruebas no cambia los globales reales del mdulo, y por lo que una "
"prueba en :mod:`M` no puede dejar atrs migajas que permitan a otras pruebas "
"trabajar. Significa que los ejemplos pueden usar libremente cualquier nombre "
"definido en el nivel superior en :mod:`M`, y nombres definidos ms temprano "
"en los docstrings siendo ejecutados. Los ejemplos no pueden ver nombres "
"definidos en otros docstrings."

#: ../Doc/library/doctest.rst:392
msgid ""
"You can force use of your own dict as the execution context by passing "
"``globs=your_dict`` to :func:`testmod` or :func:`testfile` instead."
msgstr ""
"Puedes forzar el uso de tus propios diccionarios como contexto de ejecucin "
"al pasar ``globs=your_dict`` a :func:`testmod` o :func:`testfile` en su "
"lugar."

#: ../Doc/library/doctest.rst:399
msgid "What About Exceptions?"
msgstr "Y las excepciones?"

#: ../Doc/library/doctest.rst:401
msgid ""
"No problem, provided that the traceback is the only output produced by the "
"example:  just paste in the traceback. [#]_ Since tracebacks contain details "
"that are likely to change rapidly (for example, exact file paths and line "
"numbers), this is one case where doctest works hard to be flexible in what "
"it accepts."
msgstr ""
"No hay problema, siempre que el rastreo sea la nica salida producida por el "
"ejemplo: slo copia el rastreo.  [#]_ Ya que los rastreos contienen detalles "
"que probablemente cambien rpidamente (por ejemplo, rutas de archivos "
"exactas y nmeros de lnea), este es un caso donde doctest trabaja duro para "
"ser flexible en lo que acepta."

#: ../Doc/library/doctest.rst:407
msgid "Simple example::"
msgstr "Ejemplo simple::"

#: ../Doc/library/doctest.rst:414
msgid ""
"That doctest succeeds if :exc:`ValueError` is raised, with the ``list."
"remove(x): x not in list`` detail as shown."
msgstr ""
"El doctest tiene xito si se lanza :exc:`ValueError`, con el detalle ``list."
"remove(x): x not in list`` como se muestra."

#: ../Doc/library/doctest.rst:417
msgid ""
"The expected output for an exception must start with a traceback header, "
"which may be either of the following two lines, indented the same as the "
"first line of the example::"
msgstr ""
"La salida esperada para una excepcin debe empezar con una cabecera de "
"rastreo, que puede ser una de las siguientes dos lneas, con el mismo "
"sangrado de la primera lnea del ejemplo:"

#: ../Doc/library/doctest.rst:424
msgid ""
"The traceback header is followed by an optional traceback stack, whose "
"contents are ignored by doctest.  The traceback stack is typically omitted, "
"or copied verbatim from an interactive session."
msgstr ""
"La cabecera de rastreo es seguida por una pila de rastreo opcional, cuyo "
"contenido es ignorado por doctest.  La pila de rastreo es tpicamente "
"omitida, o copiada palabra por palabra de una sesin interactiva."

#: ../Doc/library/doctest.rst:428
msgid ""
"The traceback stack is followed by the most interesting part: the line(s) "
"containing the exception type and detail.  This is usually the last line of "
"a traceback, but can extend across multiple lines if the exception has a "
"multi-line detail::"
msgstr ""
"La pila de rastreo es seguida por la parte ms interesante: la lnea o "
"lneas conteniendo el tipo de excepcin y detalle. Esto es usualmente la "
"ltima lnea de un rastreo, pero se puede extender a travs de mltiples "
"lneas si la excepcin tiene un detalle de varias lneas::"

#: ../Doc/library/doctest.rst:440
msgid ""
"The last three lines (starting with :exc:`ValueError`) are compared against "
"the exception's type and detail, and the rest are ignored."
msgstr ""
"Las ltimas tres lneas (empezando con :exc:`ValueError`) son comparados con "
"el tipo de excepcin y detalle, y el resto es ignorado."

#: ../Doc/library/doctest.rst:443
msgid ""
"Best practice is to omit the traceback stack, unless it adds significant "
"documentation value to the example.  So the last example is probably better "
"as::"
msgstr ""
"La mejor prctica es omitir la pila de rastreo, a menos que aada valor de "
"documentacin significante al ejemplo. Por lo que el ltimo ejemplo es "
"probablemente mejor como::"

#: ../Doc/library/doctest.rst:453
msgid ""
"Note that tracebacks are treated very specially.  In particular, in the "
"rewritten example, the use of ``...`` is independent of doctest's :const:"
"`ELLIPSIS` option.  The ellipsis in that example could be left out, or could "
"just as well be three (or three hundred) commas or digits, or an indented "
"transcript of a Monty Python skit."
msgstr ""
"Note que los rastreos son tratados de manera especial. En particular, en el "
"ejemplo reescrito, el uso de ``...`` es independiente de la opcin :const:"
"`ELLIPSIS` de doctest. Se pueden excluir los puntos suspensivos en ese "
"ejemplo, as como tambin pueden haber tres (o trescientas) comas o dgitos, "
"o una transcripcin sangrada de un *sketch* de Monty Python."

#: ../Doc/library/doctest.rst:459
msgid "Some details you should read once, but won't need to remember:"
msgstr "Algunos detalles que debes leer una vez, pero no necesitars recordar:"

#: ../Doc/library/doctest.rst:461
msgid ""
"Doctest can't guess whether your expected output came from an exception "
"traceback or from ordinary printing.  So, e.g., an example that expects "
"``ValueError: 42 is prime`` will pass whether :exc:`ValueError` is actually "
"raised or if the example merely prints that traceback text.  In practice, "
"ordinary output rarely begins with a traceback header line, so this doesn't "
"create real problems."
msgstr ""
"Doctest no puede adivinar si tu salida esperada vino de una excepcin de "
"rastreo o de una impresin ordinaria. As que, un ejemplo que espera "
"``ValueError: 42 is prime`` pasar, ya sea si de hecho se lance :exc:"
"`ValueError` o si el ejemplo simplemente imprime ese texto de rastreo. En la "
"prctica, la salida ordinaria raramente comienza con una lnea de cabecera "
"de rastreo, por lo que esto no crea problemas reales."

#: ../Doc/library/doctest.rst:468
msgid ""
"Each line of the traceback stack (if present) must be indented further than "
"the first line of the example, *or* start with a non-alphanumeric character. "
"The first line following the traceback header indented the same and starting "
"with an alphanumeric is taken to be the start of the exception detail.  Of "
"course this does the right thing for genuine tracebacks."
msgstr ""
"Cada lnea de la pila de rastreo (si se presenta) debe estar ms sangrada "
"que la primera lnea del ejemplo, *o* empezar con un carcter no "
"alfanumrico. la primera lnea que sigue a la cabecera de rastreo sangrada "
"de igual forma y empezando con un alfanumrico es considerado el inicio del "
"detalle de la excepcin. Por supuesto que esto es lo correcto para rastreos "
"genuinos."

#: ../Doc/library/doctest.rst:474
msgid ""
"When the :const:`IGNORE_EXCEPTION_DETAIL` doctest option is specified, "
"everything following the leftmost colon and any module information in the "
"exception name is ignored."
msgstr ""
"Cuando se especifica la opcin :const:`IGNORE_EXCEPTION_DETAIL` de doctest. "
"todo lo que sigue a los dos puntos ms a la izquierda y cualquier otra "
"informacin del mdulo en el nombre de la excepcin se ignora."

#: ../Doc/library/doctest.rst:478
msgid ""
"The interactive shell omits the traceback header line for some :exc:"
"`SyntaxError`\\ s.  But doctest uses the traceback header line to "
"distinguish exceptions from non-exceptions.  So in the rare case where you "
"need to test a :exc:`SyntaxError` that omits the traceback header, you will "
"need to manually add the traceback header line to your test example."
msgstr ""
"El shell interactivo omite la lnea de la cabecera de rastreo para algunos :"
"exc:`SyntaxError`. Pero doctest usa la lnea de la cabecera de rastreo para "
"distinguir excepciones de los que no son. As que en algunos casos raros "
"donde necesitas probar un :exc:`SyntaxError` que omite la cabecera de "
"rastreo, necesitars poner manualmente la lnea de cabecera de rastreo en tu "
"ejemplo de prueba."

#: ../Doc/library/doctest.rst:486
msgid ""
"For some exceptions, Python displays the position of the error using ``^`` "
"markers and tildes::"
msgstr ""
"En el caso de algunas excepciones Python seala la posicin donde ocurri el "
"error usando un marcador ``^``::"

#: ../Doc/library/doctest.rst:495
msgid ""
"Since the lines showing the position of the error come before the exception "
"type and detail, they are not checked by doctest.  For example, the "
"following test would pass, even though it puts the ``^`` marker in the wrong "
"location::"
msgstr ""
"Ya que las lneas mostrando la posicin del error vienen antes del tipo de "
"excepcin y detalle, no son revisadas por doctest. Por ejemplo, el siguiente "
"test pasara, a pesar de que pone el marcador ``^`` en la posicin "
"equivocada::"

#: ../Doc/library/doctest.rst:510
msgid "Option Flags"
msgstr "Banderas de Opcin"

#: ../Doc/library/doctest.rst:512
msgid ""
"A number of option flags control various aspects of doctest's behavior. "
"Symbolic names for the flags are supplied as module constants, which can be :"
"ref:`bitwise ORed ` together and passed to various functions. The "
"names can also be used in :ref:`doctest directives `, "
"and may be passed to the doctest command line interface via the ``-o`` "
"option."
msgstr ""
"Varias banderas de opcin controlan diversos aspectos del comportamiento de "
"doctest. Los nombres simblicos para las banderas son proporcionados como "
"constantes del mdulo, que se pueden conectar mediante :ref:`*OR* bit a bit "
"`  y pasar a varias funciones. Los nombres tambin pueden ser "
"usados en las :ref:`directivas de doctest `, y se pueden "
"pasar a la interfaz de la lnea de comandos de doctest a travs de la opcin "
"``-o``."

#: ../Doc/library/doctest.rst:518
msgid "The ``-o`` command line option."
msgstr "La opcin de la lnea de comandos ``-o``."

#: ../Doc/library/doctest.rst:521
msgid ""
"The first group of options define test semantics, controlling aspects of how "
"doctest decides whether actual output matches an example's expected output:"
msgstr ""
"El primer grupo de opciones definen las semnticas de la prueba, controlando "
"aspectos de cmo doctest decide si la salida de hecho concuerda con la "
"salida esperada del ejemplo:"

#: ../Doc/library/doctest.rst:527
msgid ""
"By default, if an expected output block contains just ``1``, an actual "
"output block containing just ``1`` or just ``True`` is considered to be a "
"match, and similarly for ``0`` versus ``False``.  When :const:"
"`DONT_ACCEPT_TRUE_FOR_1` is specified, neither substitution is allowed.  The "
"default behavior caters to that Python changed the return type of many "
"functions from integer to boolean; doctests expecting \"little integer\" "
"output still work in these cases.  This option will probably go away, but "
"not for several years."
msgstr ""
"Por defecto, si un bloque de salida esperada contiene slo ``1``, se "
"considera igual a un bloque de salida real conteniendo slo ``1`` o "
"``true``, y similarmente para ``0`` contra ``False``. Cuando se especifica :"
"const:`DONT_ACCEPT_TRUE_FOR_1``, no se permite ninguna sustitucin.  El "
"comportamiento por defecto atiende a que Python cambi el tipo de retorno de "
"muchas funciones de enteros a booleanos; los doctest esperando salidas \"de "
"pequeo enteros\" todava trabajan en estos casos. Esta opcin probablemente "
"se vaya, pero no por muchos aos."

#: ../Doc/library/doctest.rst:539
msgid ""
"By default, if an expected output block contains a line containing only the "
"string ````, then that line will match a blank line in the actual "
"output.  Because a genuinely blank line delimits the expected output, this "
"is the only way to communicate that a blank line is expected.  When :const:"
"`DONT_ACCEPT_BLANKLINE` is specified, this substitution is not allowed."
msgstr ""
"Por defecto, si un bloque de salida esperada contiene una lnea que slo "
"tiene la cadena de caracteres ````, entonces esa lnea "
"corresponder a una lnea en blanco en la salida real. Ya que una lnea en "
"blanca autntica delimita la salida esperada, esta es la nica manera de "
"comunicar que una lnea en blanco es esperada. Cuando se especifica :const:"
"`DONT_ACCEPT_BLANKLINE`, esta substitucin no se permite."

#: ../Doc/library/doctest.rst:548
msgid ""
"When specified, all sequences of whitespace (blanks and newlines) are "
"treated as equal.  Any sequence of whitespace within the expected output "
"will match any sequence of whitespace within the actual output. By default, "
"whitespace must match exactly. :const:`NORMALIZE_WHITESPACE` is especially "
"useful when a line of expected output is very long, and you want to wrap it "
"across multiple lines in your source."
msgstr ""
"Cuando se especifica, todas las secuencias de espacios en blanco (vacas y "
"nuevas lneas) son tratadas como iguales. Cualquier secuencia de espacios en "
"blanco dentro de la salida esperada corresponder a cualquier secuencia de "
"espacios en blanco dentro de la salida real. Por defecto, los espacios en "
"blanco deben corresponderse exactamente.  :const:`NORMALIZE_WHITESPACE` es "
"especialmente til cuando una lnea de la salida esperada es muy larga, y "
"quieres envolverla a travs de mltiples lneas en tu cdigo fuente."

#: ../Doc/library/doctest.rst:559
msgid ""
"When specified, an ellipsis marker (``...``) in the expected output can "
"match any substring in the actual output.  This includes substrings that "
"span line boundaries, and empty substrings, so it's best to keep usage of "
"this simple. Complicated uses can lead to the same kinds of \"oops, it "
"matched too much!\" surprises that ``.*`` is prone to in regular expressions."
msgstr ""
"Cuando se especifica, un marcador de puntos suspensivos (``...``) en la "
"salida esperada puede corresponder a cualquier cadena de caracteres en la "
"salida real. Esto incluye las cadenas de caracteres que abarcan lmites de "
"lneas, y cadenas de caracteres vacas, por lo que es mejor mantener su uso "
"simple. Usos complicados pueden conducir a los mismo tipos de sorpresa de "
"\"ups, coincidi demasiado\" que ``.*`` es propenso a hacer en expresiones "
"regulares."

#: ../Doc/library/doctest.rst:568
msgid ""
"When specified, doctests expecting exceptions pass so long as an exception "
"of the expected type is raised, even if the details (message and fully "
"qualified exception name) don't match."
msgstr ""
"Cuando se especifica, las excepciones que doctest espera, pasarn siempre "
"que sea lanzada una excepcin del tipo esperado, incluso si los detalles "
"(mensaje y nombre completo de la excepcin) no coinciden."

#: ../Doc/library/doctest.rst:572
msgid ""
"For example, an example expecting ``ValueError: 42`` will pass if the actual "
"exception raised is ``ValueError: 3*14``, but will fail if, say, a :exc:"
"`TypeError` is raised instead. It will also ignore any fully qualified name "
"included before the exception class, which can vary between implementations "
"and versions of Python and the code/libraries in use. Hence, all three of "
"these variations will work with the flag specified:"
msgstr ""
"Por ejemplo, si se espera ``ValueError: 42``, el test pasar si la verdadera "
"excepcin lanzada es ``ValueError: 3*14``, pero fallar si es lanzada un :"
"exc:`TypeError`. Tambin ignorar cualquier nombre completo incluido antes "
"de la clase de la excepcin, lo cual puede variar entre implementaciones y "
"versiones de Python y bibliotecas/cdigo en uso. Por lo tanto, las tres "
"variaciones funcionarn con la bandera especificada:"

#: ../Doc/library/doctest.rst:594
msgid ""
"Note that :const:`ELLIPSIS` can also be used to ignore the details of the "
"exception message, but such a test may still fail based on whether the "
"module name is present or matches exactly."
msgstr ""
"Tenga en cuenta que :const:`ELLIPSIS` tambin puede ser usado para ignorar "
"detalles del mensaje de la excepcin, pero dicha prueba an podra fallar si "
"el nombre del modulo est presente o si hay coincidencias exactas."

#: ../Doc/library/doctest.rst:598
msgid ""
":const:`IGNORE_EXCEPTION_DETAIL` now also ignores any information relating "
"to the module containing the exception under test."
msgstr ""
":const:`IGNORE_EXCEPTION_DETAIL` tambin ignora cualquier informacin "
"relacionada al mdulo conteniendo la excepcin bajo prueba."

#: ../Doc/library/doctest.rst:605
msgid ""
"When specified, do not run the example at all.  This can be useful in "
"contexts where doctest examples serve as both documentation and test cases, "
"and an example should be included for documentation purposes, but should not "
"be checked.  E.g., the example's output might be random; or the example "
"might depend on resources which would be unavailable to the test driver."
msgstr ""
"Cuando se especifica, no ejecuta el ejemplo del todo. Puede ser til en "
"contextos donde los ejemplos de doctest sirven como documentacin y casos de "
"prueba a la vez, y un ejemplo debe ser incluido para propsitos de "
"documentacin, pero no debe ser revisado. P. ej., la salida del ejemplo "
"puede ser aleatoria, o el ejemplo puede depender de recursos que no estaran "
"disponibles para el controlador de pruebas."

#: ../Doc/library/doctest.rst:611
msgid ""
"The SKIP flag can also be used for temporarily \"commenting out\" examples."
msgstr ""
"La bandera *SKIP* tambin se puede usar para temporalmente \"quitar\" "
"ejemplos."

#: ../Doc/library/doctest.rst:616
msgid "A bitmask or'ing together all the comparison flags above."
msgstr ""
"Una mscara de bits o juntadas lgicamente todas las banderas de arriba."

#: ../Doc/library/doctest.rst:618
msgid "The second group of options controls how test failures are reported:"
msgstr ""
"El segundo grupo de opciones controla cmo las fallas de las pruebas son "
"reportadas:"

#: ../Doc/library/doctest.rst:623
msgid ""
"When specified, failures that involve multi-line expected and actual outputs "
"are displayed using a unified diff."
msgstr ""
"Cuando se especifica, las fallas que involucran salidas multilnea esperadas "
"y reales son mostradas usando una diferencia (*diff*) unificada."

#: ../Doc/library/doctest.rst:629
msgid ""
"When specified, failures that involve multi-line expected and actual outputs "
"will be displayed using a context diff."
msgstr ""
"Cuando se especifica, las fallas que involucran salidas multilnea esperadas "
"y reales se mostrarn usando una diferencia (*diff*) contextual."

#: ../Doc/library/doctest.rst:635
msgid ""
"When specified, differences are computed by ``difflib.Differ``, using the "
"same algorithm as the popular :file:`ndiff.py` utility. This is the only "
"method that marks differences within lines as well as across lines.  For "
"example, if a line of expected output contains digit ``1`` where actual "
"output contains letter ``l``, a line is inserted with a caret marking the "
"mismatching column positions."
msgstr ""
"Cuando se especifica, las diferencias son computadas por ``difflib.Differ``, "
"usando el mismo algoritmo que la popular utilidad :file:`ndiff.py`. Este es "
"el nico mtodo que marca diferencias dentro de lneas tambin como a travs "
"de lneas. Por ejemplo, si una lnea de salida esperada contiene el dgito "
"``1`` donde la salida actual contiene la letra ``l``, se inserta una lnea "
"con una marca de insercin marcando la posicin de las columnas que no "
"coinciden."

#: ../Doc/library/doctest.rst:644
msgid ""
"When specified, display the first failing example in each doctest, but "
"suppress output for all remaining examples.  This will prevent doctest from "
"reporting correct examples that break because of earlier failures; but it "
"might also hide incorrect examples that fail independently of the first "
"failure.  When :const:`REPORT_ONLY_FIRST_FAILURE` is specified, the "
"remaining examples are still run, and still count towards the total number "
"of failures reported; only the output is suppressed."
msgstr ""
"Cuando se especifica, muestra el primer ejemplo fallido en cada doctest, "
"pero suprime la salida para todos ejemplos restantes. Esto evitar que "
"doctest reporte los ejemplos correctos que se rompen por causa de fallos "
"tempranos; pero tambin puede esconder ejemplos incorrectos que fallen "
"independientemente de la primera falla. Cuando se especifica :const:"
"`REPORT_ONLY_FIRST_FAILURE`, los ejemplos restantes an se ejecutan, y an "
"cuentan para el nmero total de fallas reportadas, slo se suprime la salida."

#: ../Doc/library/doctest.rst:655
msgid ""
"When specified, exit after the first failing example and don't attempt to "
"run the remaining examples. Thus, the number of failures reported will be at "
"most 1.  This flag may be useful during debugging, since examples after the "
"first failure won't even produce debugging output."
msgstr ""
"Cuando se especifica, sale despus del primer ejemplo fallido y no intenta "
"ejecutar los ejemplos restantes. Por consiguiente, el nmero de fallas "
"reportadas ser como mucho 1. Esta bandera puede ser til durante la "
"depuracin, ya que los ejemplos despus de la primera falla ni siquiera "
"producirn salida de depuracin."

#: ../Doc/library/doctest.rst:660
msgid ""
"The doctest command line accepts the option ``-f`` as a shorthand for ``-o "
"FAIL_FAST``."
msgstr ""
"La lnea de comandos de doctest acepta la opcin ``-f`` como un atajo para "
"``-o FAIL_FAST``."

#: ../Doc/library/doctest.rst:668
msgid "A bitmask or'ing together all the reporting flags above."
msgstr "Una mscara de bits o todas las banderas de reporte arriba combinadas."

#: ../Doc/library/doctest.rst:671
msgid ""
"There is also a way to register new option flag names, though this isn't "
"useful unless you intend to extend :mod:`doctest` internals via subclassing:"
msgstr ""
"Tambin hay una manera de registrar nombres de nuevas opciones de banderas, "
"aunque esto no es til a menos que intentes extender :mod:`doctest` a travs "
"de herencia:"

#: ../Doc/library/doctest.rst:677
msgid ""
"Create a new option flag with a given name, and return the new flag's "
"integer value.  :func:`register_optionflag` can be used when subclassing :"
"class:`OutputChecker` or :class:`DocTestRunner` to create new options that "
"are supported by your subclasses.  :func:`register_optionflag` should always "
"be called using the following idiom::"
msgstr ""
"Crea una nueva bandera de opcin con un nombre dado, y retorna el valor "
"entero de la nueva bandera. se puede usar :func:`register_optionflag` cuando "
"se hereda :class:`OutputChecker` o :class:`DocTestRunner` para crear nuevas "
"opciones que sean compatibles con tus clases heredadas. :func:"
"`register_optionflag` siempre debe ser llamado usando la siguiente "
"expresin::"

#: ../Doc/library/doctest.rst:693
msgid "Directives"
msgstr "Directivas"

#: ../Doc/library/doctest.rst:695
msgid ""
"Doctest directives may be used to modify the :ref:`option flags ` for an individual example.  Doctest directives are special Python "
"comments following an example's source code:"
msgstr ""
"Se pueden usar las directivas de doctest para modificar las :ref:`banderas "
"de opcin ` para un ejemplo individual. Las directivas de "
"doctest son comentarios de Python especiales que siguen el cdigo fuente de "
"un ejemplo:"

#: ../Doc/library/doctest.rst:706
msgid ""
"Whitespace is not allowed between the ``+`` or ``-`` and the directive "
"option name.  The directive option name can be any of the option flag names "
"explained above."
msgstr ""
"No se permite el espacio en blanco entre el ``+`` o ``-`` y el nombre de la "
"opcin de directiva (*directive option name*). El nombre de la opcin de "
"directiva puede ser cualquiera de los nombres de las banderas de opciones "
"explicadas arriba."

#: ../Doc/library/doctest.rst:710
msgid ""
"An example's doctest directives modify doctest's behavior for that single "
"example.  Use ``+`` to enable the named behavior, or ``-`` to disable it."
msgstr ""
"Las directivas de doctest de un ejemplo modifican el comportamiento de "
"doctest para ese nico ejemplo. Usa ``+`` para habilitar el comportamiento "
"nombrado, o ``-`` para deshabilitarlo."

#: ../Doc/library/doctest.rst:713
msgid "For example, this test passes:"
msgstr "Por ejemplo, esta prueba se ejecuta con normalidad:"

#: ../Doc/library/doctest.rst:722
msgid ""
"Without the directive it would fail, both because the actual output doesn't "
"have two blanks before the single-digit list elements, and because the "
"actual output is on a single line.  This test also passes, and also requires "
"a directive to do so:"
msgstr ""
"Sin la directiva esto fallara, porque de hecho la salida verdadera no tiene "
"dos espacios en blanco antes de cada elemento de la lista, y adems porque "
"la la salida verdadera est en una sola lnea. Mientras tanto, la siguiente "
"prueba tambin pasa, y de la misma forma requiere de directivas para "
"hacerlo::"

#: ../Doc/library/doctest.rst:733
msgid ""
"Multiple directives can be used on a single physical line, separated by "
"commas:"
msgstr ""
"Se pueden usar varias directivas en una sola lnea, separadas por comas::"

#: ../Doc/library/doctest.rst:742
msgid ""
"If multiple directive comments are used for a single example, then they are "
"combined:"
msgstr ""
"Si las diferentes directivas se usan para un slo ejemplo, entonces estas se "
"combinarn::"

#: ../Doc/library/doctest.rst:752
msgid ""
"As the previous example shows, you can add ``...`` lines to your example "
"containing only directives.  This can be useful when an example is too long "
"for a directive to comfortably fit on the same line:"
msgstr ""
"Como se muestran en los ejemplos anteriores, puedes aadir lneas de ``...`` "
"a tus ejemplos conteniendo slo directivas. Puede ser til cuando un ejemplo "
"es demasiado largo para que una directiva pueda caber cmodamente en la "
"misma lnea::"

#: ../Doc/library/doctest.rst:763
msgid ""
"Note that since all options are disabled by default, and directives apply "
"only to the example they appear in, enabling options (via ``+`` in a "
"directive) is usually the only meaningful choice.  However, option flags can "
"also be passed to functions that run doctests, establishing different "
"defaults.  In such cases, disabling an option via ``-`` in a directive can "
"be useful."
msgstr ""
"Tenga en cuenta que ya que todas las opciones estn deshabilitadas por "
"defecto, y las directivas slo aplican a los ejemplos en los que aparecen, "
"habilitarlas (a travs de ``+`` en la directiva) usualmente es la nica "
"opcin significativa. Sin embargo, las banderas de opciones tambin pueden "
"ser pasadas a funciones que ejecutan doctests, estableciendo valores por "
"defecto diferentes. En tales casos, deshabilitar una opcin a travs de ``-"
"`` en una directiva puede ser til."

#: ../Doc/library/doctest.rst:773
msgid "Warnings"
msgstr "Advertencias"

#: ../Doc/library/doctest.rst:775
msgid ""
":mod:`doctest` is serious about requiring exact matches in expected output.  "
"If even a single character doesn't match, the test fails.  This will "
"probably surprise you a few times, as you learn exactly what Python does and "
"doesn't guarantee about output.  For example, when printing a set, Python "
"doesn't guarantee that the element is printed in any particular order, so a "
"test like ::"
msgstr ""
":mod:`doctest` es serio acerca de requerir coincidencias exactas en la "
"salida esperada. Si incluso un solo carcter no coincide, el test falla. "
"Esto probablemente te sorprender algunas veces, mientras aprendes "
"exactamente lo que Python asegura y no asegura sobre la salida. Por ejemplo, "
"cuando se imprime un conjunto, Python no asegura que el elemento sea impreso "
"en ningn orden particular, por lo que una prueba como: ::"

#: ../Doc/library/doctest.rst:784
msgid "is vulnerable!  One workaround is to do ::"
msgstr "es vulnerable! Una solucin puede ser hacer::"

#: ../Doc/library/doctest.rst:789
msgid "instead.  Another is to do ::"
msgstr "en su lugar. Otra es hacer ::"

#: ../Doc/library/doctest.rst:795
msgid "There are others, but you get the idea."
msgstr "Existen otros casos, pero ya captas la idea."

#: ../Doc/library/doctest.rst:797
msgid "Another bad idea is to print things that embed an object address, like"
msgstr ""
"Otra mala idea es imprimir elementos que tienen la direccin de un objeto, "
"como por ejemplo"

#: ../Doc/library/doctest.rst:807
msgid ""
"The :const:`ELLIPSIS` directive gives a nice approach for the last example:"
msgstr ""
"Con la directiva :const:`ELLIPSIS` podemos sacar ventaja del ltimo ejemplo::"

#: ../Doc/library/doctest.rst:815
msgid ""
"Floating-point numbers are also subject to small output variations across "
"platforms, because Python defers to the platform C library for float "
"formatting, and C libraries vary widely in quality here. ::"
msgstr ""
"Los nmeros de coma flotante tambin son sujetos a pequeas variaciones de "
"la salida a travs de las plataformas, porque Python defiere a la librera C "
"de la plataforma para el formato de flotantes, y las libreras de C varan "
"extensamente en calidad aqu. ::"

#: ../Doc/library/doctest.rst:826
msgid ""
"Numbers of the form ``I/2.**J`` are safe across all platforms, and I often "
"contrive doctest examples to produce numbers of that form::"
msgstr ""
"Nmeros de la forma ``I/2.**J`` son seguros a lo largo de todas las "
"plataformas, y yo frecuentemente planeo ejemplos de doctest para producir "
"nmeros de esa forma::"

#: ../Doc/library/doctest.rst:832
msgid ""
"Simple fractions are also easier for people to understand, and that makes "
"for better documentation."
msgstr ""
"Las facciones simples tambin son ms fciles de entender para las personas, "
"y eso conduce a una mejor documentacin."

#: ../Doc/library/doctest.rst:839
msgid "Basic API"
msgstr "API bsica"

#: ../Doc/library/doctest.rst:841
msgid ""
"The functions :func:`testmod` and :func:`testfile` provide a simple "
"interface to doctest that should be sufficient for most basic uses.  For a "
"less formal introduction to these two functions, see sections :ref:`doctest-"
"simple-testmod` and :ref:`doctest-simple-testfile`."
msgstr ""
"Las funciones :func:`testmod` y :func:`testfile` proporcionan una interfaz "
"simple para doctest que debe ser suficiente para la mayora de los usos "
"bsicos. Para una introduccin menos formal a estas funciones, vase las "
"secciones :ref:`doctest-simple-testmod` y :ref:`doctest-simple-testfile`."

#: ../Doc/library/doctest.rst:849
msgid ""
"All arguments except *filename* are optional, and should be specified in "
"keyword form."
msgstr ""
"Todos los argumentos excepto *filename* son opcionales, y deben ser "
"especificados en forma de palabras claves."

#: ../Doc/library/doctest.rst:852
msgid ""
"Test examples in the file named *filename*.  Return ``(failure_count, "
"test_count)``."
msgstr ""
"Prueba los ejemplos en el archivo con nombre *filename*. Retorna "
"``(failure_count, test_count)``."

#: ../Doc/library/doctest.rst:855
msgid ""
"Optional argument *module_relative* specifies how the filename should be "
"interpreted:"
msgstr ""
"El argumento opcional *module_relative* especifica cmo el nombre de archivo "
"debe ser interpretado:"

#: ../Doc/library/doctest.rst:858
msgid ""
"If *module_relative* is ``True`` (the default), then *filename* specifies an "
"OS-independent module-relative path.  By default, this path is relative to "
"the calling module's directory; but if the *package* argument is specified, "
"then it is relative to that package.  To ensure OS-independence, *filename* "
"should use ``/`` characters to separate path segments, and may not be an "
"absolute path (i.e., it may not begin with ``/``)."
msgstr ""
"Si *module_relative* es ``True`` (el valor por defecto), entonces *filename* "
"especifica una ruta relativa al mdulo que es independiente del SO. Por "
"defecto, esta ruta es relativa al directorio del mdulo que lo invoca; pero "
"si el argumento *package* es especificado, entonces es relativo a ese "
"paquete. Para asegurar la independencia del SO, *filename* debe usar "
"caracteres ``/`` para separar segmentos, y no puede ser una ruta absoluta "
"(por ejemplo., no puede empezar con ``/``)."

#: ../Doc/library/doctest.rst:865
msgid ""
"If *module_relative* is ``False``, then *filename* specifies an OS-specific "
"path.  The path may be absolute or relative; relative paths are resolved "
"with respect to the current working directory."
msgstr ""
"Si *module_relative* es ``False``, entonces *filename* especifica una ruta "
"especifica del SO. La ruta puede ser absoluta o relativa; las rutas "
"relativas son resueltas con respecto al directorio de trabajo actual."

#: ../Doc/library/doctest.rst:869
msgid ""
"Optional argument *name* gives the name of the test; by default, or if "
"``None``, ``os.path.basename(filename)`` is used."
msgstr ""
"El argumento opcional *name* proporciona el nombre de la prueba; por "
"defecto, o si es ``None``, se usa ``os.path.basename(filename)``."

#: ../Doc/library/doctest.rst:872
msgid ""
"Optional argument *package* is a Python package or the name of a Python "
"package whose directory should be used as the base directory for a module-"
"relative filename.  If no package is specified, then the calling module's "
"directory is used as the base directory for module-relative filenames.  It "
"is an error to specify *package* if *module_relative* is ``False``."
msgstr ""
"El argumento opcional *package* es un paquete de Python o el nombre de una "
"paquete de Python cuyo directorio debe ser usado como el directorio base "
"para un nombre de archivo relativo al mdulo. Si no se especifica ningn "
"paquete, entonces el directorio del mdulo que invoca se usa como el "
"directorio base para los nombres de archivos relativos al mdulo. Es un "
"error especificar *package* si *module_relative* es ``False``."

#: ../Doc/library/doctest.rst:878
msgid ""
"Optional argument *globs* gives a dict to be used as the globals when "
"executing examples.  A new shallow copy of this dict is created for the "
"doctest, so its examples start with a clean slate. By default, or if "
"``None``, a new empty dict is used."
msgstr ""
"El argumento opcional *globs* proporciona un diccionario a ser usado como "
"los globales cuando se ejecuten los ejemplos. Se crea una nueva copia "
"superficial de este diccionario para el doctest, por lo que sus ejemplos "
"empiezan con una pizarra en blanco. Por defecto, o si es ``None``, se usa un "
"nuevo diccionario vaco."

#: ../Doc/library/doctest.rst:883
msgid ""
"Optional argument *extraglobs* gives a dict merged into the globals used to "
"execute examples.  This works like :meth:`dict.update`:  if *globs* and "
"*extraglobs* have a common key, the associated value in *extraglobs* appears "
"in the combined dict.  By default, or if ``None``, no extra globals are "
"used.  This is an advanced feature that allows parameterization of "
"doctests.  For example, a doctest can be written for a base class, using a "
"generic name for the class, then reused to test any number of subclasses by "
"passing an *extraglobs* dict mapping the generic name to the subclass to be "
"tested."
msgstr ""
"El argumento opcional *extraglobs* proporciona un diccionario mezclado con "
"los globales usados para ejecutar ejemplos. Funciona como :meth:`dict."
"update`: si *globs* y *extraglobs* tienen una clave en comn, el valor "
"asociado en *extraglobs* aparece en el diccionario combinado. Por defecto, o "
"si es ``None``, no se usa ninguna variable global. Es una caracterstica "
"avanzada que permite la parametrizacin de doctests. Por ejemplo, un doctest "
"puede ser escribo para una clase base, usando un nombre genrico para la "
"clase, y luego reusado para probar cualquier nmero de clases heredadas al "
"pasar un diccionario de *extraglobs* mapeando el nombre genrico a la clase "
"heredada para ser probada."

#: ../Doc/library/doctest.rst:892
msgid ""
"Optional argument *verbose* prints lots of stuff if true, and prints only "
"failures if false; by default, or if ``None``, it's true if and only if ``'-"
"v'`` is in ``sys.argv``."
msgstr ""
"El argumento opcional *verbose* imprime un montn de cosas si es verdadero, "
"e imprime slo las fallas si es falso; por defecto, o si es ``None``, es "
"verdadero si y slo si ``'-v'`` est en ``sys.argv``."

#: ../Doc/library/doctest.rst:896
msgid ""
"Optional argument *report* prints a summary at the end when true, else "
"prints nothing at the end.  In verbose mode, the summary is detailed, else "
"the summary is very brief (in fact, empty if all tests passed)."
msgstr ""
"El argumento opcional *report* imprime un resumen al final cuando es "
"verdadero; si no, no imprime nada al final. En modo verboso (*verbose*), el "
"resumen es detallado; si no, el resumen es muy corto (de hecho, vaco si "
"todos las pruebas pasan)."

#: ../Doc/library/doctest.rst:900
msgid ""
"Optional argument *optionflags* (default value 0) takes the :ref:`bitwise OR "
"` of option flags. See section :ref:`doctest-options`."
msgstr ""
"El argumento opcional *optionflags* (valor por defecto 0) toma las banderas "
"de opciones :ref:`juntadas lgicamente por un OR `. Vase la "
"seccin :ref:`doctest-options`."

#: ../Doc/library/doctest.rst:904
msgid ""
"Optional argument *raise_on_error* defaults to false.  If true, an exception "
"is raised upon the first failure or unexpected exception in an example.  "
"This allows failures to be post-mortem debugged. Default behavior is to "
"continue running examples."
msgstr ""
"El argumento opcional *raise_on_error* tiene como valor por defecto *false*. "
"Si es *true*, se lanza una excepcin sobre la primera falla o excepcin no "
"esperada en un ejemplo. Esto permite que los fallos sean depurados en un "
"anlisis a posteriori. El comportamiento por defecto es continuar corriendo "
"los ejemplos."

#: ../Doc/library/doctest.rst:909 ../Doc/library/doctest.rst:1049
msgid ""
"Optional argument *parser* specifies a :class:`DocTestParser` (or subclass) "
"that should be used to extract tests from the files.  It defaults to a "
"normal parser (i.e., ``DocTestParser()``)."
msgstr ""
"El argumento opcional *parser* especifica un :class:`DocTestParser` (o "
"subclase) que debe ser usado para extraer las pruebas de los archivos. Su "
"valor por defecto es un analizador sintctico normal (i.e., "
"``DocTestParser()``)."

#: ../Doc/library/doctest.rst:913 ../Doc/library/doctest.rst:1053
msgid ""
"Optional argument *encoding* specifies an encoding that should be used to "
"convert the file to unicode."
msgstr ""
"El argumento opcional *encoding* especifica una codificacin que debe ser "
"usada para convertir el archivo a *unicode*."

#: ../Doc/library/doctest.rst:919
msgid ""
"All arguments are optional, and all except for *m* should be specified in "
"keyword form."
msgstr ""
"Todos los argumentos son opcionales, y todos excepto por *m* deben ser "
"especificados en forma de palabras claves."

#: ../Doc/library/doctest.rst:922
msgid ""
"Test examples in docstrings in functions and classes reachable from module "
"*m* (or module :mod:`__main__` if *m* is not supplied or is ``None``), "
"starting with ``m.__doc__``."
msgstr ""
"Prueba los ejemplos en los docstring de las funciones y clases alcanzables "
"desde el mdulo *m* (o desde el mdulo :mod:`__main__` si *m* no es "
"proporcionado o es ``None``), empezando con ``m.__doc__``."

#: ../Doc/library/doctest.rst:926
msgid ""
"Also test examples reachable from dict ``m.__test__``, if it exists and is "
"not ``None``.  ``m.__test__`` maps names (strings) to functions, classes and "
"strings; function and class docstrings are searched for examples; strings "
"are searched directly, as if they were docstrings."
msgstr ""
"Tambin prueba los ejemplos alcanzables desde el diccionario de ``m."
"__test__``, si existe y no es ``None``. ``m.__test__`` mapea los nombres "
"(cadenas de caracteres) a funciones, clases y cadenas de caracteres; se "
"buscan los ejemplos de las funciones y clases; se buscan las cadenas de "
"caracteres directamente como si fueran docstrings."

#: ../Doc/library/doctest.rst:931
msgid ""
"Only docstrings attached to objects belonging to module *m* are searched."
msgstr ""
"Slo se buscan los docstrings anexados a los objetos pertenecientes al "
"mdulo *m*."

#: ../Doc/library/doctest.rst:933
msgid "Return ``(failure_count, test_count)``."
msgstr "Retorna ``(failure_count, test_count)``."

#: ../Doc/library/doctest.rst:935
msgid ""
"Optional argument *name* gives the name of the module; by default, or if "
"``None``, ``m.__name__`` is used."
msgstr ""
"El argumento opcional *name* proporciona el nombre del mdulo; por defecto, "
"o si es ``None``, se usa ``m.__name__``."

#: ../Doc/library/doctest.rst:938
msgid ""
"Optional argument *exclude_empty* defaults to false.  If true, objects for "
"which no doctests are found are excluded from consideration. The default is "
"a backward compatibility hack, so that code still using :meth:`doctest."
"master.summarize` in conjunction with :func:`testmod` continues to get "
"output for objects with no tests. The *exclude_empty* argument to the newer :"
"class:`DocTestFinder` constructor defaults to true."
msgstr ""
"El argumento opcional *exclude_empty* es por defecto *false*. Si es "
"verdadero, se excluyen los objetos por los cuales no se encuentren doctest. "
"El valor por defecto es un *hack* de compatibilidad hacia atrs, por lo que "
"el cdigo que use :meth:`doctest.master.summarize` en conjunto con :func:"
"`testmod` continua obteniendo la salida para objetos sin pruebas. El "
"argumento *exclude_empty* para el ms nuevo constructor :class:"
"`DocTestFinder` es por defecto verdadero."

#: ../Doc/library/doctest.rst:945
msgid ""
"Optional arguments *extraglobs*, *verbose*, *report*, *optionflags*, "
"*raise_on_error*, and *globs* are the same as for function :func:`testfile` "
"above, except that *globs* defaults to ``m.__dict__``."
msgstr ""
"Los argumentos opcionales *extraglobs*, *verbose*, *report*, *optionflags*, "
"*raise_on_error*, y *globs* son los mismos en cuanto a la funcin :func:"
"`testfile` arriba, excepto que *globs* es por defecto ``m.__dict__``."

#: ../Doc/library/doctest.rst:952
msgid ""
"Test examples associated with object *f*; for example, *f* may be a string, "
"a module, a function, or a class object."
msgstr ""
"Prueba los ejemplos asociados con el objeto *f*; por ejemplo, *f* puede ser "
"una cadena de caracteres, un mdulo, una funcin, o un objeto clase."

#: ../Doc/library/doctest.rst:955
msgid ""
"A shallow copy of dictionary argument *globs* is used for the execution "
"context."
msgstr ""
"Una copia superficial del diccionario del argumento *globs* se usa para la "
"ejecucin del contexto."

#: ../Doc/library/doctest.rst:957
msgid ""
"Optional argument *name* is used in failure messages, and defaults to "
"``\"NoName\"``."
msgstr ""
"Se usa el argumento opcional *name* en mensajes de fallos, y por defecto es "
"``\"NoName\"``."

#: ../Doc/library/doctest.rst:960
msgid ""
"If optional argument *verbose* is true, output is generated even if there "
"are no failures.  By default, output is generated only in case of an example "
"failure."
msgstr ""
"Si el argumento opcional *verbose* es verdadero, la salida se genera incluso "
"si no hay fallas. Por defecto, la salida se genera slo en caso de la falla "
"de un ejemplo."

#: ../Doc/library/doctest.rst:963
msgid ""
"Optional argument *compileflags* gives the set of flags that should be used "
"by the Python compiler when running the examples.  By default, or if "
"``None``, flags are deduced corresponding to the set of future features "
"found in *globs*."
msgstr ""
"El argumento opcional *compileflags* proporciona el conjunto de banderas que "
"se deben usar por el compilador de Python cuando se corran los ejemplos. Por "
"defecto, o si es ``None``, las banderas se deducen correspondiendo al "
"conjunto de caractersticas futuras encontradas en *globs*."

#: ../Doc/library/doctest.rst:967
msgid ""
"Optional argument *optionflags* works as for function :func:`testfile` above."
msgstr ""
"El argumento opcional *optionflags* trabaja con respecto a la funcin :func:"
"`testfile` de arriba."

#: ../Doc/library/doctest.rst:973
msgid "Unittest API"
msgstr "API de unittest"

#: ../Doc/library/doctest.rst:975
msgid ""
"As your collection of doctest'ed modules grows, you'll want a way to run all "
"their doctests systematically.  :mod:`doctest` provides two functions that "
"can be used to create :mod:`unittest` test suites from modules and text "
"files containing doctests.  To integrate with :mod:`unittest` test "
"discovery, include a :func:`load_tests` function in your test module::"
msgstr ""
"Mientras crece tu coleccin de mdulos probados con doctest, vas a querer "
"una forma de ejecutar todos sus doctests sistemticamente. :mod:`doctest` "
"proporciona dos funciones que se pueden usar para crear un banco de pruebas "
"(*test suite*) de :mod:`unittest` desde mdulos y archivos de texto que "
"contienen doctests. Para integrarse con el descubrimiento de pruebas de :mod:"
"`unittest` , incluye una funcin  :func:`load_tests` en tu mdulo de "
"pruebas::"

#: ../Doc/library/doctest.rst:989
msgid ""
"There are two main functions for creating :class:`unittest.TestSuite` "
"instances from text files and modules with doctests:"
msgstr ""
"Hay dos funciones principales para crear instancias de :class:`unittest."
"TestSuite` desde los archivos de texto y mdulos con doctests:"

#: ../Doc/library/doctest.rst:995
msgid ""
"Convert doctest tests from one or more text files to a :class:`unittest."
"TestSuite`."
msgstr ""
"Convierte las pruebas de doctest de uno o ms archivos de texto a una :class:"
"`unittest.TestSuite`."

#: ../Doc/library/doctest.rst:998
msgid ""
"The returned :class:`unittest.TestSuite` is to be run by the unittest "
"framework and runs the interactive examples in each file.  If an example in "
"any file fails, then the synthesized unit test fails, and a :exc:"
"`failureException` exception is raised showing the name of the file "
"containing the test and a (sometimes approximate) line number."
msgstr ""
"El :class:`unittest.TestSuite` que se retorne ser ejecutado por el "
"framework de unittest y ejecuta los ejemplos interactivos en cada archivo. "
"Si un ejemplo en cualquier archivo falla, entonces la prueba unitaria "
"sintetizada falla, y una excepcin :exc:`failureException` se lanza "
"mostrando el nombre del archivo conteniendo la prueba y un nmero de lnea "
"(algunas veces aproximado)."

#: ../Doc/library/doctest.rst:1004
msgid "Pass one or more paths (as strings) to text files to be examined."
msgstr ""
"Pasa una o ms rutas (como cadenas de caracteres) a archivos de texto para "
"ser examinados."

#: ../Doc/library/doctest.rst:1006
msgid "Options may be provided as keyword arguments:"
msgstr "Se pueden proporcionar las opciones como argumentos por palabra clave:"

#: ../Doc/library/doctest.rst:1008
msgid ""
"Optional argument *module_relative* specifies how the filenames in *paths* "
"should be interpreted:"
msgstr ""
"El argumento opcional *module_relative* especifica cmo los nombres de "
"archivos en *paths* se deben interpretar:"

#: ../Doc/library/doctest.rst:1011
msgid ""
"If *module_relative* is ``True`` (the default), then each filename in "
"*paths* specifies an OS-independent module-relative path.  By default, this "
"path is relative to the calling module's directory; but if the *package* "
"argument is specified, then it is relative to that package.  To ensure OS-"
"independence, each filename should use ``/`` characters to separate path "
"segments, and may not be an absolute path (i.e., it may not begin with ``/"
"``)."
msgstr ""
"Si *module_relative* is ``True`` (el  valor por defecto), entonces cada "
"archivo de nombre en *paths* especifica una ruta relativa al mdulo "
"independiente del SO. Por defecto, esta ruta es relativa al directorio del "
"mdulo lo est invocando; pero si se especifica el argumento *package*, "
"entonces es relativo a ese paquete. Para asegurar la independencia del SO, "
"cada nombre de archivo debe usar caracteres ``/`` para separar los segmentos "
"de rutas, y puede no ser una ruta absoluta (i.e., puede no empezar con ``/"
"``)."

#: ../Doc/library/doctest.rst:1019
msgid ""
"If *module_relative* is ``False``, then each filename in *paths* specifies "
"an OS-specific path.  The path may be absolute or relative; relative paths "
"are resolved with respect to the current working directory."
msgstr ""
"Si *module_relative* es ``False``, entonces cada archivo de nombre en "
"*paths* especifica una ruta especifica al SO. La ruta puede ser absoluta o "
"relativa; las rutas relativas son resueltas con respecto a directorio de "
"trabajo actual."

#: ../Doc/library/doctest.rst:1023
msgid ""
"Optional argument *package* is a Python package or the name of a Python "
"package whose directory should be used as the base directory for module-"
"relative filenames in *paths*.  If no package is specified, then the calling "
"module's directory is used as the base directory for module-relative "
"filenames.  It is an error to specify *package* if *module_relative* is "
"``False``."
msgstr ""
"El argumento opcional *package* es un paquete de Python o el nombre de un "
"paquete de Python cuyo directorio debe ser usado como el directorio base "
"para los nombres de archivos relativos al mdulo en *paths*. Si no se "
"especifica ningn paquete, entonces el directorio del mdulo que lo est "
"invocando se usa como el directorio base para los archivos de nombres "
"relativos al mdulo. Es un error especificar *package* si *module_relative* "
"es ``False``."

#: ../Doc/library/doctest.rst:1030
msgid ""
"Optional argument *setUp* specifies a set-up function for the test suite. "
"This is called before running the tests in each file.  The *setUp* function "
"will be passed a :class:`DocTest` object.  The setUp function can access the "
"test globals as the *globs* attribute of the test passed."
msgstr ""
"El argumento opcional *setUp* especifica una funcin de configuracin para "
"el banco de pruebas. Es invocado antes de ejecutar las pruebas en cada "
"archivo. La funcin *setUp* se pasar a un objeto :class:`DocTest`. La "
"funcin *setUp* puede acceder a las variables globales de prueba como el "
"atributo *globs* de la prueba pasada."

#: ../Doc/library/doctest.rst:1035
msgid ""
"Optional argument *tearDown* specifies a tear-down function for the test "
"suite.  This is called after running the tests in each file.  The *tearDown* "
"function will be passed a :class:`DocTest` object.  The setUp function can "
"access the test globals as the *globs* attribute of the test passed."
msgstr ""
"El argumento opcional *tearDown* especifica una funcin de destruccin para "
"el banco de pruebas. Es invocado despus de ejecutar las pruebas en cada "
"archivo. Se pasar un objeto :class:`DocTest` a la funcin *tearDown*. La "
"funcin *setUp* de configuracin puede acceder a los globales de la prueba "
"como el atributo *globs* de la prueba pasada."

#: ../Doc/library/doctest.rst:1040 ../Doc/library/doctest.rst:1074
msgid ""
"Optional argument *globs* is a dictionary containing the initial global "
"variables for the tests.  A new copy of this dictionary is created for each "
"test.  By default, *globs* is a new empty dictionary."
msgstr ""
"El argumento opcional *globs* es un diccionario que contiene las variables "
"globales iniciales para las pruebas. Se crea una nueva copia de este "
"diccionario para cada prueba. Por defecto, *globs* es un nuevo diccionario "
"vaco."

#: ../Doc/library/doctest.rst:1044
msgid ""
"Optional argument *optionflags* specifies the default doctest options for "
"the tests, created by or-ing together individual option flags.  See section :"
"ref:`doctest-options`. See function :func:`set_unittest_reportflags` below "
"for a better way to set reporting options."
msgstr ""
"El argumento opcional *optionflags* especifica las opciones de doctest por "
"defecto para las pruebas, creado al juntar lgicamente las opciones de "
"bandera individuales. Vase la seccin :ref:`doctest-options`. Vase la "
"funcin :func:`set_unittest_reportflags` abajo para una mejor manera de "
"definir las opciones de informe."

#: ../Doc/library/doctest.rst:1056
msgid ""
"The global ``__file__`` is added to the globals provided to doctests loaded "
"from a text file using :func:`DocFileSuite`."
msgstr ""
"Se aade el global ``__file__`` a los globales proporcionados a los doctests "
"cargados desde un archivo de texto usando :func:`DocFileSuite`."

#: ../Doc/library/doctest.rst:1062
msgid "Convert doctest tests for a module to a :class:`unittest.TestSuite`."
msgstr ""
"Convierte las pruebas de doctest para un mdulo a un  :class:`unittest."
"TestSuite`."

#: ../Doc/library/doctest.rst:1064
msgid ""
"The returned :class:`unittest.TestSuite` is to be run by the unittest "
"framework and runs each doctest in the module.  If any of the doctests fail, "
"then the synthesized unit test fails, and a :exc:`failureException` "
"exception is raised showing the name of the file containing the test and a "
"(sometimes approximate) line number."
msgstr ""
"El :class:`unittest.TestSuite` que se retorne ser ejecutado por el "
"framework de unittest y corre cada doctest en el mdulo. Si cualquiera de "
"los doctests falla, entonces la prueba unitaria combinada falla, y se lanza "
"una excepcin :exc:`failureException` mostrando el nombre del archivo que "
"contiene la prueba y un nmero de lnea (a veces aproximado)."

#: ../Doc/library/doctest.rst:1070
msgid ""
"Optional argument *module* provides the module to be tested.  It can be a "
"module object or a (possibly dotted) module name.  If not specified, the "
"module calling this function is used."
msgstr ""
"El argumento opcional *module* proporciona el mdulo a probar. Puede ser un "
"objeto de mdulo o un nombre (posiblemente punteado)  de mdulo. Si no se "
"especifica, se usa el mdulo que invoca esta funcin."

#: ../Doc/library/doctest.rst:1078
msgid ""
"Optional argument *extraglobs* specifies an extra set of global variables, "
"which is merged into *globs*.  By default, no extra globals are used."
msgstr ""
"El argumento opcional *extraglobs* especifica un conjunto de variables "
"globales adicionales que son mezcladas con *globs*. Por defecto, no se usa "
"ningn global adicional."

#: ../Doc/library/doctest.rst:1081
msgid ""
"Optional argument *test_finder* is the :class:`DocTestFinder` object (or a "
"drop-in replacement) that is used to extract doctests from the module."
msgstr ""
"El argumento opcional *test_finder* es el objeto :class:`DocTestFinder` (o "
"un reemplazo directo) que se usa para extraer doctests desde el mdulo."

#: ../Doc/library/doctest.rst:1084
msgid ""
"Optional arguments *setUp*, *tearDown*, and *optionflags* are the same as "
"for function :func:`DocFileSuite` above."
msgstr ""
"Los argumentos opcionales *setUp*, *tearDown*, y *optionflags* son lo mismo "
"con respecto a la funcin :func:`DocFileSuite` arriba."

#: ../Doc/library/doctest.rst:1087
msgid "This function uses the same search technique as :func:`testmod`."
msgstr "Esta funcin usa la misma tcnica de bsqueda que :func:`testmod`."

#: ../Doc/library/doctest.rst:1089
msgid ""
":func:`DocTestSuite` returns an empty :class:`unittest.TestSuite` if "
"*module* contains no docstrings instead of raising :exc:`ValueError`."
msgstr ""
":func:`DocTestSuite` retorna un :class:`unittest.TestSuite` vaco si "
"*module* no contiene ningn docstring en vez de lanzar  un :exc:`ValueError`."

#: ../Doc/library/doctest.rst:1094
msgid ""
"Under the covers, :func:`DocTestSuite` creates a :class:`unittest.TestSuite` "
"out of :class:`doctest.DocTestCase` instances, and :class:`DocTestCase` is a "
"subclass of :class:`unittest.TestCase`. :class:`DocTestCase` isn't "
"documented here (it's an internal detail), but studying its code can answer "
"questions about the exact details of :mod:`unittest` integration."
msgstr ""
"Por detrs, :func:`DocTestSuite` crea un :class:`unittest.TestSuite` de las "
"instancias de :class:`doctest.DocTestCase`, y :class:`DocTestCase` es una "
"subclase de :class:`unittest.TestCase`. :class:`DocTestCase` no est "
"documentado aqu (es un detalle interno), pero estudiar su cdigo puede "
"responder preguntas sobre los detalles exactos de la integracin de :mod:"
"`unittest`."

#: ../Doc/library/doctest.rst:1100
msgid ""
"Similarly, :func:`DocFileSuite` creates a :class:`unittest.TestSuite` out "
"of :class:`doctest.DocFileCase` instances, and :class:`DocFileCase` is a "
"subclass of :class:`DocTestCase`."
msgstr ""
"De manera similar, :func:`DocFileSuite` crea un  :class:`unittest.TestSuite` "
"de las instancias de :class:`doctest.DocFileCase`, y :class:`DocFileCase` es "
"una subclase de  :class:`DocTestCase`."

#: ../Doc/library/doctest.rst:1104
msgid ""
"So both ways of creating a :class:`unittest.TestSuite` run instances of :"
"class:`DocTestCase`.  This is important for a subtle reason: when you run :"
"mod:`doctest` functions yourself, you can control the :mod:`doctest` options "
"in use directly, by passing option flags to :mod:`doctest` functions.  "
"However, if you're writing a :mod:`unittest` framework, :mod:`unittest` "
"ultimately controls when and how tests get run.  The framework author "
"typically wants to control :mod:`doctest` reporting options (perhaps, e.g., "
"specified by command line options), but there's no way to pass options "
"through :mod:`unittest` to :mod:`doctest` test runners."
msgstr ""
"Por lo que ambas formas de crear un :class:`unittest.TestSuite` ejecutan "
"instancias de :class:`DocTestCase`. Esto es importante por una razn sutil: "
"cuando ejecutas las funciones de :mod:`doctest` por ti mismo, puedes "
"controlar las opciones de :mod:`doctest` en uso directamente, al pasar las "
"banderas de opciones a las funciones de :mod:`doctest`. Sin embargo, si "
"ests escribiendo un framework de :mod:`unittest`, bsicamente :mod:"
"`unittest` controla cundo y cmo se ejecutan las pruebas. El autor del "
"framework tpicamente, quiere controlar las opciones de reporte de :mod:"
"`doctest` (quizs, p.ej., especificadas por las opciones de la lnea de "
"comandos), pero no hay forma de pasar opciones a travs de :mod:`unittest` "
"al probador de ejecucin (*test runner*) de :mod:`doctest`."

#: ../Doc/library/doctest.rst:1114
msgid ""
"For this reason, :mod:`doctest` also supports a notion of :mod:`doctest` "
"reporting flags specific to :mod:`unittest` support, via this function:"
msgstr ""
"Por esta razn, :mod:`doctest` tambin admite una nocin de banderas de "
"informe de :mod:`doctest` especficas para la compatibilidad con :mod:"
"`unittest`, a travs de esta funcin:"

#: ../Doc/library/doctest.rst:1120
msgid "Set the :mod:`doctest` reporting flags to use."
msgstr "Establece las banderas de informe de :mod:`doctest` a usar."

#: ../Doc/library/doctest.rst:1122
msgid ""
"Argument *flags* takes the :ref:`bitwise OR ` of option flags.  See "
"section :ref:`doctest-options`.  Only \"reporting flags\" can be used."
msgstr ""
"El argumento *flags* toma la :ref:`combinacin por el operador OR ` "
"de las banderas de opciones. Vase la seccin :ref:`doctest-options`. Slo "
"se pueden usar las \"banderas de informe\"."

#: ../Doc/library/doctest.rst:1125
msgid ""
"This is a module-global setting, and affects all future doctests run by "
"module :mod:`unittest`:  the :meth:`runTest` method of :class:`DocTestCase` "
"looks at the option flags specified for the test case when the :class:"
"`DocTestCase` instance was constructed.  If no reporting flags were "
"specified (which is the typical and expected case), :mod:`doctest`'s :mod:"
"`unittest` reporting flags are :ref:`bitwise ORed ` into the option "
"flags, and the option flags so augmented are passed to the :class:"
"`DocTestRunner` instance created to run the doctest.  If any reporting flags "
"were specified when the :class:`DocTestCase` instance was constructed, :mod:"
"`doctest`'s :mod:`unittest` reporting flags are ignored."
msgstr ""
"Esta es una configuracin global del mdulo, y afecta a todos los doctests "
"futuros a ejecutar por :mod:`unittest`: el mtodo :meth:`runTest` de :class:"
"`DocTestCase` revisa las banderas de opciones especificadas para el caso de "
"prueba cuando la instancia de :class:`DocTestCase` fue construida. Si no se "
"especific ninguna bandera de informe (que es el caso tpico y esperado), "
"las banderas de informe -pertenecientes a :mod:`doctest`- de :mod:`unittest` "
"son :ref:`combinadas por la operacin Or ` en las banderas de "
"opciones, y las banderas de opciones aumentadas se pasan a la instancia de :"
"class:`DocTestRunner` creada para ejecutar los doctest. Si se especific "
"alguna bandera de informe cuando el :class:`DocTestCase` fue construido, se "
"ignoran las banderas de informe -pertenecientes a :mod:`doctest`- de :mod:"
"`unittest`."

#: ../Doc/library/doctest.rst:1136
msgid ""
"The value of the :mod:`unittest` reporting flags in effect before the "
"function was called is returned by the function."
msgstr ""
"La funcin retorna el valor de las banderas de informe de :mod:`unittest` en "
"efecto antes de que la funcin fuera invocada."

#: ../Doc/library/doctest.rst:1143
msgid "Advanced API"
msgstr "API avanzada"

#: ../Doc/library/doctest.rst:1145
msgid ""
"The basic API is a simple wrapper that's intended to make doctest easy to "
"use. It is fairly flexible, and should meet most users' needs; however, if "
"you require more fine-grained control over testing, or wish to extend "
"doctest's capabilities, then you should use the advanced API."
msgstr ""
"La API bsica es un simple envoltorio que sirve para hacer los doctest "
"fciles de usar. Es bastante flexible, y debe cumplir las necesidades de la "
"mayora de los usuarios; si requieres un control ms preciso en las pruebas, "
"o deseas extender las capacidades de doctest, entonces debes usar la API "
"avanzada."

#: ../Doc/library/doctest.rst:1150
msgid ""
"The advanced API revolves around two container classes, which are used to "
"store the interactive examples extracted from doctest cases:"
msgstr ""
"La API avanzada gira en torno a dos clases contenedoras, que se usan para "
"guardar los ejemplos interactivos extrados de los casos doctest:"

#: ../Doc/library/doctest.rst:1153
msgid ""
":class:`Example`: A single Python :term:`statement`, paired with its "
"expected output."
msgstr ""
":class:`Example`: Un :term:`statement` de Python, emparejado con su salida "
"esperada."

#: ../Doc/library/doctest.rst:1156
msgid ""
":class:`DocTest`: A collection of :class:`Example`\\ s, typically extracted "
"from a single docstring or text file."
msgstr ""
":class:`DocTest`: Una coleccin de clases :class:`Example`, tpicamente "
"extrados de un slo docstring o archivo de texto."

#: ../Doc/library/doctest.rst:1159
msgid ""
"Additional processing classes are defined to find, parse, and run, and check "
"doctest examples:"
msgstr ""
"Se definen clases de procesamiento adicionales para encontrar, analizar "
"sintcticamente, y ejecutar, y comprobar ejemplos de doctest:"

#: ../Doc/library/doctest.rst:1162
msgid ""
":class:`DocTestFinder`: Finds all docstrings in a given module, and uses a :"
"class:`DocTestParser` to create a :class:`DocTest` from every docstring that "
"contains interactive examples."
msgstr ""
":class:`DocTestFinder`: Encuentra todos los docstrings en un mdulo dado, y "
"usa un :class:`DocTestParser` para crear un :class:`DocTest` de cada "
"docstring que contiene ejemplos interactivos."

#: ../Doc/library/doctest.rst:1166
msgid ""
":class:`DocTestParser`: Creates a :class:`DocTest` object from a string "
"(such as an object's docstring)."
msgstr ""
":class:`DocTestParser`: Crea un objeto :class:`DocTest` de una cadena de "
"caracteres (tal como un docstring de un objeto)."

#: ../Doc/library/doctest.rst:1169
msgid ""
":class:`DocTestRunner`: Executes the examples in a :class:`DocTest`, and "
"uses an :class:`OutputChecker` to verify their output."
msgstr ""
":class:`DocTestRunner`: Ejecuta los ejemplos en un :class:`DocTest`, y usa "
"un :class:`OutputChecker` para verificar su salida."

#: ../Doc/library/doctest.rst:1172
msgid ""
":class:`OutputChecker`: Compares the actual output from a doctest example "
"with the expected output, and decides whether they match."
msgstr ""
":class:`OutputChecker`: Compara la salida real de un ejemplo de doctest con "
"la salida esperada, y decide si coinciden."

#: ../Doc/library/doctest.rst:1175
msgid ""
"The relationships among these processing classes are summarized in the "
"following diagram::"
msgstr ""
"Las relaciones entre estas clases de procesamiento se resumen en el "
"siguiente diagrama::"

#: ../Doc/library/doctest.rst:1191
msgid "DocTest Objects"
msgstr "Objetos DocTest"

#: ../Doc/library/doctest.rst:1196
msgid ""
"A collection of doctest examples that should be run in a single namespace.  "
"The constructor arguments are used to initialize the attributes of the same "
"names."
msgstr ""
"Una coleccin de ejemplos de doctest que deben ejecutarse en un slo nombre "
"de espacios. Se usan los argumentos del constructor para inicializar los "
"atributos de los mismos nombres."

#: ../Doc/library/doctest.rst:1200
msgid ""
":class:`DocTest` defines the following attributes.  They are initialized by "
"the constructor, and should not be modified directly."
msgstr ""
":class:`DocTest` define los siguientes atributos. Son inicializados por el "
"constructor, y no deben ser modificados directamente."

#: ../Doc/library/doctest.rst:1206
msgid ""
"A list of :class:`Example` objects encoding the individual interactive "
"Python examples that should be run by this test."
msgstr ""
"Una lista de objetos :class:`Example` codificando los ejemplos interactivos "
"de Python individuales que esta prueba debe ejecutar."

#: ../Doc/library/doctest.rst:1212
msgid ""
"The namespace (aka globals) that the examples should be run in. This is a "
"dictionary mapping names to values.  Any changes to the namespace made by "
"the examples (such as binding new variables) will be reflected in :attr:"
"`globs` after the test is run."
msgstr ""
"El nombre de espacios (alias *globals*) en que los ejemplos se deben "
"ejecutar. Este es un diccionario que mapea nombres a valores. Cualquier "
"cambio al nombre de espacios hecho por los ejemplos (tal como juntar nuevas "
"variables) se reflejar en :attr:`globs` despus de que se ejecute la prueba."

#: ../Doc/library/doctest.rst:1220
msgid ""
"A string name identifying the :class:`DocTest`.  Typically, this is the name "
"of the object or file that the test was extracted from."
msgstr ""
"Un nombre de cadena de caracteres que identifica el :class:`DocTest`. "
"Normalmente, este es el nombre del objeto o archivo del que se extrajo la "
"prueba."

#: ../Doc/library/doctest.rst:1226
msgid ""
"The name of the file that this :class:`DocTest` was extracted from; or "
"``None`` if the filename is unknown, or if the :class:`DocTest` was not "
"extracted from a file."
msgstr ""
"El nombre del archivo del que se extrajo este :class:`DocTest`; o ``None`` "
"si el nombre del archivo se desconoce, o si :class:`DocTest` no se extrajo "
"de un archivo."

#: ../Doc/library/doctest.rst:1233
msgid ""
"The line number within :attr:`filename` where this :class:`DocTest` begins, "
"or ``None`` if the line number is unavailable.  This line number is zero-"
"based with respect to the beginning of the file."
msgstr ""
"El nmero de lnea dentro de :attr:`filename` donde este :class:`DocTest` "
"comienza, o ``None`` si el nmero de lnea no est disponible. Este nmero "
"de lnea es comienza en 0 con respecto al comienzo del archivo."

#: ../Doc/library/doctest.rst:1240
msgid ""
"The string that the test was extracted from, or ``None`` if the string is "
"unavailable, or if the test was not extracted from a string."
msgstr ""
"La cadena de caracteres del que se extrajo la cadena, o ``None`` si la "
"cadena no est disponible, o si la prueba no se extrajo de una cadena de "
"caracteres."

# Estoy poniendo Example sin traducir porque hace referencia a la clase
# :class:`Example` que envuelve los ejemplos interactivos.
#: ../Doc/library/doctest.rst:1247
msgid "Example Objects"
msgstr "Objetos *Example*"

#: ../Doc/library/doctest.rst:1252
msgid ""
"A single interactive example, consisting of a Python statement and its "
"expected output.  The constructor arguments are used to initialize the "
"attributes of the same names."
msgstr ""
"Un slo ejemplo interactivo, que consta de una sentencia de Python y su "
"salida esperada. Los argumentos del constructor se usan para inicializar los "
"atributos del mismo nombre."

#: ../Doc/library/doctest.rst:1257
msgid ""
":class:`Example` defines the following attributes.  They are initialized by "
"the constructor, and should not be modified directly."
msgstr ""
"La clase :class:`Example` define los siguientes atributos. Son inicializados "
"por el constructor, y no deben ser modificados directamente."

#: ../Doc/library/doctest.rst:1263
msgid ""
"A string containing the example's source code.  This source code consists of "
"a single Python statement, and always ends with a newline; the constructor "
"adds a newline when necessary."
msgstr ""
"Una cadena de caracteres que contiene el cdigo fuente del ejemplo. Este "
"cdigo fuente consiste de una sola sentencia Python, y siempre termina en "
"una nueva lnea; el constructor aade una nueva lnea cuando sea necesario."

#: ../Doc/library/doctest.rst:1270
msgid ""
"The expected output from running the example's source code (either from "
"stdout, or a traceback in case of exception).  :attr:`want` ends with a "
"newline unless no output is expected, in which case it's an empty string.  "
"The constructor adds a newline when necessary."
msgstr ""
"La salida esperada de ejecutar el cdigo fuente del ejemplo (o desde la "
"salida estndar, o un seguimiento en caso de una excepcin). :attr:`wants` "
"termina con una nueva lnea a menos que no se espera ninguna salida, en cuyo "
"caso es una cadena vaca. El constructor aade una nueva lnea cuando sea "
"necesario."

#: ../Doc/library/doctest.rst:1278
msgid ""
"The exception message generated by the example, if the example is expected "
"to generate an exception; or ``None`` if it is not expected to generate an "
"exception.  This exception message is compared against the return value of :"
"func:`traceback.format_exception_only`.  :attr:`exc_msg` ends with a newline "
"unless it's ``None``.  The constructor adds a newline if needed."
msgstr ""
"El mensaje de excepcin que el ejemplo genera, si se espera que el ejemplo "
"genere una excepcin; o ``None`` si no se espera que genere una excepcin. "
"Se compara este mensaje de excepcin con el valor de retorno de :func:"
"`traceback.format_exception_only`.  :attr:`exc_msg` termina con una nueva "
"lnea a menos que sea ``None``.  El constructor aade una nueva lnea si se "
"necesita."

#: ../Doc/library/doctest.rst:1287
msgid ""
"The line number within the string containing this example where the example "
"begins.  This line number is zero-based with respect to the beginning of the "
"containing string."
msgstr ""
"El nmero de lnea dentro de la cadena de caracteres que contiene este "
"ejemplo donde el ejemplo comienza. Este nmero de lnea comienza en 0 con "
"respecto al comienzo de la cadena que lo contiene."

#: ../Doc/library/doctest.rst:1294
msgid ""
"The example's indentation in the containing string, i.e., the number of "
"space characters that precede the example's first prompt."
msgstr ""
"La sangra del ejemplo en la cadena que lo contiene; i.e., el nmero de "
"caracteres de espacio que preceden la primera entrada del ejemplo."

#: ../Doc/library/doctest.rst:1300
msgid ""
"A dictionary mapping from option flags to ``True`` or ``False``, which is "
"used to override default options for this example.  Any option flags not "
"contained in this dictionary are left at their default value (as specified "
"by the :class:`DocTestRunner`'s :attr:`optionflags`). By default, no options "
"are set."
msgstr ""
"Un diccionario que mapea de las banderas de opciones a ``True`` o ``False``, "
"que se usa para anular las opciones por defecto para este ejemplo. Cualquier "
"bandera de opcin que no contiene este diccionario se deja con su valor por "
"defecto (como se especifica por los :attr:`optionflags` de :class:"
"`DocTestRunner`). Por defecto, no se establece ninguna opcin."

#: ../Doc/library/doctest.rst:1309
msgid "DocTestFinder objects"
msgstr "Objetos *DocTestFinder*"

#: ../Doc/library/doctest.rst:1314
msgid ""
"A processing class used to extract the :class:`DocTest`\\ s that are "
"relevant to a given object, from its docstring and the docstrings of its "
"contained objects. :class:`DocTest`\\ s can be extracted from modules, "
"classes, functions, methods, staticmethods, classmethods, and properties."
msgstr ""
"Una clase de procesamiento que se usa para extraer los :class:`DocTest` que "
"son relevantes para un objeto dado, desde su docstring y los docstring de "
"sus objetos contenidos. Se puede extraer los :class:`DocTest` de los "
"mdulos, clases, funciones, mtodos, mtodos estticos, mtodos de clase, y "
"propiedades."

#: ../Doc/library/doctest.rst:1319
msgid ""
"The optional argument *verbose* can be used to display the objects searched "
"by the finder.  It defaults to ``False`` (no output)."
msgstr ""
"Se puede usar el argumento opcional *verbose* para mostrar los objetos "
"buscados por *finder*. Su valor por defecto es ``False`` (ninguna salida)."

#: ../Doc/library/doctest.rst:1322
msgid ""
"The optional argument *parser* specifies the :class:`DocTestParser` object "
"(or a drop-in replacement) that is used to extract doctests from docstrings."
msgstr ""
"El argumento opcional *parser* especifica el objeto :class:`DocTestParser` "
"(o un reemplazo directo) que se usa para extraer doctests desde docstrings."

#: ../Doc/library/doctest.rst:1325
msgid ""
"If the optional argument *recurse* is false, then :meth:`DocTestFinder.find` "
"will only examine the given object, and not any contained objects."
msgstr ""
"Si el argumento opcional *recurse* es falso, entonces el mtodo :meth:"
"`DocTestFinder.find` slo examinar el objeto dado, y no cualquier objeto "
"contenido."

#: ../Doc/library/doctest.rst:1328
msgid ""
"If the optional argument *exclude_empty* is false, then :meth:`DocTestFinder."
"find` will include tests for objects with empty docstrings."
msgstr ""
"Si el argumento opcional *exclude_empty* es falso, entonces :meth:"
"`DocTestFinder.find` incluir pruebas para objetos con docstrings vacos."

#: ../Doc/library/doctest.rst:1332
msgid ":class:`DocTestFinder` defines the following method:"
msgstr ":class:`DocTestFinder` define los siguientes mtodos:"

#: ../Doc/library/doctest.rst:1337
msgid ""
"Return a list of the :class:`DocTest`\\ s that are defined by *obj*'s "
"docstring, or by any of its contained objects' docstrings."
msgstr ""
"Retorna una lista de los :class:`Doctest` que se definen por el docstring de "
"*obj*, o por cualquiera de los docstring de sus objetos contenidos."

#: ../Doc/library/doctest.rst:1340
msgid ""
"The optional argument *name* specifies the object's name; this name will be "
"used to construct names for the returned :class:`DocTest`\\ s.  If *name* is "
"not specified, then ``obj.__name__`` is used."
msgstr ""
"El argumento opcional *name* especifica el nombre del objeto; este nombre "
"ser usado para construir los nombres de los :class:`DocTest` retornados. Si "
"*name* no se especifica, entonces se usa ``obj.__name__``."

#: ../Doc/library/doctest.rst:1344
msgid ""
"The optional parameter *module* is the module that contains the given "
"object. If the module is not specified or is ``None``, then the test finder "
"will attempt to automatically determine the correct module.  The object's "
"module is used:"
msgstr ""
"El parmetro opcional *module* es el mdulo que contiene el objeto dado. Si "
"no se especifica el mdulo o si es ``None``, entonces el buscador de pruebas "
"tratar de determinar automticamente el mdulo correcto. Se usa el mdulo "
"del objeto:"

#: ../Doc/library/doctest.rst:1348
msgid "As a default namespace, if *globs* is not specified."
msgstr "Como un espacio de nombres por defecto, si no se especifica *globs*."

#: ../Doc/library/doctest.rst:1350
msgid ""
"To prevent the DocTestFinder from extracting DocTests from objects that are "
"imported from other modules.  (Contained objects with modules other than "
"*module* are ignored.)"
msgstr ""
"Para evitar que *DocTestFinder* extraiga DocTests desde objetos que se "
"importan desde otros mdulos. (Se ignoran objetos contenidos con mdulos "
"aparte de *module*.)"

#: ../Doc/library/doctest.rst:1354
msgid "To find the name of the file containing the object."
msgstr "Para encontrar el nombre del archivo conteniendo el objeto."

#: ../Doc/library/doctest.rst:1356
msgid "To help find the line number of the object within its file."
msgstr ""
"Para ayudar a encontrar el nmero de lnea del objeto dentro de su archivo."

#: ../Doc/library/doctest.rst:1358
msgid ""
"If *module* is ``False``, no attempt to find the module will be made.  This "
"is obscure, of use mostly in testing doctest itself: if *module* is "
"``False``, or is ``None`` but cannot be found automatically, then all "
"objects are considered to belong to the (non-existent) module, so all "
"contained objects will (recursively) be searched for doctests."
msgstr ""
"Si *module* es falso, no se har ningn intento de encontrar el mdulo. Es "
"poco claro, de uso mayormente para probar doctest en si mismo: si *module* "
"es ``False``, o es ``None`` pero no se puede encontrar automticamente, "
"entonces todos los objetos se consideran que pertenecen al mdulo "
"(inexistente), por lo que todos los objetos contenidos se buscarn "
"(recursivamente) por doctests."

#: ../Doc/library/doctest.rst:1364
msgid ""
"The globals for each :class:`DocTest` is formed by combining *globs* and "
"*extraglobs* (bindings in *extraglobs* override bindings in *globs*).  A new "
"shallow copy of the globals dictionary is created for each :class:`DocTest`. "
"If *globs* is not specified, then it defaults to the module's *__dict__*, if "
"specified, or ``{}`` otherwise.  If *extraglobs* is not specified, then it "
"defaults to ``{}``."
msgstr ""
"Los globales para cada :class:`DocTest` se forma al combinar *globs* y "
"*extraglobs* (los enlaces en *extraglobs* anulan los enlaces en *globs*). Se "
"crea una nueva copia superficial del diccionario de globales para cada :"
"class:`DocTest`. Si *globs* no se especifica, entonces su valor por defecto "
"es el *__dict__* del mdulo, si se especifica, o es ``{}`` de lo contrario, "
"si *extraglobs* no se especifica, entonces su valor por defecto es ``{}``."

#: ../Doc/library/doctest.rst:1375
msgid "DocTestParser objects"
msgstr "Objetos *DocTestParser*"

#: ../Doc/library/doctest.rst:1380
msgid ""
"A processing class used to extract interactive examples from a string, and "
"use them to create a :class:`DocTest` object."
msgstr ""
"Un clase de procesamiento usada para extraer ejemplos interactivos de una "
"cadena de caracteres, y usarlos para crear un objeto :class:`DocTest`."

#: ../Doc/library/doctest.rst:1384 ../Doc/library/doctest.rst:1452
msgid ":class:`DocTestParser` defines the following methods:"
msgstr ":class:`DocTestParser` define los siguientes mtodos:"

#: ../Doc/library/doctest.rst:1389
msgid ""
"Extract all doctest examples from the given string, and collect them into a :"
"class:`DocTest` object."
msgstr ""
"Extrae todos los ejemplos de *doctest* de una cadena dada, y los recolecta "
"en un objeto :class:`DocTest`."

#: ../Doc/library/doctest.rst:1392
msgid ""
"*globs*, *name*, *filename*, and *lineno* are attributes for the new :class:"
"`DocTest` object.  See the documentation for :class:`DocTest` for more "
"information."
msgstr ""
"*globs*, *name*, *filename*, y *lineno* son atributos para el nuevo objeto :"
"class:`DocTest`. Vase la documentacin de :class:`DocTest` para ms "
"informacin."

#: ../Doc/library/doctest.rst:1399
msgid ""
"Extract all doctest examples from the given string, and return them as a "
"list of :class:`Example` objects.  Line numbers are 0-based.  The optional "
"argument *name* is a name identifying this string, and is only used for "
"error messages."
msgstr ""
"Extrae todos los ejemplos de la cadena de caracteres dada, y los retorna "
"como una lista de objetos :class:`Example`. Los nmeros de lnea empiezan en "
"0. El argumento opcional *name* es una nombre identificando esta cadena, y "
"slo es usada para mensajes de errores."

#: ../Doc/library/doctest.rst:1406
msgid ""
"Divide the given string into examples and intervening text, and return them "
"as a list of alternating :class:`Example`\\ s and strings. Line numbers for "
"the :class:`Example`\\ s are 0-based.  The optional argument *name* is a "
"name identifying this string, and is only used for error messages."
msgstr ""
"Divide el string dado en ejemplos y texto intermedio, y los retorna como una "
"lista que alterna entre objetos :class:`Example` y cadenas de caracteres. "
"Los nmeros de lnea para los objetos :class:`Example` empiezan en 0. El "
"argumento opcional *name* es un nombre identificando esta cadena, y slo se "
"usa en mensajes de error."

#: ../Doc/library/doctest.rst:1415
msgid "DocTestRunner objects"
msgstr "Objetos *DocTestRunner*"

#: ../Doc/library/doctest.rst:1420
msgid ""
"A processing class used to execute and verify the interactive examples in a :"
"class:`DocTest`."
msgstr ""
"Una clase de procesamiento usada para ejecutar y verificar los ejemplos "
"interactivos en un :class:`DocTest`."

#: ../Doc/library/doctest.rst:1423
msgid ""
"The comparison between expected outputs and actual outputs is done by an :"
"class:`OutputChecker`.  This comparison may be customized with a number of "
"option flags; see section :ref:`doctest-options` for more information.  If "
"the option flags are insufficient, then the comparison may also be "
"customized by passing a subclass of :class:`OutputChecker` to the "
"constructor."
msgstr ""
"La comparacin entre salidas esperadas y salidas reales se hace por un :"
"class:`OutputChecker`. Esta comparacin puede ser personalizada con un "
"nmero de banderas de opcin; vase la seccin :ref:`doctest-options` para "
"ms informacin. Si las banderas de opcin son insuficientes, entonces la "
"comparacin tambin puede ser personalizada al pasar una subclase de :class:"
"`OutputChecker` al constructor."

#: ../Doc/library/doctest.rst:1429
msgid ""
"The test runner's display output can be controlled in two ways. First, an "
"output function can be passed to :meth:`TestRunner.run`; this function will "
"be called with strings that should be displayed.  It defaults to ``sys."
"stdout.write``.  If capturing the output is not sufficient, then the display "
"output can be also customized by subclassing DocTestRunner, and overriding "
"the methods :meth:`report_start`, :meth:`report_success`, :meth:"
"`report_unexpected_exception`, and :meth:`report_failure`."
msgstr ""
"La salida de la pantalla del *test runner* se puede controlar de dos "
"maneras. Primero, se puede pasar una funcin de salida a :meth:`TestRunner."
"run`; esta funcin se invocar con cadenas que deben mostrarse. Su valor por "
"defecto es ``sys.stdout.write``. Si no es suficiente capturar el resultado, "
"entonces la salida de la pantalla tambin se puede personalizar al heredar "
"de DocTestRunner, y sobreescribir los mtodos :meth:`report_start`, :meth:"
"`report_success`, :meth:`report_unexpected_exception`, y :meth:"
"`report_failure`."

#: ../Doc/library/doctest.rst:1437
msgid ""
"The optional keyword argument *checker* specifies the :class:`OutputChecker` "
"object (or drop-in replacement) that should be used to compare the expected "
"outputs to the actual outputs of doctest examples."
msgstr ""
"El argumento por palabra clave opcional *checker* especifica el objeto :"
"class:`OutputChecker` (o un reemplazo directo) que se debe usar para "
"comparar las salidas esperadas con las salidas reales de los ejemplos de "
"doctest."

#: ../Doc/library/doctest.rst:1441
msgid ""
"The optional keyword argument *verbose* controls the :class:"
"`DocTestRunner`'s verbosity.  If *verbose* is ``True``, then information is "
"printed about each example, as it is run.  If *verbose* is ``False``, then "
"only failures are printed.  If *verbose* is unspecified, or ``None``, then "
"verbose output is used iff the command-line switch ``-v`` is used."
msgstr ""
"El argumento por palabra clave opcional *verbose* controla la verbosidad de :"
"class:`DocTestRunner`. Si *verbose* es ``True``, entonces la informacin de "
"cada ejemplo se imprime , mientras se ejecuta. Si *verbose* es ``False``, "
"entonces slo las fallas se imprimen. Si *verbose* no se especifica, o es "
"``None``, entonces la salida verbosa se usa si y slo se usa el modificador "
"de la lnea de comandos ``-v``."

#: ../Doc/library/doctest.rst:1447
msgid ""
"The optional keyword argument *optionflags* can be used to control how the "
"test runner compares expected output to actual output, and how it displays "
"failures. For more information, see section :ref:`doctest-options`."
msgstr ""
"El argumento por palabra clave opcional *optionflags* se puede usar para "
"controlar cmo el *test runner* compara la salida esperada con una salida "
"real, y cmo muestra las fallas. Para ms informacin, vase la seccin :ref:"
"`doctest-options`."

#: ../Doc/library/doctest.rst:1457
msgid ""
"Report that the test runner is about to process the given example. This "
"method is provided to allow subclasses of :class:`DocTestRunner` to "
"customize their output; it should not be called directly."
msgstr ""
"Notifica que el *test runner* est a punto de procesar el ejemplo dado. Este "
"mtodo es proporcionado para permitir que clases heredadas de :class:"
"`DocTestRunner` personalicen su salida; no debe ser invocado directamente."

#: ../Doc/library/doctest.rst:1461
msgid ""
"*example* is the example about to be processed.  *test* is the test "
"*containing example*.  *out* is the output function that was passed to :meth:"
"`DocTestRunner.run`."
msgstr ""
"*example* es el ejemplo a punto de ser procesado. *test* es la prueba que "
"contiene a *example*. *out* es la funcin de salida que se pas a :meth:"
"`DocTestRunner.run`."

#: ../Doc/library/doctest.rst:1468
msgid ""
"Report that the given example ran successfully.  This method is provided to "
"allow subclasses of :class:`DocTestRunner` to customize their output; it "
"should not be called directly."
msgstr ""
"Notifica que el ejemplo dado se ejecut correctamente. Este mtodo es "
"proporcionado para permitir que las clases heredadas de :class:"
"`DocTestRunner` personalicen su salida; no debe ser invocado directamente."

#: ../Doc/library/doctest.rst:1472 ../Doc/library/doctest.rst:1483
msgid ""
"*example* is the example about to be processed.  *got* is the actual output "
"from the example.  *test* is the test containing *example*.  *out* is the "
"output function that was passed to :meth:`DocTestRunner.run`."
msgstr ""
"*example* es el ejemplo a punto de ser procesado. *got* es la salida real "
"del ejemplo. *test* es la prueba conteniendo *example*. *out* es la funcin "
"de salida que se pasa a :meth:`DocTestRunner.run`."

#: ../Doc/library/doctest.rst:1479
msgid ""
"Report that the given example failed.  This method is provided to allow "
"subclasses of :class:`DocTestRunner` to customize their output; it should "
"not be called directly."
msgstr ""
"Notifica que el ejemplo dado fall. Este mtodo es proporcionado para "
"permitir que clases heredadas de :class:`DocTestRunner` personalicen su "
"salida; no debe ser invocado directamente."

#: ../Doc/library/doctest.rst:1490
msgid ""
"Report that the given example raised an unexpected exception. This method is "
"provided to allow subclasses of :class:`DocTestRunner` to customize their "
"output; it should not be called directly."
msgstr ""
"Notifica que el ejemplo dado lanz una excepcin inesperada. Este mtodo es "
"proporcionado para permitir que las clases heredadas de :class:"
"`DocTestRunner` personalicen su salida; no debe ser invocado directamente."

#: ../Doc/library/doctest.rst:1494
msgid ""
"*example* is the example about to be processed. *exc_info* is a tuple "
"containing information about the unexpected exception (as returned by :func:"
"`sys.exc_info`). *test* is the test containing *example*.  *out* is the "
"output function that was passed to :meth:`DocTestRunner.run`."
msgstr ""
"*example* es el ejemplo a punto de ser procesado, *exc_info* es una tupla "
"que contiene informacin sobre la excepcin inesperada (como se retorna por :"
"func:`sys.exc_info`). *test* es la prueba conteniendo *example*. *out* es la "
"funcin de salida que debe ser pasada a :meth:`DocTestRunner.run`."

#: ../Doc/library/doctest.rst:1502
msgid ""
"Run the examples in *test* (a :class:`DocTest` object), and display the "
"results using the writer function *out*."
msgstr ""
"Ejecuta los ejemplos en *test* (un objeto :class:`DocTest`), y muestra los "
"resultados usando funcin de escritura *out*."

#: ../Doc/library/doctest.rst:1505
msgid ""
"The examples are run in the namespace ``test.globs``.  If *clear_globs* is "
"true (the default), then this namespace will be cleared after the test runs, "
"to help with garbage collection. If you would like to examine the namespace "
"after the test completes, then use *clear_globs=False*."
msgstr ""
"Los ejemplo se ejecutan en el espacio de nombres ``test.globs``. Si "
"*clear_globs* es verdadero (el valor por defecto), entonces este espacio de "
"nombres ser limpiado despus de la prueba se ejecute, para ayudar con la "
"coleccin de basura. Si quisieras examinar el espacio de nombres despus de "
"que la prueba se complete, entonces use *clear_globs=False*."

#: ../Doc/library/doctest.rst:1510
msgid ""
"*compileflags* gives the set of flags that should be used by the Python "
"compiler when running the examples.  If not specified, then it will default "
"to the set of future-import flags that apply to *globs*."
msgstr ""
"*compileflags* da el conjunto de banderas que se deben usar por el "
"compilador de Python cuando se ejecutan los ejemplos. Si no se especifica, "
"entonces su valor por defecto ser el conjunto de banderas de *future-"
"import* que aplican a *globs*."

#: ../Doc/library/doctest.rst:1514
msgid ""
"The output of each example is checked using the :class:`DocTestRunner`'s "
"output checker, and the results are formatted by the :meth:`DocTestRunner."
"report_\\*` methods."
msgstr ""
"La salida de cada ejemplo es revisada usando el *output checker* del :class:"
"`DocTestRunner`, y los resultados se formatean por los mtodos de :meth:"
"`DocTestRunner.report_\\*`."

#: ../Doc/library/doctest.rst:1521
msgid ""
"Print a summary of all the test cases that have been run by this "
"DocTestRunner, and return a :term:`named tuple` ``TestResults(failed, "
"attempted)``."
msgstr ""
"Imprime un resumen de todos los casos de prueba que han sido ejecutados por "
"este *DocTestRunner*, y retorna un :term:`named tuple` ``TestResults(failed, "
"attempted)``."

#: ../Doc/library/doctest.rst:1524
msgid ""
"The optional *verbose* argument controls how detailed the summary is.  If "
"the verbosity is not specified, then the :class:`DocTestRunner`'s verbosity "
"is used."
msgstr ""
"El argumento opcional *verbose* controla qu tan detallado es el resumen. Si "
"no se especifica la verbosidad, entonces se usa la verbosidad de :class:"
"`DocTestRunner`."

#: ../Doc/library/doctest.rst:1531
msgid "OutputChecker objects"
msgstr "Objetos *OutputChecker*"

#: ../Doc/library/doctest.rst:1536
msgid ""
"A class used to check the whether the actual output from a doctest example "
"matches the expected output.  :class:`OutputChecker` defines two methods: :"
"meth:`check_output`, which compares a given pair of outputs, and returns "
"``True`` if they match; and :meth:`output_difference`, which returns a "
"string describing the differences between two outputs."
msgstr ""
"Una clase que se usa para verificar si la salida real de un ejemplo de "
"doctest coincide con la salida esperada. :class:`OutputChecker` define dos "
"mtodos: :meth:`check_output`, que compara un par de salidas dadas, y "
"retorna ``True`` si coinciden; y :meth:`output_difference`, que retorna una "
"cadena que describe las diferencias entre las dos salidas."

#: ../Doc/library/doctest.rst:1543
msgid ":class:`OutputChecker` defines the following methods:"
msgstr ":class:`OutputChecker` define los siguientes mtodos:"

#: ../Doc/library/doctest.rst:1547
msgid ""
"Return ``True`` iff the actual output from an example (*got*) matches the "
"expected output (*want*).  These strings are always considered to match if "
"they are identical; but depending on what option flags the test runner is "
"using, several non-exact match types are also possible.  See section :ref:"
"`doctest-options` for more information about option flags."
msgstr ""
"Retorna ``True`` si y slo si la salida real de un ejemplo (*got*) coincide "
"con la salida esperada (*want*). Siempre se considera que estas cadenas "
"coinciden si son idnticas; pero dependiendo de qu banderas de opcin el "
"*test runner* est usando, varias coincidencias inexactas son posibles. "
"Vase la seccin :ref:`doctest-options` para ms informacin sobre las "
"banderas de opcin."

#: ../Doc/library/doctest.rst:1556
msgid ""
"Return a string describing the differences between the expected output for a "
"given example (*example*) and the actual output (*got*).  *optionflags* is "
"the set of option flags used to compare *want* and *got*."
msgstr ""
"Retorna una cadena que describe las diferencias entre la salida esperada "
"para un ejemplo dado (*example*) y la salida real (*got*). *optionflags* es "
"el conjunto de banderas de opcin usado para comparar *want* y *got*."

#: ../Doc/library/doctest.rst:1564
msgid "Debugging"
msgstr "Depuracin"

#: ../Doc/library/doctest.rst:1566
msgid "Doctest provides several mechanisms for debugging doctest examples:"
msgstr ""
"Doctest proporciona varios mecanismos para depurar los ejemplos de doctest:"

#: ../Doc/library/doctest.rst:1568
msgid ""
"Several functions convert doctests to executable Python programs, which can "
"be run under the Python debugger, :mod:`pdb`."
msgstr ""
"Varias funciones convierten los doctest en programas de Python ejecutables, "
"que pueden ser ejecutadas bajo el depurador de Python, :mod:`pdb`."

#: ../Doc/library/doctest.rst:1571
msgid ""
"The :class:`DebugRunner` class is a subclass of :class:`DocTestRunner` that "
"raises an exception for the first failing example, containing information "
"about that example. This information can be used to perform post-mortem "
"debugging on the example."
msgstr ""
"La clase :class:`DebugRunner` es una subclase de :class:`DocTestRunner` que "
"lanza una excepcin por el primer ejemplo fallido, conteniendo informacin "
"sobre ese ejemplo. Esta informacin se puede usar para realizar depuracin a "
"posteriori en el ejemplo."

#: ../Doc/library/doctest.rst:1576
msgid ""
"The :mod:`unittest` cases generated by :func:`DocTestSuite` support the :"
"meth:`debug` method defined by :class:`unittest.TestCase`."
msgstr ""
"Los casos de :mod:`unittest` generados por :func:`DocTestSuite` admiten el "
"mtodo :meth:`debug` definido por :class:`unittest.TestCase`."

#: ../Doc/library/doctest.rst:1579
msgid ""
"You can add a call to :func:`pdb.set_trace` in a doctest example, and you'll "
"drop into the Python debugger when that line is executed.  Then you can "
"inspect current values of variables, and so on.  For example, suppose :file:"
"`a.py` contains just this module docstring::"
msgstr ""
"Puedes aadir una llamada a :func:`pdb.set_trace` en un ejemplo de doctest, "
"y bajars al depurador de Python cuando esa lnea sea ejecutada. Entonces "
"puedes inspeccionar los valores de las variables, y dems. Por ejemplo, "
"supongamos que :file:`a.py` contiene slo este docstring de mdulo::"

#: ../Doc/library/doctest.rst:1594
msgid "Then an interactive Python session may look like this::"
msgstr "Entonces una sesin interactiva puede lucir como esta::"

#: ../Doc/library/doctest.rst:1627
msgid ""
"Functions that convert doctests to Python code, and possibly run the "
"synthesized code under the debugger:"
msgstr ""
"Funciones que convierten los doctest a cdigo de Python, y posiblemente "
"ejecuten el cdigo sintetizado debajo del depurador:"

#: ../Doc/library/doctest.rst:1633
msgid "Convert text with examples to a script."
msgstr "Convierte texto con ejemplos a un script."

#: ../Doc/library/doctest.rst:1635
msgid ""
"Argument *s* is a string containing doctest examples.  The string is "
"converted to a Python script, where doctest examples in *s* are converted to "
"regular code, and everything else is converted to Python comments.  The "
"generated script is returned as a string. For example, ::"
msgstr ""
"El argumento *s* es una cadena que contiene los ejemplos de doctest. La "
"cadena se convierte a un script de Python, donde los ejemplos de doctest en "
"*s* se convierten en cdigo regular, y todo lo dems se convierte en "
"comentarios de Python. El script generado se retorna como una cadena, Por "
"ejemplo, ::"

#: ../Doc/library/doctest.rst:1650
msgid "displays::"
msgstr "muestra::"

#: ../Doc/library/doctest.rst:1660
msgid ""
"This function is used internally by other functions (see below), but can "
"also be useful when you want to transform an interactive Python session into "
"a Python script."
msgstr ""
"Esta funcin se usa internamente por otras funciones (vase ms abajo), pero "
"tambin pueden ser tiles cuando quieres transformar una sesin de Python "
"interactiva en un script de Python."

#: ../Doc/library/doctest.rst:1667
msgid "Convert the doctest for an object to a script."
msgstr "Convierte el doctest para un objeto en un script."

#: ../Doc/library/doctest.rst:1669
msgid ""
"Argument *module* is a module object, or dotted name of a module, containing "
"the object whose doctests are of interest.  Argument *name* is the name "
"(within the module) of the object with the doctests of interest.  The result "
"is a string, containing the object's docstring converted to a Python script, "
"as described for :func:`script_from_examples` above.  For example, if "
"module :file:`a.py` contains a top-level function :func:`f`, then ::"
msgstr ""
"El argumento *module* es un objeto mdulo, o un nombre por puntos de un "
"mdulo, que contiene el objeto cuyos doctest son de inters. El argumento "
"*name* es el nombre (dentro del mdulo) del objeto con los doctest de "
"inters. El resultado es una cadena de caracteres, que contiene el docstring "
"del objeto convertido en un script de Python, como se describe por :func:"
"`script_from_examples` arriba. Por ejemplo, si el mdulo :file:`a.py` "
"contiene un funcin de alto nivel :func:`f`, entonces ::"

#: ../Doc/library/doctest.rst:1679
msgid ""
"prints a script version of function :func:`f`'s docstring, with doctests "
"converted to code, and the rest placed in comments."
msgstr ""
"imprime una versin de script del docstring de la funcin :func:`f`, con los "
"doctest convertidos en cdigo, y el resto puesto en comentarios."

#: ../Doc/library/doctest.rst:1685
msgid "Debug the doctests for an object."
msgstr "Depura los doctest para un objeto."

#: ../Doc/library/doctest.rst:1687
msgid ""
"The *module* and *name* arguments are the same as for function :func:"
"`testsource` above.  The synthesized Python script for the named object's "
"docstring is written to a temporary file, and then that file is run under "
"the control of the Python debugger, :mod:`pdb`."
msgstr ""
"Los argumentos *module* y *name* son los mismos que para la funcin :func:"
"`testsource` arriba. El script de Python sintetizado para el docstring del "
"objeto nombrado es escrito en un archivo temporal, y entonces ese archivo es "
"ejecutado bajo el control del depurador de PYthon, :mod:`pdb`."

#: ../Doc/library/doctest.rst:1692
msgid ""
"A shallow copy of ``module.__dict__`` is used for both local and global "
"execution context."
msgstr ""
"Se usa una copia superficial de ``module.__dict__`` para el contexto de "
"ejecucin local y global."

#: ../Doc/library/doctest.rst:1695
msgid ""
"Optional argument *pm* controls whether post-mortem debugging is used.  If "
"*pm* has a true value, the script file is run directly, and the debugger "
"gets involved only if the script terminates via raising an unhandled "
"exception.  If it does, then post-mortem debugging is invoked, via :func:"
"`pdb.post_mortem`, passing the traceback object from the unhandled "
"exception.  If *pm* is not specified, or is false, the script is run under "
"the debugger from the start, via passing an appropriate :func:`exec` call "
"to :func:`pdb.run`."
msgstr ""
"El argumento opcional *pm* controla si se usa la depuracin post-mortem. Si "
"*pm* tiene un valor verdadero, el archivo de script es ejecutado "
"directamente, y el depurador est involucrado slo si el script termina a "
"travs del lanzamiento de una excepcin. Si lo hace, entonces la depuracin "
"post-mortem es invocada, a travs de :func:`pdb.post_mortem`, pasando el "
"objeto de rastreo desde la excepcin sin tratar. Si no se especifica *pm*, o "
"si es falso, el script se ejecuta bajo el depurador desde el inicio, a "
"travs de una llamada de :func:`exec` apropiada a :func:`pdb.run`."

#: ../Doc/library/doctest.rst:1706
msgid "Debug the doctests in a string."
msgstr "Depura los doctest en una cadena de caracteres."

#: ../Doc/library/doctest.rst:1708
msgid ""
"This is like function :func:`debug` above, except that a string containing "
"doctest examples is specified directly, via the *src* argument."
msgstr ""
"Es como la funcin function :func:`debug` arriba, excepto que una cadena de "
"caracteres que contiene los ejemplos de doctest se especifica directamente, "
"a travs del argumento *src*."

#: ../Doc/library/doctest.rst:1711
msgid ""
"Optional argument *pm* has the same meaning as in function :func:`debug` "
"above."
msgstr ""
"El argumento opcional *pm* tiene el mismo significado como en la funcin :"
"func:`debug` arriba."

#: ../Doc/library/doctest.rst:1713
msgid ""
"Optional argument *globs* gives a dictionary to use as both local and global "
"execution context.  If not specified, or ``None``, an empty dictionary is "
"used. If specified, a shallow copy of the dictionary is used."
msgstr ""
"El argumento opcional *globs* proporciona un diccionario a usar como "
"contexto de ejecucin local y global. Si no se especifica, o es ``None``, se "
"usa un diccionario vaco. Si se especifica, se usa una copia superficial del "
"diccionario."

#: ../Doc/library/doctest.rst:1718
msgid ""
"The :class:`DebugRunner` class, and the special exceptions it may raise, are "
"of most interest to testing framework authors, and will only be sketched "
"here.  See the source code, and especially :class:`DebugRunner`'s docstring "
"(which is a doctest!) for more details:"
msgstr ""
"La clase :class:`DebugRunner`, y las excepciones especiales que puede "
"lanzar, son de ms inters a los autores de frameworks de pruebas, y slo "
"sern descritos brevemente aqu. Vase el cdigo fuente, y especialmente el "
"docstring de :class:`DebugRunner` (que es un doctest!) para ms detalles:"

#: ../Doc/library/doctest.rst:1726
msgid ""
"A subclass of :class:`DocTestRunner` that raises an exception as soon as a "
"failure is encountered.  If an unexpected exception occurs, an :exc:"
"`UnexpectedException` exception is raised, containing the test, the example, "
"and the original exception.  If the output doesn't match, then a :exc:"
"`DocTestFailure` exception is raised, containing the test, the example, and "
"the actual output."
msgstr ""
"Una subclase de :class:`DocTestRunner` que lanza una excepcin tan pronto "
"como se encuentra una falla. Si ocurre una excepcin inesperada, se lanza "
"una excepcin :exc:`UnexpectedException`, conteniendo la prueba, el ejemplo, "
"y la excepcin original. Si la salida no coincide, entonces se lanza una "
"excepcin :exc:`DocTestFailure`, conteniendo la prueba, el ejemplo, y la "
"salida real."

#: ../Doc/library/doctest.rst:1733
msgid ""
"For information about the constructor parameters and methods, see the "
"documentation for :class:`DocTestRunner` in section :ref:`doctest-advanced-"
"api`."
msgstr ""
"Para informacin sobre los parmetros de construccin y los mtodos, vase "
"la documentacin para :class:`DocTestRunner` en la seccin :ref:`doctest-"
"advanced-api`."

#: ../Doc/library/doctest.rst:1736
msgid ""
"There are two exceptions that may be raised by :class:`DebugRunner` "
"instances:"
msgstr ""
"Hay dos excepciones que se pueden lanzar por instancias de :class:"
"`DebugRunner`:"

#: ../Doc/library/doctest.rst:1741
msgid ""
"An exception raised by :class:`DocTestRunner` to signal that a doctest "
"example's actual output did not match its expected output. The constructor "
"arguments are used to initialize the attributes of the same names."
msgstr ""
"Una excepcin lanzada por :class:`DocTestRunner` para sealar que la salida "
"real del ejemplo de un doctest no coincidi con su salida esperada. Los "
"argumentos del constructor se usan para inicializar los atributos del mismo "
"nombre."

#: ../Doc/library/doctest.rst:1745
msgid ":exc:`DocTestFailure` defines the following attributes:"
msgstr ":exc:`DocTestFailure` define los siguientes atributos:"

#: ../Doc/library/doctest.rst:1750 ../Doc/library/doctest.rst:1774
msgid "The :class:`DocTest` object that was being run when the example failed."
msgstr ""
"El objeto :class:`DocTest` que estaba siendo ejecutado cuando el ejemplo "
"fall."

#: ../Doc/library/doctest.rst:1755 ../Doc/library/doctest.rst:1779
msgid "The :class:`Example` that failed."
msgstr "El objeto :class:`Example` que fall."

#: ../Doc/library/doctest.rst:1760
msgid "The example's actual output."
msgstr "La salida real del ejemplo."

#: ../Doc/library/doctest.rst:1765
msgid ""
"An exception raised by :class:`DocTestRunner` to signal that a doctest "
"example raised an unexpected exception.  The constructor arguments are used "
"to initialize the attributes of the same names."
msgstr ""
"Una excepcin lanzada por :class:`DocTestRunner` para sealar que un ejemplo "
"de doctest lanz una excepcin inesperada. Los argumentos del constructor se "
"usan para inicializar los atributos del mismo nombre."

#: ../Doc/library/doctest.rst:1769
msgid ":exc:`UnexpectedException` defines the following attributes:"
msgstr ":exc:`UnexpectedException` define los siguientes atributos:"

#: ../Doc/library/doctest.rst:1784
msgid ""
"A tuple containing information about the unexpected exception, as returned "
"by :func:`sys.exc_info`."
msgstr ""
"Una tupla que contiene informacin sobre la excepcin inesperada, como es "
"retornado por :func:`sys.exc_info`."

#: ../Doc/library/doctest.rst:1791
msgid "Soapbox"
msgstr "Plataforma improvisada"

#: ../Doc/library/doctest.rst:1793
msgid ""
"As mentioned in the introduction, :mod:`doctest` has grown to have three "
"primary uses:"
msgstr ""
"Como se menciona en la introduccin, :mod:`doctest` ha crecido para tener "
"tres usos primarios:"

#: ../Doc/library/doctest.rst:1796
msgid "Checking examples in docstrings."
msgstr "Verificar los ejemplos en los docstring."

#: ../Doc/library/doctest.rst:1798
msgid "Regression testing."
msgstr "Pruebas de regresin."

#: ../Doc/library/doctest.rst:1800
msgid "Executable documentation / literate testing."
msgstr "Documentacin ejecutable / pruebas literarias."

#: ../Doc/library/doctest.rst:1802
msgid ""
"These uses have different requirements, and it is important to distinguish "
"them. In particular, filling your docstrings with obscure test cases makes "
"for bad documentation."
msgstr ""
"Estos usos tienen diferentes requerimientos, y es importante distinguirlos. "
"En particular, llenar tus docstring con casos de prueba desconocidos conduce "
"a mala documentacin."

#: ../Doc/library/doctest.rst:1806
msgid ""
"When writing a docstring, choose docstring examples with care. There's an "
"art to this that needs to be learned---it may not be natural at first.  "
"Examples should add genuine value to the documentation.  A good example can "
"often be worth many words. If done with care, the examples will be "
"invaluable for your users, and will pay back the time it takes to collect "
"them many times over as the years go by and things change.  I'm still amazed "
"at how often one of my :mod:`doctest` examples stops working after a "
"\"harmless\" change."
msgstr ""
"Cuando se escribe un docstring, escoja ejemplos de docstring con cuidado. "
"Hay un arte para eso que se debe aprender -- puede no ser natural al "
"comienzo. Los ejemplos deben aadir valor genuino a la documentacin. Un "
"buen ejemplo a menudo puede valer muchas palabras. Si se hace con cuidado, "
"los ejemplos sern invaluables para tus usuarios, y compensarn el tiempo "
"que toma recolectarlos varias veces mientras los aos pasan y las cosas "
"cambian. Todava estoy sorprendido de qu tan frecuente uno de mis ejemplos "
"de :mod:`doctest` paran de funcionar despus de un cambio \"inofensivo\"."

#: ../Doc/library/doctest.rst:1814
msgid ""
"Doctest also makes an excellent tool for regression testing, especially if "
"you don't skimp on explanatory text.  By interleaving prose and examples, it "
"becomes much easier to keep track of what's actually being tested, and why.  "
"When a test fails, good prose can make it much easier to figure out what the "
"problem is, and how it should be fixed.  It's true that you could write "
"extensive comments in code-based testing, but few programmers do. Many have "
"found that using doctest approaches instead leads to much clearer tests.  "
"Perhaps this is simply because doctest makes writing prose a little easier "
"than writing code, while writing comments in code is a little harder.  I "
"think it goes deeper than just that: the natural attitude when writing a "
"doctest-based test is that you want to explain the fine points of your "
"software, and illustrate them with examples. This in turn naturally leads to "
"test files that start with the simplest features, and logically progress to "
"complications and edge cases.  A coherent narrative is the result, instead "
"of a collection of isolated functions that test isolated bits of "
"functionality seemingly at random.  It's a different attitude, and produces "
"different results, blurring the distinction between testing and explaining."
msgstr ""
"Doctest tambin es una excelente herramienta para pruebas de regresin, "
"especialmente si no escatimas en texto explicativo. Al intercalar prosa y "
"ejemplos, se hace mucho ms fcil mantener el seguimiento de lo que "
"realmente se est probando, y por qu. Cuando una prueba falla, buena prosa "
"puede hacer mucho ms fcil comprender cul es el problema, y cmo debe ser "
"arreglado. Es verdad que puedes escribir comentarios extensos en pruebas "
"basadas en cdigo, pero pocos programadores lo hacen. Quizs es porque "
"simplemente doctest hace escribir pruebas mucho ms fcil que escribir "
"cdigo, mientras que escribir comentarios en cdigo es mucho ms difcil. "
"Pienso que va ms all de eso: la actitud natural cuando se escribe una "
"prueba basada en doctest es que quieres explicar los puntos finos de tu "
"software, e ilustrarlos con ejemplos. Esto naturalmente lleva a archivos de "
"pruebas que empiezan con las caractersticas ms simples, y lgicamente "
"progresan a complicaciones y casos extremos. Una narrativa coherente es el "
"resultado, en vez de una coleccin de funciones aisladas que pruebas trozos "
"aislados de funcionalidad aparentemente al azar. Es una actitud diferente, y "
"produce resultados diferentes, difuminando la distincin entre probar y "
"explicar."

#: ../Doc/library/doctest.rst:1832
msgid ""
"Regression testing is best confined to dedicated objects or files.  There "
"are several options for organizing tests:"
msgstr ""
"Pruebas de regresin se limitan mejor a objetos o archivos dedicados. Hay "
"varias opciones para organizar pruebas:"

#: ../Doc/library/doctest.rst:1835
msgid ""
"Write text files containing test cases as interactive examples, and test the "
"files using :func:`testfile` or :func:`DocFileSuite`.  This is recommended, "
"although is easiest to do for new projects, designed from the start to use "
"doctest."
msgstr ""
"Escribe archivos de texto que contienen los casos de prueba como ejemplos "
"interactivos, y prueba los archivos usando :func:`testfile` o :func:"
"`DocFileSuite`. Esto es lo recomendado, aunque es ms fcil hacerlo para "
"nuevos proyectos, diseados desde el comienzo para usar doctest."

#: ../Doc/library/doctest.rst:1840
msgid ""
"Define functions named ``_regrtest_topic`` that consist of single "
"docstrings, containing test cases for the named topics.  These functions can "
"be included in the same file as the module, or separated out into a separate "
"test file."
msgstr ""
"Define funciones nombradas ``_regrtest_topic`` que consisten en docstrings "
"nicas, que contienen casos de prueba por los tpicos nombrados. Estas "
"funciones se pueden incluir en el mismo archivo que el mdulo, o separadas "
"en un archivo de prueba separado."

#: ../Doc/library/doctest.rst:1844
msgid ""
"Define a ``__test__`` dictionary mapping from regression test topics to "
"docstrings containing test cases."
msgstr ""
"Define un diccionario ``__test__`` que asigna desde temas de prueba de "
"integracin a los docstring que contienen casos de prueba."

#: ../Doc/library/doctest.rst:1847
msgid ""
"When you have placed your tests in a module, the module can itself be the "
"test runner.  When a test fails, you can arrange for your test runner to re-"
"run only the failing doctest while you debug the problem.  Here is a minimal "
"example of such a test runner::"
msgstr ""
"Cuando has puesto tus pruebas en un mdulo, el mdulo puede ser el mismo "
"*test runner*. Cuando una prueba falla, puedes hacer que tu *test runner* "
"vuelva a ejecutar slo los doctest fallidos mientras que tu depuras el "
"problema. Aqu hay un ejemplo mnimo de tal *test runner*::"

#: ../Doc/library/doctest.rst:1869
msgid "Footnotes"
msgstr "Notas al pie de pgina"

#: ../Doc/library/doctest.rst:1870
msgid ""
"Examples containing both expected output and an exception are not supported. "
"Trying to guess where one ends and the other begins is too error-prone, and "
"that also makes for a confusing test."
msgstr ""
"No se admiten los ejemplos que contienen una salida esperada y una "
"excepcin. Intentar adivinar dnde una termina y la otra empieza es muy "
"propenso a errores, y da lugar a una prueba confusa."

#: ../Doc/library/doctest.rst:318
msgid ">>>"
msgstr ">>>"

#: ../Doc/library/doctest.rst:318
msgid "interpreter prompt"
msgstr "interpreter prompt"

#: ../Doc/library/doctest.rst:318 ../Doc/library/doctest.rst:556
msgid "..."
msgstr "..."

#: ../Doc/library/doctest.rst:484
msgid "^ (caret)"
msgstr "^ (caret)"

#: ../Doc/library/doctest.rst:484
msgid "marker"
msgstr "marker"

#: ../Doc/library/doctest.rst:536
msgid ""
msgstr ""

#: ../Doc/library/doctest.rst:556 ../Doc/library/doctest.rst:686
msgid "in doctests"
msgstr "in doctests"

#: ../Doc/library/doctest.rst:686
msgid "# (hash)"
msgstr "# (hash)"

#: ../Doc/library/doctest.rst:686
msgid "+ (plus)"
msgstr "+ (plus)"

#: ../Doc/library/doctest.rst:686
msgid "- (minus)"
msgstr "- (minus)"