peek-python 25.0.20__tar.gz → 25.0.22__tar.gz

{peek_python-25.0.20 → peek_python-25.0.22}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: peek-python
-Version: 25.0.20
+Version: 25.0.22
 Summary: peek - like print, but easy
 Author-email: Ruud van der Ham <rt.van.der.ham@gmail.com>
 Project-URL: Homepage, https://github.com/salabim/peek
@@ -467,7 +467,7 @@ prints something like
 1613635601 hello='world'
 ```
 
-output
+### output
 This will allow the output to be handled by something else than the default (output being written to stdout).
 
 The `output` attribute can be
@@ -1082,9 +1082,9 @@ Maybe more useful is to show the output change on the same line, e.g. a status.
 ```
 import time
 for i in range(50):
-  peek(f"time {time.time()}",end="\r")
-  time.sleep(0.1)
-peek('')
+    peek.print(f"time {time.time():10.2f}",end="", prefix="\r")
+    time.sleep(0.1)
+peek.print()
 ```
 > [!NOTE]
 >
@@ -1092,7 +1092,7 @@ peek('')
 
 > [!NOTE]
 >
-> `\r` does not work under Pythonista.
+> `Under Pythonista \r` has to be at the start of a peek.print output. Otherwise, it does not work.
 
 ### return_none
 Normally, `peek()`returns the values passed directly, which is usually fine. However, when used in a notebook
@@ -1134,7 +1134,7 @@ will print
 ```
 12 min(1, 2)=1 [0, 1, 2, 3]
 ```
-in yellow, but only if peek.enabled is False, nothing will be printed.
+in yellow, but if peek.enabled is False, nothing will be printed.
 
 You can also use peek.print (see below).
 
@@ -1192,7 +1192,7 @@ peek.sep = "|"  # sets the 'normal' peek separator
 
 
 ## Peeking locals and globals
-It is possible to get the name and values of all local or global variables.
+It is possible to get the names and values of all local or global variables.
 
 To do that, just put `locals` or `globals` in the call to peek, e.g.:
 
@@ -1280,10 +1280,10 @@ It is also possible to suppress output with the provided attribute (see above).
 
 ## Using filter to control peek output
 
-It is possible to define a filter function that determines whether peek output should be suppressed
+It is possible to define a filter function that determines whether peek output should be suppressed.
 By default, the filter is defined as "" denoting no filter.
 
-Suppose we a (float) level to a peek statement. By default, this level is 0. E.g.:
+Suppose we add a (float) level to a peek statement. By default, this level is 0. E.g.:
 
 ```
 peek("critical", level=0)
@@ -1291,7 +1291,7 @@ peek("important", level=1)
 peek("warning", level=2)
 ```
 
-With `peek.filter ="level <= 1"` the program makes sure that level=2 is not displayed at all.
+With `peek.filter = "level <= 1"` the program makes sure that level=2 is not displayed at all.
 
 It is possible to use more than one attribute, like
 

{peek_python-25.0.20 → peek_python-25.0.22}/README.md

@@ -450,7 +450,7 @@ prints something like
 1613635601 hello='world'
 ```
 
-output
+### output
 This will allow the output to be handled by something else than the default (output being written to stdout).
 
 The `output` attribute can be
@@ -1065,9 +1065,9 @@ Maybe more useful is to show the output change on the same line, e.g. a status.
 ```
 import time
 for i in range(50):
-  peek(f"time {time.time()}",end="\r")
-  time.sleep(0.1)
-peek('')
+    peek.print(f"time {time.time():10.2f}",end="", prefix="\r")
+    time.sleep(0.1)
+peek.print()
 ```
 > [!NOTE]
 >
@@ -1075,7 +1075,7 @@ peek('')
 
 > [!NOTE]
 >
-> `\r` does not work under Pythonista.
+> `Under Pythonista \r` has to be at the start of a peek.print output. Otherwise, it does not work.
 
 ### return_none
 Normally, `peek()`returns the values passed directly, which is usually fine. However, when used in a notebook
@@ -1117,7 +1117,7 @@ will print
 ```
 12 min(1, 2)=1 [0, 1, 2, 3]
 ```
-in yellow, but only if peek.enabled is False, nothing will be printed.
+in yellow, but if peek.enabled is False, nothing will be printed.
 
 You can also use peek.print (see below).
 
