[svn-r12416] Purpose: Maintenance

Description: Added test script and two test files in the tools/misc/testfiles
             directory for testing h5stat tool; modified Makefile.am in tools/misc
             and configure.in files to run the new test script; reran bin/recofigure
             to update relevant configuration files; updated MANIFEST

Solution:

Platforms tested: heping with in place and srcdir builds; will do more testing
                  after the checkin.

Misc. update:

5 files changed, 174 insertions, 8 deletions

diff --git a/tools/misc/Makefile.am b/tools/misc/Makefile.am
index 025ce14..7b397e1 100644
--- a/tools/misc/Makefile.am
+++ b/tools/misc/Makefile.am
@@ -24,11 +24,11 @@ INCLUDES+=-I$(top_srcdir)/src -I$(top_srcdir)/tools/lib
 
 #test script and program
 TEST_PROG=h5repart_gentest
-TEST_SCRIPT=testh5repart.sh
+TEST_SCRIPT=testh5repart.sh testh5stat.sh
 
 check_PROGRAMS=$(TEST_PROG) repart_test
 check_SCRIPTS=$(TEST_SCRIPT)
-SCRIPT_DEPEND=h5repart$(EXEEXT)
+SCRIPT_DEPEND=h5repart$(EXEEXT) h5stat$(EXEEXT)
 
 # These are our main targets, the tools
 bin_PROGRAMS=h5debug h5repart h5stat
@@ -43,7 +43,7 @@ CLEANFILES=h5redeploy
 CHECK_CLEANFILES+=*.h5 ../testfiles/fst_family*.h5 ../testfiles/scd_family*.h5
 
 # These were generated by configure.  Remove them only when distclean.
-DISTCLEANFILES=h5cc testh5repart.sh
+DISTCLEANFILES=h5cc testh5repart.sh testh5stat.sh
 
 # All programs rely on hdf5 library and h5tools library
 LDADD=$(LIBH5TOOLS) $(LIBHDF5)
diff --git a/tools/misc/Makefile.in b/tools/misc/Makefile.in
index 30fd003..23dbf56 100644
--- a/tools/misc/Makefile.in
+++ b/tools/misc/Makefile.in
@@ -57,7 +57,7 @@ build_triplet = @build@
 host_triplet = @host@
 DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in \
 	$(srcdir)/h5cc.in $(srcdir)/testh5repart.sh.in \
-	$(top_srcdir)/config/commence.am \
+	$(srcdir)/testh5stat.sh.in $(top_srcdir)/config/commence.am \
 	$(top_srcdir)/config/conclude.am
 check_PROGRAMS = $(am__EXEEXT_1) repart_test$(EXEEXT)
 bin_PROGRAMS = h5debug$(EXEEXT) h5repart$(EXEEXT) h5stat$(EXEEXT)
@@ -68,7 +68,7 @@ am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
 	$(ACLOCAL_M4)
 mkinstalldirs = $(SHELL) $(top_srcdir)/bin/mkinstalldirs
 CONFIG_HEADER = $(top_builddir)/src/H5config.h
-CONFIG_CLEAN_FILES = h5cc testh5repart.sh
+CONFIG_CLEAN_FILES = h5cc testh5repart.sh testh5stat.sh
 am__installdirs = "$(DESTDIR)$(bindir)" "$(DESTDIR)$(bindir)"
 binPROGRAMS_INSTALL = $(INSTALL_PROGRAM)
 am__EXEEXT_1 = h5repart_gentest$(EXEEXT)
@@ -367,16 +367,16 @@ CHECK_CLEANFILES = *.chkexe *.chklog *.clog *.h5 \
 
 #test script and program
 TEST_PROG = h5repart_gentest
-TEST_SCRIPT = testh5repart.sh
+TEST_SCRIPT = testh5repart.sh testh5stat.sh
 check_SCRIPTS = $(TEST_SCRIPT)
