Changes between Version 8 and Version 9 of BluePrint/XsltTesting

Timestamp:

06/06/14 11:34:20 (11 years ago)

Author:

Pat Tressel

Comment:

--

BluePrint/XsltTesting

@@ -21 +21 @@
 The transformed file will need to be compared against the golden file.  Options for performing the comparison:
 
-* For XML output, read both the transformed file and the golden file into etrees, and compare those.
+* For XML output, transform the input file, which will yield an etree.  Read the golden file into an etree as well.  Then compare the etrees.
 
 * For S3XML output, read both using S3XML utilities and compare the S3XML trees.
 
-* For other formats, compare the files as strings.
+* For other formats, transform the input, then convert it to a string.  Read in the golden file and do a textual comparison.
 
 String comparison is fragile, as alterations in whitespace or change in ordering of elements (where that change is not significant to the meaning) will break the test.  However, this is simple, and may be appropriate for getting started, even for formats that produce XML or S3XML.
 
+This can be made less fragile by ignoring whitespace and similar differences where they are not significant -- the user can be allowed to specify what can be ignored.
+
 * Allow the user to provide a comparison function.
 
+This goes against the purpose of making testing easy, so should be avoided.  If this becomes necessary, the user can be allowed to specify the function in the options.  These comparison functions could be added to the test helper, or placed in other files in the same directory.
 This goes against the purpose of making testing easy, so should be avoided.