peek-python 25.0.0__tar.gz → 25.0.1__tar.gz

{peek_python-25.0.0 → peek_python-25.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: peek-python
-Version: 25.0.0
+Version: 25.0.1
 Summary: peek - debugging and benchmarking made easy
 Author-email: Ruud van der Ham <rt.van.der.ham@gmail.com>
 Project-URL: Homepage, https://github.com/salabim/peek
@@ -50,11 +50,11 @@ And on top of that, you get some basic benchmarking functionality.
 
 * [Disabling peek's output](#disabling-peeks-output)
 
-* [Using level to control peek output](#Using-level-to-control-peek-output)
+* [Using level to control peek output](#using-level-to-control-peek-output)
 
-* [Using color to control peek output](#Using-color-to-control-peek-output)
+* [Using color to control peek output](#using-color-to-control-peek-output)
 
-* [Copying to the clipboard](#Copying-to-the-clipboard)
+* [Copying to the clipboard](#copying-to-the-clipboard)
 
 * [Interpreting the line number information](#interpreting-the-line-number-information)
 
@@ -346,6 +346,7 @@ enabled                 -               True
 end                     -               "\n"
 equals_separator        -               "="
 filter                  f               ""
+format                  fmt             ""
 indent                  -               1
 level                   lvl             0
 line_length             ll              80
@@ -905,7 +906,42 @@ This will print:
 >
 > This setting does not influence how strings are displayed within other data structures, like dicts and lists.
 
+## format / fmt
+With the format attribute, it is possible to apply a format specifier to each of the values to be printed, like
+```
+test_float = 1.3
+peek(test_float, format="06.3f")
+```
+This will print
+```
+test_float=01.300
+```
+
+The format should be like the Python format specifiers, with or without the `:` prefix, like `"6.3f"`, `">10"`, `"06d"`, `:6.3d`.
+It is also possible to use the `!` format specifier: `"!r"`, `"!r:>10"`.
+
+If format is the null string (`""`) (the default), this functionality is skipped completely.
+
+It is also possible to use a list (or tuple) of format specifiers, which are tried in succession. If they all fail, the 'normal' serializer will be used.
+
+```
+test_float = 1.3
+test_integer=10
+test_string = "test"
+test_dict=dict(one=1, two=2)
+peek(test_float, test_integer, test_string, test_dict, format=["04d", "06.3f", ">10"])
+```
+
+will result in
+
+```
+test_float=01.300, test_integer=0010, test_string=      test, test_dict={'one': 1, 'two': 2}
+```
+
+Of course, format may be put in a peek.toml file.
+
 ## values_only / vo
+
 If False (the default), both the left-hand side (if possible) and the
 value will be printed. If True, the left hand side will be suppressed:
 

{peek_python-25.0.0 → peek_python-25.0.1}/README.md

@@ -30,11 +30,11 @@ And on top of that, you get some basic benchmarking functionality.
 
 * [Disabling peek's output](#disabling-peeks-output)
 
-* [Using level to control peek output](#Using-level-to-control-peek-output)
+* [Using level to control peek output](#using-level-to-control-peek-output)
 
-* [Using color to control peek output](#Using-color-to-control-peek-output)
+* [Using color to control peek output](#using-color-to-control-peek-output)
 
-* [Copying to the clipboard](#Copying-to-the-clipboard)
+* [Copying to the clipboard](#copying-to-the-clipboard)
 
 * [Interpreting the line number information](#interpreting-the-line-number-information)
 
@@ -326,6 +326,7 @@ enabled                 -               True
 end                     -               "\n"
 equals_separator        -               "="
 filter                  f               ""
+format                  fmt             ""
 indent                  -               1
 level                   lvl             0
 line_length             ll              80
@@ -885,7 +886,42 @@ This will print:
 >
 > This setting does not influence how strings are displayed within other data structures, like dicts and lists.
 
+## format / fmt
+With the format attribute, it is possible to apply a format specifier to each of the values to be printed, like
+```
+test_float = 1.3
+peek(test_float, format="06.3f")
+```
+This will print
+```
+test_float=01.300
+```
+
+The format should be like the Python format specifiers, with or without the `:` prefix, like `"6.3f"`, `">10"`, `"06d"`, `:6.3d`.
+It is also possible to use the `!` format specifier: `"!r"`, `"!r:>10"`.
+
+If format is the null string (`""`) (the default), this functionality is skipped completely.
+
+It is also possible to use a list (or tuple) of format specifiers, which are tried in succession. If they all fail, the 'normal' serializer will be used.
+
+```
+test_float = 1.3
+test_integer=10
+test_string = "test"
+test_dict=dict(one=1, two=2)
+peek(test_float, test_integer, test_string, test_dict, format=["04d", "06.3f", ">10"])
+```
+
+will result in
+
+```
+test_float=01.300, test_integer=0010, test_string=      test, test_dict={'one': 1, 'two': 2}
+```
+
+Of course, format may be put in a peek.toml file.
+
 ## values_only / vo
+
 If False (the default), both the left-hand side (if possible) and the
 value will be printed. If True, the left hand side will be suppressed:
 

{peek_python-25.0.0 → peek_python-25.0.1}/peek/peek.py

@@ -4,7 +4,7 @@
 #  | .__/  \___| \___||_|\_\
 #  |_| like print, but easy.
 
-__version__ = "25.0.0"
+__version__ = "25.0.1"
 
 """
 See https://github.com/salabim/peek for details
@@ -65,6 +65,7 @@ class _Peek:
         ("end", "", "\n"),
         ("equals_separator", "", "="),
         ("filter", "f", ""),
+        ("format", "fmt", ""),
         ("indent", "", 1),
         ("level", "lvl", 0),
         ("line_length", "ll", 80),
@@ -180,6 +181,15 @@ class _Peek:
                 if value > 0:
                     return
 
+        elif name == "format":
+            if isinstance(value, str):
+                return
+            try:
+                if all(isinstance(sub_format, str) for sub_format in value):
+                    return
+            except TypeError:
+                ...
+
         elif name == "filter":
             if value.strip() == "":
                 return
@@ -701,6 +711,17 @@ class _Peek:
             return ""
 
     def serialize_kwargs(self, obj, width):
+        if self.format:
+            if isinstance(self.format, str):
+                iterator=iter([self.format])
+            else:
+                iterator=iter(self.format)
+            for sub_format in iterator:
+                format_string = "{" + sub_format + "}" if sub_format.startswith(":") or sub_format.startswith("!") else "{:" + sub_format + "}"
+                try:
+                    return format_string.format(obj)
+                except Exception:
+                    ...
         if isinstance(obj, str):
             if not self.quote_string:
                 return str(self.add_color_value(obj))

{peek_python-25.0.0 → peek_python-25.0.1}/peek_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: peek-python
-Version: 25.0.0
+Version: 25.0.1
 Summary: peek - debugging and benchmarking made easy
 Author-email: Ruud van der Ham <rt.van.der.ham@gmail.com>
 Project-URL: Homepage, https://github.com/salabim/peek
@@ -50,11 +50,11 @@ And on top of that, you get some basic benchmarking functionality.
 
 * [Disabling peek's output](#disabling-peeks-output)
 
-* [Using level to control peek output](#Using-level-to-control-peek-output)
+* [Using level to control peek output](#using-level-to-control-peek-output)
 
-* [Using color to control peek output](#Using-color-to-control-peek-output)
+* [Using color to control peek output](#using-color-to-control-peek-output)
 
-* [Copying to the clipboard](#Copying-to-the-clipboard)
+* [Copying to the clipboard](#copying-to-the-clipboard)
 
 * [Interpreting the line number information](#interpreting-the-line-number-information)
 
@@ -346,6 +346,7 @@ enabled                 -               True
 end                     -               "\n"
 equals_separator        -               "="
 filter                  f               ""
+format                  fmt             ""
 indent                  -               1
 level                   lvl             0
 line_length             ll              80
@@ -905,7 +906,42 @@ This will print:
 >
 > This setting does not influence how strings are displayed within other data structures, like dicts and lists.
 
+## format / fmt
+With the format attribute, it is possible to apply a format specifier to each of the values to be printed, like
+```
+test_float = 1.3
+peek(test_float, format="06.3f")
+```
+This will print
+```
+test_float=01.300
+```
+
+The format should be like the Python format specifiers, with or without the `:` prefix, like `"6.3f"`, `">10"`, `"06d"`, `:6.3d`.
+It is also possible to use the `!` format specifier: `"!r"`, `"!r:>10"`.
+
+If format is the null string (`""`) (the default), this functionality is skipped completely.
+
+It is also possible to use a list (or tuple) of format specifiers, which are tried in succession. If they all fail, the 'normal' serializer will be used.
+
+```
+test_float = 1.3
+test_integer=10
+test_string = "test"
+test_dict=dict(one=1, two=2)
+peek(test_float, test_integer, test_string, test_dict, format=["04d", "06.3f", ">10"])
+```
+
+will result in
+
+```
+test_float=01.300, test_integer=0010, test_string=      test, test_dict={'one': 1, 'two': 2}
+```
+
+Of course, format may be put in a peek.toml file.
+
 ## values_only / vo
+
 If False (the default), both the left-hand side (if possible) and the
 value will be printed. If True, the left hand side will be suppressed:
 

{peek_python-25.0.0 → peek_python-25.0.1}/pyproject.toml

@@ -10,7 +10,7 @@ authors = [
     { name = "Ruud van der Ham", email = "rt.van.der.ham@gmail.com" },
 ]
 description = "peek - debugging and benchmarking made easy"
-version = "25.0.0"
+version = "25.0.1"
 readme = "README.md"
 requires-python = ">=3.6"
 dependencies = [