Repolode
Enviar
Tinche

Tinche/aiofiles

Una biblioteca compatible con asyncio que ejecuta operaciones bloqueantes de archivos locales, os, tempfile y pathlib en un grupo de hilos sin detener el bucle de eventos.

Ver en GitHub
Estrellas
3,270
Forks
182
Issues abiertos
66
Último commit
hace 4 días

¿Qué es?

aiofiles es una biblioteca de Python para leer y escribir archivos locales en aplicaciones asyncio. Las operaciones habituales de E/S de archivos bloquean el hilo que las ejecuta, lo que puede detener un bucle de eventos. aiofiles ofrece objetos de archivo asíncronos cuyos métodos, como read, write y seek, son corrutinas que delegan el trabajo en un ejecutor de grupo de hilos.

La API replica de cerca la función integrada open(), por lo que es fácil adaptar el código existente, y async for permite iterar por líneas. El paquete también incluye envoltorios asíncronos para el módulo tempfile, las funciones de os que operan con archivos y directorios, y una alternativa a pathlib.Path cuyos métodos del sistema de archivos se pueden esperar con await.

Instálala con pip install aiofiles. El proyecto tiene licencia Apache-2.0 y sus pruebas se ejecutan con tox.

Funciones clave

  • 01Objetos de archivo asíncronos con una API similar a la función integrada open()
  • 02Las operaciones bloqueantes con archivos se ejecutan en un ejecutor de grupo de hilos
  • 03Iteración asíncrona por las líneas de un archivo con async for
  • 04Envoltorios asíncronos para tempfile y las funciones habituales de os relacionadas con archivos
  • 05pathlib.Path asíncrono con métodos del sistema de archivos que se pueden esperar con await

Casos de uso

  • Leer o escribir archivos de registro y datos en un servidor web asyncio sin bloquear las solicitudes
  • Crear archivos o directorios temporales dentro de tareas asíncronas
  • Recorrer árboles de directorios de forma asíncrona con llamadas al estilo de pathlib

Inicio rápido

  1. 1

    Instala aiofiles desde PyPI

    pip install aiofiles
  2. 2

    Abre un archivo de forma asíncrona con aiofiles.open y usa await para leerlo

Antes de usarlo

  • Las operaciones con archivos se ejecutan en un grupo de hilos, por lo que no son realmente no bloqueantes a nivel del sistema operativo.

Temas

#asyncio#file-io#python#threadpool#async

Preguntas frecuentes

¿Qué es aiofiles?
Una biblioteca compatible con asyncio que ejecuta operaciones bloqueantes de archivos locales, os, tempfile y pathlib en un grupo de hilos sin detener el bucle de eventos. aiofiles es una biblioteca de Python para leer y escribir archivos locales en aplicaciones asyncio. Las operaciones habituales de E/S de archivos bloquean el hilo que las ejecuta, lo que puede detener un bucle de eventos. aiofiles ofrece objetos de archivo asíncronos cuyos métodos, como read, write y seek, son corrutinas que delegan el trabajo en un ejecutor de grupo de hilos.
¿aiofiles es gratuito? ¿Qué licencia tiene?
aiofiles es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿aiofiles sigue mantenido?
Mantenimiento activo. El último commit de aiofiles fue el 21 oct 2026.
¿Para qué puedo usar aiofiles?
Leer o escribir archivos de registro y datos en un servidor web asyncio sin bloquear las solicitudes Crear archivos o directorios temporales dentro de tareas asíncronas Recorrer árboles de directorios de forma asíncrona con llamadas al estilo de pathlib
¿Cómo se instala aiofiles?
Instala aiofiles desde PyPI: pip install aiofiles Abre un archivo de forma asíncrona con aiofiles.open y usa await para leerlo
¿Dónde consigo aiofiles?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/Tinche/aiofiles

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados