# 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: 2024-11-21 16:38-0300\n"

"PO-Revision-Date: 2024-02-02 00:07+0100\n"

"Last-Translator: Carlos Mena Pérez <@carlosm00>\n"

"Language: es\n"

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

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

"MIME-Version: 1.0\n"

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

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

"Generated-By: Babel 2.16.0\n"

#: ../Doc/library/doctest.rst:2

#, fuzzy

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 "**Código 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 módulo :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 módulo están al día al verificar que "

"todos los ejemplos interactivos todavía 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 regresión 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 documentación 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 "

"\"documentación ejecutable\"."

#: ../Doc/library/doctest.rst:31

msgid "Here's a complete but small example module::"

msgstr "Aquí hay un módulo de ejemplo completo pero pequeño::"

#: ../Doc/library/doctest.rst:33

msgid ""

"\"\"\"\n"

"This is the \"example\" module.\n"

"\n"

"The example module supplies one function, factorial(). For example,\n"

"\n"

">>> factorial(5)\n"

"120\n"

"\"\"\"\n"

"\n"

"def factorial(n):\n"

" \"\"\"Return the factorial of n, an exact integer >= 0.\n"

"\n"

" >>> [factorial(n) for n in range(6)]\n"

" [1, 1, 2, 6, 24, 120]\n"

" >>> factorial(30)\n"

" 265252859812191058636308480000000\n"

" >>> factorial(-1)\n"

" Traceback (most recent call last):\n"

" ...\n"

" ValueError: n must be >= 0\n"

"\n"

" Factorials of floats are OK, but the float must be an exact integer:\n"

" >>> factorial(30.1)\n"

" Traceback (most recent call last):\n"

" ...\n"

" ValueError: n must be exact integer\n"

" >>> factorial(30.0)\n"

" 265252859812191058636308480000000\n"

"\n"

" It must also not be ridiculously large:\n"

" >>> factorial(1e100)\n"

" Traceback (most recent call last):\n"

" ...\n"

" OverflowError: n too large\n"

" \"\"\"\n"

"\n"

" import math\n"

" if not n >= 0:\n"

" raise ValueError(\"n must be >= 0\")\n"

" if math.floor(n) != n:\n"

" raise ValueError(\"n must be exact integer\")\n"

" if n+1 == n: # catch a value like 1e300\n"

" raise OverflowError(\"n too large\")\n"

" result = 1\n"

" factor = 2\n"

" while factor <= n:\n"

" result *= factor\n"

" factor += 1\n"

" return result\n"

"\n"

"\n"

"if __name__ == \"__main__\":\n"

" import doctest\n"

" doctest.testmod()"

msgstr ""

#: ../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 línea de comandos, :mod:"

"`doctest` hará su magia:"

#: ../Doc/library/doctest.rst:91

msgid ""

"$ python example.py\n"

"$"

msgstr ""

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

msgid ""

"$ python example.py -v\n"

"Trying:\n"

" factorial(5)\n"

"Expecting:\n"

" 120\n"

"ok\n"

"Trying:\n"

" [factorial(n) for n in range(6)]\n"

"Expecting:\n"

" [1, 1, 2, 6, 24, 120]\n"

"ok"

msgstr ""

#: ../Doc/library/doctest.rst:114

msgid "And so on, eventually ending with:"

msgstr "Y demás, eventualmente terminando con:"

#: ../Doc/library/doctest.rst:116

msgid ""

"Trying:\n"

" factorial(1e100)\n"

"Expecting:\n"

" Traceback (most recent call last):\n"

" ...\n"

" OverflowError: n too large\n"

"ok\n"

"2 items passed all tests:\n"

" 1 test in __main__\n"

" 6 tests in __main__.factorial\n"

"7 tests in 2 items.\n"

"7 passed.\n"

"Test passed.\n"

"$"

msgstr ""

#: ../Doc/library/doctest.rst:133

#, fuzzy

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/test_doctest.py`."

msgstr ""

"¡Eso es todo lo que necesitas saber para empezar a hacer uso productivo de :"

"mod:`doctest`! Lánzate. Las siguientes secciones proporcionan detalles "

"completos. Note que hay muchos ejemplos de doctests en el conjunto de "

"pruebas estándar de Python y bibliotecas. Especialmente ejemplos útiles se "

"pueden encontrar en el archivo de pruebas estándar :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

#, fuzzy

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 más simple para empezar a usar doctest (pero no necesariamente la "

"forma que continuarás usándolo) es terminar cada módulo :mod:`M` con::"

#: ../Doc/library/doctest.rst:148

msgid ""

"if __name__ == \"__main__\":\n"

" import doctest\n"

" doctest.testmod()"

msgstr ""

#: ../Doc/library/doctest.rst:152

#, fuzzy

msgid ":mod:`!doctest` then examines docstrings in module :mod:`!M`."

msgstr ":mod:`doctest` entonces examina docstrings en el módulo :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 módulo como un script causa que los ejemplos en los docstrings "

"se ejecuten y sean verificados::"

#: ../Doc/library/doctest.rst:157

msgid "python M.py"

msgstr ""

#: ../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 línea final de salida es ``***Test Failed*** N failures.``, "

"donde *N* es el número de ejemplos que fallaron."

#: ../Doc/library/doctest.rst:164

msgid "Run it with the ``-v`` switch instead::"

msgstr "Ejecútalo con el modificador ``-v`` en su lugar::"

#: ../Doc/library/doctest.rst:166

msgid "python M.py -v"

msgstr ""

#: ../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 estándar, junto con resúmenes 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 ""

"También hay un atajo de línea de comandos para ejecutar :func:`testmod`. "

"Puedes instruir al intérprete de Python para ejecutar el módulo doctest "

"directamente de la biblioteca estándar y pasar los nombres del módulo en la "

"línea de comandos::"

#: ../Doc/library/doctest.rst:180

msgid "python -m doctest -v example.py"

msgstr ""

#: ../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 módulo independiente y ejecutará "

"a :func:`testmod`. Note que esto puede no funcionar correctamente si el "

"archivo es parte de un paquete e importa otros submódulos de ese paquete."

#: ../Doc/library/doctest.rst:186

msgid ""

"For more information on :func:`testmod`, see section :ref:`doctest-basic-"

"api`."

msgstr ""

"Para más información de :func:`testmod`, consulte la sección :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 aplicación de doctest es probar ejemplos interactivos en un "

"archivo de texto. Esto puede ser hecho con la función :func:`testfile`::"

#: ../Doc/library/doctest.rst:197

msgid ""

"import doctest\n"

"doctest.testfile(\"example.txt\")"

msgstr ""

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

msgid ""

"The ``example`` module\n"

"======================\n"

"\n"

"Using ``factorial``\n"

"-------------------\n"

"\n"

"This is an example text file in reStructuredText format. First import\n"

"``factorial`` from the ``example`` module:\n"

"\n"

" >>> from example import factorial\n"

"\n"

"Now use it:\n"

"\n"

" >>> factorial(6)\n"

" 120"

msgstr ""

#: ../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 documentación::"

#: ../Doc/library/doctest.rst:226

msgid ""

"File \"./example.txt\", line 14, in example.txt\n"

"Failed example:\n"

" factorial(6)\n"

"Expected:\n"

" 120\n"

"Got:\n"

" 720"

msgstr ""

#: ../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 módulo al "

"que se llama. Véase la sección :ref:`doctest-basic-api` para una descripción "

"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 línea 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 ""

"También hay un atajo de línea de comandos para ejecutar :func:`testfile`. "

"Puedes indicar al intérprete de Python para correr el módulo doctest "

"directamente desde la biblioteca estándar y pasar el nombre de los archivos "

"en la línea de comandos::"

#: ../Doc/library/doctest.rst:251

msgid "python -m doctest -v example.txt"

msgstr ""

#: ../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 más información en :func:`testfile`, véase la sección :ref:`doctest-"

"basic-api`."

#: ../Doc/library/doctest.rst:262

msgid "How It Works"

msgstr "Cómo 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 sección examina en detalle cómo funciona doctest: qué docstrings "

"revisa, cómo encuentra ejemplos interactivos, qué contexto de ejecución usa, "

"cómo maneja las excepciones, y cómo las banderas pueden ser usadas para "

"controlar su comportamiento. Esta es la información que necesitas saber para "

"escribir ejemplos de doctest; para información sobre ejecutar doctest en "

"estos ejemplos, véase 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 módulo, y todos los docstrings de las "

"funciones, clases, y métodos. Los objetos importados en el módulo no se "

