peek-python 1.8.0__tar.gz → 1.8.1__tar.gz

{peek_python-1.8.0 → peek_python-1.8.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: peek-python
-Version: 1.8.0
+Version: 1.8.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/ycecream
@@ -16,6 +16,7 @@ Requires-Dist: six
 Requires-Dist: executing
 Requires-Dist: asttokens
 Requires-Dist: tomli
+Requires-Dist: pyperclip
 
  <img src="https://www.salabim.org/peek/peek_logo1.png">
 
@@ -49,6 +50,8 @@ And on top of that, you get some basic benchmarking functionality.
 
 * [Using level to control peek output](#Using-level-to-control-peek-output)
 
+* [Copying to the clipboard](#Copying-to-the-clipboard)
+
 * [Speeding up disabled peek](#speeding-up-disabled-peek)
 
 * [Using peek as a substitute for `assert`](#using-peek-as-a-substitute-for-assert)
@@ -91,7 +94,7 @@ pip install peek-python --upgrade
 
 Alternatively, peek.py can be just copied into you current work directory from GitHub (https://github.com/salabim/peek).
 
-Note that peek requires the `asttokens`,  `colorama`, `executing`. `six` and `tomli` modules, all of which will be automatically installed.
+Note that peek requires the `asttokens`,  `colorama`, `executing`. `six`,  tomli and pyperclip` modules, all of which will be automatically installed.
 
 # Importing peek
 
@@ -1054,14 +1057,15 @@ This will print only 1.
 
 The most easy form for `peek.show_level` is just a simple value as argument, like `peek.show.level(2)`, which will make only level 2 peeks to work.
 
-`peek.show_level` can have a number (usualy 1) of arguments. Each parameter may be a float value or a string of the format
+`peek.show_level` can have a number (usually 1) of arguments.
 
-- <from>
-- <from>-<to>
+Each parameter may be:
 
-both <from> and >to> are optional. If<from> is omitted, -1E30 is assumed. If <to> is omitted, 1E30 is assumed. 
+* a float value or
 
-Negative values have to be parenthesized.
+- a string with the format *from* - *to*
+  , where both *from* and *to* are optional. If *from* is omitted, -1E30 is assumed. If *to* is omitted, 1E30 is assumed. 
+  Negative values have to be parenthesized.
 
 Examples:
 
@@ -1094,7 +1098,26 @@ Examples:
 
 This will print one line with`1` only.
 
+# Copying to the clipboard
+It is possible to copy a value to the clipbaord with the method `to_clipboard` which accepts a value to be copied to the clipboard.
+So,
+
+```
+part1 = 1234
+peek.to_clipboard(part1)
+```
+
+will copy `1234` to the clipboard and write `copied to clipboard: 1234` to the console.
+If the confirmation message is not wanted, just add confirm=False, like
+
+```
+peek.to_clipboard(part1, confirm=False)
+```
+
+Implementation detail: this functionality uses pyperclip, apart from under Pythonista, whre the
+builtin clipboard module is used.
 
+This functionality is particularly useful for entering an answer of an *Advent of Code* solution to the site.
 
 # Interpreting the line number information
 

{peek_python-1.8.0 → peek_python-1.8.1}/README.md

@@ -30,6 +30,8 @@ And on top of that, you get some basic benchmarking functionality.
 
 * [Using level to control peek output](#Using-level-to-control-peek-output)
 
+* [Copying to the clipboard](#Copying-to-the-clipboard)
+
 * [Speeding up disabled peek](#speeding-up-disabled-peek)
 
 * [Using peek as a substitute for `assert`](#using-peek-as-a-substitute-for-assert)
@@ -72,7 +74,7 @@ pip install peek-python --upgrade
 
 Alternatively, peek.py can be just copied into you current work directory from GitHub (https://github.com/salabim/peek).
 
-Note that peek requires the `asttokens`,  `colorama`, `executing`. `six` and `tomli` modules, all of which will be automatically installed.
+Note that peek requires the `asttokens`,  `colorama`, `executing`. `six`,  tomli and pyperclip` modules, all of which will be automatically installed.
 
 # Importing peek
 
@@ -1035,14 +1037,15 @@ This will print only 1.
 
 The most easy form for `peek.show_level` is just a simple value as argument, like `peek.show.level(2)`, which will make only level 2 peeks to work.
 
-`peek.show_level` can have a number (usualy 1) of arguments. Each parameter may be a float value or a string of the format
+`peek.show_level` can have a number (usually 1) of arguments.
 
-- <from>
-- <from>-<to>
+Each parameter may be:
 
-both <from> and >to> are optional. If<from> is omitted, -1E30 is assumed. If <to> is omitted, 1E30 is assumed. 
+* a float value or
 
-Negative values have to be parenthesized.
+- a string with the format *from* - *to*
+  , where both *from* and *to* are optional. If *from* is omitted, -1E30 is assumed. If *to* is omitted, 1E30 is assumed. 
+  Negative values have to be parenthesized.
 
 Examples:
 
@@ -1075,7 +1078,26 @@ Examples:
 
 This will print one line with`1` only.
 
+# Copying to the clipboard
+It is possible to copy a value to the clipbaord with the method `to_clipboard` which accepts a value to be copied to the clipboard.
+So,
+
+```
+part1 = 1234
+peek.to_clipboard(part1)
+```
+
+will copy `1234` to the clipboard and write `copied to clipboard: 1234` to the console.
+If the confirmation message is not wanted, just add confirm=False, like
+
+```
+peek.to_clipboard(part1, confirm=False)
+```
+
+Implementation detail: this functionality uses pyperclip, apart from under Pythonista, whre the
+builtin clipboard module is used.
 
+This functionality is particularly useful for entering an answer of an *Advent of Code* solution to the site.
 
 # Interpreting the line number information
 

{peek_python-1.8.0 → peek_python-1.8.1}/peek/peek.py

@@ -4,7 +4,7 @@
 #  | .__/  \___| \___||_|\_\
 #  |_| like print, but easy.
 
-__version__ = "1.8.0"
+__version__ = "1.8.1"
 
 """
 See https://github.com/salabim/peek for details
@@ -40,8 +40,10 @@ from pathlib import Path
 Pythonista = sys.platform == "ios"
 if Pythonista:
     import console
+    import clipboard
 else:
     import colorama
+    import pyperclip
 
 try:
     import tomlib
@@ -479,6 +481,15 @@ class _Peek:
     def fork(self, **kwargs):
         kwargs["_parent"] = self
         return _Peek(**kwargs)
+        
+    def to_clipboard(self, value, confirm=True):
+        if Pythonista:
+            clipboard.set(str(value))
+        else:
+            pyperclip.copy(str(value))
+        if confirm:
+            print(f'copied to clipboard: {value}')            
+                 
 
     def __call__(self, *args, **kwargs):
         prefix = kwargs.pop("prefix", nv)
@@ -941,7 +952,6 @@ class _Peek:
                 logging.critical(s)
             elif self.output in ("", "null"):
                 pass
-
             elif isinstance(self.output, str):
                 with open(self.output, "a+", encoding="utf-8") as f:
                     print(s, file=f)

{peek_python-1.8.0 → peek_python-1.8.1}/peek_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: peek-python
-Version: 1.8.0
+Version: 1.8.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/ycecream
@@ -16,6 +16,7 @@ Requires-Dist: six
 Requires-Dist: executing
 Requires-Dist: asttokens
 Requires-Dist: tomli
+Requires-Dist: pyperclip
 
  <img src="https://www.salabim.org/peek/peek_logo1.png">
 
@@ -49,6 +50,8 @@ And on top of that, you get some basic benchmarking functionality.
 
 * [Using level to control peek output](#Using-level-to-control-peek-output)
 
+* [Copying to the clipboard](#Copying-to-the-clipboard)
+
 * [Speeding up disabled peek](#speeding-up-disabled-peek)
 
 * [Using peek as a substitute for `assert`](#using-peek-as-a-substitute-for-assert)
@@ -91,7 +94,7 @@ pip install peek-python --upgrade
 
 Alternatively, peek.py can be just copied into you current work directory from GitHub (https://github.com/salabim/peek).
 
-Note that peek requires the `asttokens`,  `colorama`, `executing`. `six` and `tomli` modules, all of which will be automatically installed.
+Note that peek requires the `asttokens`,  `colorama`, `executing`. `six`,  tomli and pyperclip` modules, all of which will be automatically installed.
 
 # Importing peek
 
@@ -1054,14 +1057,15 @@ This will print only 1.
 
 The most easy form for `peek.show_level` is just a simple value as argument, like `peek.show.level(2)`, which will make only level 2 peeks to work.
 
-`peek.show_level` can have a number (usualy 1) of arguments. Each parameter may be a float value or a string of the format
+`peek.show_level` can have a number (usually 1) of arguments.
 
-- <from>
-- <from>-<to>
+Each parameter may be:
 
-both <from> and >to> are optional. If<from> is omitted, -1E30 is assumed. If <to> is omitted, 1E30 is assumed. 
+* a float value or
 
-Negative values have to be parenthesized.
+- a string with the format *from* - *to*
+  , where both *from* and *to* are optional. If *from* is omitted, -1E30 is assumed. If *to* is omitted, 1E30 is assumed. 
+  Negative values have to be parenthesized.
 
 Examples:
 
@@ -1094,7 +1098,26 @@ Examples:
 
 This will print one line with`1` only.
 
+# Copying to the clipboard
+It is possible to copy a value to the clipbaord with the method `to_clipboard` which accepts a value to be copied to the clipboard.
+So,
+
+```
+part1 = 1234
+peek.to_clipboard(part1)
+```
+
+will copy `1234` to the clipboard and write `copied to clipboard: 1234` to the console.
+If the confirmation message is not wanted, just add confirm=False, like
+
+```
+peek.to_clipboard(part1, confirm=False)
+```
+
+Implementation detail: this functionality uses pyperclip, apart from under Pythonista, whre the
+builtin clipboard module is used.
 
+This functionality is particularly useful for entering an answer of an *Advent of Code* solution to the site.
 
 # Interpreting the line number information
 

{peek_python-1.8.0 → peek_python-1.8.1}/peek_python.egg-info/requires.txt

@@ -3,3 +3,4 @@ six
 executing
 asttokens
 tomli
+pyperclip

{peek_python-1.8.0 → peek_python-1.8.1}/pyproject.toml

@@ -8,10 +8,10 @@ authors = [
     {name = "Ruud van der Ham", email = "rt.van.der.ham@gmail.com"}
 ]
 description = "peek - debugging and benchmarking made easy"
-version = "1.8.0"
+version = "1.8.1"
 readme = "README.md"
 requires-python = ">=3.6"
-dependencies = ["colorama","six","executing","asttokens","tomli"]
+dependencies = ["colorama","six","executing","asttokens","tomli","pyperclip"]
 
 classifiers = [
   "Development Status :: 5 - Production/Stable",