[LON-CAPA-cvs] cvs: loncom /metadata_database dump_db.pl

matthew lon-capa-cvs@mail.lon-capa.org
Thu, 15 Aug 2002 17:57:13 -0000


matthew		Thu Aug 15 13:57:13 2002 EDT

  Added files:                 
    /loncom/metadata_database	dump_db.pl 
  Log:
  Small routine to dump a gdbm database to standard output.  Helpful for 
  debugging.  Run it with --help to learn a little more.
  
  

Index: loncom/metadata_database/dump_db.pl
+++ loncom/metadata_database/dump_db.pl
#!/usr/bin/perl -w
#
# The LearningOnline Network
#
# dump_db.pl - dump a GDBM database to standard output, unescaping if asked to.
#
# $Id: dump_db.pl,v 1.1 2002/08/15 17:57:13 matthew Exp $
#
# Copyright Michigan State University Board of Trustees
#
# This file is part of the LearningOnline Network with CAPA (LON-CAPA).
#
# LON-CAPA is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# LON-CAPA is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with LON-CAPA; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
#
# /home/httpd/html/adm/gpl.txt
#
# http://www.lon-capa.org/
#
#################################################
use strict;
use Getopt::Long;
use GDBM_File;

#
# Options
my $unesc = 0;
my $help = 0;
GetOptions("unescape" => \$unesc,
             "help"     => \$help);

#
# Help them out if they ask for it
if ($help) {
    print <<END;
dump_db.pl - dump GDBM_File databases to stdout.  
Specify the database filenames on the command line.
Specify --unescape to have all the keys and values unescaped from every
database.
Options:
   --help     Display this help.
   --unescape Unescape the keys and values before printing them out.
Examples: 
    dump_db.pl mydata.db
    dump_db.pl mydata.db yourdata.db ourdata.db theirdata.db
    dump_db.pl --unescape \*db
END
    exit;
}

#
# Loop through ARGV getting files.
while (my $fname = shift) {
    my %db;
    if (! tie(%db,'GDBM_File',$fname,&GDBM_READER,0640)) {
        warn "Unable to tie to $fname";
        next;
    }
    while (my ($key,$value) = each(%db)) {
        if ($unesc) {
            $key = &unescape($key);
            $value = &unescape($value);
        }
        print "$key = $value\n";
    }
    untie %db;
}
exit;

######################################
sub unescape {
    my $str=shift;
    $str =~ s/%([a-fA-F0-9][a-fA-F0-9])/pack("C",hex($1))/eg;
    return $str;
}