a little bit more advanced thanks to pair programming

clacri · clacri · commit 799127eca6e7 · 2020-06-06T19:44:28.000+02:00
diff --git a/dict b/dict
@@ -1,3 +1,6 @@
+superclase
+classmethods
+super
 separándolos
 obtenedor
 asignador
diff --git a/library/functions.po b/library/functions.po
@@ -11,7 +11,7 @@ msgstr ""
 "Project-Id-Version: Python 3.8\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2020-05-07 14:37+0200\n"
-"PO-Revision-Date: 2020-05-30 20:01+0200\n"
+"PO-Revision-Date: 2020-06-06 19:43+0200\n"
 "Last-Translator: \n"
 "Language: es\n"
 "Language-Team: python-doc-esMIME-Version: 1.0\n"
@@ -3001,13 +3001,20 @@ msgstr ""
 "`super`. El atributo es dinámico y puede cambiar en cuanto la jerarquía de "
 "herencia se actualiza."
 
+# No estoy segura si aqui pudiera haber un error en la documentación oficial y se refiere a métodos de clase, o si se refiere al decorador classmethod, que creo que es el caso
 #: ../Doc/library/functions.rst:1611
+#, fuzzy
 msgid ""
 "If the second argument is omitted, the super object returned is unbound.  If "
 "the second argument is an object, ``isinstance(obj, type)`` must be true.  "
 "If the second argument is a type, ``issubclass(type2, type)`` must be true "
 "(this is useful for classmethods)."
 msgstr ""
+"Si se omite el segundo argumento, el objeto super retornado no está "
+"vinculado.  Si el segundo argumento es un objeto, entonces ``isinstance(obj, "
+"type)`` debe ser verdadero.  Si el segundo argumento es un tipo, entonces "
+"``issubclass(type2, type)`` debe ser verdadero (esto es útil para "
+"classmethods)."
 
 #: ../Doc/library/functions.rst:1616
 msgid ""
@@ -3016,6 +3023,11 @@ msgid ""
 "naming them explicitly, thus making the code more maintainable.  This use "
 "closely parallels the use of *super* in other programming languages."
 msgstr ""
+"Hay dos casos de uso típicos para *super*.  En una jerarquía de clases con "
+"herencia única, *super* puede ser utilizado para referirse a las clases "
+"progenitoras sin llamarlas explícitamente, haciendo el código más sencillo "
+"de mantener. Este uso es muy similar al de *super* en otros lenguajes de "
+"programación."
 
 #: ../Doc/library/functions.rst:1621
 msgid ""
@@ -3029,17 +3041,30 @@ msgid ""
 "the class hierarchy, and because that order can include sibling classes that "
 "are unknown prior to runtime)."
 msgstr ""
+"El segundo caso de uso es el soporte de herencia múltiple cooperativa en un "
+"entorno de ejecución dinámica.  Este caso de uso es único en Python y no se "
+"encuentra en lenguajes estáticos compilados o que solo soportan herencia "
+"única.  Esto hace posible implementar los   \"diagramas de diamantes\", "
+"donde múltiples clases base implementan el mismo método. Las buenas "
+"prácticas de diseño dictan que este método tenga la misma signatura de "
+"llamada en cada caso (porque el orden de llamadas se determina en tiempo de "
+"ejecución, porque ese orden se adapta a los cambios en la jerarquía de clase "
+"y porque ese orden puede incluir clases hermanas que son desconocidas antes "
+"de la ejecución)."
 
 #: ../Doc/library/functions.rst:1631
 msgid "For both use cases, a typical superclass call looks like this::"
-msgstr ""
+msgstr "Para ambos casos, la llamada típica de una superclase se parece a::"
 
 #: ../Doc/library/functions.rst:1638
 msgid ""
 "In addition to method lookups, :func:`super` also works for attribute "
 "lookups.  One possible use case for this is calling :term:`descriptors "
 "<descriptor>` in a parent or sibling class."
 msgstr ""
+"Además de para los métodos de búsqueda, :func:`super`  también funciona para "
+"búsquedas de atributos.  Un caso de uso posible para esto es llamar a  :term:"
+"`descriptores <descriptor>`  en una clase progenitora o hermana."
 
 #: ../Doc/library/functions.rst:1642
 msgid ""
@@ -3050,6 +3075,13 @@ msgid ""
 "inheritance. Accordingly, :func:`super` is undefined for implicit lookups "
 "using statements or operators such as ``super()[name]``."
 msgstr ""
