Skip to content

Emulating Python's interactive interpreter in asynchronous contexts

License

Notifications You must be signed in to change notification settings

loic-simon/asyncode

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

asyncode

PyPI PyPI - Python Version PyPI - Wheel Read the Docs Travis CI

Python package for emulating Python's interactive interpreter in asynchronous contexts.

Installation

Use the package manager pip to install asyncode:

pip install asyncode

Dependencies

  • Python ≥ 3.5 (no CI for Python < 3.8)

Usage

This package's external API consists in two classes, AsyncInteractiveInterpreter and AsyncInteractiveConsole, which subclass respectively code.InteractiveInterpreter and code.InteractiveConsole.

These classes are meant to be used in already running asynchronous contexts. Minimal useful code will need to subclass provided classes to implement specific functions:

import asyncode

class MyAsyncConsole(asyncode.AsyncInteractiveConsole):
    """AsyncInteractiveConsole adapted to running environment"""

    async def write(self, data):
        """Use specific function"""
        await some_output_coroutine(data)

    async def raw_input(self, prompt=""):
        """Use specific functions"""
        if prompt:
            await some_output_coroutine(prompt)

        data = await some_input_coroutine()
        return data


async def run_interpreter():
    """Run an interactive Python interpreter"""
    console = MyAsyncConsole()
    try:
        await console.interact()
    except SystemExit:
        # Do not exit the whole program when sending "exit()" or "quit()"
        await some_output_coroutine("Bye!")

Read the docs for more informations.

Contributing

Pull requests are welcome. Do not hesitate to get in touch with me (see below) for any question or suggestion about this project!

License

This work is shared under the MIT license.

© 2020 Loïc Simon ([email protected])

About

Emulating Python's interactive interpreter in asynchronous contexts

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages