From c0a943652556b638e58c5c65c1cbb0b9967a59e8 Mon Sep 17 00:00:00 2001
From: Thorsten Vitt <thorsten.vitt@uni-wuerzburg.de>
Date: Mon, 15 Sep 2014 16:19:10 +0200
Subject: [PATCH] Added a script to help examine stylesheet regressions
---
examine-stylesheet-results.sh | 93 +++++++++++++++++++++++++++++++++++
1 file changed, 93 insertions(+)
create mode 100755 examine-stylesheet-results.sh
diff --git a/examine-stylesheet-results.sh b/examine-stylesheet-results.sh
new file mode 100755
index 0000000..7414a34
--- /dev/null
+++ b/examine-stylesheet-results.sh
@@ -0,0 +1,93 @@
+#!/bin/bash
+cat <<EOP
+This debugging script assists in the progress that is neccessary after
+stylesheet updates: It runs the html regression test to dump generated HTMLs to
+the hard disk, generates canonicalized and formatted versions of them, and
+allows you to compare the committed versions with the newly generated ones.
+
+EOP
+
+
+mkdir -p target/diffable-html/{old,new,new-raw}
+echo "Running the regression test (may take a while) ..."
+if mvn test -Dtest=HtmlRegressionTest > target/diffable-html/mvn.log 2>&1
+then
+ echo ':-) Regression test succeeded -- you can probably ^C now ...'
+else
+ echo ':-( Test failed -- probably there are differences in the generated HTML'
+fi
+
+cp target/surefire-reports/info.textgrid.services.aggregator.html.HtmlRegressionTest.txt target/diffable-html/HtmlRegressionTest.txt
+cat target/diffable-html/HtmlRegressionTest.txt
+
+echo "Generating the new HTMLs now (may take a while) ..."
+mvn test -Dtest=HtmlRegressionTest -Dregression.outputdir=target/diffable-html/new-raw > target/diffable-html/mvn2.log 2>&1
+for f in src/test/resources/*.html
+do
+ xmlstarlet c14n --without-comments $f | xmlstarlet fo > target/diffable-html/old/`basename $f`
+done
+for f in target/diffable-html/new-raw/*.html
+do
+ xmlstarlet c14n --without-comments $f | xmlstarlet fo > target/diffable-html/new/`basename $f`
+done
+ cat <<EOP
+
+Canonicalized, formatted HTML test files have been generated in subdirectories
+of target/diffable-html:
+ - old: As present in src/test/resources/*.html
+ - new: As generated from the current version of the stylesheet
+ - new-raw: Not canonicalized and formatted, i.e. ready for inclusion in the next commit.
+EOP
+
+cd target/diffable-html
+
+choice=0
+while [ $choice != x ]
+do
+ cat <<EOP
+
+What do you want to do?
+ (d) view the diffs via colordiff
+ (m) view the diffs via meld
+ (t) view the test report with xmldiff information
+ (l) view the maven log
+ (a) accept the changes, i.e. copy stuff to src/test/resources
+
+ (x) exit this tool
+EOP
+read -p"dmtax > " -n1 choice
+
+case $choice in
+ D|d)
+ colordiff old new | less -R
+ ;;
+ M|m)
+ meld old new
+ ;;
+ T|t)
+ echo "Running less ..."
+ less HtmlRegressionTest.txt
+ ;;
+ L|l)
+ less mvn.log mvn2.log
+ ;;
+ A|a)
+
+ for f in new-raw/*.html
+ do
+ if cmp -s old/`basename $f` new/`basename $f`
+ then
+ : # echo Skipping semantically unchanged file $f
+ else
+ cp -vp $f ../../src/test/resources
+ fi
+ done
+
+ cd ../../
+ git status
+ echo You need to add and commit stuff now.
+ exit 0
+ ;;
+esac
+
+done
--
GitLab