'avances'

Author: ignaciodopazo

library/dataclasses.po

@@ -11,7 +11,7 @@ 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: 2020-06-29 15:36-0300\n"
+"PO-Revision-Date: 2020-07-01 19:31-0300\n"
 "Language-Team: python-doc-es\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
@@ -293,14 +293,14 @@ msgid ""
 "superclass will be used (if the superclass is :class:`object`, this means it "
 "will fall back to id-based hashing)."
 msgstr ""
-"Si ``eq`` y ``frozen`` son true, :func:`dataclass` genera "
-"por defecto un método :meth:`hash` por ti. En el caso que ``eq`` sea true y "
-"``frozen`` false, a :meth:`__hash__` se le asigna ``None``, en consecuencia "
-"será *unhashable* (lo cual es deseable, ya que es mutable). Si ``eq`` es "
-"false :meth:`__hash__` permanece sin cambios, por lo tanto en este caso "
-"aplica el uso del método :meth:`hash` heredado de la superclase (sólo si la "
-"superclase es :class:`object`, esto significa que cae en manos del *hashing* "
-"basado en el id de los objetos)."
+"Si ``eq`` y ``frozen`` son true, :func:`dataclass` genera por defecto un "
+"método :meth:`hash` por ti. En el caso que ``eq`` sea true y ``frozen`` "
+"false, a :meth:`__hash__` se le asigna ``None``, en consecuencia será "
+"*unhashable* (lo cual es deseable, ya que es mutable). Si ``eq`` es false :"
+"meth:`__hash__` permanece sin cambios, por lo tanto en este caso aplica el "
+"uso del método :meth:`hash` heredado de la superclase (sólo si la superclase "
+"es :class:`object`, esto significa que cae en manos del *hashing* basado en "
+"el id de los objetos)."
 
 #: ../Doc/library/dataclasses.rst:157
 msgid ""
@@ -320,19 +320,25 @@ msgid ""
 "``field``\\s may optionally specify a default value, using normal Python "
 "syntax::"
 msgstr ""
+"Los ``campos`` pueden, opcionalmente, especificar un valor por defecto::"
 
 #: ../Doc/library/dataclasses.rst:170
 msgid ""
 "In this example, both ``a`` and ``b`` will be included in the added :meth:"
 "`__init__` method, which will be defined as::"
 msgstr ""
+"En este ejemplo, ``a`` y ``b`` serán incluidos en el método generado :meth:"
+"`__init__`, el cual es definido como sigue::"
 
 #: ../Doc/library/dataclasses.rst:175
 msgid ""
 ":exc:`TypeError` will be raised if a field without a default value follows a "
 "field with a default value.  This is true either when this occurs in a "
 "single class, or as a result of class inheritance."
 msgstr ""
+"Si, en la definición de una clase, a un campo con valor por defecto le sigue "
+"un campo sin valor por defecto será lanzada la excepción :exc:`TypeError`. "
+"Esto aplica también en la definición de una clase mediante herencia."
 
 #: ../Doc/library/dataclasses.rst:181
 msgid ""
@@ -342,6 +348,10 @@ msgid ""
 "replace the default field value with a call to the provided :func:`field` "
 "function.  For example::"
 msgstr ""
+"Para casos de uso común, estas funcionalidades son suficientes. Sin embargo, "
+"existen otras características de *dataclass* que requieren información "
+"adicional en ciertos campos. Para satisfacer esta necesidad, es posible "
+"reemplazar algún "
 
 #: ../Doc/library/dataclasses.rst:194
 msgid ""
@@ -350,17 +360,25 @@ msgid ""
 "sentinel is used because ``None`` is a valid value for ``default``.  No code "
 "should directly use the ``MISSING`` value."
 msgstr ""
