Merge branch '3.7' of https://github.com/PyCampES/python-docs-es into claudia_dev_py37

clacri · clacri · commit b379b4e732f1 · 2020-05-05T22:38:41.000+02:00
diff --git a/.overrides/CONTRIBUTING.rst b/.overrides/CONTRIBUTING.rst
@@ -9,7 +9,6 @@ Actualmente se puede colaborar utilizando una de las dos siguientes formas que:
 #. Utilizando el repositorio de GitHub y el editor poedit_
 #. Realizando traducciones directamente en Transifex
 
-
 .. note::
 
    Si tienes cualquier duda, puedes enviarnos un email a docs-es@python.org.
@@ -20,14 +19,10 @@ Desde GitHub
 
 #. Crea un fork del repositorio_.
 
-.. _repositorio: https://github.com/PyCampES/python-docs-es
-
    .. note::
 
       Puedes consular la `ayuda oficial de GitHub`_, si lo deseas.
 
-      .. _ayuda oficial de GitHub: https://help.github.com/es/github/getting-started-with-github/fork-a-repo
-
 #. Clona el repositorio::
 
     git clone git@github.com:<TU-USUARIO>/python-docs-es.git
@@ -41,7 +36,7 @@ Desde GitHub
     git remote add upstream https://github.com/pycampes/python-docs-es.git
 
 #. Crea una branch nueva en base al artículo en el que vayas a trabajar.
-  
+
     git checkout -b traduccion_glosario
 
 #. Mira que archivo necesita ser traducido. El siguiente comando te mostrará una lista de archivos y los porcentajes traducidos.
@@ -56,18 +51,15 @@ Desde GitHub
     git commit -am 'Traducido archivo {nombre de archivo}'
     git push origin traduccion_glosario
 
+#. No olvides añadir tu nombre al archivo TRANSLATORS si no lo has hecho todavía.
+   Los nombres se encuentran ordenados alfabéticamente por apellido.
+
 #. Luego ve a tu página de GitHub y propone hacer un Pull Request
 
    .. note::
 
       Puedes consultar la `ayuda oficial de GitHub para crear un Pull Request`_ si lo deseas.
 
-      .. _ayuda oficial de GitHub para crear un Pull Request: https://help.github.com/es/github/collaborating-with-issues-and-pull-requests/about-pull-requests
-
-
-.. _poedit: https://poedit.net/
-
-
 
 Previsualizar los cambios
 ~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -100,3 +92,9 @@ Utilizando Transifex
 --------------------
 
 ToDo.
+
+
+.. _repositorio: https://github.com/PyCampES/python-docs-es
+.. _ayuda oficial de GitHub: https://help.github.com/es/github/getting-started-with-github/fork-a-repo
+.. _ayuda oficial de GitHub para crear un Pull Request: https://help.github.com/es/github/collaborating-with-issues-and-pull-requests/about-pull-requests
+.. _poedit: https://poedit.net/
diff --git a/.overrides/translation-memory.rst b/.overrides/translation-memory.rst
@@ -0,0 +1,39 @@
+=======================
+ Memoria de traducción
+=======================
+
+
+Esta página contiene la Memoria de Traducción, con todos los términos que hemos ido teniendo dudas,
+y coordinamos cuál era la mejor traducción dado el contexto.
+
+Si quieres ver cómo se ha utilizado un término anteriormente, puedes utilizar la herramienta
+``find_in_po.py`` que muestra dónde se usó ese término: original y traducción lado a lado:
+
+.. code-block:: text
+
+   $ python scripts/find_in_po.py docstring
+   ╒════════════════════════════════════════════════════════════════════════════════════════════════╤═══════════════════════════════════════════════════════════════════════════════════════════════╕
+   │ The first statement of the function body can optionally be a string literal; this string       │ La primera sentencia del cuerpo de la función puede ser opcionalmente una cadena de texto     │
+   │ literal is the function's documentation string, or :dfn:`docstring`. (More about docstrings    │ literal; esta es la cadena de texto de documentación de la función, o :dfn:`docstring`.       │
+   │ can be found in the section :ref:`tut-docstrings`.) There are tools which use docstrings to    │ (Puedes encontrar más acerca de docstrings en la sección :ref:`tut-docstrings`.). Existen     │
+   │ automatically produce online or printed documentation, or to let the user interactively browse │ herramientas que usan las ``docstrings`` para producir documentación imprimible o disponible  │
+   │ through code; it's good practice to include docstrings in code that you write, so make a habit │ en línea, o para dejar que los usuarios busquen interactivamente a través del código; es una  │
+   │ of it.                                                                                         │ buena práctica incluir ``docstrings`` en el código que escribes, y hacerlo un buen hábito.    │
+   ├────────────────────────────────────────────────────────────────────────────────────────────────┼───────────────────────────────────────────────────────────────────────────────────────────────┤
+   │ Here is an example of a multi-line docstring::                                                 │ Este es un ejemplo de un ``docstring`` multi-línea::                                          │
+   ├────────────────────────────────────────────────────────────────────────────────────────────────┼───────────────────────────────────────────────────────────────────────────────────────────────┤
+   │ Use docstrings.                                                                                │ Usar ``docstrings``.                                                                          │
+   ├────────────────────────────────────────────────────────────────────────────────────────────────┼───────────────────────────────────────────────────────────────────────────────────────────────┤
+
+
+Éstos son las palabras que hemos coordinado hasta el momento:
+
+
+   loop
+      Bucle. ``tutorial/controlflow.po``
+
+   handle exception
+      Gestionar excepción. ``tutorial/inputoutput.po``
+
+   docstring
+      docstring. ``library/idle.po``
diff --git a/TRANSLATORS b/TRANSLATORS
@@ -1,2 +1,4 @@
+Raúl Cumplido (@raulcd)
 Nicolás Demarchi (@gilgamezh)
 Manuel Kaufmann (@humitos)
