Skip to main content
Help us improve Python packaging – donate today!

Asynchronous file operations.

Project Description

Travis CI Latest Version

Real asynchronous file operations with asyncio support.

Status

Development - BETA

Features

  • AIOFile has no internal pointer. You should pass offset and chunk_size for each operation or use helpers (Reader or Writer).
  • For POSIX (MacOS X and Linux) using Cython implementaion based on aio.h (using Cython).
  • For non-POSIX systems using thread-based implementation

Code examples

Totally async read and write:

import asyncio
from aiofile import AIOFile, Reader, Writer

async def main(loop):
    aio_file = AIOFile("/tmp/hello.txt", 'w+', loop=loop)

    await aio_file.write(b"Hello ")
    await aio_file.write(b"world", offset=7)
    await aio_file.fsync()

    print(await aio_file.read())

loop = asyncio.get_event_loop()
loop.run_until_complete(main(loop))

Write and read with helpers:

import asyncio
from aiofile import AIOFile, Reader, Writer

async def main(loop):
    aio_file = AIOFile("/tmp/hello.txt", 'w+', loop=loop)

    writer = Writer(aio_file)
    reader = Reader(aio_file, chunk_size=8)

    await writer(b"Hello")
    await writer(b" ")
    await writer(b"World")
    await aio_file.flush()

    async for chunk in reader:
        print(chunk)

loop = asyncio.get_event_loop()
loop.run_until_complete(main(loop))

Release history Release notifications

This version
History Node

0.5.3

History Node

0.5.2

History Node

0.5.1

History Node

0.5.0

History Node

0.4.0

History Node

0.3.0

History Node

0.2.3

History Node

0.1.4

History Node

0.1.3

History Node

0.1.2

History Node

0.1.1

History Node

0.1.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
aiofile-0.5.3-cp34-cp34m-macosx_10_6_intel.whl (96.4 kB) Copy SHA256 hash SHA256 Wheel cp34 Feb 6, 2018
aiofile-0.5.3-cp34-cp34m-manylinux1_x86_64.whl (191.5 kB) Copy SHA256 hash SHA256 Wheel cp34 Feb 6, 2018
aiofile-0.5.3-cp35-cp35m-macosx_10_6_intel.whl (94.9 kB) Copy SHA256 hash SHA256 Wheel cp35 Feb 6, 2018
aiofile-0.5.3-cp35-cp35m-manylinux1_x86_64.whl (185.1 kB) Copy SHA256 hash SHA256 Wheel cp35 Feb 6, 2018
aiofile-0.5.3-cp36-cp36m-macosx_10_6_intel.whl (93.6 kB) Copy SHA256 hash SHA256 Wheel cp36 Feb 6, 2018
aiofile-0.5.3-cp36-cp36m-manylinux1_x86_64.whl (188.2 kB) Copy SHA256 hash SHA256 Wheel cp36 Feb 6, 2018
aiofile-0.5.3.tar.gz (72.2 kB) Copy SHA256 hash SHA256 Source None Feb 6, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page