+"Como se muestra arriba, el valor ``MISSING`` es un objeto centinela "
+"utilizado para detectar si los parámetros ``default`` y ``default_factory`` "
+"son provistos. Este objeto centinela es utilizado ya que ``None`` es un "
+"valor válido para ``default``. Ningún procedimiento debe utilizar "
+"directamente el valor ``MISSING``."
 
 #: ../Doc/library/dataclasses.rst:200
 msgid "The parameters to :func:`field` are:"
-msgstr ""
+msgstr "Los parámetros de :func:`field`son:"
 
 #: ../Doc/library/dataclasses.rst:202
 msgid ""
 "``default``: If provided, this will be the default value for this field.  "
 "This is needed because the :meth:`field` call itself replaces the normal "
 "position of the default value."
 msgstr ""
+"``default``: Si es provisto, este será el valor por defecto para este campo. "
+"Es necesario definirlo ya que la propia llamada :meth:`field` reemplaza "
+"automáticamente la posición del valor *default*."
 
 #: ../Doc/library/dataclasses.rst:206
 msgid ""
@@ -370,24 +388,36 @@ msgid ""
 "discussed below.  It is an error to specify both ``default`` and "
 "``default_factory``."
 msgstr ""
+"``default_factory``: Si es provisto, debe ser un objeto invocable sin "
+"argumentos el cual será llamado cuando el valor por defecto de este campo "
+"sea necesario. Además de otros propósitos, puede ser utilizado para "
+"especificar campos con valores por defecto mutables, como se explica a "
+"continuación. Especificar tanto ``default`` como ``default_factory`` resulta "
+"en un error."
 
 #: ../Doc/library/dataclasses.rst:212
 msgid ""
 "``init``: If true (the default), this field is included as a parameter to "
 "the generated :meth:`__init__` method."
 msgstr ""
+"``init``: Si true (por defecto), este campo es incluido como parámetro del "
+"método :meth:`__init__` generado."
 
 #: ../Doc/library/dataclasses.rst:215
 msgid ""
 "``repr``: If true (the default), this field is included in the string "
 "returned by the generated :meth:`__repr__` method."
 msgstr ""
+"``repr``: Si true (por defecto), este campo es incluido en la cadena de "
+"caracteres que devuelve el método :meth:`__repr__` generado."
 
 #: ../Doc/library/dataclasses.rst:218
 msgid ""
 "``compare``: If true (the default), this field is included in the generated "
 "equality and comparison methods (:meth:`__eq__`, :meth:`__gt__`, et al.)."
 msgstr ""
+"``compare``: Si true (por defecto), este campo es incluido en los métodos de "
+"comparación generados: :meth:`__eq__`, :meth:`__gt__` y otros."
 
 #: ../Doc/library/dataclasses.rst:222
 msgid ""
@@ -397,6 +427,12 @@ msgid ""
 "field should be considered in the hash if it's used for comparisons.  "
 "Setting this value to anything other than ``None`` is discouraged."
 msgstr ""
+"``hash``: Su valor puede ser de tipo booleano o ``None``. Si true, este "
+"campo es incluido en el método :meth:`__hash__` generado. Si ``None`` (por "
+"defecto), utiliza el valor de ``compare``; normalmente éste es el "
+"comportamiento esperado; un campo debería ser considerado para el *hash* si "
+"el mismo es compatible con operaciones de comparación. Está desaconsejado "
+"establecer este valor como otro que no sea ``None``."
 
 #: ../Doc/library/dataclasses.rst:229
 msgid ""
@@ -406,8 +442,16 @@ msgid ""
 "hash value.  Even if a field is excluded from the hash, it will still be "
 "used for comparisons."
 msgstr ""
+"Una posible razón para definir ``hash=False`` y ``compare=True`` podría ser "
+"en el caso que computar el valor *hash* para dicho campo es costoso, es "
+"necesario que tenga definido métodos de comparación y además otros campos "
+"contribuyen a determinar el tipo del valor *hash*. Aunque un campo sea "
+"excluido del *hash*, puede ser sujeto a comparaciones."
 
