Sandbox::https://github.com/python/python-docs-es/blob/3.14/library/asyncio-dev.po

Repository navigation

459 lines (404 loc) · 16.8 KB
# 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
"Project-Id-Version: Python 3.8\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-02-26 18:44-0300\n"
"PO-Revision-Date: 2023-11-01 13:57+0100\n"
"Last-Translator: Marcos Medrano <marcosmedrano0@gmail.com>\n"
"Language: es\n"
"Language-Team: python-doc-es\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.18.0\n"
#: ../Doc/library/asyncio-dev.rst:7
msgid "Developing with asyncio"
msgstr "Desarrollando con asyncio"
#: ../Doc/library/asyncio-dev.rst:9
"Asynchronous programming is different from classic \"sequential\" "
"programming."
"La programación asincrónica es diferente a la programación \"secuencial\" "
#: ../Doc/library/asyncio-dev.rst:12
"This page lists common mistakes and traps and explains how to avoid them."
"Esta página enumera errores y trampas comunes y explica cómo evitarlos."
#: ../Doc/library/asyncio-dev.rst:19
msgid "Debug Mode"
msgstr "Modo depuración"
#: ../Doc/library/asyncio-dev.rst:21
"By default asyncio runs in production mode.  In order to ease the "
"development asyncio has a *debug mode*."
"Por defecto asyncio se ejecuta en modo producción. Para facilitar el "
"desarrollo asyncio tiene un *modo depuración*."
#: ../Doc/library/asyncio-dev.rst:24
msgid "There are several ways to enable asyncio debug mode:"
msgstr "Hay varias maneras de habilitar el modo depuración de asyncio:"
#: ../Doc/library/asyncio-dev.rst:26
msgid "Setting the :envvar:`PYTHONASYNCIODEBUG` environment variable to ``1``."
"Definiendo la variable de entorno :envvar:`PYTHONASYNCIODEBUG` a ``1``."
#: ../Doc/library/asyncio-dev.rst:28
msgid "Using the :ref:`Python Development Mode <devmode>`."
msgstr "Usando :ref:`Modo de Desarrollo de Python <devmode>`."
#: ../Doc/library/asyncio-dev.rst:30
msgid "Passing ``debug=True`` to :func:`asyncio.run`."
msgstr "Pasando ``debug=True`` a :func:`asyncio.run`."
#: ../Doc/library/asyncio-dev.rst:32
msgid "Calling :meth:`loop.set_debug`."
msgstr "Invocando :meth:`loop.set_debug`."
#: ../Doc/library/asyncio-dev.rst:34
msgid "In addition to enabling the debug mode, consider also:"
msgstr "Además de habilitar el modo depuración, considere también:"
#: ../Doc/library/asyncio-dev.rst:36
"setting the log level of the :ref:`asyncio logger <asyncio-logger>` to :py:"
"const:`logging.DEBUG`, for example the following snippet of code can be run "
"at startup of the application::"
"definir el nivel de log del :ref:`asyncio logger <asyncio-logger>` a :py:"
"const:`logging.DEBUG`, por ejemplo el siguiente fragmento de código puede "
"ser ejecutado al inicio de la aplicación:"
#: ../Doc/library/asyncio-dev.rst:40
msgid "logging.basicConfig(level=logging.DEBUG)"
#: ../Doc/library/asyncio-dev.rst:42
"configuring the :mod:`warnings` module to display :exc:`ResourceWarning` "
"warnings.  One way of doing that is by using the :option:`-W` ``default`` "
"command line option."
"configurando el módulo :mod:`warnings` para mostrar advertencias :exc:"
"`ResourceWarning`. Una forma de hacerlo es usando la opción :option:`-W` "
"``default`` de la línea de comandos."
#: ../Doc/library/asyncio-dev.rst:47
msgid "When the debug mode is enabled:"
msgstr "Cuando el modo depuración está habilitado:"
#: ../Doc/library/asyncio-dev.rst:49
"Many non-threadsafe asyncio APIs (such as :meth:`loop.call_soon` and :meth:"
"`loop.call_at` methods) raise an exception if they are called from a wrong "
"Muchas APIs asyncio que no son seguras para hilos (como los métodos :meth:"
"`loop.call_soon` y :meth:`loop.call_at`) generan una excepción si son "
"llamados desde un hilo equivocado."
#: ../Doc/library/asyncio-dev.rst:53
"The execution time of the I/O selector is logged if it takes too long to "
"perform an I/O operation."
"El tiempo de ejecución del selector E/S es registrado si tarda demasiado "
"tiempo en realizar una operación E/S."
#: ../Doc/library/asyncio-dev.rst:56
"Callbacks taking longer than 100 milliseconds are logged.  The :attr:`loop."
"slow_callback_duration` attribute can be used to set the minimum execution "
"duration in seconds that is considered \"slow\"."
"Los callbacks que tardan más de 100ms son registrados. El atributo :attr:"
"`loop.slow_callback_duration` puede ser usado para definir la duración "
"mínima de ejecución en segundos que se considere como \"lenta\"."
#: ../Doc/library/asyncio-dev.rst:64
msgid "Concurrency and Multithreading"
msgstr "Concurrencia y multihilo"
#: ../Doc/library/asyncio-dev.rst:66
"An event loop runs in a thread (typically the main thread) and executes all "
"callbacks and Tasks in its thread.  While a Task is running in the event "
"loop, no other Tasks can run in the same thread.  When a Task executes an "
"``await`` expression, the running Task gets suspended, and the event loop "
"executes the next Task."
"Un bucle de eventos se ejecuta en un hilo (generalmente el hilo principal) y "
"ejecuta todos los callbacks y las Tareas en su hilo. Mientras una Tarea está "
"ejecutándose en el bucle de eventos, ninguna otra Tarea puede ejecutarse en "
"el mismo hilo. Cuando una Tarea ejecuta una expresión ``await``, la Tarea en "
"ejecución se suspende y el bucle de eventos ejecuta la siguiente Tarea."
#: ../Doc/library/asyncio-dev.rst:72
"To schedule a :term:`callback` from another OS thread, the :meth:`loop."
"call_soon_threadsafe` method should be used. Example::"
"Para programar un :term:`callback` desde otro hilo del SO, se debe usar el "
"método :meth:`loop.call_soon_threadsafe`. Ejemplo::"
#: ../Doc/library/asyncio-dev.rst:75
msgid "loop.call_soon_threadsafe(callback, *args)"
#: ../Doc/library/asyncio-dev.rst:77
"Almost all asyncio objects are not thread safe, which is typically not a "
"problem unless there is code that works with them from outside of a Task or "
"a callback.  If there's a need for such code to call a low-level asyncio "
"API, the :meth:`loop.call_soon_threadsafe` method should be used, e.g.::"
"Casi ningún objeto asyncio es seguro entre hilos (*thread safe*), lo cual "
"generalmente no es un problema a no ser que haya código que trabaje con "
"ellos desde fuera de una Tarea o un callback. Si tal código necesita llamar "
"a la API de asyncio de bajo nivel, se debe usar el método :meth:`loop."
"call_soon_threadsafe`, por ejemplo::"
#: ../Doc/library/asyncio-dev.rst:83
msgid "loop.call_soon_threadsafe(fut.cancel)"
#: ../Doc/library/asyncio-dev.rst:85
"To schedule a coroutine object from a different OS thread, the :func:"
"`run_coroutine_threadsafe` function should be used. It returns a :class:"
"`concurrent.futures.Future` to access the result::"
"Para programar un objeto de corrutina desde una hilo diferente del sistema "
"operativo se debe usar la función :func:`run_coroutine_threadsafe`. Esta "
"retorna un :class:`concurrent.futures.Future` para acceder al resultado::"
#: ../Doc/library/asyncio-dev.rst:89
"async def coro_func():\n"
"     return await asyncio.sleep(1, 42)\n"
"# Later in another OS thread:\n"
"future = asyncio.run_coroutine_threadsafe(coro_func(), loop)\n"
"# Wait for the result:\n"
"result = future.result()"
#: ../Doc/library/asyncio-dev.rst:98
msgid "To handle signals the event loop must be run in the main thread."
"Para manejar señales el bucle de eventos debe ser ejecutado en el hilo "
"principal."
#: ../Doc/library/asyncio-dev.rst:101
"The :meth:`loop.run_in_executor` method can be used with a :class:"
"`concurrent.futures.ThreadPoolExecutor` or :class:`~concurrent.futures."
"InterpreterPoolExecutor` to execute blocking code in a different OS thread "
"without blocking the OS thread that the event loop runs in."
"El método :meth:`loop.run_in_executor` puede ser usado con un :class:"
"`concurrent.futures.ThreadPoolExecutor` para ejecutar código bloqueante en "
"un hilo diferente del sistema operativo sin bloquear el hilo del sistema "
"operativo en el que el bucle de eventos está siendo ejecutado."
#: ../Doc/library/asyncio-dev.rst:107
"There is currently no way to schedule coroutines or callbacks directly from "
"a different process (such as one started with :mod:`multiprocessing`). The :"
"ref:`asyncio-event-loop-methods` section lists APIs that can read from pipes "
"and watch file descriptors without blocking the event loop. In addition, "
"asyncio's :ref:`Subprocess <asyncio-subprocess>` APIs provide a way to start "
"a process and communicate with it from the event loop. Lastly, the "
"aforementioned :meth:`loop.run_in_executor` method can also be used with a :"
"class:`concurrent.futures.ProcessPoolExecutor` to execute code in a "
"different process."
"Actualmente no hay forma de programar corrutinas o retrollamadas "
"directamente desde un proceso diferente (como uno que haya comenzado con :"
"mod:`multiprocessing`). La sección :ref:`asyncio-event-loop-methods` enumera "
"las API que pueden leer desde tuberías y descriptores de archivos sin "
"bloquear el bucle de eventos. Además, las API :ref:`Subprocess <asyncio-"
"subprocess>` de asyncio proporcionan una forma de iniciar un proceso y "
"comunicarse con él desde el bucle de eventos. Por último, el método :meth:"
"`loop.run_in_executor` mencionado anteriormente también se puede usar con "
"un :class:`concurrent.futures.ProcessPoolExecutor` para ejecutar código en "
"un proceso diferente."
#: ../Doc/library/asyncio-dev.rst:121
msgid "Running Blocking Code"
msgstr "Ejecutando código bloqueante"
#: ../Doc/library/asyncio-dev.rst:123
"Blocking (CPU-bound) code should not be called directly.  For example, if a "
"function performs a CPU-intensive calculation for 1 second, all concurrent "
"asyncio Tasks and IO operations would be delayed by 1 second."
"Código bloqueante (dependiente de la CPU) no debe ser ejecutado "
"directamente. Por ejemplo, si una función realiza un cálculo intensivo de "
"CPU durante 1 segundo, todas las Tareas y operaciones de Entrada/Salida (IO) "
"concurrentes se retrasarían 1 segundo."
#: ../Doc/library/asyncio-dev.rst:128
"An executor can be used to run a task in a different thread, including in a "
"different interpreter, or even in a different process to avoid blocking the "
"OS thread with the event loop.  See the :meth:`loop.run_in_executor` method "
"for more details."
"Un ejecutor puede ser usado para ejecutar una tarea en un hilo diferente o "
"incluso en un proceso diferente para evitar bloquear el hilo del sistema "
"operativo con el bucle de eventos. Consulte el método :meth:`loop."
"run_in_executor` para más detalles."
#: ../Doc/library/asyncio-dev.rst:138
msgid "Logging"
msgstr "Logueando"
#: ../Doc/library/asyncio-dev.rst:140
"asyncio uses the :mod:`logging` module and all logging is performed via the "
"``\"asyncio\"`` logger."
"asyncio usa el módulo :mod:`logging` y todo el logueo es realizado mediante "
"el logger ``\"asyncio\"``."
#: ../Doc/library/asyncio-dev.rst:143
"The default log level is :py:const:`logging.INFO`, which can be easily "
"adjusted::"
"El nivel de log por defecto es :py:const:`logging.INFO`, el cual puede ser "
"fácilmente ajustado::"
#: ../Doc/library/asyncio-dev.rst:146
msgid "logging.getLogger(\"asyncio\").setLevel(logging.WARNING)"
#: ../Doc/library/asyncio-dev.rst:149
"Network logging can block the event loop. It is recommended to use a "
"separate thread for handling logs or use non-blocking IO. For example, see :"
"ref:`blocking-handlers`."
"Loguear por la red puede bloquear el bucle de eventos. Se recomienda usar un "
"subproceso separado para manejar registros o usar sin bloqueo IO. Por "
"ejemplo, consulte :ref:`blocking-handlers`."
#: ../Doc/library/asyncio-dev.rst:157
msgid "Detect never-awaited coroutines"
msgstr "Detectar corrutinas no esperadas"
#: ../Doc/library/asyncio-dev.rst:159
"When a coroutine function is called, but not awaited (e.g. ``coro()`` "
"instead of ``await coro()``) or the coroutine is not scheduled with :meth:"
"`asyncio.create_task`, asyncio will emit a :exc:`RuntimeWarning`::"
"Cuando una función de corrutina es invocada, pero no esperada (por ejemplo "
"``coro()`` en lugar de ``await coro()``) o la corrutina no es programada "
"con :meth:`asyncio.create_task`, asyncio emitirá una :exc:`RuntimeWarning`::"
#: ../Doc/library/asyncio-dev.rst:164
"import asyncio\n"
"async def test():\n"
"    print(\"never scheduled\")\n"
"async def main():\n"
"    test()\n"
"asyncio.run(main())"
#: ../Doc/library/asyncio-dev.rst:174 ../Doc/library/asyncio-dev.rst:219
msgid "Output::"
msgstr "Salida::"
#: ../Doc/library/asyncio-dev.rst:176
"test.py:7: RuntimeWarning: coroutine 'test' was never awaited\n"
#: ../Doc/library/asyncio-dev.rst:179 ../Doc/library/asyncio-dev.rst:235
msgid "Output in debug mode::"
msgstr "Salida en modo depuración::"
#: ../Doc/library/asyncio-dev.rst:181
"test.py:7: RuntimeWarning: coroutine 'test' was never awaited\n"
"Coroutine created at (most recent call last)\n"
"  File \"../t.py\", line 9, in <module>\n"
"    asyncio.run(main(), debug=True)\n"
"  < .. >\n"
"  File \"../t.py\", line 7, in main\n"
"    test()\n"
#: ../Doc/library/asyncio-dev.rst:192
"The usual fix is to either await the coroutine or call the :meth:`asyncio."
"create_task` function::"
"La solución habitual es esperar la corrutina o llamar a la función :meth:"
"`asyncio.create_task`::"
#: ../Doc/library/asyncio-dev.rst:195
"async def main():\n"
"    await test()"
#: ../Doc/library/asyncio-dev.rst:200
msgid "Detect never-retrieved exceptions"
msgstr "Detectar excepciones nunca recuperadas"
#: ../Doc/library/asyncio-dev.rst:202
"If a :meth:`Future.set_exception` is called but the Future object is never "
"awaited on, the exception would never be propagated to the user code.  In "
"this case, asyncio would emit a log message when the Future object is "
"garbage collected."
"Si un :meth:`Future.set_exception` es invocado pero el objeto Futuro nunca "
"es esperado, la excepción nunca será propagada al código del usuario. En "
"este caso, asyncio emitiría un mensaje de registro cuando el objeto Futuro "
"fuera recolectado como basura."
#: ../Doc/library/asyncio-dev.rst:207
msgid "Example of an unhandled exception::"
msgstr "Ejemplo de una excepción no manejada::"
#: ../Doc/library/asyncio-dev.rst:209
"import asyncio\n"
"async def bug():\n"
"    raise Exception(\"not consumed\")\n"
"async def main():\n"
"    asyncio.create_task(bug())\n"
"asyncio.run(main())"
#: ../Doc/library/asyncio-dev.rst:221
"Task exception was never retrieved\n"
"future: <Task finished coro=<bug() done, defined at test.py:3>\n"
"  exception=Exception('not consumed')>\n"
"Traceback (most recent call last):\n"
"  File \"test.py\", line 4, in bug\n"
"    raise Exception(\"not consumed\")\n"
"Exception: not consumed"
#: ../Doc/library/asyncio-dev.rst:230
":ref:`Enable the debug mode <asyncio-debug-mode>` to get the traceback where "
"the task was created::"
":ref:`Habilita el modo depuración <asyncio-debug-mode>` para obtener el "
"seguimiento de pila (*traceback*) donde la tarea fue creada::"
#: ../Doc/library/asyncio-dev.rst:233
msgid "asyncio.run(main(), debug=True)"
#: ../Doc/library/asyncio-dev.rst:237
"Task exception was never retrieved\n"
"future: <Task finished coro=<bug() done, defined at test.py:3>\n"
"    exception=Exception('not consumed') created at asyncio/tasks.py:321>\n"
"source_traceback: Object created at (most recent call last):\n"
"  File \"../t.py\", line 9, in <module>\n"
"    asyncio.run(main(), debug=True)\n"
"Traceback (most recent call last):\n"
"  File \"../t.py\", line 4, in bug\n"
"    raise Exception(\"not consumed\")\n"
"Exception: not consumed"
#~ msgid ""
#~ "asyncio checks for :ref:`coroutines that were not awaited <asyncio-"
#~ "coroutine-not-scheduled>` and logs them; this mitigates the \"forgotten "
#~ "await\" pitfall."
#~ msgstr ""
#~ "asyncio comprueba las :ref:`corrutinas que no son esperadas <asyncio-"
#~ "coroutine-not-scheduled>` y las registra; esto mitiga la dificultad de "
#~ "las \"esperas olvidadas\"."
FilesExpand file tree

asyncio-dev.po

Latest commit

History

asyncio-dev.po

File metadata and controls