+Marco Richetta (@marcorichetta)
diff --git a/conf.py b/conf.py
@@ -21,8 +21,10 @@
 sys.path.append(os.path.abspath('cpython/Doc'))
 from conf import *
 
-version = '3.7'
-release = '3.7.7'
+# Call patchlevel with the proper path to get the version from
+# instead of hardcoding it
+import patchlevel
+version, release = patchlevel.get_header_version_info(os.path.abspath('cpython/Doc'))
 
 project = 'Python en Español'
 copyright = '2001-%s, Python Software Foundation' % time.strftime('%Y')
diff --git a/scripts/find_in_po.py b/scripts/find_in_po.py
@@ -0,0 +1,46 @@
+#!/usr/bin/env python3
+
+import argparse
+from glob import glob
+import os
+from textwrap import fill
+
+import regex
+import polib
+from tabulate import tabulate
+
+
+def find_in_po(pattern):
+    table = []
+    try:
+        _, columns = os.popen("stty size", "r").read().split()
+        available_width = int(columns) // 2 - 3
+    except:
+        available_width = 80 // 2 - 3
+
+    for file in glob("**/*.po"):
+        pofile = polib.pofile(file)
+        for entry in pofile:
+            if entry.msgstr and regex.search(pattern, entry.msgid):
+                table.append(
+                    [
+                        fill(entry.msgid, width=available_width),
+                        fill(entry.msgstr, width=available_width),
+                    ]
+                )
+    print(tabulate(table, tablefmt="fancy_grid"))
+
+
+def parse_args():
+    parser = argparse.ArgumentParser(description="Find translated words.")
+    parser.add_argument("pattern")
+    return parser.parse_args()
+
+
+def main():
+    args = parse_args()
+    find_in_po(args.pattern)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/tutorial/classes.po b/tutorial/classes.po
@@ -4,18 +4,21 @@
 # docs-es@python.org / https://mail.python.org/mailman3/lists/docs-es.python.org/
 # Check https://github.com/PyCampES/python-docs-es/blob/3.7/TRANSLATORS to get the list of volunteers
 #
-#, fuzzy
 msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.7\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2019-05-06 11:59-0400\n"
-"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
-"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
-"Language-Team: python-doc-es (https://mail.python.org/mailman3/lists/docs-es.python.org)\n"
+"PO-Revision-Date: 2020-05-04 13:28-0300\n"
+"Language-Team: python-doc-es (https://mail.python.org/mailman3/lists/docs-es."
+"python.org)\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"
+"Last-Translator: Marco Richetta <marcorichetta@gmail.com>\n"
+"Language: es\n"
+"X-Generator: Poedit 2.3\n"
 
 #: ../Doc/tutorial/classes.rst:5
 msgid "Classes"
@@ -97,7 +100,7 @@ msgstr ""
 "(Sin haber una terminología universalmente aceptada sobre clases, haré uso "
 "ocasional de términos de Smalltalk y C++.  Usaría términos de Modula-3, ya "
 "que su semántica orientada a objetos es más cercana a Python que C++, pero "