+# Duda en la traduccion de wrapper: dejarlo en ingles, empaquetado, envuelto?
+# Mapping podria ser mapeo u objeto mapeador
 #: ../Doc/library/dataclasses.rst:235
+#, fuzzy
 msgid ""
 "``metadata``: This can be a mapping or None. None is treated as an empty "
 "dict.  This value is wrapped in :func:`~types.MappingProxyType` to make it "
@@ -416,6 +460,12 @@ msgid ""
 "Multiple third-parties can each have their own key, to use as a namespace in "
 "the metadata."
 msgstr ""
+"``metadata``: Puede ser un mapeo o None. None es tratado como un diccionario "
+"vacío. Este valor es envuelto en :func:`~types.MappingProxyType` para que "
+"sea de sólo lectura y visible en el objeto :class:`Field`. No es utilizado "
+"por Clases de datos, mas bien es provista como un mecanismo de extensión de "
+"terceros. Varios terceros pueden tener su propia clave a utilizar como "
+"espacio de nombres en *metadata*."
 
 #: ../Doc/library/dataclasses.rst:243
 msgid ""
@@ -427,12 +477,21 @@ msgid ""
 "fields, just as if the default value itself were specified.  For example, "
 "after::"
 msgstr ""
+"Si el valor por defecto de un campo es especificado por una llamada a :func:"
+"`field()`, los atributos de clase para este campo serán reemplazados por los "
+"especificados en el valor ``default``. Si el valor de ``default`` no es "
+"provisto, el atributo de clase será eliminado. La idea es que, después que "
+"la ejecución del decorador :func:`dataclass`, todos los atributos de la "
+"clase contengan los valores por defecto de cada campo, como si fueran "
+"definidos uno por uno. Por ejemplo, luego de::"
 
 #: ../Doc/library/dataclasses.rst:259
 msgid ""
 "The class attribute ``C.z`` will be ``10``, the class attribute ``C.t`` will "
 "be ``20``, and the class attributes ``C.x`` and ``C.y`` will not be set."
 msgstr ""
+"El atributo ``C.z`` será ``10``, el atributo ``C.t`` será ``20`` y los "
+"atributos ``C.x`` y ``C.y`` estarán sin definir."
 
 #: ../Doc/library/dataclasses.rst:265
 msgid ""
@@ -441,27 +500,36 @@ msgid ""
 "method (see below).  Users should never instantiate a :class:`Field` object "
 "directly.  Its documented attributes are:"
 msgstr ""
+"Los objetos :class:`Field` describen cada campo definido. Estos objetos son "
+"creados implícitamente y son devueltos por el método :func:`fields` definido "
+"en este módulo (explicado más abajo). Los usuarios no deben instanciar un "
+"objeto :class:`Field` directamente. Sus atributos documentados son:"
 
 #: ../Doc/library/dataclasses.rst:270
 msgid "``name``: The name of the field."
-msgstr ""
+msgstr "``name``: Nombre del campo."
 
 #: ../Doc/library/dataclasses.rst:272
 msgid "``type``: The type of the field."
-msgstr ""
+msgstr "``type``: El tipo del campo"
 
 #: ../Doc/library/dataclasses.rst:274
 msgid ""
 "``default``, ``default_factory``, ``init``, ``repr``, ``hash``, ``compare``, "
 "and ``metadata`` have the identical meaning and values as they do in the :"
 "func:`field` declaration."
 msgstr ""
+"``default``, ``default_factory``, ``init``, ``repr``, ``hash``, ``compare`` "
+"y ``metadata`` tienen los mismos valores y significados respecto a la "
+"declaración de :func:`field` (arriba)."
 
 #: ../Doc/library/dataclasses.rst:278
 msgid ""
 "Other attributes may exist, but they are private and must not be inspected "
 "or relied on."
 msgstr ""
+"Pueden existir otros atributos, pero son privados y no deberían ser "
+"examinados ni depender de ellos."
 
 #: ../Doc/library/dataclasses.rst:283
 msgid ""