liveConsole 1.6.2__py3-none-any.whl → 1.7.1__py3-none-any.whl

{liveconsole-1.6.2.dist-info → liveconsole-1.7.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: liveConsole
-Version: 1.6.2
+Version: 1.7.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
@@ -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.1.dist-info/RECORD

@@ -0,0 +1,18 @@
+liveconsole-1.7.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=AzAUSP5W1jUhYnnGUNOG8LUGPkRW8jOqOHlk-pJC_V4,15053
+pysole/pysole.py,sha256=anitwu82nowLlW1e3ukD3pde1zLu7CLfJ0YTXnqe5aU,11994
+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.1.dist-info/METADATA,sha256=UogN-5fZCBKdaIJLDYm-DiDQ2XYjvOCGxbf7VFrNYLs,4955
+liveconsole-1.7.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+liveconsole-1.7.1.dist-info/entry_points.txt,sha256=qtvuJHcex4QqM97x_UawFWJYnfhQRl0jhqLcWRpnAGo,84
+liveconsole-1.7.1.dist-info/top_level.txt,sha256=DlpA93ScJbRZcF8kGSc5YoO8Ntu1ib1_MEZMb4xea_Q,7
+liveconsole-1.7.1.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,16 +12,16 @@ 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"
@@ -28,10 +29,10 @@ class InteractiveConsoleText(StyledTextWindow):
         # Track current command
         self.currentCommandLine = 1
         self.isExecuting = False
-        
+
         # Setup bindings
         self._setupBindings()
-        
+
         # Initialize with first prompt
         self.addPrompt()
 
@@ -52,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:
@@ -73,6 +77,16 @@ class InteractiveConsoleText(StyledTextWindow):
         # 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:
@@ -94,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(
@@ -120,7 +135,7 @@ class InteractiveConsoleText(StyledTextWindow):
             args=(command,),
             daemon=True
         ).start()
-        
+
         return("break")
 
     def readInput(self):
@@ -324,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."""
@@ -357,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")
@@ -380,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,23 +37,30 @@ 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, font=None, fontSize=None,
+                 runRemainingCode=False, printStartupCode=False,
+                 removeWaterMark=False):
         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:
             self.BEHAVIOR["DEFAULT_SIZE"] = defaultSize
+        if font != None:
+            self.FONT["FONT"] = font
+        if fontSize != None:
+            self.FONT["FONT_SIZE"] = fontSize
 
         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 +72,32 @@ 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.runRemainingCode = runRemainingCode
+        self.printStartupCode = printStartupCode
+        self.removeWaterMark = removeWaterMark
+        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 +123,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 +242,71 @@ 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():
+            if not self.removeWaterMark:
+                m = (
+                    "Welcome to Pysole, if you find me useful, please star me on GitHub:\n"
+                    "https://github.com/TzurSoffer/Pysole"
+                )
+                stdPrint(m)
+                self.console.newline()
+                self.console.writeOutput(m, "instruction")
+                time.sleep(0.1)
+                if self.runRemainingCode:
+                    if self.printStartupCode:
+                        self.console.addPrompt()
+                    else:
+                        self.console.newline()
+                else:
+                    self.console.addPrompt()
+            elif self.runRemainingCode == True and self.printStartupCode == False:
+                self.console.newline()
+
+            for line in self.startupCode:
+                line = line.rstrip()
+                while self.console.isExecuting:
+                    time.sleep(0.01)
+                if self.printStartupCode:
+                    # self.console.writeOutput(line)
+                    self.console.runCommand(line, printCommand=True)
+                else:
+                    # self.console.writeOutput(line)
+                    self.console.runCommand(line, printCommand=False)
+
+            if self.runRemainingCode == True and 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.2.dist-info/RECORD

@@ -1,18 +0,0 @@
-liveconsole-1.6.2.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=CkZGUOxLhHRRb21gHfxRmuGOwf-H2T0feI9KDskXdgg,14397
-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.2.dist-info/METADATA,sha256=WSL_DMarxOF1Gvz0BzC1aL8PgyI_1WFP6LuIm2nAatw,4011
-liveconsole-1.6.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-liveconsole-1.6.2.dist-info/entry_points.txt,sha256=qtvuJHcex4QqM97x_UawFWJYnfhQRl0jhqLcWRpnAGo,84
-liveconsole-1.6.2.dist-info/top_level.txt,sha256=DlpA93ScJbRZcF8kGSc5YoO8Ntu1ib1_MEZMb4xea_Q,7
-liveconsole-1.6.2.dist-info/RECORD,,