liveConsole 1.6.1__py3-none-any.whl → 1.7.0__py3-none-any.whl

{liveconsole-1.6.1.dist-info → liveconsole-1.7.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: liveConsole
-Version: 1.6.1
+Version: 1.7.0
 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
@@ -21,6 +21,8 @@ A fully-featured, **live Python console GUI** built with **CustomTkinter** and *
 *   Python syntax highlighting via **Pygments**
     
 *   Autocomplete for **keywords, built-ins, and local/global variables**
+
+*   Run code at startup for easier debugging
     
 *   Thread-safe execution of Python code
     
@@ -52,6 +54,15 @@ A fully-featured, **live Python console GUI** built with **CustomTkinter** and *
     
 *   Highlights Python keywords, built-ins, and expressions in the console.
     
+### Run Code at Startup
+
+*   Pysole can automatically execute Python code when the console launches.
+
+*   Use the runRemainingCode=True argument in pysole.probe() to run all remaining lines in the calling script after the probe() call.
+
+*   The printStartupCode flag controls whether these lines are printed in the console as they execute (True) or run silently (False).
+
+*   Useful for initializing variables, importing libraries, or setting up your environment automatically.
 
 ### Autocomplete
 
@@ -110,6 +121,15 @@ A fully-featured, **live Python console GUI** built with **CustomTkinter** and *
 import pysole
 pysole.probe()
 ```
+or for also running some code at the startup of the pysole
+```
+import pysole
+pysole.probe(runRemainingCode=True,   #< for executing the code below probe
+             printStartupCode=True    #< for printing the command as well as it output
+             )
+x = 1                                 #< initialize some variable
+print(x)                              #< print the variable on the console
+```
 
 *   Type Python commands in the `>>>` prompt and see live output.
 

liveconsole-1.7.0.dist-info/RECORD

@@ -0,0 +1,18 @@
+liveconsole-1.7.0.dist-info/licenses/LICENSE,sha256=7dZ0zL72aGaFE0C9DxacOpnaSkC5jajhG6iL7lqhWmU,1064
+pysole/__init__.py,sha256=SfaSBmFVSmhyf55UedBCqhi2Ss6Tre-BCKtZb3bSr2k,60
+pysole/__main__.py,sha256=QvVFH8J2yzgQaF9MosQ6ajCW67uiRbYliePsTEUCIAg,82
+pysole/commandHistory.py,sha256=xJtWbJ_vgJo2QGgaZJsApTOi_Hm8Yz0V9_zqQUCItj8,1084
+pysole/helpTab.py,sha256=o0uSY-8sw7FuuBrt0FQwcgK6ljNVx3IgRnW7heZ6GvY,2454
+pysole/liveConsole.py,sha256=lzS3dphAQ1i8pQC4E2FY-FyMMSKi-dAN0xr6XUgrNmo,168
+pysole/mainConsole.py,sha256=AzAUSP5W1jUhYnnGUNOG8LUGPkRW8jOqOHlk-pJC_V4,15053
+pysole/pysole.py,sha256=klQHCIRTE9uAIRA2DqUEtOh0521ht-g2KswA50Nw0no,10923
+pysole/settings.json,sha256=oFguWetRe_vGXUrqWSFUvY3JmGIArUZYpSiA8YZgRU8,722
+pysole/styledTextbox.py,sha256=qWnwGAKjl7R2HYPXQOr8GrGYIr4JC8PzmeioOCH7hGo,2236
+pysole/suggestionManager.py,sha256=EUFeCQoZnLS8EjPPNuZpzjY0BR07m2KP5TloyaMDVGY,6457
+pysole/themes.json,sha256=wv56r5XOV-ao7dY4_5Yjsio9VvJ58vHOI9nT7MEbXKY,2525
+pysole/utils.py,sha256=-mGHAp0MkbMPQ9eYzPmo5AGHDLuQ9NfPio_2_iaiCuY,294
+liveconsole-1.7.0.dist-info/METADATA,sha256=4-QotGWSs2WNGUrb-PGLm2e1ZR2mHEkEMpO-s62guxI,4955
+liveconsole-1.7.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+liveconsole-1.7.0.dist-info/entry_points.txt,sha256=qtvuJHcex4QqM97x_UawFWJYnfhQRl0jhqLcWRpnAGo,84
+liveconsole-1.7.0.dist-info/top_level.txt,sha256=DlpA93ScJbRZcF8kGSc5YoO8Ntu1ib1_MEZMb4xea_Q,7
+liveconsole-1.7.0.dist-info/RECORD,,

pysole/mainConsole.py

@@ -3,6 +3,7 @@ import traceback
 from .suggestionManager import CodeSuggestionManager
 from .commandHistory import CommandHistory
 from .styledTextbox import StyledTextWindow
+from .utils import stdPrint
 
 import tkinter as tk
 
@@ -11,26 +12,27 @@ class InteractiveConsoleText(StyledTextWindow):
     def __init__(self, master, helpTab, theme, font, behavior, userLocals=None, userGlobals=None, **kwargs):
         super().__init__(master, theme=theme, font=font, **kwargs)
         self.font=(font["FONT"], font["FONT_SIZE"])
-        
+
         # Initialize components
         self.PROMPT = behavior["PRIMARY_PROMPT"]
         self.PROMPT_LENGTH = len(self.PROMPT)
         self.suggestionManager = CodeSuggestionManager(self, userLocals=userLocals, userGlobals=userGlobals, theme=theme, font=font)
         self.helpTab = helpTab
-        
+
         self.navigatingHistory = False
         self.history = CommandHistory()
-        
+
         self.inputVar = tk.StringVar()
         self.waitingForInput = False
+        self.inputLine = "1.0"
 
         # Track current command
         self.currentCommandLine = 1
         self.isExecuting = False
-        
+
         # Setup bindings
         self._setupBindings()
-        
+
         # Initialize with first prompt
         self.addPrompt()
 
@@ -41,6 +43,7 @@ class InteractiveConsoleText(StyledTextWindow):
         self.bind("<Control-c>", self.cancel)
         self.bind("<Tab>", self.onTab)
         self.bind("<BackSpace>", self.onBackspace)
+        self.bind("<Delete>", self.onDelete)
         self.bind("<KeyRelease>", self.onKeyRelease)
         self.bind("<KeyPress>", self.onKeyPress)
         self.bind("<Button-1>", self.onClick)
@@ -50,11 +53,14 @@ class InteractiveConsoleText(StyledTextWindow):
     def getCurrentLineNumber(self):
         """Get the line number where current command starts."""
         return(int(self.index("end-1c").split(".")[0]))
-    
+
+    def resetCurrentLineNumber(self):
+        self.currentCommandLine = self.getCurrentLineNumber()
+
     def getCommandStartPosition(self):
         """Get the starting position of the current command."""
         return(f"{self.currentCommandLine}.0")
-    
+
     def replaceCurrentCommand(self, newCommand):
         """Replace the current command with new text."""
         if self.isExecuting:
@@ -64,9 +70,23 @@ class InteractiveConsoleText(StyledTextWindow):
         end = "end-1c"
         
         self.delete(start, end)
-        self.insert(start, newCommand)
+        if newCommand:
+            self.insert(start, newCommand)
+        self.mark_set("insert", "end")
         self.see("end")
-    
+        # Ensure styling/lexer applied after programmatic change:
+        self.updateStyling(start=self.getPromptPosition())
+
+    def runCommand(self, command, printCommand=False):
+        """Insert code into the console prompt and execute it as if Enter was pressed."""
+        if self.isExecuting:
+            return(False)
+        if printCommand:
+            self.replaceCurrentCommand(command)  #< Replace current command with the new code
+            self.onEnter(None)  #< Simulate pressing Enter to run the command
+        else:
+            self.executeCommandThreaded(command, addPrompt=False)
+
     def isCursorInEditableArea(self):
         """Check if cursor is in the editable command area."""
         if self.isExecuting:
@@ -88,25 +108,26 @@ class InteractiveConsoleText(StyledTextWindow):
             self.inputVar.set(line)
             self.waitingForInput = False
             return("break")
-        
+
         if self.isExecuting:
             return("break")
-        
+
         command = self.getCurrentCommand()
-        
+        # print(command)
+
         if not command.strip():
             return("break")
-        
+
         # Check if statement is incomplete
         if self.isIncompleteStatement(command):
             return(self.onShiftEnter(event))
-        
+
         # Execute the command
         self.history.add(command)
         self.mark_set("insert", "end")
         self.insert("end", "\n")
         self.see("end")
-        
+
         # Execute in thread
         self.isExecuting = True
         threading.Thread(
@@ -114,16 +135,17 @@ class InteractiveConsoleText(StyledTextWindow):
             args=(command,),
             daemon=True
         ).start()
-        
+
         return("break")
 
     def readInput(self):
         """Return the last entered line when input() is called."""
         self.waitingForInput = True
+        self.inputLine = self.index("end -1c")
         self.wait_variable(self.inputVar)  #< waits until Enter is pressed
         line = self.inputVar.get()
         self.inputVar.set("")  #< reset
-        return(line)
+        return(line or "\n")
 
     def onShiftEnter(self, event):
         """Handle Shift+Enter - new line with auto-indent."""
@@ -162,15 +184,35 @@ class InteractiveConsoleText(StyledTextWindow):
     
     def onBackspace(self, event):
         """Prevent backspace from deleting the prompt."""
+        
+        if self.waitingForInput:      #< During input mode, only allow editing after input start
+            if self.compare("insert", "<=", self.inputLine):
+                return "break"
+            return None
+            
         if not self.isCursorInEditableArea():
-            return("break")
+            return "break"
         
         # Check if we're at the prompt boundary
         cursorPos = self.index("insert")
         promptPos = self.getPromptPosition()
         
         if self.compare(cursorPos, "<=", promptPos):
+            return "break"
+        
+        return None
+    
+    def onDelete(self, event):
+        """Prevent delete from deleting protected content."""
+        if self.waitingForInput:      #< During input mode, only allow editing after input start
+            if self.compare("insert", "<=", self.inputLine):
+                return("break")
+            return(None)
+            
+        if not self.isCursorInEditableArea():
             return("break")
+        
+        return(None)
 
     def onClick(self, event):
         """Handle mouse clicks - Ctrl+Click opens help for the clicked word."""
@@ -206,7 +248,11 @@ class InteractiveConsoleText(StyledTextWindow):
 
     def onKeyPress(self, event):
         """Handle key press events."""
-        # print(event.keysym)
+        if self.waitingForInput:      #< During input mode, only allow editing after input start
+            if (self.compare("insert", "<=", self.inputLine) and event.keysym == "Left"):
+                return("break")
+            return(None)
+
         if self.suggestionManager.suggestionWindow and \
            self.suggestionManager.suggestionWindow.winfo_viewable():
             if event.keysym == "Escape":
@@ -293,13 +339,17 @@ class InteractiveConsoleText(StyledTextWindow):
         
         return(currentIndent)
 
-    def writeOutput(self, text, tag="output"):
+    def writeOutput(self, text, tag="output", loc="end"):
         """Write output to the console (thread-safe)."""
         def _write():
-            self.insert("end", text + "\n", tag)
+            self.insert(loc, text + "\n", tag)
             self.see("end")
         
         self.after(0, _write)
+    
+    def newline(self):
+        """Insert a newline at the end."""
+        self.writeOutput("")
 
     def getPromptPosition(self):
         """Get the position right after the prompt on current command line."""
@@ -326,16 +376,15 @@ class InteractiveConsoleText(StyledTextWindow):
             self.mark_set("insert", "end")
             self.see("end")
             self.isExecuting = False
-        
+
         if self.isExecuting:
             self.after(0, _add)
         else:
             _add()
     
-    def executeCommandThreaded(self, command):
+    def executeCommandThreaded(self, command, addPrompt=True):
         """Execute a command in a separate thread."""
         try:
-            # Try eval first for expressions
             result = eval(command, self.master.userGlobals, self.master.userLocals)
             if result is not None:
                 self.writeOutput(str(result), "result")
@@ -349,5 +398,7 @@ class InteractiveConsoleText(StyledTextWindow):
         except Exception:
             self.writeOutput(traceback.format_exc(), "error")
         
-        # Add new prompt after execution
-        self.addPrompt()
+        if addPrompt:
+            self.addPrompt()
+        else:
+            self.isExecuting = False

pysole/pysole.py

@@ -1,3 +1,5 @@
+import threading
+import time
 import customtkinter as ctk
 import tkinter as tk
 from tkinter import messagebox
@@ -6,7 +8,7 @@ import sys
 import io
 import json
 
-from .utils import settingsPath, themesPath
+from .utils import settingsPath, themesPath, stdPrint
 from .helpTab import HelpTab
 from .mainConsole import InteractiveConsoleText
 
@@ -35,15 +37,17 @@ class StdinRedirect(io.StringIO):
 
 class InteractiveConsole(ctk.CTk):
     """Main console window application."""
-    
-    def __init__(self, userGlobals=None, userLocals=None, callerFrame=None, theme=None, defaultSize=None, primaryPrompt=None):
+
+    def __init__(self, userGlobals=None, userLocals=None, callerFrame=None,
+                 defaultSize=None, primaryPrompt=None,
+                 runRemainingCode=False, printStartupCode=True):
         super().__init__()
         with open(settingsPath, "r") as f:
             settings = json.load(f)
         self.THEME = settings["THEME"]
         self.FONT = self.THEME["FONT"]
         self.BEHAVIOR = settings["BEHAVIOR"]
-        
+
         if primaryPrompt != None:
             self.BEHAVIOR["PRIMARY_PROMPT"] = primaryPrompt
         if defaultSize != None:
@@ -51,7 +55,7 @@ class InteractiveConsole(ctk.CTk):
 
         self.title("Live Interactive Console")
         self.geometry(self.BEHAVIOR["DEFAULT_SIZE"])
-        
+
         ctk.set_appearance_mode(self.THEME["APPEARANCE"])
         ctk.set_default_color_theme("blue")
 
@@ -63,17 +67,30 @@ class InteractiveConsole(ctk.CTk):
                 userGlobals = callerFrame.f_globals
             if userLocals is None:
                 userLocals = callerFrame.f_locals
-        
+
         self.userGlobals = userGlobals
         self.userLocals = userLocals
-        
+
         # Create UI
         self._createMenu()
         self._createUi()
-        
+
         # Redirect stdout/stderr
         self._setupOutputRedirect()
         self._setupInputRedirect()
+        
+        self.printStartupCode = printStartupCode
+        self.startupCode = ()
+        if runRemainingCode:
+            code_obj = callerFrame.f_code
+            filename = code_obj.co_filename
+
+            # Read the rest of the file after the call to probe()
+            with open(filename, "r", encoding="utf-8") as f:
+                lines = f.readlines()
+
+            startLine = callerFrame.f_lineno
+            self.startupCode = lines[startLine:]
 
     def _createMenu(self):
         """Create a menu bar using CTkOptionMenu."""
@@ -99,7 +116,7 @@ class InteractiveConsole(ctk.CTk):
             self._editSettings()
         elif choice == "Load Theme":
             self._loadTheme()
-    
+
     def _loadTheme(self):
         """
         Open a CTk popup to let the user choose a theme from themes.json.
@@ -218,28 +235,51 @@ class InteractiveConsole(ctk.CTk):
         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")
+            lambda text, tag: self.console.writeOutput(text, "error", "end")
         )
 
     def _setupInputRedirect(self):
         """Setup stdin redirection to console."""
         sys.stdin = StdinRedirect(self.console.readInput)
-    
+
+    def onClose(self):
+        sys.stdout = sys.__stdout__
+        sys.stderr = sys.__stderr__
+        self.destroy()
+
     def probe(self, *args, **kwargs):
         """Start the console main loop."""
+        def runStartup():
+            self.console.newline()
+            self.console.writeOutput("Welcome to Pysole, if you find me useful, please star me on github:\nhttps://github.com/TzurSoffer/Pysole", "instruction")
+            for line in self.startupCode:
+                line = line.rstrip()
+                while self.console.isExecuting:
+                    time.sleep(0.01)
+                if self.printStartupCode:
+                    self.console.runCommand(line, printCommand=True)
+                else:
+                    self.console.runCommand(line, printCommand=False)
+
+            if self.printStartupCode == False:
+                self.console.resetCurrentLineNumber()
+                self.console.addPrompt()
+        threading.Thread(target=runStartup).start()
         self.mainloop(*args, **kwargs)
 
-def probe(userGlobals=None, userLocals=None, callerFrame=None):
+def probe(userGlobals=None, userLocals=None, callerFrame=None, runRemainingCode=False, printStartupCode=False, **kwargs):
     if callerFrame == None:
         callerFrame = inspect.currentframe().f_back
     InteractiveConsole(userGlobals=userGlobals,
                               userLocals=userLocals,
-                              callerFrame=callerFrame).probe()
+                              callerFrame=callerFrame,
+                              runRemainingCode=runRemainingCode,
+                              printStartupCode=printStartupCode,
+                              **kwargs).probe()
 
 def _standalone():
     import pysole

pysole/settings.json

@@ -11,6 +11,7 @@
         "OUTPUT": "#ffffff",
         "ERROR": "#ff0000",
         "RESULT": "#66ccff",
+        "INSTRUCTION": "#ffff00",
         "SUGGESTION_BOX_BG": "#2d2d2d",
         "SUGGESTION_BOX_SELECTION_BG": "#0066cc",
         "FONT": {

pysole/styledTextbox.py

@@ -19,6 +19,7 @@ class StyledTextWindow(tk.Text):
         self.tag_configure("output", foreground=theme["OUTPUT"], font=(font["FONT"], font["FONT_SIZE"]))
         self.tag_configure("error", foreground=theme["ERROR"], font=(font["FONT"], font["FONT_SIZE"]))
         self.tag_configure("result", foreground=theme["RESULT"], font=(font["FONT"], font["FONT_SIZE"]))
+        self.tag_configure("instruction", foreground=theme["INSTRUCTION"], font=(font["FONT"], font["FONT_SIZE"]))
         
         # Configure syntax highlighting tags
         for token, style in self.style:

pysole/themes.json

@@ -11,6 +11,7 @@
         "OUTPUT": "#ffffff",
         "ERROR": "#ff0000",
         "RESULT": "#66ccff",
+        "INSTRUCTION": "#ffff00",
         "SUGGESTION_BOX_BG": "#2d2d2d",
         "SUGGESTION_BOX_SELECTION_BG": "#0066cc",
         "FONT": {
@@ -30,6 +31,7 @@
         "OUTPUT": "#000000",
         "ERROR": "#ff0000",
         "RESULT": "#0066cc",
+        "INSTRUCTION": "#ffff00",
         "SUGGESTION_BOX_BG": "#f0f0f0",
         "SUGGESTION_BOX_SELECTION_BG": "#cce6ff",
         "FONT": {
@@ -49,6 +51,7 @@
         "OUTPUT": "#586e75",
         "ERROR": "#dc322f",
         "RESULT": "#2aa198",
+        "INSTRUCTION": "#ffff00",
         "SUGGESTION_BOX_BG": "#eee8d5",
         "SUGGESTION_BOX_SELECTION_BG": "#b58900",
         "FONT": {
@@ -68,6 +71,7 @@
         "OUTPUT": "#f8f8f2",
         "ERROR": "#ff5555",
         "RESULT": "#8be9fd",
+        "INSTRUCTION": "#ffff00",
         "SUGGESTION_BOX_BG": "#44475a",
         "SUGGESTION_BOX_SELECTION_BG": "#6272a4",
         "FONT": {

pysole/utils.py

@@ -1,4 +1,10 @@
 import os
+import sys
 
 settingsPath = os.path.join(os.path.dirname(__file__), "settings.json")
 themesPath = os.path.join(os.path.dirname(__file__), "themes.json")
+
+def stdPrint(text):
+    """Print text to the terminal."""
+    sys.__stdout__.write(f"{text}\n")
+    sys.__stdout__.flush()

liveconsole-1.6.1.dist-info/RECORD

@@ -1,18 +0,0 @@
-liveconsole-1.6.1.dist-info/licenses/LICENSE,sha256=7dZ0zL72aGaFE0C9DxacOpnaSkC5jajhG6iL7lqhWmU,1064
-pysole/__init__.py,sha256=SfaSBmFVSmhyf55UedBCqhi2Ss6Tre-BCKtZb3bSr2k,60
-pysole/__main__.py,sha256=QvVFH8J2yzgQaF9MosQ6ajCW67uiRbYliePsTEUCIAg,82
-pysole/commandHistory.py,sha256=xJtWbJ_vgJo2QGgaZJsApTOi_Hm8Yz0V9_zqQUCItj8,1084
-pysole/helpTab.py,sha256=o0uSY-8sw7FuuBrt0FQwcgK6ljNVx3IgRnW7heZ6GvY,2454
-pysole/liveConsole.py,sha256=lzS3dphAQ1i8pQC4E2FY-FyMMSKi-dAN0xr6XUgrNmo,168
-pysole/mainConsole.py,sha256=9Kdjpe9rQzx3Nk9aBaECR3PlwAXszgRt4VfIJmVJnRw,13141
-pysole/pysole.py,sha256=vTmPvS4nzapVudNPtf2JrnwBWB-x_n-XxBsr4jW7MK8,9230
-pysole/settings.json,sha256=6wCdMlemV6PblPKeQQsIiCrGWPLDLOMFD3hLMVAXL24,687
-pysole/styledTextbox.py,sha256=zpbaN0qX5FduhNyuWGU7y8Ll8J9p9YqczpSuRLo4PX0,2120
-pysole/suggestionManager.py,sha256=EUFeCQoZnLS8EjPPNuZpzjY0BR07m2KP5TloyaMDVGY,6457
-pysole/themes.json,sha256=2RG3ohn2ZBc2-h9bdooQZD6hW5pD41a5c2jdaKDA4MA,2385
-pysole/utils.py,sha256=VN42ukHMJpOvGb7ZV-qhF_zRUt13hzJKV_uRn9t6580,155
-liveconsole-1.6.1.dist-info/METADATA,sha256=ScK9vL5BuDsaRSoUZicUfWx2wDDqYlonVtJlH5Di_f0,4011
-liveconsole-1.6.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-liveconsole-1.6.1.dist-info/entry_points.txt,sha256=qtvuJHcex4QqM97x_UawFWJYnfhQRl0jhqLcWRpnAGo,84
-liveconsole-1.6.1.dist-info/top_level.txt,sha256=DlpA93ScJbRZcF8kGSc5YoO8Ntu1ib1_MEZMb4xea_Q,7
-liveconsole-1.6.1.dist-info/RECORD,,