aiofiles is a library for using Python’s file I/O in an asynchronous (async/await) style. It’s useful if you want to work with files without blocking the event loop in async applications.
Project status
- Maintenance status: The project shows signs of ongoing work (an upstream GitHub push on 2026-08-29), but the most recently summarized published update is v25.1.0 from 2025-10-09, so it does not look “freshly released” relative to today (2026-09-10).
- Update cadence: Published updates appear irregular, with a long gap between v24.1.0 (2024-06-24) and v25.1.0 (2025-10-09) (about 15 months), and an even longer earlier interval. Recent upstream activity in 2026 does not come with a new summarized update yet.
AI summary generated
Recent updates
v25.1.0
This release is mainly a maintenance and tooling update. It adds Python 3.14 support, drops Python 3.8, and moves the repository to uv and ruff-based workflows, while the library code itself is mostly refactored internally.
BreakingFeaturesv24.1.0
aiofiles 24.1.0 focuses on async API modernization and platform compatibility. It adds new async path helpers, fixes platform-specific import and export issues in `aiofiles.os`, updates the test and packaging setup for Python 3.13, and drops Python 3.7 support.
BreakingFeaturesv23.2.1
This patch release fixes an import-time failure on platforms without os.statvfs by defining aiofiles.os.statvfs only when the standard library supports it. It also expands CI to run on Windows and adjusts tests for known Windows-specific filesystem limitations.
v23.2.0
This release adds Python 3.12 coverage, including aligning aiofiles.tempfile.NamedTemporaryFile behavior with the Python stdlib. It also introduces two new os-related helpers (statvfs, ismount) and updates the project tooling to use PDM instead of Poetry. Most user-visible behavior changes concern NamedTemporaryFile attribute exposure on Python 3.12.
BreakingFeatures