+"Nótese que :func:`super` se implementa como parte del proceso vinculante "
+"para búsquedas de atributos explícitos punteados tales como ``super()."
+"__getitem__(name)``. Lo hace implementando su propio método :meth:"
+"`__getattribute__`  para buscar clases en un orden predecible que soporte "
+"herencia múltiple cooperativa. De la misma manera, :func:`super`  no está "
+"definida para búsquedas implícitas usando declaraciones o operadores como  "
+"``super()[name]``."
 
 #: ../Doc/library/functions.rst:1649
 msgid ""
@@ -3060,32 +3092,50 @@ msgid ""
 "necessary details to correctly retrieve the class being defined, as well as "
 "accessing the current instance for ordinary methods."
 msgstr ""
+"Nótese también, que aparte de en su forma sin argumentos,  :func:`super`  no "
+"está limitada a su uso dentro de métodos.  La forma con dos argumentos "
+"especifica de forma exacta los argumentos y hace las referencias "
+"apropiadas.  La forma sin argumentos solo funciona dentro de una definición "
+"de clase, ya que el compilador completa los detalles necesarios para obtener "
+"correctamente la clase que está siendo definida, así como accediendo a la "
+"instancia actual para métodos ordinarios."
 
 #: ../Doc/library/functions.rst:1656
 msgid ""
 "For practical suggestions on how to design cooperative classes using :func:"
 "`super`, see `guide to using super() <https://rhettinger.wordpress."
 "com/2011/05/26/super-considered-super/>`_."
 msgstr ""
+"Para sugerencias prácticas sobre como diseñas clases cooperativas usando  :"
+"func:`super`, véase `guía de uso de super() <https://rhettinger.wordpress."
+"com/2011/05/26/super-considered-super/>`_."
 
 #: ../Doc/library/functions.rst:1665
 msgid ""
 "Rather than being a function, :class:`tuple` is actually an immutable "
 "sequence type, as documented in :ref:`typesseq-tuple` and :ref:`typesseq`."
 msgstr ""
+"Más que una función, :class:`tuple`  es en realidad un tipo de secuencia "
+"inmutable, tal y como está documentado en :ref:`typesseq-tuple` y  :ref:"
+"`typesseq`."
 
 #: ../Doc/library/functions.rst:1674
 msgid ""
 "With one argument, return the type of an *object*.  The return value is a "
 "type object and generally the same object as returned by :attr:`object."
 "__class__ <instance.__class__>`."
 msgstr ""
+"Con un argumento, devuelve el tipo de un *object*. El valor de retorno es un "
+"objeto tipo y generalmente el mismo objeto que el retornado por :attr:"
+"`object.__class__ <instance.__class__>`."
 
 #: ../Doc/library/functions.rst:1678
 msgid ""
 "The :func:`isinstance` built-in function is recommended for testing the type "
 "of an object, because it takes subclasses into account."
 msgstr ""
+"La función integrada  :func:`isinstance` es la recomendada para testear el "
+"tipo de un objeto, ya que tiene en cuenta las subclases."
 
 #: ../Doc/library/functions.rst:1682
 msgid ""
@@ -3098,22 +3148,35 @@ msgid ""
 "the :attr:`~object.__dict__` attribute.  For example, the following two "
 "statements create identical :class:`type` objects:"
 msgstr ""
+"Con tres argumentos, devuelve un nuevo objeto tipo. Ésta es esencialmente "
+"una forma dinámica de la declaración :keyword:`class`. La cadena *name* es "
+"el nombre de la clase y se convierte en el atributo :attr:`~definition."
+"__name__` ; la tupla *bases* enumera las clases base y se convierte en el "
+"atributo :attr:`~class.__bases__`; y el diccionario *dict* es el espacio de "
+"nombres que contiene las definiciones del cuerpo de la clase y se copia a un "
+"diccionario estándar para convertirse en el atributo  :attr:`~object."
+"__dict__`. Por ejemplo, las dos siguientes declaraciones crean objetos "
+"idénticos :class:`type`:"
 
 #: ../Doc/library/functions.rst:1696
 msgid "See also :ref:`bltin-type-objects`."
-msgstr ""
+msgstr "Ver también :ref:`bltin-type-objects`."
 
 #: ../Doc/library/functions.rst:1698
 msgid ""
 "Subclasses of :class:`type` which don't override ``type.__new__`` may no "
 "longer use the one-argument form to get the type of an object."
 msgstr ""
