asyncio-policy.po

# 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.
# docs-es@python.org /
# https://mail.python.org/mailman3/lists/docs-es.python.org/
# Check https://github.com/python/python-docs-es/blob/3.8/TRANSLATORS to
# get the list of volunteers
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3.8\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-10-12 19:43+0200\n"
"PO-Revision-Date: 2023-11-19 13:55-0500\n"
"Last-Translator: Cristián Maureira-Fredes <cmaureirafredes@gmail.com>\n"
"Language-Team: python-doc-es\n"
"Language: es\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.13.0\n"
"X-Generator: Poedit 3.0.1\n"

#: ../Doc/library/asyncio-policy.rst:8
msgid "Policies"
msgstr "Políticas"

#: ../Doc/library/asyncio-policy.rst:10
msgid ""
"An event loop policy is a global object used to get and set the current :ref:"
"`event loop <asyncio-event-loop>`, as well as create new event loops. The "
"default policy can be :ref:`replaced <asyncio-policy-get-set>` with :ref:"
"`built-in alternatives <asyncio-policy-builtin>` to use different event loop "
"implementations, or substituted by a :ref:`custom policy <asyncio-custom-"
"policies>` that can override these behaviors."
msgstr ""
"Una política de bucle de eventos es un objeto global que se utiliza para "
"obtener y establecer el :ref:`bucle de eventos <asyncio-event-loop>` actual "
"o para crear nuevos bucles de eventos. La política preestablecida puede ser :"
"ref:`reemplazada <asyncio-policy-get-set>` con :ref:`alternativas built-in "
"<asyncio-policy-builtin>` para usar diferentes implementaciones de bucles de "
"eventos, o sustituida por una :ref:`política personalizada <asyncio-custom-"
"policies>` la cual puede anular estos comportamientos."

#: ../Doc/library/asyncio-policy.rst:19
msgid ""
"The :ref:`policy object <asyncio-policy-objects>` gets and sets a separate "
"event loop per *context*. This is per-thread by default, though custom "
"policies could define *context* differently."
msgstr ""
"El :ref:`objeto de política <asyncio-policy-objects>` obtiene y establece un "
"bucle de eventos separado por *contexto*. Por defecto, esto se realiza por "
"hilo, aunque las políticas personalizadas pueden definir el *contexto* de "
"una forma diferente."

#: ../Doc/library/asyncio-policy.rst:24
msgid ""
"Custom event loop policies can control the behavior of :func:"
"`get_event_loop`, :func:`set_event_loop`, and :func:`new_event_loop`."
msgstr ""
"Las políticas de bucle de eventos personalizadas pueden controlar el "
"comportamiento de :func:`get_event_loop`, :func:`set_event_loop`, y :func:"
"`new_event_loop`."

#: ../Doc/library/asyncio-policy.rst:27
msgid ""
"Policy objects should implement the APIs defined in the :class:"
"`AbstractEventLoopPolicy` abstract base class."
msgstr ""
"Los objetos de política deberían implementar las APIs definidas en la clase "
"abstracta base :class:`AbstractEventLoopPolicy`."

#: ../Doc/library/asyncio-policy.rst:34
msgid "Getting and Setting the Policy"
msgstr "Obteniendo y configurando la política"

#: ../Doc/library/asyncio-policy.rst:36
msgid ""
"The following functions can be used to get and set the policy for the "
"current process:"
msgstr ""
"Las siguientes funciones pueden ser usadas para obtener y configurar la "
"política de los procesos actuales:"

#: ../Doc/library/asyncio-policy.rst:41
msgid "Return the current process-wide policy."
msgstr "Retorna la política actual en todo el proceso."

#: ../Doc/library/asyncio-policy.rst:45
msgid "Set the current process-wide policy to *policy*."
msgstr "Establece la política actual en todo el proceso a *policy*."

#: ../Doc/library/asyncio-policy.rst:47
msgid "If *policy* is set to ``None``, the default policy is restored."
msgstr ""
"Si *policy* está configurado a ``None``, la política por defecto se "
"reestablece."

#: ../Doc/library/asyncio-policy.rst:53
msgid "Policy Objects"
msgstr "Objetos de política"

#: ../Doc/library/asyncio-policy.rst:55
msgid "The abstract event loop policy base class is defined as follows:"
msgstr ""
"La clase base de política de bucle de eventos abstractos se define de la "
"siguiente manera:"

