[Zope-Checkins] CVS: ZODB3/ZODB - fsdump.py:1.13

[Jeremy Hylton]

Update of /cvs-repository/ZODB3/ZODB
In directory cvs.zope.org:/tmp/cvs-serv29901

Modified Files:
	fsdump.py 
Log Message:
Add a small feature from Dieter-- start and stop flags on fsdump().
Also add docstring, copyright notice.


=== ZODB3/ZODB/fsdump.py 1.12 => 1.13 ===
--- ZODB3/ZODB/fsdump.py:1.12	Tue Oct 14 13:50:29 2003
+++ ZODB3/ZODB/fsdump.py	Wed Nov 12 00:00:43 2003
@@ -1,3 +1,29 @@
+##############################################################################
+#
+# Copyright (c) 2002 Zope Corporation and Contributors.
+# All Rights Reserved.
+#
+# This software is subject to the provisions of the Zope Public License,
+# Version 2.0 (ZPL).  A copy of the ZPL should accompany this distribution.
+# THIS SOFTWARE IS PROVIDED "AS IS" AND ANY AND ALL EXPRESS OR IMPLIED
+# WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+# WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST INFRINGEMENT, AND FITNESS
+# FOR A PARTICULAR PURPOSE
+#
+##############################################################################
+"""Low-level text dumps of FileStorage contents.
+
+fsdump() prints a two-line summary of each transaction and a one-line
+summary of each data record in that transaction.  This report is often
+useful when analyzing a storage's contents.
+
+Dumper() prints a very detailed representation of the contents.  Each
+header field is printed on a separate line.  This produces lots of
+data that is useful when debugging the storage implementation.
+"""
+
+from ZODB.FileStorage import TRANS_HDR, TRANS_HDR_LEN
+from ZODB.FileStorage import DATA_HDR, DATA_HDR_LEN, DATA_VERSION_HDR_LEN
 from ZODB.FileStorage import FileIterator
 from ZODB.TimeStamp import TimeStamp
 from ZODB.utils import u64
@@ -6,6 +32,7 @@
 from cPickle import Unpickler
 from cStringIO import StringIO
 import md5
+import struct
 import types
 
 def get_pickle_metadata(data):
@@ -36,9 +63,9 @@
         classname = ''
     return modname, classname
 
-def fsdump(path, file=None, with_offset=1):
+def fsdump(path, file=None, with_offset=True, start=None, stop=None):
     i = 0
-    iter = FileIterator(path)
+    iter = FileIterator(path, start, stop)
     for trans in iter:
         if with_offset:
             print >> file, ("Trans #%05d tid=%016x time=%s size=%d"
@@ -89,10 +116,6 @@
         print >> file
         i += 1
     iter.close()
-
-import struct
-from ZODB.FileStorage import TRANS_HDR, TRANS_HDR_LEN
-from ZODB.FileStorage import DATA_HDR, DATA_HDR_LEN, DATA_VERSION_HDR_LEN
 
 def fmt(p64):
     # Return a nicely formatted string for a packaged 64-bit value