add kibitzr stash command

CHANGELOG.md

@@ -2,6 +2,11 @@
 
 ## Unreleased
 
+## [5.1.1] - 2018-04-19
+
+## Added
+- `kibitzr stash` command to show stash contents.
+
 ## [5.1.0] - 2018-04-10
 
 ## Added

docs/stash.rst

@@ -8,15 +8,20 @@ Overview
 --------
 
 Kibitzr maintains persistent key-value storage - ``stash``.
-All data inside ``stash`` is accessible inside all checks.
-It is meant to be populated in notify.
-Than it can be referred from :ref:`python-fetcher` and :ref:`jinja transform`.
+All data inside ``stash`` is accessible inside all checks
+and can be referred from :ref:`python-fetcher` and :ref:`jinja transform`.
 
-Stash keys are populated in notifies.
+Stash keys are populated in notify.
 Use ``stash`` notifier and provide it key-value dictionary.
 Each value is a Jinja template.
 It has access to the same context as Jinja transform.
 
+Stored values can be printed with command:
+
+.. code-block:: shell
+
+    $ kibitzr stash
+
 Example
 -------
 

kibitzr/cli.py

@@ -64,8 +64,9 @@ def init():
 @cli.command()
 def telegram_chat():
     """Return chat id for the last message sent to Telegram Bot"""
-    from kibitzr.main import telegram_chat
-    telegram_chat()
+    # rename import to escape name clashing:
+    from kibitzr.main import telegram_chat as kilogram
+    kilogram()
 
 
 @cli.command()
@@ -75,5 +76,12 @@ def clean():
     PageHistory.clean()
 
 
+@cli.command()
+def stash():
+    """Print stash contents"""
+    from kibitzr.stash import Stash
+    Stash.print_content()
+
+
 if __name__ == "__main__":
     cli()

kibitzr/stash.py

@@ -24,6 +24,11 @@ def write(self, data):
             for key, value in data.items():
                 db[key] = value
 
+    @classmethod
+    def print_content(cls):
+        for key, value in cls().read().items():
+            print("{0}: {1}".format(key, value))
+
 
 class LazyStash(Stash):
     def __init__(self):