#: ../Doc/library/asyncio-policy.rst:59
msgid "An abstract base class for asyncio policies."
msgstr "Una clase base abstracta para políticas asyncio."

#: ../Doc/library/asyncio-policy.rst:63
msgid "Get the event loop for the current context."
msgstr "Retorna el bucle de eventos para el contexto actual."

#: ../Doc/library/asyncio-policy.rst:65
msgid ""
"Return an event loop object implementing the :class:`AbstractEventLoop` "
"interface."
msgstr ""
"Retorna un objeto bucle de eventos implementando la interfaz :class:"
"`AbstractEventLoop`."

#: ../Doc/library/asyncio-policy.rst:68 ../Doc/library/asyncio-policy.rst:80
msgid "This method should never return ``None``."
msgstr "Este método nunca debería retornar ``None``."

#: ../Doc/library/asyncio-policy.rst:74
msgid "Set the event loop for the current context to *loop*."
msgstr "Establece el bucle de eventos para el contexto a *loop*."

#: ../Doc/library/asyncio-policy.rst:78
msgid "Create and return a new event loop object."
msgstr "Crea y retorna un nuevo objeto de bucle de eventos."

#: ../Doc/library/asyncio-policy.rst:84
msgid "Get a child process watcher object."
msgstr "Retorna un objeto observador de procesos secundarios."

#: ../Doc/library/asyncio-policy.rst:86
msgid ""
"Return a watcher object implementing the :class:`AbstractChildWatcher` "
"interface."
msgstr ""
"Retorna un objeto observador implementando la interfaz :class:"
"`AbstractChildWatcher`."

#: ../Doc/library/asyncio-policy.rst:89 ../Doc/library/asyncio-policy.rst:97
msgid "This function is Unix specific."
msgstr "Esta función es específica de Unix."

#: ../Doc/library/asyncio-policy.rst:95
msgid "Set the current child process watcher to *watcher*."
msgstr "Establece el observador de procesos secundarios actuales a *watcher*."

#: ../Doc/library/asyncio-policy.rst:104
msgid "asyncio ships with the following built-in policies:"
msgstr "asyncio se envía con las siguientes políticas integradas:"

#: ../Doc/library/asyncio-policy.rst:109
msgid ""
"The default asyncio policy.  Uses :class:`SelectorEventLoop` on Unix and :"
"class:`ProactorEventLoop` on Windows."
msgstr ""
"La política por defecto asyncio.  Usa :class:`SelectorEventLoop` en Unix y :"
"class:`ProactorEventLoop` en Windows."

#: ../Doc/library/asyncio-policy.rst:112
msgid ""
"There is no need to install the default policy manually. asyncio is "
"configured to use the default policy automatically."
msgstr ""
"No hay necesidad de instalar la política por defecto manualmente. asyncio "
"está configurado para usar la política por defecto automáticamente."

#: ../Doc/library/asyncio-policy.rst:117
msgid "On Windows, :class:`ProactorEventLoop` is now used by default."
msgstr "En Windows, :class:`ProactorEventLoop` ahora se usa por defecto."

#: ../Doc/library/asyncio-policy.rst:119
msgid ""
"The :meth:`get_event_loop` method of the default asyncio policy now emits a :"
"exc:`DeprecationWarning` if there is no current event loop set and it "
"decides to create one. In some future Python release this will become an "
"error."
msgstr ""
"El método :meth:`get_event_loop` de la política asyncio predeterminada ahora "
"emite una :exc:`DeprecationWarning` si no hay un bucle de eventos actual "
"configurado y decide crear uno. En alguna versión futura de Python, esto se "
"convertirá en un error."

#: ../Doc/library/asyncio-policy.rst:128
msgid ""
"An alternative event loop policy that uses the :class:`SelectorEventLoop` "
"event loop implementation."
msgstr ""
"Una política de bucle de eventos alternativa que usa la implementación de "
"bucle de eventos :class:`SelectorEventLoop`."

#: ../Doc/library/asyncio-policy.rst:131 ../Doc/library/asyncio-policy.rst:139
msgid ":ref:`Availability <availability>`: Windows."
msgstr ":ref:`Disponibilidad <availability>`: Windows."

#: ../Doc/library/asyncio-policy.rst:136
msgid ""
"An alternative event loop policy that uses the :class:`ProactorEventLoop` "
"event loop implementation."
msgstr ""
"Una política de bucle de eventos alternativa que usa la implementación de "
"bucle de eventos :class:`ProactorEventLoop`."

