diff --git a/c-api/function.po b/c-api/function.po index 8cc916bc04..6b5751ae1a 100644 --- a/c-api/function.po +++ b/c-api/function.po @@ -12,7 +12,7 @@ msgstr "" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2024-11-21 16:38-0300\n" "PO-Revision-Date: 2021-12-09 10:29+0800\n" -"Last-Translator: Rodrigo Tobar \n" +"Last-Translator: Erick G. Islas-Osuna \n" "Language: es\n" "Language-Team: python-doc-es\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" @@ -64,7 +64,6 @@ msgstr "" "la función." #: ../Doc/c-api/function.rst:37 -#, fuzzy msgid "" "The function's docstring and name are retrieved from the code object. :attr:" "`~function.__module__` is retrieved from *globals*. The argument defaults, " @@ -72,13 +71,13 @@ msgid "" "is set to the same value as the code object's :attr:`~codeobject." "co_qualname` field." msgstr "" -"El docstring y el nombre de la función se obtiene del objeto código. " -"*__module__* se obtiene de *globals *. El argumento *defaults*, " -"*annotations* y *closure* se establecen en ``NULL``. *__qualname__* se " -"establece en el mismo valor que el nombre de la función." +"El docstring y el nombre de la función se obtienen del objeto código. " +":attr:`~function.__module__` se obtiene de *globals*. Los argumentos por defecto, " +"anotaciones y clausura se establecen en ``NULL``. :attr:`~function.__qualname__` " +"se establece en el mismo valor que el campo :attr:`~codeobject.co_qualname` " +"del objeto código." #: ../Doc/c-api/function.rst:46 -#, fuzzy msgid "" "As :c:func:`PyFunction_New`, but also allows setting the function object's :" "attr:`~function.__qualname__` attribute. *qualname* should be a unicode " @@ -86,9 +85,9 @@ msgid "" "to the same value as the code object's :attr:`~codeobject.co_qualname` field." msgstr "" "Como :c:func:`PyFunction_New`, pero también permite configurar el atributo " -"``__qualname__`` del objeto función. *qualname* debe ser un objeto unicode o " -"``NULL``; si es ``NULL``, el atributo ``__qualname__`` se establece en el " -"mismo valor que su atributo ``__name__``." +":attr:`~function.__qualname__` del objeto función. *qualname* debe ser un objeto unicode o " +"``NULL``; si es ``NULL``, el atributo :attr:`!__qualname__` se establece en el " +"mismo valor que el campo :attr:`~codeobject.co_qualname` del objeto código." #: ../Doc/c-api/function.rst:57 msgid "Return the code object associated with the function object *op*." @@ -99,22 +98,20 @@ msgid "Return the globals dictionary associated with the function object *op*." msgstr "Retorna el diccionario global asociado con el objeto función *op*." #: ../Doc/c-api/function.rst:67 -#, fuzzy msgid "" "Return a :term:`borrowed reference` to the :attr:`~function.__module__` " "attribute of the :ref:`function object ` *op*. It can be " "*NULL*." msgstr "" -"Retorna una referencia tomada (:term:`borrowed reference`) al atributo " -"*__module__* del objeto función *op*. Puede ser *NULL*." +"Retorna una :term:`referencia prestada` al atributo :attr:`~function.__module__` " +"del :ref:`objeto función ` *op*. Puede ser *NULL*." #: ../Doc/c-api/function.rst:71 -#, fuzzy msgid "" "This is normally a :class:`string ` containing the module name, but can " "be set to any other object by Python code." msgstr "" -"Éste es normalmente una cadena de caracteres que contiene el nombre del " +"Esto es normalmente una :class:`cadena de caracteres ` que contiene el nombre del " "módulo, pero se puede establecer en cualquier otro objeto mediante código " "Python." @@ -141,13 +138,15 @@ msgstr "Lanza :exc:`SystemError` y retorna ``-1`` en caso de error." #: ../Doc/c-api/function.rst:91 msgid "Set the vectorcall field of a given function object *func*." -msgstr "" +msgstr "Establece el campo vectorcall de un objeto función dado *func*." #: ../Doc/c-api/function.rst:93 msgid "" "Warning: extensions using this API must preserve the behavior of the " "unaltered (default) vectorcall function!" msgstr "" +"Advertencia: ¡las extensiones que usan esta API deben preservar el comportamiento " +"de la función vectorcall inalterada (por defecto)!" #: ../Doc/c-api/function.rst:100 msgid "" @@ -188,6 +187,10 @@ msgid "" "case of error (e.g. no more watcher IDs available), return ``-1`` and set an " "exception." msgstr "" +"Registra *callback* como un observador de función para el intérprete actual. " +"Retorna un ID que puede pasarse a :c:func:`PyFunction_ClearWatcher`. En caso " +"de error (por ejemplo, no hay más IDs de observador disponibles), retorna ``-1`` " +"y establece una excepción." #: ../Doc/c-api/function.rst:138 msgid "" @@ -196,6 +199,10 @@ msgid "" "success, or ``-1`` and set an exception on error (e.g. if the given " "*watcher_id* was never registered.)" msgstr "" +"Limpia el observador identificado por *watcher_id* previamente retornado de :c:func:" +"`PyFunction_AddWatcher` para el intérprete actual. Retorna ``0`` en caso de " +"éxito, o ``-1`` y establece una excepción en caso de error (por ejemplo, si el " +"*watcher_id* dado nunca fue registrado)." #: ../Doc/c-api/function.rst:148 msgid "" @@ -204,10 +211,14 @@ msgid "" "``PyFunction_EVENT_MODIFY_CODE`` - ``PyFunction_EVENT_MODIFY_DEFAULTS`` - " "``PyFunction_EVENT_MODIFY_KWDEFAULTS``" msgstr "" +"Enumeración de posibles eventos de observador de función: - " +"``PyFunction_EVENT_CREATE`` - ``PyFunction_EVENT_DESTROY`` - " +"``PyFunction_EVENT_MODIFY_CODE`` - ``PyFunction_EVENT_MODIFY_DEFAULTS`` - " +"``PyFunction_EVENT_MODIFY_KWDEFAULTS``" #: ../Doc/c-api/function.rst:160 msgid "Type of a function watcher callback function." -msgstr "" +msgstr "Tipo de una función callback de observador de función." #: ../Doc/c-api/function.rst:162 msgid "" @@ -216,12 +227,18 @@ msgid "" "`borrowed reference` to the new value that is about to be stored in *func* " "for the attribute that is being modified." msgstr "" +"Si *event* es ``PyFunction_EVENT_CREATE`` o ``PyFunction_EVENT_DESTROY`` " +"entonces *new_value* será ``NULL``. De lo contrario, *new_value* mantendrá una :term:" +"`referencia prestada` al nuevo valor que está a punto de almacenarse en *func* " +"para el atributo que se está modificando." #: ../Doc/c-api/function.rst:167 msgid "" "The callback may inspect but must not modify *func*; doing so could have " "unpredictable effects, including infinite recursion." msgstr "" +"El callback puede inspeccionar pero no debe modificar *func*; hacerlo podría tener " +"efectos impredecibles, incluyendo recursión infinita." #: ../Doc/c-api/function.rst:170 msgid "" @@ -234,6 +251,14 @@ msgid "" "behavior depending on optimization decisions, it does not change the " "semantics of the Python code being executed." msgstr "" +"Si *event* es ``PyFunction_EVENT_CREATE``, entonces el callback se invoca " +"después de que `func` haya sido completamente inicializada. De lo contrario, el callback se invoca " +"antes de que tenga lugar la modificación a *func*, por lo que el estado previo de *func* " +"puede ser inspeccionado. Se permite al tiempo de ejecución optimizar la creación de " +"objetos función cuando sea posible. En tales casos no se emitirá ningún evento. " +"Aunque esto crea la posibilidad de una diferencia observable del comportamiento del tiempo de ejecución " +"dependiendo de las decisiones de optimización, no cambia la " +"semántica del código Python que se está ejecutando." #: ../Doc/c-api/function.rst:179 msgid "" @@ -242,6 +267,10 @@ msgid "" "it from being freed at this time. When the resurrected object is destroyed " "later, any watcher callbacks active at that time will be called again." msgstr "" +"Si *event* es ``PyFunction_EVENT_DESTROY``, tomar una referencia en el " +"callback a la función a punto de ser destruida la resucitará, evitando " +"que sea liberada en este momento. Cuando el objeto resucitado sea destruido " +"más tarde, cualquier callback observador activo en ese momento será llamado de nuevo." #: ../Doc/c-api/function.rst:184 msgid "" @@ -249,6 +278,9 @@ msgid "" "will be printed as an unraisable exception using :c:func:" "`PyErr_WriteUnraisable`. Otherwise it should return ``0``." msgstr "" +"Si el callback establece una excepción, debe retornar ``-1``; esta excepción " +"se imprimirá como una excepción no elevable usando :c:func:`PyErr_WriteUnraisable`. " +"De lo contrario debe retornar ``0``." #: ../Doc/c-api/function.rst:188 msgid "" @@ -258,16 +290,19 @@ msgid "" "exception unless it saves and clears the exception state first, and restores " "it before returning." msgstr "" +"Puede haber ya una excepción pendiente establecida al entrar al callback. En " +"este caso, el callback debe retornar ``0`` con la misma excepción aún " +"establecida. Esto significa que el callback no puede llamar a ninguna otra API que pueda establecer una " +"excepción a menos que guarde y borre el estado de la excepción primero, y lo restaure antes de retornar." #: ../Doc/c-api/function.rst:8 msgid "object" -msgstr "" +msgstr "objeto" #: ../Doc/c-api/function.rst:8 -#, fuzzy msgid "function" -msgstr "Objetos función" +msgstr "función" #: ../Doc/c-api/function.rst:20 msgid "MethodType (in module types)" -msgstr "" +msgstr "MethodType (en module types)"