-"no espero que muchos lectores hayan escuchado hablar de él)."
+"no espero que muchos lectores hayan escuchado hablar de él.)"
 
 #: ../Doc/tutorial/classes.rst:43
 msgid "A Word About Names and Objects"
@@ -276,22 +279,29 @@ msgstr ""
 #: ../Doc/tutorial/classes.rst:120
 msgid "the innermost scope, which is searched first, contains the local names"
 msgstr ""
+"el alcance más interno, que es inspeccionado primero, contiene los nombres "
+"locales"
 
 #: ../Doc/tutorial/classes.rst:121
 msgid ""
 "the scopes of any enclosing functions, which are searched starting with the "
 "nearest enclosing scope, contains non-local, but also non-global names"
 msgstr ""
+"los alcances de las funciones que encierran a la función actual, que son "
+"inspeccionados a partir del alcance más cercano, contienen nombres no "
+"locales, pero también no globales"
 
 #: ../Doc/tutorial/classes.rst:123
 msgid "the next-to-last scope contains the current module's global names"
-msgstr ""
+msgstr "el penúltimo alcance contiene nombres globales del módulo actual"
 
 #: ../Doc/tutorial/classes.rst:124
 msgid ""
 "the outermost scope (searched last) is the namespace containing built-in "
 "names"
 msgstr ""
+"el alcance más externo (el último inspeccionado) es el espacio de nombres "
+"que contiene los nombres integrados"
 
 #: ../Doc/tutorial/classes.rst:126
 msgid ""
@@ -719,6 +729,15 @@ msgid ""
 "from the instance object and the argument list, and the function object is "
 "called with this new argument list."
 msgstr ""
+"Si todavía no entiendes como funcionan los métodos, una mirada a su "
+"implementación quizás pueda aclarar dudas. Cuando un atributo sin datos de "
+"una instancia es referenciado, la clase de la instancia es accedida. Si el "
+"nombre indica un atributo de clase válido que sea un objeto función, se crea "
+"un objeto método empaquetando (apunta a) la instancia y al objeto función, "
+"juntados en un objeto abstracto: este es el objeto método. Cuando el objeto "
+"método es llamado con una lista de argumentos, se crea una nueva lista de "
+"argumentos a partir del objeto instancia y la lista de argumentos. "
+"Finalmente el objeto función es llamado con esta nueva lista de argumentos."
 
 #: ../Doc/tutorial/classes.rst:403
 msgid "Class and Instance Variables"
@@ -1000,6 +1019,9 @@ msgid ""
 "will be ``True`` only if ``obj.__class__`` is :class:`int` or some class "
 "derived from :class:`int`."
 msgstr ""
+"Usar :func:`isinstance` para verificar el tipo de una instancia: "
+"``isinstance(obj, int)`` será ``True`` sólo si ``obj.__class__`` es :class:"
+"`int` o alguna clase derivada de :class:`int`."
 
 #: ../Doc/tutorial/classes.rst:614
 msgid ""
@@ -1008,6 +1030,10 @@ msgid ""
 "``issubclass(float, int)`` is ``False`` since :class:`float` is not a "
 "subclass of :class:`int`."
 msgstr ""
+"Usar :func:`issubclass` para verificar la herencia de clases: "
+"``issubclass(bool, int)`` es ``True`` ya que :class:`bool` es una subclase "
+"de :class:`int`. Sin embargo, ``issubclass(float, int)`` es ``False`` ya "
+"que :class:`float` no es una subclase de :class:`int`."
 
 #: ../Doc/tutorial/classes.rst:624
 msgid "Multiple Inheritance"
@@ -1141,6 +1167,10 @@ msgid ""
 "the ``Mapping`` class  and ``_MappingSubclass__update`` in the "
 "``MappingSubclass`` class respectively."
 msgstr ""
+"El ejemplo de arriba funcionaría incluso si ``MappingSubclass`` introdujera "
+"un identificador ``__update`` ya que se reemplaza con ``_Mapping__update`` "
+"en la clase ``Mapping``  y ``_MappingSubclass__update`` en la clase "
+"``MappingSubclass`` respectivamente."
 
 #: ../Doc/tutorial/classes.rst:714
 msgid ""
@@ -1326,14 +1356,21 @@ msgid ""
 "compact but less versatile than full generator definitions and tend to be "
 "more memory friendly than equivalent list comprehensions."
 msgstr ""
