Finalizando library/collections.abc (#1760)

cmaureir · aroquega · web-flow · commit b129428cae77 · 2021-12-30T21:14:57.000+01:00
* Finalizando library/collections.abc

* Apply suggestions from code review

Co-authored-by: Adolfo Hristo David Roque Gámez &lt;42866358+aroquega@users.noreply.github.com&gt;

* powrap

Signed-off-by: Cristián Maureira-Fredes &lt;Cristian.Maureira-Fredes@qt.io&gt;

Co-authored-by: Adolfo Hristo David Roque Gámez &lt;42866358+aroquega@users.noreply.github.com&gt;
diff --git a/library/collections.abc.po b/library/collections.abc.po
@@ -13,12 +13,12 @@ msgstr ""
 "POT-Creation-Date: 2021-10-16 21:42+0200\n"
 "PO-Revision-Date: 2021-08-07 10:29+0200\n"
 "Last-Translator: Cristián Maureira-Fredes <cmaureirafredes@gmail.com>\n"
-"Language: es_AR\n"
 "Language-Team: python-doc-es\n"
-"Plural-Forms: nplurals=2; plural=(n != 1)\n"
+"Language: es_AR\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.9.1\n"
 
 #: ../Doc/library/collections.abc.rst:2
@@ -49,6 +49,8 @@ msgid ""
 "An :func:`issubclass` or :func:`isinstance` test for an interface works in "
 "one of three ways."
 msgstr ""
+"Una prueba :func:`issubclass` o :func:`isinstance` para una interfaz "
+"funciona de tres formas."
 
 #: ../Doc/library/collections.abc.rst:30
 msgid ""
@@ -57,6 +59,10 @@ msgid ""
 "remaining mixin methods come from inheritance and can be overridden if "
 "desired.  Other methods may be added as needed:"
 msgstr ""
+"1) Una clase recién escrita puede heredar directamente de una de las clases "
+"base abstractas. La clase debe proporcionar los métodos abstractos "
+"requeridos. Los métodos mixin restantes provienen de la herencia y se pueden "
+"anular si se desea. Se pueden agregar otros métodos según sea necesario:"
 
 #: ../Doc/library/collections.abc.rst:50
 msgid ""
@@ -67,6 +73,13 @@ msgid ""
 "determine whether the full interface is supported.  The exception to this "
 "rule is for methods that are automatically inferred from the rest of the API:"
 msgstr ""
+"2) Las clases existentes y las clases integradas se pueden registrar como "
+"\"subclases virtuales\" de los ABC. Esas clases deben definir la API "
+"completa, incluidos todos los métodos abstractos y todos los métodos mixin. "
+"Esto permite a los usuarios confiar en las pruebas :func:`issubclass` o :"
+"func:`isinstance` para determinar si se admite la interfaz completa. La "
+"excepción a esta regla es para los métodos que se infieren automáticamente "
+"del resto de la API:"
 
 #: ../Doc/library/collections.abc.rst:76
 msgid ""
@@ -76,12 +89,19 @@ msgid ""
 "`reversed` function automatically fall back to using ``__getitem__`` and "
 "``__len__``."
 msgstr ""
+"En este ejemplo, la clase :class:`D` no necesita definir ``__contains__``, "
+"``__iter__`` y ``__reversed__`` porque el :ref:`operador in <comparisons>`, "
+"la lógica de :term:`iteración <iterable>` y la función :func:`reversed` "
+"recurren automáticamente al uso de ``__getitem__`` y ``__len__``."
 
 #: ../Doc/library/collections.abc.rst:82
 msgid ""
 "3) Some simple interfaces are directly recognizable by the presence of the "
 "required methods (unless those methods have been set to :const:`None`):"
 msgstr ""
+"3) Algunas interfaces simples son directamente reconocibles por la presencia "
+"de los métodos requeridos (a menos que esos métodos se hayan configurado en :"
+"const:`None`):"
 
 #: ../Doc/library/collections.abc.rst:99
 msgid ""
@@ -92,6 +112,13 @@ msgid ""
 "class supplies ``__getitem__``, ``__len__``, and ``__iter__`` is "
 "insufficient for distinguishing a :class:`Sequence` from a :class:`Mapping`."
 msgstr ""
+"Las interfaces complejas no admiten esta última técnica porque una interfaz "
+"es más que la simple presencia de nombres de métodos. Las interfaces "
+"especifican la semántica y las relaciones entre métodos que no se pueden "
+"inferir únicamente de la presencia de nombres de métodos específicos. Por "
+"ejemplo, saber que una clase proporciona ``__getitem__``, ``__len__`` y "
+"``__iter__`` no es suficiente para distinguir un :class:`Sequence` de un :"
+"class:`Mapping`."
 
 #: ../Doc/library/collections.abc.rst:111
 msgid "Collections Abstract Base Classes"
@@ -122,37 +149,33 @@ msgid "Mixin Methods"
 msgstr "Métodos Mixin"
 
 #: ../Doc/library/collections.abc.rst:120
-#, fuzzy
 msgid ":class:`Container` [1]_"
-msgstr ":class:`Container`"
+msgstr ":class:`Container` [1]_"
 
 #: ../Doc/library/collections.abc.rst:120
 msgid "``__contains__``"
 msgstr "``__contains__``"
 
 #: ../Doc/library/collections.abc.rst:121
-#, fuzzy
 msgid ":class:`Hashable` [1]_"
-msgstr ":class:`Hashable`"
+msgstr ":class:`Hashable` [1]_"
 
 #: ../Doc/library/collections.abc.rst:121
 msgid "``__hash__``"
 msgstr "``__hash__``"
 
 #: ../Doc/library/collections.abc.rst:122
-#, fuzzy
 msgid ":class:`Iterable` [1]_ [2]_"
-msgstr ":class:`Iterable`"
+msgstr ":class:`Iterable` [1]_ [2]_"
 
 #: ../Doc/library/collections.abc.rst:122
 #: ../Doc/library/collections.abc.rst:123
 msgid "``__iter__``"
 msgstr "``__iter__``"
 
 #: ../Doc/library/collections.abc.rst:123
-#, fuzzy
 msgid ":class:`Iterator` [1]_"
-msgstr ":class:`Iterator`"
+msgstr ":class:`Iterator` [1]_"
 
 #: ../Doc/library/collections.abc.rst:123
 #: ../Doc/library/collections.abc.rst:124
@@ -164,18 +187,16 @@ msgid "``__next__``"
 msgstr "``__next__``"
 
 #: ../Doc/library/collections.abc.rst:124
-#, fuzzy
 msgid ":class:`Reversible` [1]_"
-msgstr ":class:`Reversible`"
+msgstr ":class:`Reversible` [1]_"
 
 #: ../Doc/library/collections.abc.rst:124
 msgid "``__reversed__``"
 msgstr "``__reversed__``"
 
 #: ../Doc/library/collections.abc.rst:125
-#, fuzzy
 msgid ":class:`Generator`  [1]_"
-msgstr ":class:`Generator`"
+msgstr ":class:`Generator` [1]_"
 
 #: ../Doc/library/collections.abc.rst:125
 msgid ":class:`Iterator`"
@@ -191,28 +212,25 @@ msgid "``close``, ``__iter__``, ``__next__``"
 msgstr "``close``, ``__iter__``, ``__next__``"
 
 #: ../Doc/library/collections.abc.rst:126
-#, fuzzy
 msgid ":class:`Sized`  [1]_"
-msgstr ":class:`Sized`"
+msgstr ":class:`Sized` [1]_"
 
 #: ../Doc/library/collections.abc.rst:126
 #: ../Doc/library/collections.abc.rst:165
 msgid "``__len__``"
 msgstr "``__len__``"
 
 #: ../Doc/library/collections.abc.rst:127
-#, fuzzy
 msgid ":class:`Callable`  [1]_"
-msgstr ":class:`Callable`"
+msgstr ":class:`Callable` [1]_"
 
 #: ../Doc/library/collections.abc.rst:127
 msgid "``__call__``"
 msgstr "``__call__``"
 
 #: ../Doc/library/collections.abc.rst:128
-#, fuzzy
 msgid ":class:`Collection`  [1]_"
-msgstr ":class:`Collection`"
+msgstr ":class:`Collection` [1]_"
 
 #: ../Doc/library/collections.abc.rst:128
 msgid ":class:`Sized`, :class:`Iterable`, :class:`Container`"
@@ -375,18 +393,16 @@ msgid ":class:`MappingView`, :class:`Collection`"
 msgstr ":class:`MappingView`, :class:`Collection`"
 
 #: ../Doc/library/collections.abc.rst:172
-#, fuzzy
 msgid ":class:`Awaitable` [1]_"
-msgstr ":class:`Awaitable`"
+msgstr ":class:`Awaitable` [1]_"
 
 #: ../Doc/library/collections.abc.rst:172
 msgid "``__await__``"
 msgstr "``__await__``"
 
 #: ../Doc/library/collections.abc.rst:173
-#, fuzzy
 msgid ":class:`Coroutine` [1]_"
-msgstr ":class:`Coroutine`"
+msgstr ":class:`Coroutine` [1]_"
 
 #: ../Doc/library/collections.abc.rst:173
 msgid ":class:`Awaitable`"
@@ -397,19 +413,17 @@ msgid "``close``"
 msgstr "``close``"
 
 #: ../Doc/library/collections.abc.rst:174
-#, fuzzy
 msgid ":class:`AsyncIterable` [1]_"
-msgstr ":class:`AsyncIterable`"
+msgstr ":class:`AsyncIterable` [1]_"
 
 #: ../Doc/library/collections.abc.rst:174
 #: ../Doc/library/collections.abc.rst:175
 msgid "``__aiter__``"
 msgstr "``__aiter__``"
 
 #: ../Doc/library/collections.abc.rst:175
-#, fuzzy
 msgid ":class:`AsyncIterator` [1]_"
-msgstr ":class:`AsyncIterator`"
+msgstr ":class:`AsyncIterator` [1]_"
 
 #: ../Doc/library/collections.abc.rst:175
 msgid ":class:`AsyncIterable`"
@@ -420,9 +434,8 @@ msgid "``__anext__``"
 msgstr "``__anext__``"
 
 #: ../Doc/library/collections.abc.rst:176
-#, fuzzy
 msgid ":class:`AsyncGenerator` [1]_"
-msgstr ":class:`AsyncGenerator`"
+msgstr ":class:`AsyncGenerator` [1]_"
 
 #: ../Doc/library/collections.abc.rst:176
 msgid ":class:`AsyncIterator`"
@@ -438,7 +451,7 @@ msgstr "``aclose``, ``__aiter__``, ``__anext__``"
 
 #: ../Doc/library/collections.abc.rst:181
 msgid "Footnotes"
-msgstr ""
+msgstr "Notas al pie"
 
 #: ../Doc/library/collections.abc.rst:182
 msgid ""
@@ -447,26 +460,28 @@ msgid ""
 "set to :const:`None`.  This only works for simple interfaces.  More complex "
 "interfaces require registration or direct subclassing."
 msgstr ""
+"Estos ABC anulan :meth:`object.__subclasshook__` para admitir la prueba de "
+"una interfaz verificando que los métodos requeridos estén presentes y no se "
+"hayan configurado en :const:`None`. Esto solo funciona para interfaces "
+"simples. Las interfaces más complejas requieren registro o herencia directa."
 
 #: ../Doc/library/collections.abc.rst:188
-#, fuzzy
 msgid ""
 "Checking ``isinstance(obj, Iterable)`` detects classes that are registered "
 "as :class:`Iterable` or that have an :meth:`__iter__` method, but it does "
 "not detect classes that iterate with the :meth:`__getitem__` method.  The "
 "only reliable way to determine whether an object is :term:`iterable` is to "
 "call ``iter(obj)``."
 msgstr ""
-"Al marcar ``isinstance(obj, Iterable)`` se detectan las clases que están "
+"La verificación de ``isinstance(obj, Iterable)`` detecta clases que están "
 "registradas como :class:`Iterable` o que tienen un método :meth:`__iter__`, "
 "pero no detecta clases que iteran con el método :meth:`__getitem__`. La "
 "única forma confiable de determinar si un objeto es :term:`iterable` es "
 "llamar a ``iter(obj)``."
 
 #: ../Doc/library/collections.abc.rst:196
-#, fuzzy
 msgid "Collections Abstract Base Classes -- Detailed Descriptions"
-msgstr "Colecciones Clases Base Abstractas"
+msgstr "Colecciones Clases base abstractas - Descripciones detalladas"
 
 #: ../Doc/library/collections.abc.rst:201
 msgid "ABC for classes that provide the :meth:`__contains__` method."
@@ -661,16 +676,15 @@ msgstr ""
 
 #: ../Doc/library/collections.abc.rst:347
 msgid "Examples and Recipes"
-msgstr ""
+msgstr "Ejemplos y Recetas"
 
 #: ../Doc/library/collections.abc.rst:349
-#, fuzzy
 msgid ""
 "ABCs allow us to ask classes or instances if they provide particular "
 "functionality, for example::"
 msgstr ""
-"Estos ABC nos permiten preguntar a clases o instancias si proporcionan una "
-"funcionalidad particular, por ejemplo::"
+"Los ABC nos permiten preguntar a las clases o instancias si brindan una "
+"funcionalidad particular, por ejemplo:"
 
 #: ../Doc/library/collections.abc.rst:356
 msgid ""
