peek-python 1.6.1__tar.gz → 1.6.2.post1__tar.gz

{peek_python-1.6.1 → peek_python-1.6.2.post1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: peek-python
-Version: 1.6.1
+Version: 1.6.2.post1
 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/ycecream
@@ -11,6 +11,8 @@ Classifier: Programming Language :: Python :: 3 :: Only
 Requires-Python: >=3.6
 Description-Content-Type: text/markdown
 License-File: license.txt
+Requires-Dist: colorama
+Requires-Dist: six
 
  <img src="https://www.salabim.org/peek/peek_logo1.png">
 
@@ -1002,20 +1004,20 @@ peek("warning", level=2)
 With `peek.show_level()` the program may select which level(s) to show or not.
 
 This is done with a string that specifies which level(s) to show. The string
-consist of one or more specifiers seperated by a `,`. Each specifier may be simple value or a comparison operator
-followed by a value. Valid strings are
+consist of one or more specifiers seperated by a `,`. Each specifier may be simple value or a pair of values, seperated by a - . 
+Valid strings are
 
 * `peek.show_level("0")` ==> 0
 
 * `peek.show_level("0, 1 , 2")` ==> 0, 1, 2
 
-* `peek.show_level(">1")` ==> 1, 2, 3, ...
+* `peek.show_level("1-3")` ==> 1, 2, 3
 
-* `peek.show_level("<=2, >=6")` ==> 0, 1, 2, 6, 7. 8, ...
+* `peek.show_level("1-")` ==> 1, 2, 3, 4, ...
 
-* `peek.show_level("!=1")` ==> 0, 2, 3, 4, ...
+* `peek.show_level("-2")` ==> 0, 1, 2
 
-* `peek.show_level("==2")` ==> 2
+* `peek.show_level("-")` ==> 0, 1, 2, 3, ...
 
 Notice that a level matches if any of the specifiers conditions is met.
 
@@ -1027,7 +1029,7 @@ It is also possible to use a float value where the string is expected:
 Only peek with a level that meets any of the specifications is printed.
 
 An obvious use is to set the level of critical info to 0, important info to 1 and warning to 2.
-Then `peek.show_level = "<=1"` will show critical and important info, but no warning info.
+Then `peek.show_level = "-1"` will show critical and important info, but no warning info.
 
 The default show_level may, of course, be specified in a `peek.toml` file.
 
@@ -1040,6 +1042,13 @@ peek0 = peek.fork(color="red", level=0)
 peek1 = peek.fork(color="yellow", level=1)
 peek2 = peek.fork(color="green", level=2) 
 ```
+If level is the null string, peek will never print. That can be useful to disable peek debug info on a per peek instance basis:
+
+```peek_cond = peek.new()
+peek_cond(1)
+peek_cond.level = ""
+peek_cond(2)
+```
 
 # Interpreting the line number information
 

{peek_python-1.6.1 → peek_python-1.6.2.post1}/README.md

@@ -988,20 +988,20 @@ peek("warning", level=2)
 With `peek.show_level()` the program may select which level(s) to show or not.
 
 This is done with a string that specifies which level(s) to show. The string
-consist of one or more specifiers seperated by a `,`. Each specifier may be simple value or a comparison operator
-followed by a value. Valid strings are
+consist of one or more specifiers seperated by a `,`. Each specifier may be simple value or a pair of values, seperated by a - . 
+Valid strings are
 
 * `peek.show_level("0")` ==> 0
 
 * `peek.show_level("0, 1 , 2")` ==> 0, 1, 2
 
-* `peek.show_level(">1")` ==> 1, 2, 3, ...
+* `peek.show_level("1-3")` ==> 1, 2, 3
 
-* `peek.show_level("<=2, >=6")` ==> 0, 1, 2, 6, 7. 8, ...
+* `peek.show_level("1-")` ==> 1, 2, 3, 4, ...
 
-* `peek.show_level("!=1")` ==> 0, 2, 3, 4, ...
+* `peek.show_level("-2")` ==> 0, 1, 2
 
-* `peek.show_level("==2")` ==> 2
+* `peek.show_level("-")` ==> 0, 1, 2, 3, ...
 
 Notice that a level matches if any of the specifiers conditions is met.
 
@@ -1013,7 +1013,7 @@ It is also possible to use a float value where the string is expected:
 Only peek with a level that meets any of the specifications is printed.
 
 An obvious use is to set the level of critical info to 0, important info to 1 and warning to 2.
-Then `peek.show_level = "<=1"` will show critical and important info, but no warning info.
+Then `peek.show_level = "-1"` will show critical and important info, but no warning info.
 
 The default show_level may, of course, be specified in a `peek.toml` file.
 
@@ -1026,6 +1026,13 @@ peek0 = peek.fork(color="red", level=0)
 peek1 = peek.fork(color="yellow", level=1)
 peek2 = peek.fork(color="green", level=2) 
 ```
+If level is the null string, peek will never print. That can be useful to disable peek debug info on a per peek instance basis:
+
+```peek_cond = peek.new()
+peek_cond(1)
+peek_cond.level = ""
+peek_cond(2)
+```
 
 # Interpreting the line number information