"buscan."

#: ../Doc/library/doctest.rst:280

#, fuzzy

msgid ""

"In addition, there are cases when you want tests to be part of a module but "

"not part of the help text, which requires that the tests not be included in "

"the docstring. Doctest looks for a module-level variable called ``__test__`` "

"and uses it to locate other tests. If ``M.__test__`` exists, 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 ``M."

"__test__.K``."

msgstr ""

"Además, si ``M.__test__`` existe y \"es verdaderos\", debe ser un "

"diccionario, y cada entrada mapea un nombre (cadena de caracteres) a un "

"objeto de función, objeto de clase, o cadena de caracteres. Se buscan los "

"docstrings de los objetos de función 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:289

msgid "For example, place this block of code at the top of :file:`example.py`:"

msgstr ""

#: ../Doc/library/doctest.rst:291

msgid ""

"__test__ = {\n"

" 'numbers': \"\"\"\n"

">>> factorial(6)\n"

"720\n"

"\n"

">>> [factorial(n) for n in range(6)]\n"

"[1, 1, 2, 6, 24, 120]\n"

"\"\"\"\n"

"}"

msgstr ""

#: ../Doc/library/doctest.rst:303

msgid ""

"The value of ``example.__test__[\"numbers\"]`` will be treated as a "

"docstring and all the tests inside it will be run. It is important to note "

"that the value can be mapped to a function, class object, or module; if so, :"

"mod:`!doctest` searches them recursively for docstrings, which are then "

"scanned for tests."

msgstr ""

#: ../Doc/library/doctest.rst:309

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 métodos contenidos y clases anidadas."

#: ../Doc/library/doctest.rst:316

msgid "How are Docstring Examples Recognized?"

msgstr "¿Cómo se reconocen los ejemplos de docstring?"

#: ../Doc/library/doctest.rst:318

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 mayoría de los casos un copiar y pegar de una sesión de consola "

"interactiva funciona bien, pero doctest no está intentando hacer una "

"emulación exacta de ningún shell específico de Python."

#: ../Doc/library/doctest.rst:323

msgid ""

">>> # comments are ignored\n"

">>> x = 12\n"

">>> x\n"

"12\n"

">>> if x == 13:\n"

"... print(\"yes\")\n"

"... else:\n"

"... print(\"no\")\n"

"... print(\"NO\")\n"

"... print(\"NO!!!\")\n"

"...\n"

"no\n"

"NO\n"

"NO!!!\n"

">>>"

msgstr ""

#: ../Doc/library/doctest.rst:343

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 línea "

"``'>>>'`` o ``'...'`` conteniendo el código, y la salida esperada (si la "

"hubiera) se extiende hasta el siguiente ``'>>>'`` o la línea en blanco."

#: ../Doc/library/doctest.rst:347

msgid "The fine print:"

msgstr "La letra pequeña:"

#: ../Doc/library/doctest.rst:349

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 ``<BLANKLINE>`` in your doctest example each place a blank "

"line is expected."

msgstr ""

"La salida esperada no puede contener una línea de espacios en blanco, ya que "

"ese tipo de línea se toma para indicar el fin de la salida esperada. Si la "

"salida esperada de verdad contiene una línea en blanco, pon ``<BLANKLINE>`` "

"en tu ejemplo de doctest en cada lugar donde una línea en blanco sea "

"esperada."

