asyncgnostic

Python functions agnostic towards being called with await or otherwise.

Uses multiple dispatch to automatically call asynchronous or synchronous function based on calling context.

Example:

import asyncio
from asyncgnostic import awaitable


def handler() -> str:
    return "Running Sync"


@awaitable(handler)
async def handler() -> str:
    return "Running Async"


def sync_main():
    print("sync context", handler())


async def async_main():
    print("async context:", await handler())


sync_main()
asyncio.run(async_main())

Output:

sync context Running Sync
async context: Running Async

Credits:

Gratefully borrowed improvements from curio.

Reference:

• https://mastodon.sharma.io/@harshad/110476942596328864
• https://mastodon.social/@dabeaz/110477080111974062
• https://github.com/dabeaz/curio/blob/master/curio/meta.py