Asynchronous Console and Interfaces for asyncio

0.8.2 · active · verified Sat Apr 11

aioconsole provides asynchronous equivalents to built-in functions like input(), print(), and exec() for use within asyncio applications. It includes an interactive loop for running an asynchronous Python console and a script (apython) to access asyncio code at runtime. The library is actively maintained, with regular updates to support newer Python versions.

Warnings

breaking Python 3.7 support was deprecated in aioconsole v0.7.0. Subsequent versions (0.7.0+) require Python 3.8 or higher. Python 3.7 has reached its official End-of-Life.
Fix: Upgrade your Python environment to 3.8 or newer.
gotcha For complex interactive console applications or rich input prompts, more feature-rich libraries like IPython, ptpython, or prompt_toolkit (for ainput alternatives) are often recommended over aioconsole due to its inherent limitations.
Fix: Evaluate if a more powerful async-compatible REPL or prompting library better suits your advanced interactive needs.
gotcha Versions prior to 0.7.1 might have had issues with 'more robust protection against the closing of standard streams', which implies potential unexpected behavior if sys.stdin/sys.stdout were closed externally.
Fix: Ensure you are using aioconsole v0.7.1 or newer for more robust handling of standard stream protection.

Install

pip install aioconsole Install aioconsole

Imports

ainput
```
from aioconsole import ainput
```
aprint
```
from aioconsole import aprint
```
aexec
```
from aioconsole import aexec
```
aeval
```
from aioconsole import aeval
```
Added in v0.8.0. Asynchronous equivalent to eval().
interact
```
from aioconsole import interact
```

Quickstart

This quickstart demonstrates basic asynchronous input and output using `ainput` and `aprint`. Run this script and type in the console when prompted.

import asyncio
from aioconsole import ainput, aprint

async def main():
    await aprint("Enter your name:")
    name = await ainput("> ")
    await aprint(f"Hello, {name}!")

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

view raw JSON →