#: ../Doc/library/asyncio-policy.rst:145
msgid "Process Watchers"
msgstr "Observadores de procesos"

#: ../Doc/library/asyncio-policy.rst:147
msgid ""
"A process watcher allows customization of how an event loop monitors child "
"processes on Unix. Specifically, the event loop needs to know when a child "
"process has exited."
msgstr ""
"Un observador de procesos permite personalizar cómo un bucle de eventos "
"monitorea procesos secundarios en Unix. Específicamente, un bucle de eventos "
"necesita saber cuándo un proceso secundario ha terminado."

#: ../Doc/library/asyncio-policy.rst:151
msgid ""
"In asyncio, child processes are created with :func:`create_subprocess_exec` "
"and :meth:`loop.subprocess_exec` functions."
msgstr ""
"En asyncio, los procesos secundarios son creados con las funciones :func:"
"`créate_subprocess_exec` y :meth:`loop.subprocess_exec`."

#: ../Doc/library/asyncio-policy.rst:155
msgid ""
"asyncio defines the :class:`AbstractChildWatcher` abstract base class, which "
"child watchers should implement, and has four different implementations: :"
"class:`ThreadedChildWatcher` (configured to be used by default), :class:"
"`MultiLoopChildWatcher`, :class:`SafeChildWatcher`, and :class:"
"`FastChildWatcher`."
msgstr ""
"asyncio define la clase base abstracta :class:`AbstractChildWatcher`, qué "
"observadores de subprocesos deberían implementarse, y tiene cuatro "
"implementaciones diferentes: :class:`ThreadedChildWatcher` (configurado para "
"ser usado por defecto), :class:`MultiLoopChildWatcher`, :class:"
"`SaferChildWatcher`, y :class:`FastChildWatcher`."

#: ../Doc/library/asyncio-policy.rst:161
msgid ""
"See also the :ref:`Subprocess and Threads <asyncio-subprocess-threads>` "
"section."
msgstr ""
"Mirar también la sección :ref:`Subprocesos e hilos <asyncio-subprocess-"
"threads>`."

#: ../Doc/library/asyncio-policy.rst:164
msgid ""
"The following two functions can be used to customize the child process "
"watcher implementation used by the asyncio event loop:"
msgstr ""
"Las siguientes dos funciones pueden ser usadas para personalizar la "
"implementación de observadores de procesos secundarios usados por el bucle "
"de eventos de asyncio:"

#: ../Doc/library/asyncio-policy.rst:169
msgid "Return the current child watcher for the current policy."
msgstr "Retorna el observador de procesos secundarios para la política actual."

#: ../Doc/library/asyncio-policy.rst:175
msgid ""
"Set the current child watcher to *watcher* for the current policy.  "
"*watcher* must implement methods defined in the :class:"
"`AbstractChildWatcher` base class."
msgstr ""
"Establece el observador de procesos secundarios actuales a *watcher* para la "
"política actual. *watcher* debe implementar métodos definidos en la clase "
"base :class:`AbstractChildWatcher`."

#: ../Doc/library/asyncio-policy.rst:182
msgid ""
"Third-party event loops implementations might not support custom child "
"watchers.  For such event loops, using :func:`set_child_watcher` might be "
"prohibited or have no effect."
msgstr ""
"Implementaciones de bucles de eventos de terceras partes no deben dar "
"soporte a observadores de procesos secundarios personalizados.  Para dichos "
"bucles de eventos, usando :func:`set_child_watcher` podría estar prohibido o "
"no tener efecto."

#: ../Doc/library/asyncio-policy.rst:190
msgid "Register a new child handler."
msgstr "Registra un nuevo gestor de proceso secundario."

#: ../Doc/library/asyncio-policy.rst:192
msgid ""
"Arrange for ``callback(pid, returncode, *args)`` to be called when a process "
"with PID equal to *pid* terminates.  Specifying another callback for the "
"same process replaces the previous handler."
msgstr ""
"Arreglo para ``callback(pid, returncode, *args)`` a ser invocado cuando un "
"proceso con PID igual a *pid* termina. Especificando otro retrollamada para "
"el mismo proceso reemplaza el gestor previo."

