ayafileio

library1.4.4pypypi✓ verified 84d ago

Cross-platform async file API for Python. Provides unified async file I/O operations for POSIX and Windows, aiming for high performance and ease of use. Current version: 1.4.4. Released regularly.

devops

pip install ayafileio

github ↗homepage ↗

INSTALL

IMPORT

SIG · AYAFILEIO

ayafileio

devopspythonv1.4.4

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

AsyncFile

✓ from ayafileio import AsyncFile

✗ from ayafileio.file import AsyncFile

AsyncFile is exported at package level since v1.0.

open_async

✓ from ayafileio import open_async

✗ from ayafileio.async_api import open_async

open_async is a top-level function.

Opens a file asynchronously, writes and reads content.

import asyncio from ayafileio import AsyncFile async def main(): async with AsyncFile('example.txt', 'w') as f: await f.write('Hello, Ayafileio!') async with AsyncFile('example.txt', 'r') as f: print(await f.read()) asyncio.run(main())

Debug

Known issues

breakingAsyncFile does not support the full synchronous file interface. Calls like .flush or .seek may raise NotImplementedError.

fix

Check the documentation for supported methods; use underlying buffers if needed.

affects: all

gotchaOn Windows, async operations rely on overlapped I/O; ensure you use asyncio event loop that supports Windows (ProactorEventLoop).

fix

Set event loop policy: asyncio.set_event_loop_policy(asyncio.WindowsProactorEventLoopPolicy())

affects: all

deprecatedThe function ayafileio.open is deprecated in favor of ayafileio.open_async.

fix

Use open_async instead of open.

affects: >=1.3.0

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'ayafileio'

Library not installed or Python version too old (requires >=3.10).

fix

pip install ayafileio && ensure Python >=3.10.

AttributeError: module 'ayafileio' has no attribute 'open'

The deprecated 'open' was removed in later versions.

fix

Use 'open_async' instead.

NotImplementedError: The file object doesn't implement read/write

Using AsyncFile with a mode not supported (e.g., 'rb' may not be implemented).

fix

Check supported modes in the documentation; use 'r', 'w', or 'a'.

Upgrade

Version history

1.4.4latest on PyPI · released Jun 2, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

16 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/Patchouli-CN/ayafileio.git ↗

homepagehttps://github.com/Patchouli-CN/ayafileio.git ↗