-SCRIPT_DEPEND = h5repart$(EXEEXT)
+SCRIPT_DEPEND = h5repart$(EXEEXT) h5stat$(EXEEXT)
 bin_SCRIPTS = h5redeploy
 
 # Tell automake to clean h5redeploy script
 CLEANFILES = h5redeploy
 
 # These were generated by configure.  Remove them only when distclean.
-DISTCLEANFILES = h5cc testh5repart.sh
+DISTCLEANFILES = h5cc testh5repart.sh testh5stat.sh
 
 # All programs rely on hdf5 library and h5tools library
 LDADD = $(LIBH5TOOLS) $(LIBHDF5)
@@ -439,6 +439,8 @@ h5cc: $(top_builddir)/config.status $(srcdir)/h5cc.in
 	cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@
 testh5repart.sh: $(top_builddir)/config.status $(srcdir)/testh5repart.sh.in
 	cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@
+testh5stat.sh: $(top_builddir)/config.status $(srcdir)/testh5stat.sh.in
+	cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@
 install-binPROGRAMS: $(bin_PROGRAMS)
 	@$(NORMAL_INSTALL)
 	test -z "$(bindir)" || $(mkdir_p) "$(DESTDIR)$(bindir)"
diff --git a/tools/misc/testfiles/h5stat_help1.ddl b/tools/misc/testfiles/h5stat_help1.ddl
new file mode 100644
index 0000000..05f1926
--- /dev/null
+++ b/tools/misc/testfiles/h5stat_help1.ddl
@@ -0,0 +1,22 @@
+#############################
+Expected output for 'h5stat -h'
+#############################
+
+This tool is under development. For detailed information
+please see the specification document at
+http://hdf.ncsa.uiuc.edu/RFC/h5stat/h5stat-spec.pdf
+
+Please send your comments and questions to help@hdfgroup.org
+
+Usage: h5stat [OPTIONS] file
+
+      OPTIONS
+     -h, --help            Print a usage message and exit
+     -f, --file            Print file information
+     -F, --filemetadata    Print file metadata
+     -g, --group           Print group information
+     -G, --groupmetadata   Print group metadata
+     -d, --dset            Print dataset information
+     -D, --dsetmetadata    Print dataset metadata
+     -T, --dtypemetadata   Print datatype metadata
+
diff --git a/tools/misc/testfiles/h5stat_help2.ddl b/tools/misc/testfiles/h5stat_help2.ddl
new file mode 100644
index 0000000..b8eda84
--- /dev/null
+++ b/tools/misc/testfiles/h5stat_help2.ddl
@@ -0,0 +1,22 @@
+#############################
+Expected output for 'h5stat --help'
+#############################
+
+This tool is under development. For detailed information
+please see the specification document at
+http://hdf.ncsa.uiuc.edu/RFC/h5stat/h5stat-spec.pdf
+
+Please send your comments and questions to help@hdfgroup.org
+
+Usage: h5stat [OPTIONS] file
+
+      OPTIONS
+     -h, --help            Print a usage message and exit
+     -f, --file            Print file information
+     -F, --filemetadata    Print file metadata
+     -g, --group           Print group information
+     -G, --groupmetadata   Print group metadata
+     -d, --dset            Print dataset information
+     -D, --dsetmetadata    Print dataset metadata
+     -T, --dtypemetadata   Print datatype metadata
+
diff --git a/tools/misc/testh5stat.sh.in b/tools/misc/testh5stat.sh.in
new file mode 100644
index 0000000..1981f7b
--- /dev/null
+++ b/tools/misc/testh5stat.sh.in
@@ -0,0 +1,120 @@
+#! /bin/sh
+#
+# Copyright by the Board of Trustees of the University of Illinois.
+# All rights reserved.
+#
+# This file is part of HDF5.  The full HDF5 copyright notice, including
+# terms governing use, modification, and redistribution, is contained in
+# the files COPYING and Copyright.html.  COPYING can be found at the root
+# of the source code distribution tree; Copyright.html can be found at the
+# root level of an installed copy of the electronic HDF5 document set and
+# is linked from the top-level documents page.  It can also be found at
+# http://hdf.ncsa.uiuc.edu/HDF5/doc/Copyright.html.  If you do not have
+# access to either file, you may request a copy from hdfhelp@ncsa.uiuc.edu.
+#
+# Tests for the h5dump tool
+
+# Determine which filters are available
+USE_FILTER_SZIP="@USE_FILTER_SZIP@"
+USE_FILTER_DEFLATE="@USE_FILTER_DEFLATE@"
+USE_FILTER_SHUFFLE="@USE_FILTER_SHUFFLE@"
+USE_FILTER_FLETCHER32="@USE_FILTER_FLETCHER32@"
+USE_FILTER_NBIT="@USE_FILTER_NBIT@"
+USE_FILTER_SCALEOFFSET="@USE_FILTER_SCALEOFFSET@"
+
+STAT=h5stat               # The tool name
+STAT_BIN=`pwd`/$STAT    # The path of the tool binary
+
+CMP='cmp -s'
+DIFF='diff -c'
+
+nerrors=0
+verbose=yes
+
+# The build (current) directory might be different than the source directory.
+if test -z "$srcdir"; then
+   srcdir=.
+fi
+
+test -d ./testfiles || mkdir ./testfiles
+
+# Print a line-line message left justified in a field of 70 characters
+# beginning with the word "Testing".
+#
+TESTING() {
+   SPACES="                                                               "
+   echo "Testing $* $SPACES" | cut -c1-70 | tr -d '\012'
+}
+
+# Run a test and print PASS or *FAIL*.  If a test fails then increment
+# the `nerrors' global variable and (if $verbose is set) display the
+# difference between the actual output and the expected output. The
+# expected output is given as the first argument to this function and
+# the actual output file is calculated by replacing the `.ddl' with
+# `.out'.  The actual output is not removed if $HDF5_NOCLEANUP has a
+# non-zero value.
+#
+TOOLTEST() {
+   expect="$srcdir/testfiles/$1"
+   actual="./testfiles/`basename $1 .ddl`.out"
+   actual_err="./testfiles/`basename $1 .ddl`.err"
+   shift
+
+   # Run test.
+   TESTING $STAT $@
+   (
+      echo "#############################"
+      echo "Expected output for '$STAT $@'" 
+      echo "#############################"
+      cd $srcdir/testfiles
+      $RUNSERIAL $STAT_BIN $@
+   ) >$actual 2>$actual_err
+   cat $actual_err >> $actual
+
+
+   if [ ! -f $expect ]; then
+    # Create the expect file if it doesn't yet exist.
+    echo " CREATED"
+    cp $actual $expect
+   elif $CMP $expect $actual; then
+      echo " PASSED"
+   else
+      echo "*FAILED*"
+      echo "    Expected result (*.ddl) differs from actual result (*.out)"
+      nerrors="`expr $nerrors + 1`"
+      test yes = "$verbose" && $DIFF $expect $actual |sed 's/^/    /'
+   fi
+
+   # Clean up output file
+   if test -z "$HDF5_NOCLEANUP"; then
+      rm -f $actual $actual_err
+   fi
+}
+
+
+# Print a "SKIP" message
+SKIP() {
+	 TESTING $STAT $@
+	  echo  " -SKIP-"
+}
+  
+
+
+##############################################################################
+##############################################################################
+###			  T H E   T E S T S                                ###
+##############################################################################
+##############################################################################
+
+# test for help flag
+TOOLTEST h5stat_help1.ddl -h
+TOOLTEST h5stat_help2.ddl --help
+echo
+
+
+if test $nerrors -eq 0 ; then
+   echo "All $STAT tests passed."
+fi
+
+exit $nerrors
+