@@ -1175,7 +1175,7 @@ peek.sep = "|"  # sets the 'normal' peek separator
 
 
 ## Peeking locals and globals
-It is possible to get the name and values of all local or global variables.
+It is possible to get the names and values of all local or global variables.
 
 To do that, just put `locals` or `globals` in the call to peek, e.g.:
 
@@ -1263,10 +1263,10 @@ It is also possible to suppress output with the provided attribute (see above).
 
 ## Using filter to control peek output
 
-It is possible to define a filter function that determines whether peek output should be suppressed
+It is possible to define a filter function that determines whether peek output should be suppressed.
 By default, the filter is defined as "" denoting no filter.
 
-Suppose we a (float) level to a peek statement. By default, this level is 0. E.g.:
+Suppose we add a (float) level to a peek statement. By default, this level is 0. E.g.:
 
 ```
 peek("critical", level=0)
@@ -1274,7 +1274,7 @@ peek("important", level=1)
 peek("warning", level=2)
 ```
 
-With `peek.filter ="level <= 1"` the program makes sure that level=2 is not displayed at all.
+With `peek.filter = "level <= 1"` the program makes sure that level=2 is not displayed at all.
 
 It is possible to use more than one attribute, like
 

{peek_python-25.0.20 → peek_python-25.0.22}/peek/peek.py

@@ -4,7 +4,6 @@
 #  | .__/  \___| \___||_|\_\
 #  |_| like print, but easy.
 
-__version__ = "25.0.20"
 
 """
 See https://github.com/salabim/peek for details
@@ -15,6 +14,7 @@ Inspired by IceCream "Never use print() to debug again".
 Also contains some of the original code.
 IceCream was written by Ansgar Grunseid / grunseid.com / grunseid@gmail.com
 """
+
 import inspect
 import sys
 import datetime
@@ -32,14 +32,16 @@ import executing
 import types
 import pprint
 import builtins
-import traceback
 import shutil
 
+__version__ = "25.0.22"
+
 from pathlib import Path
 
 Pythonista = sys.platform == "ios"
 Pyodide = "pyodide" in sys.modules
 
+
 if Pythonista:
     import console
 else:
@@ -52,6 +54,7 @@ try:
 except ModuleNotFoundError:
     import tomli as tomlib
 
