liveConsole 1.0.0

An IDLE-like debugger to allow for real-time command injection for debugging and testing python code

Live Interactive Python Console

You can finally test your code in real time without using idle!

A fully-featured, live Python console GUI built with CustomTkinter and Tkinter, featuring:

• Python syntax highlighting via Pygments

• Autocomplete for keywords, built-ins, and local/global variables

• Thread-safe execution of Python code

• Output capturing for stdout and stderr

• Multi-line input with auto-indentation

• Clickable history of previous commands

Features

Syntax Highlighting

• Real-time syntax highlighting using Pygments and the Monokai style.

• Highlights Python keywords, built-ins, and expressions in the console.

Autocomplete

• Suggests keywords, built-in functions, and variables in scope.

• Popup list appears after typing at least 2 characters.

• Only inserts the missing portion of a word.

• Navigate suggestions with Up/Down arrows, confirm with Tab/Return.

Multi-Line Input

• Supports Shift+Enter for inserting a new line with proper indentation.

• Automatically detects incomplete statements and continues the prompt.

Thread-Safe Execution

• Executes user code in a separate thread to prevent GUI freezing.

• Captures both stdout and stderr output and prints them in the console.

• Supports both expressions (eval) and statements (exec).

Clickable History

• Hover previous commands to see them highlighted.

• Click to copy them back to the prompt for editing or re-execution.

Easy Integration

• Automatically grabs caller frame globals and locals if not provided.

• Can be used standalone or embedded in larger CustomTkinter applications.

Installation

pip install customtkinter pygments

Tkinter is included with Python on most platforms.

Usage

from liveConsole import InteractiveConsole
InteractiveConsole().mainloop()

• Type Python commands in the >>> prompt and see live output.

Keyboard Shortcuts

Key	Action
Enter	Execute command (if complete)
Shift+Enter	Insert newline with auto-indent
Tab	Complete the current word / show suggestions
Up/Down	Navigate suggestion list
Escape	Hide suggestions
Mouse Click	Select previous command from history

Customization

• Appearance mode: Dark mode is default (ctk.set_appearance_mode("dark"))

• Font: Consolas, 12pt by default, configurable in InteractiveConsoleText constructor

• Syntax Highlighting Style: Change Pygments style by modifying get_style_by_name("monokai")

License

MIT License – free to use, modify, and distribute.