simple-xspec-wrapper 0.1.0-java

data/vendor/xspec-1.0.0/src/schematron/sch-location-compare.xsl

@@ -0,0 +1,139 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
+    xmlns:x="http://www.jenitennison.com/xslt/xspec" version="2.0">
+
+    <!-- function x:schematron-location-compare
+      
+      This function is used in Schematron tests to compare 
+      an expected @location XPath in a test scenario with
+      a SVRL @location XPath in Schematron output.
+      
+      If the Schematron uses XPath 1.0 the SVRL location XPath has all namespaced
+      elements use a wildcard namespace, so only the element name can be matched. 
+      If XPath 1.0 is detected then namespace prefixes are removed from the comparison.
+      
+      Parameters:
+      
+      expect-location : @location from x:expect-assert or x:expect-report
+      
+      svrl-location : @location from svrl:failed-assert or svrl:successful-report
+      
+      namespaces : elements that contain namespace definitions in attributes @uri and @prefix
+        <svrl:ns-prefix-in-attribute-values uri="http://example.com/ns1" prefix="ex1"/>
+        <sch:ns uri="http://example.com/ns1" prefix="ex1"/>
+    -->
+    <xsl:function name="x:schematron-location-compare" as="xs:boolean">
+        <xsl:param name="expect-location" as="xs:string?"/>
+        <xsl:param name="svrl-location" as="xs:string?"/>
+        <xsl:param name="namespaces" as="element()*"/>
+        <xsl:variable name="svrl-expand1"
+            select="
+                x:schematron-location-expand-xpath1(
+                x:schematron-location-expand-attributes($svrl-location, $namespaces))"/>
+        <xsl:variable name="svrl-expand2" select="x:schematron-location-expand-xpath2($svrl-expand1, $namespaces)"/>
+        <xsl:variable name="expect-expand"
+            select="
+                x:schematron-location-expand-xpath1-expect(
+                x:schematron-location-expand-attributes($expect-location, $namespaces), $svrl-location, $namespaces)"/>
+        <!--xsl:variable name="expect-parts" select="tokenize($expect-expand, '/')[.]"/>
+        <xsl:variable name="svrl-parts" select="tokenize($svrl-expand2, '/')[.]"/-->
+        <xsl:sequence select="
+                ($expect-location = $svrl-location) or
+                (replace($svrl-expand2, '^/|\[1\]', '') = replace($expect-expand, '^/|\[1\]', ''))
+                "/>
+        <!-- (: every $i in (1 to max((count($svrl-parts),count($expect-parts)))) satisfies
+        replace($expect-parts[$i], '\[1\]$', '') = replace($svrl-parts[$i], '\[1\]$', '') :) -->
+    </xsl:function>
+
+    <!-- function x:schematron-location-expand-xpath2
+  
+      This function is used in Schematron tests to reformat XPath location attribute values
+      from the format Schematron produces for XPath 2.0 to human friendly XPath
+      using namespace prefixes defined in Schematron ns elements.
+      
+      The XPath 2.0 format produced by Schematron is:
+      *:name[namespace-uri()='http://example.com/ns1']
+    -->
+    <xsl:function name="x:schematron-location-expand-xpath2" as="xs:string">
+        <xsl:param name="location" as="xs:string?"/>
+        <xsl:param name="namespaces" as="element()*"/>
+        <xsl:choose>
+            <xsl:when test="$namespaces">
+                <xsl:variable name="match"
+                    select="concat('\*:([^\[]+)\[namespace\-uri\(\)=', codepoints-to-string(39), replace($namespaces[1]/@uri, '([\.\\\?\*\+\|\^\$\{\}\(\)\[\]])', '\\$1'), codepoints-to-string(39), '\]')"/>
+                <xsl:variable name="replace" select="concat($namespaces[1]/@prefix, ':$1')"/>
+                <xsl:value-of
+                    select="x:schematron-location-expand-xpath2(replace($location, $match, $replace), subsequence($namespaces, 2))"
+                />
+            </xsl:when>
+            <xsl:otherwise>
+                <xsl:value-of select="$location"/>
+            </xsl:otherwise>
+        </xsl:choose>
+    </xsl:function>
+
+    <!-- function x:schematron-location-expand-xpath1
+  
+      This function is used in Schematron tests to reformat XPath location attribute values
+      from the format Schematron produces for XPath 1.0 to human friendly XPath.
+      Namespace URIs are not available so effectively the XPath does not recognize namespaces.
+      
+      The XPath 1.0 format produced by Schematron is:
+      *[local-name()='name']
+  -->
+    <xsl:function name="x:schematron-location-expand-xpath1" as="xs:string">
+        <xsl:param name="location" as="xs:string?"/>
+        <xsl:variable name="match"
+            select="concat('\*\[local-name\(\)=', codepoints-to-string(39), '([^', codepoints-to-string(39), ']+)', codepoints-to-string(39), '\]')"/>
+        <xsl:value-of select="replace($location, $match, '$1')"/>
+    </xsl:function>
+
+    <!-- function schematron-location-expand-xpath1-expect
+    
+    
+  -->
+    <xsl:function name="x:schematron-location-expand-xpath1-expect" as="xs:string">
+        <xsl:param name="expect-location" as="xs:string?"/>
+        <xsl:param name="svrl-location" as="xs:string?"/>
+        <xsl:param name="namespaces" as="element()*"/>
+        <xsl:value-of
+            select="
+                if ($namespaces and contains($svrl-location, '*[local-name()=')) then
+                    replace($expect-location, concat('(', string-join(for $prefix in $namespaces/@prefix
+                    return
+                        concat($prefix, ':'), '|'), ')'), '')
+                else
+                    $expect-location"
+        />
+    </xsl:function>
+
+    <!-- function schematron-location-expand-attributes
+    
+    This function reformats namespaced attribute nodes in XPath to use the 
+    namespace prefix defined in the Schematron.
+    
+    The XPath format produced by Schematron for XPath 1 and 2, which is also 
+    produced by oXygen's Copy XPath function, is:
+    
+    @*[namespace-uri()='http://example.com/ns2' and local-name()='type']
+    -->
+    <xsl:function name="x:schematron-location-expand-attributes" as="xs:string">
+        <xsl:param name="location" as="xs:string?"/>
+        <xsl:param name="namespaces" as="element()*"/>
+        <xsl:choose>
+            <xsl:when test="$namespaces">
+                <xsl:variable name="match"
+                    select="concat('@\*\[namespace-uri\(\)=', codepoints-to-string(39), replace($namespaces[1]/@uri, '([\.\\\?\*\+\|\^\$\{\}\(\)\[\]])', '\\$1'), codepoints-to-string(39), ' and local-name\(\)=', codepoints-to-string(39), '([^', codepoints-to-string(39), ']+)', codepoints-to-string(39), '\]')"/>
+                <xsl:variable name="replace" select="concat('@', $namespaces[1]/@prefix, ':$1')"/>
+                <xsl:value-of
+                    select="x:schematron-location-expand-attributes(replace($location, $match, $replace), subsequence($namespaces, 2))"
+                />
+            </xsl:when>
+            <xsl:otherwise>
+                <xsl:value-of select="$location"/>
+            </xsl:otherwise>
+        </xsl:choose>
+    </xsl:function>
+
+
+</xsl:stylesheet>

data/vendor/xspec-1.0.0/src/schematron/schut-to-xspec.xsl

@@ -0,0 +1,179 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<?xml-model href="../../src/schemas/xspec.rnc" type="application/relax-ng-compact-syntax"?>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+    xmlns:xs="http://www.w3.org/2001/XMLSchema" 
+    xmlns:x="http://www.jenitennison.com/xslt/xspec" 
+    exclude-result-prefixes="xs" version="2.0">
+    
+    <xsl:param name="stylesheet" select="concat(x:description/@schematron, '.xsl')"/>
+    <xsl:param name="test_dir" select="'xspec'"/>
+    
+
+    <xsl:variable name="error" select="('error', 'fatal')"/>
+    <xsl:variable name="warn" select="('warn', 'warning')"/>
+    <xsl:variable name="info" select="('info', 'information')"/>
+
+
+    <xsl:template match="@* | node()" priority="-2">
+        <xsl:copy>
+            <xsl:apply-templates select="@* | node()"/>
+        </xsl:copy>
+    </xsl:template>
+    
+    <xsl:template match="x:description[@schematron]">
+        <xsl:element name="x:description">
+            <xsl:namespace name="svrl" select="'http://purl.oclc.org/dsdl/svrl'"/>
+            <xsl:apply-templates select="@*[not(name() = ('stylesheet'))]"/>
+            <xsl:element name="x:scenario">
+                <xsl:attribute name="label">
+                    <xsl:text>Schematron: "</xsl:text>
+                    <xsl:value-of select="@schematron"/>
+                    <xsl:text>"</xsl:text>
+                    <xsl:if test="x:param[@name='phase']">
+                        <xsl:value-of select="concat(' phase: ', x:param[@name='phase'][1]/(@select,string())[1])"/>
+                    </xsl:if>
+                </xsl:attribute>
+            </xsl:element>
+            <xsl:apply-templates select="node()"/>
+        </xsl:element>
+    </xsl:template>
+
+    <xsl:template match="@schematron">
+        <xsl:attribute name="stylesheet" select="$stylesheet"/>
+        <xsl:variable name="path" select="resolve-uri(string(), base-uri())"/>
+        <xsl:for-each select="doc($path)/sch:schema/sch:ns" xmlns:sch="http://purl.oclc.org/dsdl/schematron">
+            <xsl:namespace name="{./@prefix}" select="./@uri"/>
+        </xsl:for-each>
+    </xsl:template>
+
+    <xsl:template match="x:import">
+        <xsl:variable name="href" select="resolve-uri(@href, base-uri())"/>
+        <xsl:choose>
+            <xsl:when test="doc($href)//*[ 
+                self::x:expect-assert | self::x:expect-not-assert | 
+                self::x:expect-report | self::x:expect-not-report |
+                self::x:expect-valid | self::x:description[@schematron] ]">
+                <xsl:comment>BEGIN IMPORT "<xsl:value-of select="@href"/>"</xsl:comment>
+                <xsl:apply-templates select="doc($href)/x:description/node()"/>
+                <xsl:comment>END IMPORT "<xsl:value-of select="@href"/>"</xsl:comment>
+            </xsl:when>
+            <xsl:otherwise>
+                <xsl:next-match/>
+            </xsl:otherwise>
+        </xsl:choose>
+    </xsl:template>
+    
+    <xsl:template match="x:context[not(@href)][
+        parent::*/x:expect-assert | parent::*/x:expect-not-assert |
+        parent::*/x:expect-report | parent::*/x:expect-not-report |
+        parent::*/x:expect-valid | ancestor::x:description[@schematron] ]">
+        <xsl:variable name="file" select="concat($test_dir, '/', 'context-', generate-id(), '.xml')"/>
+        <xsl:result-document href="{$file}">
+            <xsl:copy-of select="./node()"/>
+        </xsl:result-document>
+        <xsl:element name="x:context">
+            <xsl:attribute name="href" select="$file"/>
+        </xsl:element>
+    </xsl:template>
+    
+    <xsl:template match="x:expect-assert">
+        <xsl:element name="x:expect">
+            <xsl:call-template name="make-label"/>
+            <xsl:attribute name="test">
+                <xsl:sequence select="if (@count) then 'count' else 'exists'"/>
+                <xsl:sequence select="'(svrl:schematron-output/svrl:failed-assert'"/>
+                <xsl:apply-templates select="@*" mode="make-predicate"/>
+                <xsl:sequence select="')'"/>
+                <xsl:sequence select="current()[@count]/concat(' eq ', @count)"/>
+            </xsl:attribute>
+        </xsl:element>
+    </xsl:template>
+
+    <xsl:template match="x:expect-not-assert">
+        <xsl:element name="x:expect">
+            <xsl:call-template name="make-label"/>
+            <xsl:attribute name="test">
+                <xsl:sequence select="'boolean(svrl:schematron-output[svrl:fired-rule]) and empty(svrl:schematron-output/svrl:failed-assert'"/>
+                <xsl:apply-templates select="@*" mode="make-predicate"/>
+                <xsl:sequence select="')'"/>
+            </xsl:attribute>
+        </xsl:element>
+    </xsl:template>
+
+    <xsl:template match="x:expect-report">
+        <xsl:element name="x:expect">
+            <xsl:call-template name="make-label"/>
+            <xsl:attribute name="test">
+                <xsl:sequence select="if (@count) then 'count' else 'exists'"/>
+                <xsl:sequence select="'(svrl:schematron-output/svrl:successful-report'"/>
+                <xsl:apply-templates select="@*" mode="make-predicate"/>
+                <xsl:sequence select="')'"/>
+                <xsl:sequence select="current()[@count]/concat(' eq ', @count)"/>
+            </xsl:attribute>
+        </xsl:element>
+    </xsl:template>
+
+
+    <xsl:template match="x:expect-not-report">
+        <xsl:element name="x:expect">
+            <xsl:call-template name="make-label"/>
+            <xsl:attribute name="test">
+                <xsl:sequence select="'boolean(svrl:schematron-output[svrl:fired-rule]) and empty(svrl:schematron-output/svrl:successful-report'"/>
+                <xsl:apply-templates select="@*" mode="make-predicate"/>
+                <xsl:sequence select="')'"/>
+            </xsl:attribute>
+        </xsl:element>
+    </xsl:template>
+
+    <xsl:template match="@location" mode="make-predicate">
+        <xsl:variable name="escaped" select="if (not(contains(., codepoints-to-string(39)))) then 
+            concat(codepoints-to-string(39), ., codepoints-to-string(39)) else 
+            concat('concat(', codepoints-to-string(39), replace(., codepoints-to-string(39), concat(codepoints-to-string(39), ', codepoints-to-string(39), ', codepoints-to-string(39))), codepoints-to-string(39), ')')"/>
+        <xsl:sequence select="concat('[x:schematron-location-compare(', $escaped, ', @location, preceding-sibling::svrl:ns-prefix-in-attribute-values)]')"/>
+    </xsl:template>
+
+    <xsl:template match="@id | @role" mode="make-predicate">
+        <xsl:sequence select="concat('[(@', local-name(.), 
+            ', preceding-sibling::svrl:fired-rule[1]/@',local-name(.), 
+            ', preceding-sibling::svrl:active-pattern[1]/@',local-name(.), 
+            ')[1] = ', codepoints-to-string(39), ., codepoints-to-string(39), ']')"/>
+    </xsl:template>
+    
+    <xsl:template match="@id[parent::x:expect-rule] | @context[parent::x:expect-rule]" mode="make-predicate">
+        <xsl:sequence select="concat('[@', local-name(.), 
+            ' = ', codepoints-to-string(39), ., codepoints-to-string(39), ']')"/>
+    </xsl:template>
+    
+    <xsl:template match="@count | @label" mode="make-predicate"/>
+    
+    <xsl:template name="make-label">
+        <xsl:attribute name="label" select="string-join((@label, tokenize(local-name(),'-')[.=('report','assert','not','rule')], @id, @role, @location, @context, current()[@count]/string('count:'), @count), ' ')"/>
+    </xsl:template>
+
+    <xsl:template match="x:expect-valid">
+        <xsl:element name="x:expect">
+            <xsl:attribute name="label" select="'valid'"/>
+            <xsl:attribute name="test" select="concat(
+                'boolean(svrl:schematron-output[svrl:fired-rule]) and
+                not(boolean((svrl:schematron-output/svrl:failed-assert union svrl:schematron-output/svrl:successful-report)[
+                not(@role) or @role = (',
+                string-join(for $e in $error return concat(codepoints-to-string(39), $e, codepoints-to-string(39)), ','),
+                ')]))'
+                )"/>
+        </xsl:element>
+    </xsl:template>
+    
+    <xsl:template match="x:expect-rule">
+        <xsl:element name="x:expect">
+            <xsl:call-template name="make-label"/>
+            <xsl:attribute name="test">
+                <xsl:sequence select="if (@count) then 'count' else 'exists'"/>
+                <xsl:sequence select="'(svrl:schematron-output/svrl:fired-rule'"/>
+                <xsl:apply-templates select="@*" mode="make-predicate"/>
+                <xsl:sequence select="')'"/>
+                <xsl:sequence select="current()[@count]/concat(' eq ', @count)"/>
+            </xsl:attribute>
+        </xsl:element>
+    </xsl:template>
+    
+</xsl:stylesheet>

data/vendor/xspec-1.0.0/test/Makefile

@@ -0,0 +1,117 @@
+# ========================================================================== #
+#   File:       test/Makefile                                                #
+#   Author:     Jeni Tennsion                                                #
+#   Tags:                                                                    #
+#     Copyright (c) 2010 Jeni Tennsion (see end of file.)                    #
+# -------------------------------------------------------------------------- #
+#   TODO: Use the XSpec test harnesses (in XProc) themselves, by using
+#   XProject directly.  Adapt the process to be able (for some tests) to
+#   compile some XSpec code and test either (1) its report or (2) the result
+#   of its compilation.
+# ----------------------------------------------------------------------------
+#   To use this Makefile, $SAXON_HOME must be set to a directory that
+#   contains either saxon9.jar (for B in 9.1 or below) or saxon9he.jar
+#   (for HE in 9.2 and above).  Set it the usual way you set environ
+#   variables.
+# ----------------------------------------------------------------------------
+
+
+# the classpath to invoke Saxon
+CP=$$SAXON_HOME/saxon9he.jar:$$SAXON_HOME/saxon9.jar
+# invoke Saxon as XSLT processor
+XSLT=java -cp $(CP) net.sf.saxon.Transform
+# invoke Saxon as XQuery processor
+XQUERY=java -cp $(CP) net.sf.saxon.Query
+
+### MAIN TARGETS ###
+
+# run all tests
+all: xslt xquery
+
+# run XSLT tests
+xslt: xspec-function-xsl.html                     \
+      xspec-rule-xsl.html                         \
+      xspec-import-xsl.html                       \
+      xspec-focus-1-xsl.html                      \
+      xspec-focus-2-xsl.html                      \
+      xspec-pending-xsl.html                      \
+      xspec-variable-xsl.html                     \
+      generate-tests-utils-xsl.html               \
+      generate-xspec-tests-xsl.html
+
+# run XQuery tests
+xquery: xspec-function-xq.html                    \
+        xspec-import-xq.html                      \
+        xspec-focus-1-xq.html                     \
+        xspec-focus-2-xq.html                     \
+        xspec-pending-xq.html                     \
+        xspec-variable-xq.html                    \
+        generate-tests-utils-xq.html
+
+# clean result files
+clean:
+	rm -fv *.html
+
+### FILE RULES ###
+
+# compile to XSLT
+%.xsl: %.xspec
+	$(XSLT)                                               \
+	    -xsl:../src/compiler/generate-xspec-tests.xsl     \
+	    -s:$<                                             \
+	    -o:$@
+
+# compile to XQuery
+%.xq: %.xspec
+	$(XSLT)                                               \
+	    -xsl:../src/compiler/generate-query-tests.xsl     \
+	    -s:$<                                             \
+	    -o:$@
+
+# run an XSLT compiled suite
+%-xsl.xml: %.xsl xspec-tested.xsl
+	$(XSLT)                                               \
+	    -xsl:$<                                           \
+	    -o:$@                                             \
+	    -it:"{http://www.jenitennison.com/xslt/xspec}main"
+
+# run an XQuery compiled suite
+%-xq.xml: %.xq xspec-tested.xql
+	$(XQUERY)                                             \
+	    -o:$@ $< '!indent=yes'
+
+# format an XML report to HTML
+%.html: %.xml
+	$(XSLT)                                               \
+	    -xsl:../src/reporter/format-xspec-report.xsl      \
+	    -s:$<                                             \
+	    -o:$@
+
+
+# -------------------------------------------------------------------------- #
+#   DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS COMMENT.                #
+#                                                                            #
+#   Copyright (c) 2010 Jeni Tennsion                                         #
+#                                                                            #
+#   The contents of this file are subject to the MIT License (see the URI    #
+#   http://www.opensource.org/licenses/mit-license.php for details).         #
+#                                                                            #
+#   Permission is hereby granted, free of charge, to any person obtaining    #
+#   a copy of this software and associated documentation files (the          #
+#   "Software"), to deal in the Software without restriction, including      #
+#   without limitation the rights to use, copy, modify, merge, publish,      #
+#   distribute, sublicense, and/or sell copies of the Software, and to       #
+#   permit persons to whom the Software is furnished to do so, subject to    #
+#   the following conditions:                                                #
+#                                                                            #
+#   The above copyright notice and this permission notice shall be           #
+#   included in all copies or substantial portions of the Software.          #
+#                                                                            #
+#   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,          #
+#   EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF       #
+#   MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.   #
+#   IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY     #
+#   CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,     #
+#   TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE        #
+#   SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.                   #
+# -------------------------------------------------------------------------- #

data/vendor/xspec-1.0.0/test/README

@@ -0,0 +1,5 @@
+Those test suites try to cover all features of XSpec, and are aimed to
+be run as any other suites to test a specific implementation of XSpec.
+This is NOT an automated test set, as which test must pass and which
+test must fail is not autmatically checked.  We need something better,
+but this is better than nothing.

data/vendor/xspec-1.0.0/test/catalog/xspec-160_catalog.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog">
+	<rewriteURI rewritePrefix="../../tutorial/" uriStartString="xspec-tutorial:/" />
+</catalog>

data/vendor/xspec-1.0.0/test/catalog/xspec-160_schematron.xspec

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<?xml-model href="../../src/schemas/xspec.rnc" type="application/relax-ng-compact-syntax"?>
+<x:description schematron="xspec-tutorial:/schematron/demo-04.sch"
+	xmlns:x="http://www.jenitennison.com/xslt/xspec">
+	<x:import href="xspec-tutorial:/schematron/demo-04.xspec" />
+</x:description>

data/vendor/xspec-1.0.0/test/catalog/xspec-160_xslt.xspec

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<x:description stylesheet="xspec-tutorial:/escape-for-regex.xslt"
+	xmlns:functx="http://www.functx.com" xmlns:x="http://www.jenitennison.com/xslt/xspec">
+	<x:import href="xspec-tutorial:/escape-for-regex.xspec" />
+</x:description>

data/vendor/xspec-1.0.0/test/end-to-end/README.md

@@ -0,0 +1,42 @@
+This procedure is a primitive end-to-end testing for XSpec itself.
+
+The primary goal is to verify that XSpec is generating the report HTML files as expected. The test should be done as simply as possible and without using XSpec itself.
+
+## Preparing the expected HTML files
+
+First you need to set up the expected HTML files. This is a manual operation which you have to perform only once.
+
+1. Put `*.xspec` files into the `cases` directory.
+
+1. Run `./generate-expected.sh` (or `.cmd`).
+
+	The script executes the `cases/*.xspec` files.
+	
+	In the `cases/expected` directory, two kinds of the report HTML files are generated:
+	
+	* Original ones: `*-result.html`
+	* Normalized ones: `*-result-norm.html`
+	
+1. Verify that the original ones (`*-result.html`) contain the scenario results as expected.
+
+1. Compare the normalized ones (`*-result-norm.html`) with the original ones (`*-result.html`).
+
+	Verify that they are essentially identical. Only the transient parts (`href`, `id`, datetime and file path) should be different.
+
+1. Commit the normalized ones (`*-result-norm.html`) to the repository. (You can discard the other sibling files.)
+
+	They are called the expected HTML files hereafter.
+
+## Running the regular tests
+
+Once the expected HTML files are prepared, you can run tests regularly by executing `./run-e2e-tests.sh` (or `.cmd`).
+
+The script performs these tasks in sequence:
+
+1. Executes the `cases/*.xspec` files.
+
+	The report HTML files are generated: `cases/xspec/*-result.html`
+
+1. Loads the report HTML files, normalizes them on memory, and compares them with the expected HTML files (`cases/expected/*-result-norm.html`).
+
+	If they are different, the test is considered as failure.

data/vendor/xspec-1.0.0/test/end-to-end/cases/.gitignore

@@ -0,0 +1 @@
+/xspec/

data/vendor/xspec-1.0.0/test/end-to-end/cases/expected/.gitignore

@@ -0,0 +1,3 @@
+/*-result.html
+/*.xml
+/*.xsl

data/vendor/xspec-1.0.0/test/end-to-end/cases/expected/xspec-50-result-norm.html

@@ -0,0 +1,74 @@
+<?xml version="1.0" encoding="UTF-8"?><html xmlns:test="http://www.jenitennison.com/xslt/unit-test" xmlns="http://www.w3.org/1999/xhtml">
+   <head>
+      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+      <title>Test Report for xspec-50.xsl (passed: 0 / pending: 0 / failed: 1 / total: 1)</title>
+      <link rel="stylesheet" type="text/css" href="../../../../src/reporter/test-report.css" />
+   </head>
+   <body>
+      <h1>Test Report</h1>
+      <p>Stylesheet: <a href="xspec-50.xsl">xspec-50.xsl</a></p>
+      <p>Tested: ONCE-UPON-A-TIME</p>
+      <h2>Contents</h2>
+      <table class="xspec">
+         <col width="75%" />
+         <col width="6.25%" />
+         <col width="6.25%" />
+         <col width="6.25%" />
+         <col width="6.25%" />
+         <thead>
+            <tr>
+               <th></th>
+               <th class="totals">passed: 0</th>
+               <th class="totals">pending: 0</th>
+               <th class="totals">failed: 1</th>
+               <th class="totals">total: 1</th>
+            </tr>
+         </thead>
+         <tbody>
+            <tr class="failed">
+               <th><a href="#ELEM-31">Expecting xs:hexBinary('0123') when $x:result is xs:untypedAtomic('0123')</a></th>
+               <th class="totals">0</th>
+               <th class="totals">0</th>
+               <th class="totals">1</th>
+               <th class="totals">1</th>
+            </tr>
+         </tbody>
+      </table>
+      <div id="ELEM-31">
+         <h2 class="failed">Expecting xs:hexBinary('0123') when $x:result is xs:untypedAtomic('0123')<span class="scenario-totals">passed: 0 / pending: 0 / failed: 1 / total: 1</span></h2>
+         <table class="xspec" id="ELEM-33">
+            <col width="75%" />
+            <col width="25%" />
+            <tbody>
+               <tr class="failed">
+                  <th>Expecting xs:hexBinary('0123') when $x:result is xs:untypedAtomic('0123')</th>
+                  <th>passed: 0 / pending: 0 / failed: 1 / total: 1</th>
+               </tr>
+               <tr class="failed">
+                  <td><a href="#ELEM-45">must generate a failure report HTML which reads [Result] = "xs:untypedAtomic('0123')"
+                        and [Expected Result] = "xs:hexBinary('0123')"</a></td>
+                  <td>Failure</td>
+               </tr>
+            </tbody>
+         </table>
+         <h3 id="ELEM-31">Expecting xs:hexBinary('0123') when $x:result is xs:untypedAtomic('0123')</h3>
+         <h4 id="ELEM-45">must generate a failure report HTML which reads [Result] = "xs:untypedAtomic('0123')"
+            and [Expected Result] = "xs:hexBinary('0123')"
+         </h4>
+         <table class="xspecResult">
+            <thead>
+               <tr>
+                  <th>Result</th>
+                  <th>Expected Result</th>
+               </tr>
+            </thead>
+            <tbody>
+               <tr>
+                  <td><pre>xs:untypedAtomic('0123')</pre></td>
+                  <td><pre>xs:hexBinary('0123')</pre></td>
+               </tr>
+            </tbody>
+         </table>
+      </div>
+   </body>
+</html>