liveConsole 1.3.2__tar.gz → 1.4.1__tar.gz

{liveconsole-1.3.2/src/liveConsole.egg-info → liveconsole-1.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: liveConsole
-Version: 1.3.2
+Version: 1.4.1
 Summary: An IDLE-like debugger to allow for real-time command injection for debugging and testing python code
 Author-email: Tzur Soffer <tzur.soffer@gmail.com>
 License: MIT
@@ -29,6 +29,9 @@ A fully-featured, **live Python console GUI** built with **CustomTkinter** and *
     
 *   Clickable history of previous commands
 
+* **Integrated Help Panel** for quick access to Python object documentation
+
+
 ## Installation
 
 `pip install liveConsole`
@@ -77,6 +80,17 @@ A fully-featured, **live Python console GUI** built with **CustomTkinter** and *
 *   Click to copy them back to the prompt for editing or re-execution.
     
 
+### Help Panel
+
+*   A resizable right-hand panel that displays Python documentation (help()) for any object.
+
+*   Opens when clicking ctrl+click on a function/method and can be closed with the "X" button.
+
+*   Scrollable and syntax-styled.
+
+*   Perfect for quick reference without leaving the console.
+
+
 ### Easy Integration
 
 *   Automatically grabs **caller frame globals and locals** if not provided.

{liveconsole-1.3.2 → liveconsole-1.4.1}/README.md

@@ -16,6 +16,9 @@ A fully-featured, **live Python console GUI** built with **CustomTkinter** and *
     
 *   Clickable history of previous commands
 
+* **Integrated Help Panel** for quick access to Python object documentation
+
+
 ## Installation
 
 `pip install liveConsole`
@@ -64,6 +67,17 @@ A fully-featured, **live Python console GUI** built with **CustomTkinter** and *
 *   Click to copy them back to the prompt for editing or re-execution.
     
 
+### Help Panel
+
+*   A resizable right-hand panel that displays Python documentation (help()) for any object.
+
+*   Opens when clicking ctrl+click on a function/method and can be closed with the "X" button.
+
+*   Scrollable and syntax-styled.
+
+*   Perfect for quick reference without leaving the console.
+
+
 ### Easy Integration
 
 *   Automatically grabs **caller frame globals and locals** if not provided.

{liveconsole-1.3.2 → liveconsole-1.4.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "liveConsole"
-version = "1.3.2"
+version = "1.4.1"
 description = "An IDLE-like debugger to allow for real-time command injection for debugging and testing python code"
 authors = [{ name="Tzur Soffer", email="tzur.soffer@gmail.com" }]
 license = {text = "MIT"}

liveconsole-1.4.1/src/commandHistory.py

@@ -0,0 +1,34 @@
+class CommandHistory:
+    """Manages command history and navigation."""
+    
+    def __init__(self):
+        self.history = []
+        self.index = -1
+        self.tempCommand = ""
+    
+    def add(self, command):
+        """Add a command to history."""
+        if command.strip():
+            self.history.append(command)
+            self.index = len(self.history)
+    
+    def navigateUp(self):
+        """Get previous command from history."""
+        if self.index > 0:
+            self.index -= 1
+            return(self.history[self.index])
+        return(None)
+    
+    def navigateDown(self):
+        """Get next command from history."""
+        if self.index < len(self.history) - 1:
+            self.index += 1
+            return(self.history[self.index])
+        elif self.index == len(self.history) - 1:
+            self.index = len(self.history)
+            return(self.tempCommand)
+        return(None)
+    
+    def setTemp(self, command):
+        """Store temporary command while navigating history."""
+        self.tempCommand = command

liveconsole-1.4.1/src/helpTab.py

@@ -0,0 +1,64 @@
+import sys
+import io
+from pygments.styles import get_style_by_name
+import customtkinter as ctk
+from styledTextbox import StyledTextWindow
+
+class HelpTab(ctk.CTkFrame):
+    """A right-hand help tab with closable and updateable text content."""
+
+    def __init__(self, parent, width=500, title="Help", **kwargs):
+        super().__init__(parent, width=width, **kwargs)
+        self.parent = parent
+        self.visible = False
+
+        # Ensure initial width is respected
+        self.pack_propagate(False)
+
+        # Header frame with title and close button
+        headerFrame = ctk.CTkFrame(self, height=30)
+        headerFrame.pack(fill="x")
+        self.style = get_style_by_name("monokai")
+
+        self.titleLabel = ctk.CTkLabel(headerFrame, text=title, font=("Consolas", 12, "bold"))
+        self.titleLabel.pack(side="left", padx=5)
+
+        self.closeButton = ctk.CTkButton(headerFrame, text="X", height=20, command=self.close)
+        self.closeButton.pack(side="right", padx=5)
+
+        # Scrollable text area
+        self.textBox = StyledTextWindow(self, wrap="word", font=("Consolas", 11), bg="#2e2e2e")
+        self.textBox.pack(fill="both", expand=True, padx=5, pady=5)
+        self.textBox.configure(state="disabled")  # read-only
+
+    def close(self):
+        """Hide the help tab."""
+        if self.visible:
+            self.pack_forget()
+            self.visible = False
+
+    def open(self):
+        """Show the help tab."""
+        if not self.visible:
+            self.pack(side="left", fill="y")
+            # self.configure(width=self.minWidth)
+            self.visible = True
+            
+    def _getHelp(self, obj):
+        """Return the output of help(obj) as a string."""
+        old_stdout = sys.stdout  # save current stdout
+        sys.stdout = buffer = io.StringIO()  # redirect stdout to a string buffer
+        try:
+            help(obj)
+            return(buffer.getvalue())
+        finally:
+            sys.stdout = old_stdout  # restore original stdout
+
+    def updateHelp(self, obj):
+        """Update the help tab content."""
+
+        self.textBox.configure(state="normal")
+        self.textBox.delete("1.0", "end")
+        self.textBox.insert("1.0", self._getHelp(obj))
+        self.textBox.updateStyling()
+        self.textBox.configure(state="disabled")

{liveconsole-1.3.2 → liveconsole-1.4.1/src/liveConsole.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: liveConsole
-Version: 1.3.2
+Version: 1.4.1
 Summary: An IDLE-like debugger to allow for real-time command injection for debugging and testing python code
 Author-email: Tzur Soffer <tzur.soffer@gmail.com>
 License: MIT
@@ -29,6 +29,9 @@ A fully-featured, **live Python console GUI** built with **CustomTkinter** and *
     
 *   Clickable history of previous commands
 
+* **Integrated Help Panel** for quick access to Python object documentation
+
+
 ## Installation
 
 `pip install liveConsole`
@@ -77,6 +80,17 @@ A fully-featured, **live Python console GUI** built with **CustomTkinter** and *
 *   Click to copy them back to the prompt for editing or re-execution.
     
 
+### Help Panel
+
+*   A resizable right-hand panel that displays Python documentation (help()) for any object.
+
+*   Opens when clicking ctrl+click on a function/method and can be closed with the "X" button.
+
+*   Scrollable and syntax-styled.
+
+*   Perfect for quick reference without leaving the console.
+
+
 ### Easy Integration
 
 *   Automatically grabs **caller frame globals and locals** if not provided.

{liveconsole-1.3.2 → liveconsole-1.4.1}/src/liveConsole.egg-info/SOURCES.txt

@@ -2,7 +2,12 @@ LICENSE
 README.md
 pyproject.toml
 src/__init__.py
+src/commandHistory.py
+src/helpTab.py
 src/liveConsole.py
+src/mainConsole.py
+src/styledTextbox.py
+src/suggestionManager.py
 src/liveConsole.egg-info/PKG-INFO
 src/liveConsole.egg-info/SOURCES.txt
 src/liveConsole.egg-info/dependency_links.txt

liveconsole-1.4.1/src/liveConsole.egg-info/top_level.txt

@@ -0,0 +1,7 @@
+__init__
+commandHistory
+helpTab
+liveConsole
+mainConsole
+styledTextbox
+suggestionManager

liveconsole-1.4.1/src/liveConsole.py

@@ -0,0 +1,126 @@
+import customtkinter as ctk
+import inspect
+import sys
+import io
+
+from helpTab import HelpTab
+from mainConsole import InteractiveConsoleText
+
+
+class StdoutRedirect(io.StringIO):
+    """Redirects stdout/stderr to a callback function."""
+    
+    def __init__(self, writeCallback):
+        super().__init__()
+        self.writeCallback = writeCallback
+
+    def write(self, s):
+        if s.strip():
+            self.writeCallback(s, "output")
+
+    def flush(self):
+        pass
+
+class StdinRedirect(io.StringIO):
+    """Redirects stdin to capture input() from the console."""
+    def __init__(self, readCallback):
+        super().__init__()
+        self.readCallback = readCallback
+
+    def readline(self, *args, **kwargs):
+        return(self.readCallback())
+
+
+class InteractiveConsole(ctk.CTk):
+    """Main console window application."""
+    
+    def __init__(self, userGlobals=None, userLocals=None):
+        super().__init__()
+        
+        # Window setup
+        self.title("Live Interactive Console")
+        self.geometry("900x600")
+        
+        ctk.set_appearance_mode("dark")
+        ctk.set_default_color_theme("blue")
+        
+        # Get namespace from caller if not provided
+        if userGlobals is None or userLocals is None:
+            callerFrame = inspect.currentframe().f_back
+            if userGlobals is None:
+                userGlobals = callerFrame.f_globals
+            if userLocals is None:
+                userLocals = callerFrame.f_locals
+        
+        self.userGlobals = userGlobals
+        self.userLocals = userLocals
+        
+        # Create UI
+        self._createUi()
+        
+        # Redirect stdout/stderr
+        self._setupOutputRedirect()
+        self._setupInputRedirect()
+    
+    def _createUi(self):
+        """Create UI with console and help tab."""
+        frame = ctk.CTkFrame(self)
+        frame.pack(padx=10, pady=10, fill="both", expand=True)
+
+        # Horizontal frame
+        self.horizFrame = ctk.CTkFrame(frame)
+        self.horizFrame.pack(fill="both", expand=True)
+
+        # Right: Help Tab
+        self.helpTab = HelpTab(self.horizFrame, width=500)
+
+        # Left: Console
+        self.consoleFrame = ctk.CTkFrame(self.horizFrame, width=600)
+        self.consoleFrame.pack(side="left", fill="both", expand=True)
+        self.consoleFrame.pack_propagate(False)  # prevent shrinking to fit contents
+
+        self.console = InteractiveConsoleText(
+            self.consoleFrame,
+            self.helpTab,
+            userGlobals=self.userGlobals,
+            userLocals=self.userLocals,
+            wrap="word",
+            bg="#1e1e1e",
+            fg="white",
+            insertbackground="white",
+            font=("Consolas", 12)
+        )
+        self.console.pack(fill="both", expand=True, padx=5, pady=5)
+        self.console.master = self
+
+    
+    def _setupOutputRedirect(self):
+        """Setup stdout/stderr redirection to console."""
+        sys.stdout = StdoutRedirect(self.console.writeOutput)
+        sys.stderr = StdoutRedirect(
+            lambda text, tag: self.console.writeOutput(text, "error")
+        )
+
+    def _setupInputRedirect(self):
+        """Setup stdin redirection to console."""
+        sys.stdin = StdinRedirect(self.console.readInput)
+    
+    def probe(self, *args, **kwargs):
+        """Start the console main loop."""
+        self.mainloop(*args, **kwargs)
+
+
+# Example usage
+if __name__ == "__main__":
+    # Example variables and functions for testing
+    foo = 42
+    
+    def greet(name):
+        print(f"Hello {name}!")
+        return(f"Greeted {name}")
+    
+    # Create the list for testing autocomplete
+    exampleList = [1, 2, 3, 4, 5]
+    
+    # Start the console
+    InteractiveConsole().probe()