/usr/lib/python2.7/dist-packages/tables/scripts/ptdump.py is in python-tables 3.1.1-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 | # -*- coding: utf-8 -*-
########################################################################
#
# License: BSD
# Created: February 10, 2004
# Author: Francesc Alted - faltet@pytables.com
#
# $Id$
#
########################################################################
"""This utility lets you look into the data and metadata of your data files.
Pass the flag -h to this for help on usage.
"""
from __future__ import print_function
import argparse
from tables.file import open_file
from tables.group import Group
from tables.leaf import Leaf
from tables.table import Table, Column
from tables.unimplemented import UnImplemented
from tables._past import previous_api
# default options
options = argparse.Namespace(
rng=slice(None),
showattrs=0,
verbose=0,
dump=0,
colinfo=0,
idxinfo=0,
)
def dump_leaf(leaf):
if options.verbose:
print(repr(leaf))
else:
print(str(leaf))
if options.showattrs:
print(" "+repr(leaf.attrs))
if options.dump and not isinstance(leaf, UnImplemented):
print(" Data dump:")
# print((leaf.read(options.rng.start, options.rng.stop,
# options.rng.step))
# This is better for large objects
if options.rng.start is None:
start = 0
else:
start = options.rng.start
if options.rng.stop is None:
if leaf.shape != ():
stop = leaf.shape[0]
else:
stop = options.rng.stop
if options.rng.step is None:
step = 1
else:
step = options.rng.step
if leaf.shape == ():
print("[SCALAR] %s" % (leaf[()]))
else:
for i in range(start, stop, step):
print("[%s] %s" % (i, leaf[i]))
if isinstance(leaf, Table) and options.colinfo:
# Show info of columns
for colname in leaf.colnames:
print(repr(leaf.cols._f_col(colname)))
if isinstance(leaf, Table) and options.idxinfo:
# Show info of indexes
for colname in leaf.colnames:
col = leaf.cols._f_col(colname)
if isinstance(col, Column) and col.index is not None:
idx = col.index
print(repr(idx))
dumpLeaf = previous_api(dump_leaf)
def dump_group(pgroup):
node_kinds = pgroup._v_file._node_kinds[1:]
for group in pgroup._f_walk_groups():
print(str(group))
if options.showattrs:
print(" "+repr(group._v_attrs))
for kind in node_kinds:
for node in group._f_list_nodes(kind):
if options.verbose or options.dump:
dump_leaf(node)
else:
print(str(node))
dumpGroup = previous_api(dump_group)
def _get_parser():
parser = argparse.ArgumentParser(
description='''The ptdump utility allows you look into the contents
of your PyTables files. It lets you see not only the data but also
the metadata (that is, the *structure* and additional information in
the form of *attributes*).''')
parser.add_argument(
'-v', '--verbose', action='store_true',
help='dump more metainformation on nodes',
)
parser.add_argument(
'-d', '--dump', action='store_true',
help='dump data information on leaves',
)
parser.add_argument(
'-a', '--showattrs', action='store_true',
help='show attributes in nodes (only useful when -v or -d are active)',
)
parser.add_argument(
'-c', '--colinfo', action='store_true',
help='''show info of columns in tables (only useful when -v or -d
are active)''',
)
parser.add_argument(
'-i', '--idxinfo', action='store_true',
help='''show info of indexed columns (only useful when -v or -d are
active)''',
)
parser.add_argument(
'-R', '--range', dest='rng', metavar='RANGE',
help='''select a RANGE of rows (in the form "start,stop,step")
during the copy of *all* the leaves.
Default values are "None,None,1", which means a copy of all the
rows.''',
)
parser.add_argument('src', metavar='filename[:nodepath]',
help='name of the HDF5 file to dump')
return parser
def main():
parser = _get_parser()
args = parser.parse_args(namespace=options)
# Get the options
if isinstance(args.rng, basestring):
try:
options.rng = eval("slice(" + args.rng + ")")
except Exception:
parser.error("Error when getting the range parameter.")
else:
args.dump = 1
# Catch the files passed as the last arguments
src = args.src.split(':')
if len(src) == 1:
filename, nodename = src[0], "/"
else:
filename, nodename = src
if nodename == "":
# case where filename == "filename:" instead of "filename:/"
nodename = "/"
# Check whether the specified node is a group or a leaf
h5file = open_file(filename, 'r')
nodeobject = h5file.get_node(nodename)
if isinstance(nodeobject, Group):
# Close the file again and reopen using the root_uep
dump_group(nodeobject)
elif isinstance(nodeobject, Leaf):
# If it is not a Group, it must be a Leaf
dump_leaf(nodeobject)
else:
# This should never happen
print("Unrecognized object:", nodeobject)
# Close the file
h5file.close()
|