+
 class _Peek:
     name_alias_default = (
         # name, alias, default value, print_like accept?
@@ -184,7 +187,7 @@ class _Peek:
                 return
 
         elif name == "line_length":
-            if (isinstance(value, numbers.Number) and value >= 0) or value=='terminal_width':
+            if (isinstance(value, numbers.Number) and value >= 0) or value == "terminal_width":
                 return
 
         elif name == "indent":
@@ -248,18 +251,18 @@ class _Peek:
         _Peek.in_read_toml_message = f" in reading environment variable(s)"
         for environment_variable, value in os.environ.items():
             environment_variable = environment_variable.lower()
-            value=value.strip()
+            value = value.strip()
             if environment_variable.startswith("peek."):
                 attribute = environment_variable[5:]
                 if (value.startswith("'") and value.endswith("'")) or (value.startswith('"') and value.endswith('"')):
                     value = value[1:-1]
-                elif value.lower()=="true":
-                    value=True
-                elif value.lower()=="false":
-                    value=False
+                elif value.lower() == "true":
+                    value = True
+                elif value.lower() == "false":
+                    value = False
                 else:
                     try:
-                        value=int(value)
+                        value = int(value)
                     except ValueError:
                         ...
 
@@ -278,16 +281,20 @@ class _Peek:
 
     @staticmethod
     def print_pythonista_color(s, end="\n", file=sys.stdout):
+        cached = ""
         while s:
             for ansi, rgb in _Peek._ANSI_to_rgb.items():
                 if s.startswith(ansi):
+                    if cached:
+                        print(cached, end="", file=file)
+                        cached = ""
                     console.set_color(*tuple(v / 255 for v in rgb))
                     s = s[len(ansi) :]
                     break
             else:
-                print(s[0], end="", file=file)
+                cached += s[0]
                 s = s[1:]
-        print("", end=end, file=file)
+        print(cached + end, end="", file=file)
 
     def print_without_color(s, end="\n", file=sys.stdout):
         while s:
@@ -339,7 +346,7 @@ class _Peek:
         item = _Peek.de_alias(item)
         if item in _Peek.name_default or item == "delta1":
             node = self
-            while not item in node._attributes or node._attributes[item] is None:
+            while item not in node._attributes or node._attributes[item] is None:
                 node = node._parent
             if item == "delta":
                 return _Peek.perf_counter() - node._attributes["delta1"] + node._attributes["delta"]
@@ -383,7 +390,7 @@ class _Peek:
     def print(self, *args, as_str=False, **kwargs):
         if "print" in kwargs and "print_like" in kwargs:
             raise AttributeError("both print_like and print specified")
-        if not "print" in kwargs and not "print_like" in kwargs:
+        if "print" not in kwargs and "print_like" not in kwargs:
             kwargs["print_like"] = True
         return self(*args, as_str=as_str, **kwargs)
 
@@ -401,8 +408,8 @@ class _Peek:
 
         any_args = bool(args)
         this = self.fork(**kwargs)
-        if this.line_length in ( 0, 'terminal_width'):
-            this.line_length=shutil.get_terminal_size().columns
+        if this.line_length in (0, "terminal_width"):
+            this.line_length = shutil.get_terminal_size().columns
 
         this._as_str = as_str
 
@@ -615,7 +622,7 @@ class _Peek:
                         indent1_rest = wrap_indent
                         lines = [context]
                     else:
-                        indent1 = context.rstrip().ljust(len(wrap_indent)) 
+                        indent1 = context.rstrip().ljust(len(wrap_indent))
                         indent1_rest = wrap_indent
                         lines = []
                 else:
@@ -626,7 +633,7 @@ class _Peek:
                 for pair in pairs:
                     do_right = False
                     if "\n" in pair.left:
-                        for s in pair.left.splitlines():    
+                        for s in pair.left.splitlines():
                             lines.append(indent1 + s)
                             do_right = True
                     else:
@@ -659,7 +666,7 @@ class _Peek:
         if as_str:
             if this.do_show():
                 if this.use_color and this.color not in ("", "-"):
-                    out = f'{_Peek._color_name_to_ANSI[this.color.lower()]}{out}{_Peek._color_name_to_ANSI["-"]}'
+                    out = f"{_Peek._color_name_to_ANSI[this.color.lower()]}{out}{_Peek._color_name_to_ANSI['-']}"
                 return out + this.end
             else:
                 return ""
@@ -726,22 +733,23 @@ class _Peek:
     def do_output(self, s):
         if self.do_show():
             if self.use_color and self.color not in ("", "-"):
-                s = f'{_Peek._color_name_to_ANSI[self.color.lower()]}{s}{_Peek._color_name_to_ANSI["-"]}'
+                s = f"{_Peek._color_name_to_ANSI[self.color.lower()]}{s}{_Peek._color_name_to_ANSI['-']}"
+            s_end = s + self.end
 
             if callable(self.output):
                 if self.output == builtins.print or "end" in inspect.signature(self.output).parameters:
                     # test for builtins.print is required as for Python <= 3.10, builtins.print has no signature
-                    self.output(s, end=self.end)
+                    self.output(s_end, end="")
                 else:
-                    self.output(s + self.end)
+                    self.output(s_end)
             elif self.output in ("stdout", "stderr"):
                 file = sys.stdout if self.output == "stdout" else sys.stderr
                 if Pythonista:
-                    _Peek.print_pythonista_color(s, end=self.end, file=file)
+                    _Peek.print_pythonista_color(s_end, end="", file=file)
                 # elif Pyodide:  # not handled via use_color
                 #     _Peek.print_without_color(s, end=self.end, file=file)
                 else:
-                    print(s, end=self.end, file=file)
+                    print(s_end, end="", file=file)
             elif self.output == "logging.debug":
                 logging.debug(s)
             elif self.output == "logging.info":
@@ -756,12 +764,12 @@ class _Peek:
                 pass
             elif isinstance(self.output, str):
                 with open(self.output, "a+", encoding="utf-8") as f:
-                    print(s, file=f, end=self.end)
+                    print(s_end, file=f, end="")
             elif isinstance(self.output, Path):
                 with self.output.open("a+", encoding="utf-8") as f:
-                    print(s, file=f, end=self.end)
+                    print(s_end, file=f, end="")
             else:
-                print(s, file=self.output, end=self.end)
+                print(s_end, file=self.output, end="")
 
     def copy_to_clipboard(self, value, confirm=True):
         if Pythonista:
@@ -820,13 +828,12 @@ class _Peek:
         }
         if "width" in inspect.signature(self.serialize).parameters:
             kwargs["width"] = width