#: ../Doc/library/asyncio-policy.rst:197
msgid "The *callback* callable must be thread-safe."
msgstr "El *callback* invocable debe ser seguro para hilos."

#: ../Doc/library/asyncio-policy.rst:201
msgid "Removes the handler for process with PID equal to *pid*."
msgstr "Remueve el gestor para el proceso con PID igual a *pid*."

#: ../Doc/library/asyncio-policy.rst:203
msgid ""
"The function returns ``True`` if the handler was successfully removed, "
"``False`` if there was nothing to remove."
msgstr ""
"La función retorna ``True`` si el gestor fue removido de forma exitosa, "
"``False`` si no hubo nada que remover."

#: ../Doc/library/asyncio-policy.rst:208
msgid "Attach the watcher to an event loop."
msgstr "Adjunta el observador a un bucle de eventos."

#: ../Doc/library/asyncio-policy.rst:210
msgid ""
"If the watcher was previously attached to an event loop, then it is first "
"detached before attaching to the new loop."
msgstr ""
"Si el observador estaba previamente adjuntado a un bucle de eventos, "
"entonces primero es separado antes de adjuntar el nuevo bucle."

#: ../Doc/library/asyncio-policy.rst:213
msgid "Note: loop may be ``None``."
msgstr "Nota: el bucle puede ser ``None``."

#: ../Doc/library/asyncio-policy.rst:217
msgid "Return ``True`` if the watcher is ready to use."
msgstr "Retorna ``True`` si el observador está listo para usarse."

#: ../Doc/library/asyncio-policy.rst:219
msgid ""
"Spawning a subprocess with *inactive* current child watcher raises :exc:"
"`RuntimeError`."
msgstr ""
"Generar un nuevo subproceso con observador de procesos secundarios actual "
"*inactive* lanza :exc:`RuntimeError`."

#: ../Doc/library/asyncio-policy.rst:226
msgid "Close the watcher."
msgstr "Cierra el observador."

#: ../Doc/library/asyncio-policy.rst:228
msgid ""
"This method has to be called to ensure that underlying resources are cleaned-"
"up."
msgstr ""
"Este método tiene que ser invocado para asegurar que los objetos subyacentes "
"están limpiados."

#: ../Doc/library/asyncio-policy.rst:236
msgid ""
"This implementation starts a new waiting thread for every subprocess spawn."
msgstr ""
"Esta implementación inicia un nuevo hilo esperando para cada subproceso "
"generado."

#: ../Doc/library/asyncio-policy.rst:238
msgid ""
"It works reliably even when the asyncio event loop is run in a non-main OS "
"thread."
msgstr ""
"Trabaja de manera confiable incluso cuando el bucle de eventos asyncio se "
"ejecuta en un hilo de SO no principal."

#: ../Doc/library/asyncio-policy.rst:240
msgid ""
"There is no noticeable overhead when handling a big number of children "
"(*O(1)* each time a child terminates), but starting a thread per process "
"requires extra memory."
msgstr ""
"No hay sobrecarga notable cuando se gestiona un número grande de procesos "
"secundarios (*O(1)* cada vez que un proceso secundario termina), pero "
"iniciar un hilo por proceso requiere memoria extra."

#: ../Doc/library/asyncio-policy.rst:243
msgid "This watcher is used by default."
msgstr "Este observador es usado por defecto."

#: ../Doc/library/asyncio-policy.rst:249
msgid ""
"This implementation registers a :py:data:`SIGCHLD` signal handler on "
"instantiation. That can break third-party code that installs a custom "
"handler for :py:data:`SIGCHLD` signal."
msgstr ""
"Esta implementación registra un gestor de señal en instanciación :py:data:"
"`SIGCHLD`. Eso puede romper código de terceras partes que instalen un gestor "
"personalizado para la señal :py:data:`SIGCHLD`."

#: ../Doc/library/asyncio-policy.rst:253 ../Doc/library/asyncio-policy.rst:273
msgid ""
"The watcher avoids disrupting other code spawning processes by polling every "
"process explicitly on a :py:data:`SIGCHLD` signal."
msgstr ""
"El observador evita interrumpir otro código generando procesos sondeando "
"cada proceso explícitamente en una señal :py:data:`SIGCHLD`."

#: ../Doc/library/asyncio-policy.rst:256
msgid ""
"There is no limitation for running subprocesses from different threads once "
"the watcher is installed."
msgstr ""
"No hay limitación para ejecutar subprocesos de diferentes hilos una vez el "
"observador es instalado."