+"Algunos generadores simples pueden ser escritos de manera concisa como "
+"expresiones usando una sintaxis similar a las comprensiones de listas pero "
+"con paréntesis en lugar de corchetes. Estas expresiones están hechas para "
+"situaciones donde el generador es utilizado de inmediato por la función que "
+"lo encierra. Las expresiones generadoras son más compactas pero menos "
+"versátiles que las definiciones completas de generadores y tienden a ser más "
+"amigables con la memoria que sus comprensiones de listas equivalentes."
 
 #: ../Doc/tutorial/classes.rst:893
 msgid "Examples::"
 msgstr "Ejemplos::"
 
 #: ../Doc/tutorial/classes.rst:917
 msgid "Footnotes"
-msgstr ""
+msgstr "Notas al pie"
 
 #: ../Doc/tutorial/classes.rst:918
 msgid ""
@@ -1344,3 +1381,9 @@ msgid ""
 "abstraction of namespace implementation, and should be restricted to things "
 "like post-mortem debuggers."
 msgstr ""
+"Excepto por una cosa. Los objetos módulo tienen un atributo de sólo lectura "
+"secreto llamado :attr:`~object.__dict__` que devuelve el diccionario usado "
+"para implementar el espacio de nombres del módulo; el nombre :attr:~object."
+"__dict__` es un atributo pero no un nombre global. Obviamente, usar esto "
+"viola la abstracción de la implementación del espacio de nombres, y debería "
+"ser restringido a cosas como depuradores post-mortem."
diff --git a/tutorial/controlflow.po b/tutorial/controlflow.po
@@ -1,6 +1,6 @@
 # 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. 
+# 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/PyCampES/python-docs-es/blob/3.7/TRANSLATORS to get the list of volunteers
 #
@@ -9,15 +9,16 @@ msgstr ""
 "Project-Id-Version: Python 3.7\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2019-05-06 11:59-0400\n"
-"PO-Revision-Date: 2019-12-22 12:00+0100\n"
+"PO-Revision-Date: 2020-05-05 11:40+0200\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"
-"Last-Translator: \n"
-"Language-Team: python-doc-es (https://mail.python.org/mailman3/lists/docs-es.python.org)\n"
+"Last-Translator: Raúl Cumplido <raulcumplido@gmail.com>\n"
+"Language-Team: python-doc-es (https://mail.python.org/mailman3/lists/docs-es."
+"python.org)\n"
 "Language: es\n"
-"X-Generator: Poedit 2.2.4\n"
+"X-Generator: Poedit 2.3\n"
 
 #: ../Doc/tutorial/controlflow.rst:5
 msgid "More Control Flow Tools"
@@ -185,14 +186,14 @@ msgid ""
 "Clauses on Loops"
 msgstr ""
 "Las sentencias :keyword:`break`, :keyword:`continue`, y :keyword:`else` en "
-"lazos"
+"bucles"
 
 #: ../Doc/tutorial/controlflow.rst:160
 msgid ""
 "The :keyword:`break` statement, like in C, breaks out of the innermost "
 "enclosing :keyword:`for` or :keyword:`while` loop."
 msgstr ""
-"La sentencia :keyword:`break`, como en C, termina el lazo :keyword:`for` o :"
+"La sentencia :keyword:`break`, como en C, termina el bucle :keyword:`for` o :"
 "keyword:`while` más anidado."
 
 #: ../Doc/tutorial/controlflow.rst:163
@@ -203,11 +204,11 @@ msgid ""
 "is terminated by a :keyword:`break` statement.  This is exemplified by the "
 "following loop, which searches for prime numbers::"
 msgstr ""
-"Las sentencias de lazo pueden tener una cláusula`!else` que es ejecutada "
+"Las sentencias de bucle pueden tener una cláusula`!else` que es ejecutada "
 "cuando el lazo termina, luego de agotar la lista (con :keyword:`for`) o "
 "cuando la condición se hace falsa (con :keyword:`while`), pero no cuando el "
-"lazo es terminado con la sentencia :keyword:`break`. Se ejemplifica en el "
-"siguiente lazo, que busca números primos::"
+"bucle se termina con la sentencia :keyword:`break`. Se puede ver el ejemplo "
+"en el siguiente bucle, que busca números primos::"
 
 #: ../Doc/tutorial/controlflow.rst:187
 msgid ""
diff --git a/tutorial/inputoutput.po b/tutorial/inputoutput.po
diff --git a/tutorial/modules.po b/tutorial/modules.po