+"Subclases de :class:`type` que no sobrecarguen ``type.__new__`` ya no pueden "
+"usar la forma con un argumento para obtener el tipo de un objeto."
 
 #: ../Doc/library/functions.rst:1704
 msgid ""
 "Return the :attr:`~object.__dict__` attribute for a module, class, instance, "
 "or any other object with a :attr:`~object.__dict__` attribute."
 msgstr ""
+"Retorna el atributo :attr:`~object.__dict__`  para un módulo, clase, "
+"instancia o cualquier otro objeto con un atributo  :attr:`~object.__dict__`."
 
 #: ../Doc/library/functions.rst:1707
 msgid ""
@@ -3122,17 +3185,25 @@ msgid ""
 "their :attr:`~object.__dict__` attributes (for example, classes use a :class:"
 "`types.MappingProxyType` to prevent direct dictionary updates)."
 msgstr ""
+"Los objetos como módulos o instancias tienen un atributo actualizable :attr:"
+"`~object.__dict__`; sin embargo, otros objetos pueden tener restricciones de "
+"escritura en sus atributos :attr:`~object.__dict__` (por ejemplo, hay clases "
+"que usan :class:`types.MappingProxyType`  para evitar actualizaciones "
+"directas del diccionario)."
 
 #: ../Doc/library/functions.rst:1712
 msgid ""
 "Without an argument, :func:`vars` acts like :func:`locals`.  Note, the "
 "locals dictionary is only useful for reads since updates to the locals "
 "dictionary are ignored."
 msgstr ""
+"Sin un argumento, :func:`vars` funciona como :func:`locals`. Ten en cuenta "
+"que el diccionario de *locals* solo es útil para lecturas ya que las "
+"actualizaciones del diccionario de *locals* son ignoradas."
 
 #: ../Doc/library/functions.rst:1719
 msgid "Make an iterator that aggregates elements from each of the iterables."
-msgstr ""
+msgstr "Produce un iterador que agrega elementos de cada uno de los iterables."
 
 #: ../Doc/library/functions.rst:1721
 msgid ""
@@ -3142,6 +3213,11 @@ msgid ""
 "argument, it returns an iterator of 1-tuples.  With no arguments, it returns "
 "an empty iterator.  Equivalent to::"
 msgstr ""
+"Retorna un iterador de tuplas, donde el *i*-ésimo elemento de la tupla "
+"contiene el  *i*-ésimo elemento de cada una de las secuencias o iterables en "
+"los argumentos. El iterador para cuando se agota el iterable de entrada más "
+"corto. Con un sólo argumento iterable, devuelve un iterador de 1 tupla. Sin "
+"argumentos, retorna un iterador vacío. Es equivalente a::"
 
 #: ../Doc/library/functions.rst:1740
 msgid ""
@@ -3151,19 +3227,31 @@ msgid ""
 "so that each output tuple has the result of ``n`` calls to the iterator. "
 "This has the effect of dividing the input into n-length chunks."
 msgstr ""
+"La evaluación de izquierda a derecha de los iterables está garantizada. Esto "
+"permite emplear una expresión idiomática para agregar una serie de datos en "
+"grupos de tamaño *n* usando  ``zip(*[iter(s)]*n)``. Esto repite el *mismo* "
+"iterador ``n`` veces de forma que cada tupla de salida tiene el resultado "
+"de  ``n`` llamadas al iterador. Esto tiene el efecto de dividir la entrada "
+"en trozos de tamaño *n*."
 
 #: ../Doc/library/functions.rst:1746
 msgid ""
 ":func:`zip` should only be used with unequal length inputs when you don't "
 "care about trailing, unmatched values from the longer iterables.  If those "
 "values are important, use :func:`itertools.zip_longest` instead."
 msgstr ""
+":func:`zip`  solo debería utilizarse con tamaños de entrada diferentes en el "
+"caso de que no te importe que haya valores sin agrupar de los iterables más "
+"largos. Si en cambio esos valores son importantes, utiliza en cambio :func:"
+"`itertools.zip_longest`."
 
 #: ../Doc/library/functions.rst:1750
 msgid ""
 ":func:`zip` in conjunction with the ``*`` operator can be used to unzip a "
 "list::"
 msgstr ""
+":func:`zip`  en conjunción con el operador  ``*``  puede usar para "
+"descomprimir (*unzip*) una lista::"
 
 #: ../Doc/library/functions.rst:1771
 msgid ""
