aiostdlib 0.0.0

Only the standard library... but asynchronous!

aiostdlib

Key Features

• Provides asynchronous versions of the standard libraries;
• The same API as the Python's standard, blocking API;
• Blocking IO is performed in a separate thread.

Getting Started

For more, see the documentation.

Installation

The library is available as aiostdlib on PyPI:

pip install aiostdlib

Usage

The aiostdlib API is the same as the standard library, except that it is asynchronous.

builtins

import asyncio

from aiostdlib import builtins


async def main() -> None:
    async with builtins.open("./file.txt", mode="w") as file:
        await file.write("aiostdlib")


if __name__ == "__main__":
    asyncio.run(main())

json

import asyncio

from aiostdlib import builtins, json


async def main() -> None:
    async with builtins.open("./file.json", mode="w") as file:
        await json.dump(["aiostdlib"], file)


if __name__ == "__main__":
    asyncio.run(main())

pathlib

import asyncio

from aiostdlib import pathlib


async def main() -> None:
    path = pathlib.Path("file.txt")

    if not await path.exists():
        await path.write_text("aiostdlib")


if __name__ == "__main__":
    asyncio.run(main())

shutil

import asyncio

from aiostdlib import shutil


async def main() -> None:
    await shutil.rmtree("/tmp/aioshutil")


if __name__ == "__main__":
    asyncio.run(main())

tarfile

import asyncio

from aiostdlib import tarfile


async def main() -> None:
    if not await tarfile.is_tarfile("./aiostdlib.tar.gz"):
        detail = "The file is not a `tar` archive"
        raise RuntimeError(detail)


if __name__ == "__main__":
    asyncio.run(main())

tempfile

import asyncio

from aiostdlib import tempfile


async def main() -> None:
    tempdir, path = await asyncio.gather(
        tempfile.gettempdir(),
        tempfile.mkdtemp(),
    )

    if not path.startswith(tempdir):
        detail = "This is strange..."
        raise RuntimeError(detail)


if __name__ == "__main__":
    asyncio.run(main())

tomllib

import asyncio

from aiostdlib import builtins, tomllib


async def main() -> None:
    async with builtins.open("./file.toml", mode="rb") as file:
        data = await tomllib.load(file)

        if "aiostdlib" not in data:
            detail = "Where is 'aiostdlib'?"
            raise RuntimeError(detail)


if __name__ == "__main__":
    asyncio.run(main())

zipfile

import asyncio

from aiostdlib import zipfile


async def main() -> None:
    if not await zipfile.is_zipfile("./aiostdlib.zip"):
        detail = "The file is not a `zip` archive"
        raise RuntimeError(detail)


if __name__ == "__main__":
    asyncio.run(main())

License

MIT License, Copyright (c) 2024 Sergei Bogdanov. See LICENSE file.