Add small utility script for dumping dbm based databases.

Use it to dump dbm based files like db/sessions (records session keys)
or db/otks (records one time key for password recovery, data for rate
limiting logins and rest interface and other short duration data).

Author: rouilj

CHANGES.txt

@@ -104,6 +104,8 @@ Features:
   issue23#msg24 could jump to the element with id msg24 in issue 23.
   Before this patch you would have two links issue23 and msg24
   separated by # (John Rouillard).
+- added small utility script to dump dbm based tracker databases
+  (e.g. db/sessions). (John Rouillard)
 
 
 2021-07-13 2.1.0

scripts/README.txt

@@ -7,6 +7,10 @@ add-issue
 copy-user.py
  Copy one or more Roundup users from one tracker instance to another. 
 
+dump_dbm_sessions_db.py
+ Simple script to dump a session style dbm database e.g. db/otks or
+ db/sessions in readable form.
+ 
 imapServer.py
  This IMAP server script that runs in the background and checks for new
  email from a variety of mailboxes.

scripts/dump_dbm_sessions_db.py

@@ -0,0 +1,35 @@
+#! /usr/bin/env python3
+"""Usage: dump_dbm_sessions_db.py [filename]
+
+Simple script to dump the otks and sessions dbm databases.  Dumps
+sessions db in current directory if no argument is given.
+
+Dump format:
+
+   key: <timestamp> data
+
+where <timestamp> is the human readable __timestamp decoded from the
+data object.
+
+""""
+
+import dbm, marshal, sys
+from datetime import datetime
+
+try:
+  file = sys.argv[1]
+except IndexError:
+  file="sessions"
+
+try:
+   db = dbm.open(file)
+except Exception:
+   print("Unable to open database: %s"%file)
+   exit(1)
+
+k = db.firstkey()
+while k is not None:
+    d = marshal.loads(db[k])
+    t = datetime.fromtimestamp(d['__timestamp'])
+    print("%s: %s %s"%(k, t, d))
+    k = db.nextkey(k)