translate first two sections from doctest

Hristo Roque · Hristo Roque · commit 2cd21337e15c · 2020-11-15T14:08:58.000-05:00
diff --git a/library/doctest.po b/library/doctest.po
@@ -6,46 +6,56 @@
 # Check https://github.com/python/python-docs-es/blob/3.8/TRANSLATORS to
 # get the list of volunteers
 #
-#, fuzzy
 msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.8\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2020-05-05 12:54+0200\n"
-"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
-"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"PO-Revision-Date: 2020-11-15 13:56-0500\n"
 "Language-Team: python-doc-es\n"
 "MIME-Version: 1.0\n"
-"Content-Type: text/plain; charset=utf-8\n"
+"Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 "Generated-By: Babel 2.8.0\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+"Last-Translator: \n"
+"Language: es\n"
+"X-Generator: Poedit 2.4.2\n"
 
 #: ../Doc/library/doctest.rst:2
 msgid ":mod:`doctest` --- Test interactive Python examples"
-msgstr ""
+msgstr ":mod:`doctest` -- Prueba ejemplos interactivos de Python"
 
 #: ../Doc/library/doctest.rst:12
 msgid "**Source code:** :source:`Lib/doctest.py`"
-msgstr ""
+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 ""
@@ -54,27 +64,36 @@ msgid ""
 "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 en 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 ""
+msgstr "Aquí hay un módulo de ejemplo completo pero pequeño::"
 
 #: ../Doc/library/doctest.rst:88
 msgid ""
 "If you run :file:`example.py` directly from the command line, :mod:`doctest` "
 "works its magic:"
 msgstr ""
+"Si tu ejecutas :file:`example.py` directamente desde la línea 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 ""
+msgstr "Y demás, eventualmente terminando con:"
 
 #: ../Doc/library/doctest.rst:133
 msgid ""
@@ -84,26 +103,36 @@ msgid ""
 "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`! Zambúllete. 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 ""
+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 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:152
 msgid ":mod:`doctest` then examines docstrings in module :mod:`M`."
-msgstr ""
+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 verifiquen::"
 
 #: ../Doc/library/doctest.rst:159
 msgid ""
@@ -112,16 +141,22 @@ msgid ""
 "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 ""
+msgstr "Ejecútalo 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 estándar, junto con resúmenes clasificados  al final."
 
 #: ../Doc/library/doctest.rst:171
 msgid ""
@@ -130,36 +165,51 @@ msgid ""
 "``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: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`, véase la sección :ref:`doctest-"
+"basic-api`."
 
 #: ../Doc/library/doctest.rst:192
 msgid "Simple Usage: Checking Examples in a Text File"
-msgstr ""
+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:200
 msgid ""
@@ -168,12 +218,19 @@ msgid ""
 "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 documentación::"
 
 #: ../Doc/library/doctest.rst:234
 msgid ""
@@ -182,6 +239,9 @@ msgid ""
 "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 ""
@@ -190,31 +250,46 @@ msgid ""
 "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 modificaor 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 instruir al intérprete de Python para correr el módulo doctest "
+"directamente de la biblioteca estandar y pasar el nombre de los archivos en "
+"la línea 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 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"