-        return self.add_color_value(self.serialize(obj, **kwargs).replace("\\n", "\n")) 
-    
+        return self.add_color_value(self.serialize(obj, **kwargs).replace("\\n", "\n"))
+
     def reset(self):
         reset()
 
 
-
 def reset():
     global _peek_no_toml
     global _peek_toml
@@ -855,9 +862,9 @@ class _PeekModule(types.ModuleType):
 
     def __str__(self):
         return str(peek)
-        
+
+
 reset()
 
 if __name__ != "__main__":
     sys.modules["peek"].__class__ = _PeekModule
-

{peek_python-25.0.20 → peek_python-25.0.22}/peek_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: peek-python
-Version: 25.0.20
+Version: 25.0.22
 Summary: peek - like print, but easy
 Author-email: Ruud van der Ham <rt.van.der.ham@gmail.com>
 Project-URL: Homepage, https://github.com/salabim/peek
@@ -467,7 +467,7 @@ prints something like
 1613635601 hello='world'
 ```
 
-output
+### output
 This will allow the output to be handled by something else than the default (output being written to stdout).
 
 The `output` attribute can be
@@ -1082,9 +1082,9 @@ Maybe more useful is to show the output change on the same line, e.g. a status.
 ```
 import time
 for i in range(50):
-  peek(f"time {time.time()}",end="\r")
-  time.sleep(0.1)
-peek('')
+    peek.print(f"time {time.time():10.2f}",end="", prefix="\r")
+    time.sleep(0.1)
+peek.print()
 ```
 > [!NOTE]
 >
@@ -1092,7 +1092,7 @@ peek('')
 
 > [!NOTE]
 >
-> `\r` does not work under Pythonista.
+> `Under Pythonista \r` has to be at the start of a peek.print output. Otherwise, it does not work.
 
 ### return_none
 Normally, `peek()`returns the values passed directly, which is usually fine. However, when used in a notebook
@@ -1134,7 +1134,7 @@ will print
 ```
 12 min(1, 2)=1 [0, 1, 2, 3]
 ```
-in yellow, but only if peek.enabled is False, nothing will be printed.
+in yellow, but if peek.enabled is False, nothing will be printed.
 
 You can also use peek.print (see below).
 
@@ -1192,7 +1192,7 @@ peek.sep = "|"  # sets the 'normal' peek separator
 
 
 ## Peeking locals and globals
-It is possible to get the name and values of all local or global variables.
+It is possible to get the names and values of all local or global variables.
 
 To do that, just put `locals` or `globals` in the call to peek, e.g.:
 
@@ -1280,10 +1280,10 @@ It is also possible to suppress output with the provided attribute (see above).
 
 ## Using filter to control peek output
 
-It is possible to define a filter function that determines whether peek output should be suppressed
+It is possible to define a filter function that determines whether peek output should be suppressed.
 By default, the filter is defined as "" denoting no filter.
 
-Suppose we a (float) level to a peek statement. By default, this level is 0. E.g.:
+Suppose we add a (float) level to a peek statement. By default, this level is 0. E.g.:
 
 ```
 peek("critical", level=0)
@@ -1291,7 +1291,7 @@ peek("important", level=1)
 peek("warning", level=2)
 ```
 
-With `peek.filter ="level <= 1"` the program makes sure that level=2 is not displayed at all.
+With `peek.filter = "level <= 1"` the program makes sure that level=2 is not displayed at all.
 
 It is possible to use more than one attribute, like
 

{peek_python-25.0.20 → peek_python-25.0.22}/pyproject.toml

@@ -10,7 +10,7 @@ authors = [
     { name = "Ruud van der Ham", email = "rt.van.der.ham@gmail.com" },
 ]
 description = "peek - like print, but easy"
-version = "25.0.20"
+version = "25.0.22"
 readme = "README.md"
 requires-python = ">=3.9"
 dependencies = [