#: ../Doc/library/asyncio-policy.rst:259
msgid ""
"The solution is safe but it has a significant overhead when handling a big "
"number of processes (*O(n)* each time a :py:data:`SIGCHLD` is received)."
msgstr ""
"La solución es segura pero tiene una sobrecarga significativa cuando se "
"gestiona un número grande de procesos (*O(n)* cada vez que un :py:data:"
"`SIGCHLD` es recibido)."

#: ../Doc/library/asyncio-policy.rst:269
msgid ""
"This implementation uses active event loop from the main thread to handle :"
"py:data:`SIGCHLD` signal. If the main thread has no running event loop "
"another thread cannot spawn a subprocess (:exc:`RuntimeError` is raised)."
msgstr ""
"Esta implementación usa bucles de eventos activos del hilo principal para "
"gestionar la señal :py:data:`SIGCHLD`. Si el hilo principal no tiene bucles "
"de eventos en ejecución otro hilo no puede generar un subproceso (:exc:"
"`RuntimeError` es disparada)."

#: ../Doc/library/asyncio-policy.rst:276
msgid ""
"This solution is as safe as :class:`MultiLoopChildWatcher` and has the same "
"*O(N)* complexity but requires a running event loop in the main thread to "
"work."
msgstr ""
"Esta solución es tan segura como :class:`MultiLoopChildWatcher` y tiene la "
"misma complejidad *O(n)* pero requiere de un bucle de eventos ejecutándose "
"en el hilo principal para trabajar."

#: ../Doc/library/asyncio-policy.rst:283
msgid ""
"This implementation reaps every terminated processes by calling ``os."
"waitpid(-1)`` directly, possibly breaking other code spawning processes and "
"waiting for their termination."
msgstr ""
"Esta implementación cosecha cada proceso terminado llamando ``os."
"waitpad(-1)`` directamente, posiblemente rompiendo otro código generando "
"procesos y esperando por su terminación."

#: ../Doc/library/asyncio-policy.rst:287
msgid ""
"There is no noticeable overhead when handling a big number of children "
"(*O(1)* each time a child terminates)."
msgstr ""
"No hay sobrecarga notable cuando se gestiona un número grande de procesos "
"secundarios (*O(1)* cada vez que un proceso secundario termina)."

#: ../Doc/library/asyncio-policy.rst:290
msgid ""
"This solution requires a running event loop in the main thread to work, as :"
"class:`SafeChildWatcher`."
msgstr ""
"Esta solución requiere un bucle de eventos ejecutándose en el hilo principal "
"para trabajar, como :class:`SafeChildWatcher`."

#: ../Doc/library/asyncio-policy.rst:297
msgid ""
"This implementation polls process file descriptors (pidfds) to await child "
"process termination. In some respects, :class:`PidfdChildWatcher` is a "
"\"Goldilocks\" child watcher implementation. It doesn't require signals or "
"threads, doesn't interfere with any processes launched outside the event "
"loop, and scales linearly with the number of subprocesses launched by the "
"event loop. The main disadvantage is that pidfds are specific to Linux, and "
"only work on recent (5.3+) kernels."
msgstr ""
"Esta implementación sondea los descriptores de archivos de proceso (pidfds) "
"para esperar la terminación del proceso hijo. En ciertos sentidos :class:"
"`PidfdChildWatcher` es una implementación de niño vigilante \"Ricitos de "
"oro\". No requiere señales o hilos, no interfiere con ningún proceso lanzado "
"fuera del bucle de eventos y escala linealmente con el número de subprocesos "
"lanzados por el bucle de eventos. La principal desventaja es que los pidfds "
"son específicos de Linux y solo funcionan en kernels recientes (5.3+)."

#: ../Doc/library/asyncio-policy.rst:311
msgid "Custom Policies"
msgstr "Personalizar Políticas"

#: ../Doc/library/asyncio-policy.rst:313
msgid ""
"To implement a new event loop policy, it is recommended to subclass :class:"
"`DefaultEventLoopPolicy` and override the methods for which custom behavior "
"is wanted, e.g.::"
msgstr ""
"Para implementar una nueva política de bucle de eventos, se recomienda "
"heredar :class:`DefaultEventLoopPolicy` y sobreescribir los métodos para los "
"cuales se desea una conducta personalizada, por ejemplo::"