asynciorun

asynciorun is a lightweight Python library that provides a convenient mechanism for executing top‑level asynchronous coroutines in a synchronous context. The package was created to address the limitations of the standard library’s asyncio.run function, particularly around compatibility with older Python releases and the need for custom event‑loop handling. It is distributed under an open‑source license and is available on PyPI and GitHub.

The primary interface offered by asynciorun is the function run, which accepts a coroutine object and optional parameters controlling the event loop. When called, run creates or reuses an event loop, schedules the provided coroutine, and blocks until the coroutine completes. It handles the creation and eventual closure of the event loop, thereby relieving the developer from manually managing loop lifecycle. The function also supports running coroutines that require an existing event loop, by accepting a loop argument.

asynciorun is designed for compatibility with Python 3.7 and newer, and it mimics the behaviour of asyncio.run while adding support for environments where the default event loop policy has been altered. Because it relies only on Python’s built‑in asyncio module, it has zero external dependencies, making it suitable for lightweight scripts and command‑line utilities.

The library has received positive feedback from the Python community for its simplicity and reliability. Users report that asynciorun reduces boilerplate in scripts that need to invoke async code from a synchronous entry point. Examples in the documentation illustrate common patterns such as running a coroutine that performs network I/O or coordinates multiple concurrent tasks.

Future updates to asynciorun focus on expanding compatibility with different asynchronous frameworks and improving type‑hinting support. The project’s repository includes unit tests and Python documentation generated with Sphinx, ensuring maintainability and ease of contribution.