#: ../Doc/library/doctest.rst:354

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 <doctest-directives>` "

"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 tabulación se expanden a espacios, usando paradas de "

"tabulación de 8 -columnas. Las tabulaciones generadas por el código en "

"pruebas no son modificadas. Ya que todas las tabulaciones en la salida de "

"prueba *son* expandidas, significa que si el código de salida incluye "

"tabulaciones, la única manera de que el doctest pueda pasar es si la opción :"

"const:`NORMALIZE_WHITESPACE` o :ref:`directive <doctest-directives>` 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 través 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:366

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 excepción son capturados a través de maneras diferentes)."

#: ../Doc/library/doctest.rst:369

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 línea poniendo una barra invertida en una sesión "

"interactiva, o por cualquier otra razón usas una barra invertida, debes usar "

"un docstring crudo, que preservará tus barras invertidas exactamente como "

"las escribes::"

#: ../Doc/library/doctest.rst:373

msgid ""

">>> def f(x):\n"

"... r'''Backslashes in a raw docstring: m\\n'''\n"

"...\n"

">>> print(f.__doc__)\n"

"Backslashes in a raw docstring: m\\n"

msgstr ""

#: ../Doc/library/doctest.rst:379

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 sería interpretado como un carácter "

"de nueva línea. Alternativamente, puedes duplicar cada barra invertida en "

"la versión de doctest (y no usar una cadena de caracteres cruda)::"

#: ../Doc/library/doctest.rst:383

msgid ""

">>> def f(x):\n"

"... '''Backslashes in a raw docstring: m\\\\n'''\n"

"...\n"

">>> print(f.__doc__)\n"

"Backslashes in a raw docstring: m\\n"

msgstr ""

#: ../Doc/library/doctest.rst:389

msgid "The starting column doesn't matter::"

msgstr "La columna inicial no importa::"

#: ../Doc/library/doctest.rst:391

msgid ""

">>> assert \"Easy!\"\n"

" >>> import math\n"

" >>> math.floor(1.9)\n"

" 1"

msgstr ""

#: ../Doc/library/doctest.rst:396

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 línea ``'>>>'`` inicial que empezó el ejemplo."

#: ../Doc/library/doctest.rst:403

msgid "What's the Execution Context?"

msgstr "¿Cuál es el contexto de ejecución?"

#: ../Doc/library/doctest.rst:405

#, fuzzy

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 módulo, y por lo que una "

"prueba en :mod:`M` no puede dejar atrás 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 más temprano "

"en los docstrings siendo ejecutados. Los ejemplos no pueden ver nombres "

"definidos en otros docstrings."

#: ../Doc/library/doctest.rst:413

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 ejecución "

"al pasar ``globs=your_dict`` a :func:`testmod` o :func:`testfile` en su "

"lugar."

#: ../Doc/library/doctest.rst:420

msgid "What About Exceptions?"

msgstr "¿Y las excepciones?"

#: ../Doc/library/doctest.rst:422

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: sólo copia el rastreo. [#]_ Ya que los rastreos contienen detalles "

"que probablemente cambien rápidamente (por ejemplo, rutas de archivos "

"exactas y números de línea), este es un caso donde doctest trabaja duro para "

"ser flexible en lo que acepta."

#: ../Doc/library/doctest.rst:428

msgid "Simple example::"

msgstr "Ejemplo simple::"

#: ../Doc/library/doctest.rst:430

msgid ""

">>> [1, 2, 3].remove(42)\n"

"Traceback (most recent call last):\n"

" File \"<stdin>\", line 1, in <module>\n"

"ValueError: list.remove(x): x not in list"

msgstr ""

#: ../Doc/library/doctest.rst:435

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:438

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 excepción debe empezar con una cabecera de "

"rastreo, que puede ser una de las siguientes dos líneas, con el mismo "

"sangrado de la primera línea del ejemplo:"

#: ../Doc/library/doctest.rst:442

msgid ""

"Traceback (most recent call last):\n"

"Traceback (innermost last):"

msgstr ""

#: ../Doc/library/doctest.rst:445

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 típicamente "

"omitida, o copiada palabra por palabra de una sesión interactiva."

#: ../Doc/library/doctest.rst:449

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 más interesante: la línea o "

"líneas conteniendo el tipo de excepción y detalle. Esto es usualmente la "

"última línea de un rastreo, pero se puede extender a través de múltiples "

"líneas si la excepción tiene un detalle de varias líneas::"

#: ../Doc/library/doctest.rst:454

msgid ""

">>> raise ValueError('multi\\n line\\ndetail')\n"

"Traceback (most recent call last):\n"

" File \"<stdin>\", line 1, in <module>\n"

"ValueError: multi\n"

" line\n"

"detail"

msgstr ""

#: ../Doc/library/doctest.rst:461

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 líneas (empezando con :exc:`ValueError`) son comparados con "

"el tipo de excepción y detalle, y el resto es ignorado."

#: ../Doc/library/doctest.rst:464

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 práctica es omitir la pila de rastreo, a menos que añada valor de "

"documentación significante al ejemplo. Por lo que el último ejemplo es "

"probablemente mejor como::"

#: ../Doc/library/doctest.rst:467

msgid ""

">>> raise ValueError('multi\\n line\\ndetail')\n"

"Traceback (most recent call last):\n"

" ...\n"

"ValueError: multi\n"

" line\n"

"detail"

msgstr ""

#: ../Doc/library/doctest.rst:474

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 opción :const:"

"`ELLIPSIS` de doctest. Se pueden excluir los puntos suspensivos en ese "

"ejemplo, así como también pueden haber tres (o trescientas) comas o dígitos, "

"o una transcripción sangrada de un *sketch* de Monty Python."

#: ../Doc/library/doctest.rst:480

msgid "Some details you should read once, but won't need to remember:"

msgstr "Algunos detalles que debes leer una vez, pero no necesitarás recordar:"

#: ../Doc/library/doctest.rst:482

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 excepción de "

"rastreo o de una impresión 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 "

"práctica, la salida ordinaria raramente comienza con una línea de cabecera "

"de rastreo, por lo que esto no crea problemas reales."

#: ../Doc/library/doctest.rst:489

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 línea de la pila de rastreo (si se presenta) debe estar más sangrada "

"que la primera línea del ejemplo, *o* empezar con un carácter no "

"alfanumérico. la primera línea que sigue a la cabecera de rastreo sangrada "

"de igual forma y empezando con un alfanumérico es considerado el inicio del "

"detalle de la excepción. Por supuesto que esto es lo correcto para rastreos "

"genuinos."

#: ../Doc/library/doctest.rst:495

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 opción :const:`IGNORE_EXCEPTION_DETAIL` de doctest. "

"todo lo que sigue a los dos puntos más a la izquierda y cualquier otra "

"información del módulo en el nombre de la excepción se ignora."

#: ../Doc/library/doctest.rst:499

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 línea de la cabecera de rastreo para algunos :"

"exc:`SyntaxError`. Pero doctest usa la línea 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, necesitarás poner manualmente la línea de cabecera de rastreo en tu "

"ejemplo de prueba."

#: ../Doc/library/doctest.rst:507

msgid ""

"For some exceptions, Python displays the position of the error using ``^`` "

"markers and tildes::"

msgstr ""

"En el caso de algunas excepciones Python señala la posición donde ocurrió el "

"error usando un marcador ``^``::"

#: ../Doc/library/doctest.rst:510

msgid ""

">>> 1 + None\n"

" File \"<stdin>\", line 1\n"

" 1 + None\n"

" ~~^~~~~~\n"

"TypeError: unsupported operand type(s) for +: 'int' and 'NoneType'"

msgstr ""

#: ../Doc/library/doctest.rst:516

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 líneas mostrando la posición del error vienen antes del tipo de "

"excepción y detalle, no son revisadas por doctest. Por ejemplo, el siguiente "

"test pasaría, a pesar de que pone el marcador ``^`` en la posición "

"equivocada::"

#: ../Doc/library/doctest.rst:520

msgid ""

">>> 1 + None\n"

" File \"<stdin>\", line 1\n"

" 1 + None\n"

" ^~~~~~~~\n"

"TypeError: unsupported operand type(s) for +: 'int' and 'NoneType'"

msgstr ""

#: ../Doc/library/doctest.rst:531

msgid "Option Flags"

msgstr "Banderas de Opción"

#: ../Doc/library/doctest.rst:533

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 <bitwise>` together and passed to various functions. The "

"names can also be used in :ref:`doctest directives <doctest-directives>`, "

"and may be passed to the doctest command line interface via the ``-o`` "

"option."

msgstr ""

"Varias banderas de opción controlan diversos aspectos del comportamiento de "

"doctest. Los nombres simbólicos para las banderas son proporcionados como "

"constantes del módulo, que se pueden conectar mediante :ref:`*OR* bit a bit "

"<bitwise>` y pasar a varias funciones. Los nombres también pueden ser "

"usados en las :ref:`directivas de doctest <doctest-directives>`, y se pueden "

"pasar a la interfaz de la línea de comandos de doctest a través de la opción "

"``-o``."

#: ../Doc/library/doctest.rst:539

msgid "The ``-o`` command line option."

msgstr "La opción de la línea de comandos ``-o``."

#: ../Doc/library/doctest.rst:542

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 semánticas de la prueba, controlando "

"aspectos de cómo doctest decide si la salida de hecho concuerda con la "

"salida esperada del ejemplo:"

#: ../Doc/library/doctest.rst:548

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