rgwfuncs 0.0.85__py3-none-any.whl → 0.0.86__py3-none-any.whl

rgwfuncs/interactive_shell_lib.py

@@ -14,9 +14,10 @@ from .docs_lib import *  # noqa: F401, F403, E402
 def interactive_shell(local_vars: Dict[str, Any]) -> None:
     """
     Launch an interactive prompt for inspecting and modifying local variables,
-    with a custom blue output and white prompt. All helper definitions are nested within.
+    with blue-colored output and a prompt in white. An extra blank line is inserted
+    before each new input prompt.
     
-    local_vars: dictionary with local variables to be available in the interactive shell.
+    local_vars: dictionary of local variables to be available in the interactive shell.
     """
     
     # ANSI color escape codes.
@@ -24,7 +25,7 @@ def interactive_shell(local_vars: Dict[str, Any]) -> None:
     WHITE = "\033[37m"
     RESET = "\033[0m"
     
-    # Helper: setup readline for history persistence.
+    # Function to set up readline history.
     def setup_readline() -> None:
         HISTORY_FILE = os.path.expanduser("~/.rgwfuncs_shell_history")
         readline.set_history_length(1000)
@@ -36,18 +37,18 @@ def interactive_shell(local_vars: Dict[str, Any]) -> None:
                 print(f"Warning: Could not load history file: {e}")
         atexit.register(readline.write_history_file, HISTORY_FILE)
     
-    # Nested BlueStdout: a wrapper for sys.stdout that prepends blue color on output.
+    # BlueStdout: wrap stdout so output is printed in blue.
     class BlueStdout:
         def __init__(self, wrapped):
             self.wrapped = wrapped
             self.at_line_start = True
             
         def write(self, s):
-            # Do not interfere with the prompt strings.
+            # If s matches our prompt strings, write verbatim.
             if s == sys.ps1 or s == sys.ps2:
                 self.wrapped.write(s)
                 return
-            # Process output line by line.
+            # Write each new line in blue.
             lines = s.split('\n')
             for i, line in enumerate(lines):
                 if self.at_line_start and line:
@@ -72,13 +73,15 @@ def interactive_shell(local_vars: Dict[str, Any]) -> None:
         def __getattr__(self, attr):
             return getattr(self.wrapped, attr)
     
-    # Nested ColorInteractiveConsole: a subclass of InteractiveConsole that temporarily
-    # restores the original stdout when reading input so that readline functions properly.
+    # ColorInteractiveConsole: subclass InteractiveConsole to restore the original
+    # stdout during input, and print an extra blank line before each prompt.
     class ColorInteractiveConsole(code.InteractiveConsole):
         def raw_input(self, prompt=""):
             saved_stdout = sys.stdout
             sys.stdout = sys.__stdout__
             try:
+                # Print an extra newline before the prompt.
+                print("")
                 line = input(prompt)
             except EOFError:
                 raise
@@ -86,25 +89,23 @@ def interactive_shell(local_vars: Dict[str, Any]) -> None:
                 sys.stdout = saved_stdout
             return line
     
-    # Ensure that the passed local_vars is a dictionary.
+    # Validate that local_vars is a dictionary.
     if not isinstance(local_vars, dict):
         raise TypeError("local_vars must be a dictionary")
     
-    # Setup readline.
     setup_readline()
     
-    # Make imported functions available in the REPL by merging globals.
+    # Merge globals into local_vars.
     local_vars.update(globals())
     
-    # Wrap ANSI escape sequences in markers recognized by readline so that they do not count
-    # toward the visible prompt length.
+    # Wrap ANSI color codes with markers for zero-width in the prompt.
     sys.ps1 = "\001" + WHITE + "\002" + ">>> " + "\001" + RESET + "\002"
     sys.ps2 = "\001" + WHITE + "\002" + "... " + "\001" + RESET + "\002"
     
-    # Replace sys.stdout with our blue-printing wrapper.
+    # Use BlueStdout to wrap the original stdout.
     sys.stdout = BlueStdout(sys.__stdout__)
     
-    # Instantiate our custom interactive console.
+    # Create the custom interactive console.
     console = ColorInteractiveConsole(locals=local_vars)
     
     banner = ("Welcome to the rgwfuncs interactive shell.\n"

{rgwfuncs-0.0.85.dist-info → rgwfuncs-0.0.86.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: rgwfuncs
-Version: 0.0.85
+Version: 0.0.86
 Summary: A functional programming paradigm for mathematical modelling and data science
 Home-page: https://github.com/ryangerardwilson/rgwfunc
 Author: Ryan Gerard Wilson

{rgwfuncs-0.0.85.dist-info → rgwfuncs-0.0.86.dist-info}/RECORD

@@ -2,11 +2,11 @@ rgwfuncs/__init__.py,sha256=LSn54Tlyskcb6Wab_wUpPLB6UGMe5LdrB3GU88mDEbU,1712
 rgwfuncs/algebra_lib.py,sha256=rKFITfpWfgdBswnbMUuS41XgndEt-jUVz2ObO_ik7eM,42234
 rgwfuncs/df_lib.py,sha256=r6T-MwyDq9NAPW1Xf6NzSy7ZFicIKdemR-UKu6TZt5g,71111
 rgwfuncs/docs_lib.py,sha256=y3wSAOPO3qsA4HZ7xAtW8HimM8w-c8hjcEzMRLJ96ao,1960
-rgwfuncs/interactive_shell_lib.py,sha256=zM4WrG425WK3MsPOfSgxvJxRJsUV177IYrSGvE-uAQE,4254
+rgwfuncs/interactive_shell_lib.py,sha256=rebSWi6L8akWA9LlQXjv9jlG2VoT9B8PqgCB4Oz9hEc,4177
 rgwfuncs/str_lib.py,sha256=rtAdRlnSJIu3JhI-tA_A0wCiPK2m-zn5RoGpBxv_g-4,2228
-rgwfuncs-0.0.85.dist-info/LICENSE,sha256=jLvt20gcUZYB8UOvyBvyKQ1qhYYhD__qP7ZDx2lPFkU,1062
-rgwfuncs-0.0.85.dist-info/METADATA,sha256=28YYKElMTP4Fm5TnxB8iU2F088nrhzQEg8YhM1XaoI4,60288
-rgwfuncs-0.0.85.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-rgwfuncs-0.0.85.dist-info/entry_points.txt,sha256=j-c5IOPIQ0252EaOV6j6STio56sbXl2C4ym_fQ0lXx0,43
-rgwfuncs-0.0.85.dist-info/top_level.txt,sha256=aGuVIzWsKiV1f2gCb6mynx0zx5ma0B1EwPGFKVEMTi4,9
-rgwfuncs-0.0.85.dist-info/RECORD,,
+rgwfuncs-0.0.86.dist-info/LICENSE,sha256=jLvt20gcUZYB8UOvyBvyKQ1qhYYhD__qP7ZDx2lPFkU,1062
+rgwfuncs-0.0.86.dist-info/METADATA,sha256=pY5udapgOBioWgi1uxLFdPyGIxj9q9BRioqVxZzLYlI,60288
+rgwfuncs-0.0.86.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+rgwfuncs-0.0.86.dist-info/entry_points.txt,sha256=j-c5IOPIQ0252EaOV6j6STio56sbXl2C4ym_fQ0lXx0,43
+rgwfuncs-0.0.86.dist-info/top_level.txt,sha256=aGuVIzWsKiV1f2gCb6mynx0zx5ma0B1EwPGFKVEMTi4,9
+rgwfuncs-0.0.86.dist-info/RECORD,,