"asyncio" --- Asynchronous I/O
******************************

======================================================================


¡Hola Mundo!
^^^^^^^^^^^^

   import asyncio

   async def main():
       print('Hello ...')
       await asyncio.sleep(1)
       print('... World!')

   asyncio.run(main())

asyncio es una biblioteca para escribir código **concurrente**
utilizando la sintaxis **async/await**.

asyncio es utilizado como base en múltiples *frameworks* asíncronos de
Python y provee un alto rendimiento en redes y servidores web,
bibliotecas de conexión de base de datos, colas de tareas
distribuidas, etc.

asyncio suele encajar perfectamente para operaciones con límite de E/S
y código de red **estructurado** de alto nivel.

asyncio provee un conjunto de *APIs* de **alto nivel** para:

* ejecutar corutinas de Python de manera concurrente y tener control
  total sobre su ejecución;

* realizar redes E/S y comunicación entre procesos(IPC);

* controlar subprocesos;

* distribuir tareas a través de colas;

* sincronizar código concurrente;

Adicionalmente, existen *APIs* de **bajo nivel** para *desarrolladores
de bibliotecas y frameworks* para:

* create and manage event loops, which provide asynchronous APIs for
  networking, running subprocesses, handling OS signals, etc;

* implementar protocolos eficientes utilizando transportes;

* Bibliotecas puente basadas en retrollamadas y código con sintaxis
  *async/wait*.

Availability: not Emscripten, not WASI.

Este módulo no funciona o no está disponible para plataformas
WebAssembly "wasm32-emscripten" y "wasm32-wasi". Consulte Plataformas
WebAssembly para más información.

-[ asyncio REPL ]-

Puedes experimentar con un contexto concurrente de "asyncio" en el
REPL:

   $ python -m asyncio
   asyncio REPL ...
   Use "await" directly instead of "asyncio.run()".
   Type "help", "copyright", "credits" or "license" for more information.
   >>> import asyncio
   >>> await asyncio.sleep(10, result='hello')
   'hello'

Raises an auditing event "cpython.run_stdin" with no arguments.

Distinto en la versión 3.12.5: (also 3.11.10, 3.10.15, 3.9.20, and
3.8.20) Emits audit events.

-[ Referencias ]-


*APIs* de alto nivel
^^^^^^^^^^^^^^^^^^^^

* Runners

* Corrutinas y tareas

* Streams

* Primitivas de sincronización

* Sub-procesos

* Colas

* Excepciones


*APIs* de bajo nivel
^^^^^^^^^^^^^^^^^^^^

* Bucle de eventos

* Futures

* Transportes y protocolos

* Políticas

* Soporte de plataforma

* Extensión


Guías y tutoriales
^^^^^^^^^^^^^^^^^^

* Índice de API de alto nivel

* Índice de API de bajo nivel

* Desarrollando con asyncio

Nota:

  El código fuente para asyncio puede encontrarse en Lib/asyncio/.
