simple-xspec-wrapper 0.1.0-java

data/vendor/xspec-1.0.0/test/end-to-end/processor/_normalizer.xsl

@@ -0,0 +1,192 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<xsl:stylesheet exclude-result-prefixes="#all" version="2.0"
+	xmlns:local="x-urn:xspec:test:end-to-end:processor:normalizer:local"
+	xmlns:normalizer="x-urn:xspec:test:end-to-end:processor:normalizer"
+	xmlns:util="x-urn:xspec:test:end-to-end:processor:util"
+	xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+	xpath-default-namespace="http://www.w3.org/1999/xhtml">
+
+	<!--
+		This stylesheet module provides a primitive normalizer for the XSpec report HTML.
+	-->
+
+	<!--
+		Public functions
+	-->
+
+	<!-- Normalizes the transient parts of the document such as @href, @id, datetime and file path -->
+	<xsl:function as="document-node()" name="normalizer:normalize">
+		<xsl:param as="document-node()" name="doc" />
+
+		<xsl:apply-templates mode="local:normalize" select="$doc" />
+	</xsl:function>
+
+	<!--
+		Private templates
+	-->
+
+	<!-- Identity template, in lowest priority -->
+	<xsl:template as="node()" match="document-node() | attribute() | node()" mode="local:normalize"
+		priority="-1">
+		<xsl:copy>
+			<xsl:apply-templates mode="#current" select="attribute() | node()" />
+		</xsl:copy>
+	</xsl:template>
+
+	<!--
+		Removes comments and processing instructions
+			They are often ignored by fn:deep-equal(). So remove them explicitly in the first place.
+	-->
+	<xsl:template as="empty-sequence()" match="comment() | processing-instruction()"
+		mode="local:normalize" />
+
+	<!--
+		Normalizes the title text
+			Example:
+				in:		<title>Test Report for /path/to/tested.xsl (passed: 2 / pending: 0 / failed: 1 / total: 3)</title>
+				out:	<title>Test Report for tested.xsl (passed: 2 / pending: 0 / failed: 1 / total: 3)</title>
+	-->
+	<xsl:template as="text()" match="/html/head/title/text()" mode="local:normalize">
+		<xsl:analyze-string regex="^(Test Report for) (.+) (\([a-z0-9/: ]+\))$" select=".">
+			<xsl:matching-substring>
+				<xsl:value-of
+					select="
+						regex-group(1),
+						util:filename-and-extension(regex-group(2)),
+						regex-group(3)"
+					separator=" " />
+			</xsl:matching-substring>
+		</xsl:analyze-string>
+	</xsl:template>
+
+	<!--
+		Replaces the embedded CSS with the link to its source
+			For brevity. The details of style are not critical anyway.
+	-->
+	<xsl:template as="element(link)" match="/html/head/style" mode="local:normalize">
+		<link rel="stylesheet" type="text/css" xmlns="http://www.w3.org/1999/xhtml">
+			<xsl:attribute name="href">
+				<!-- Relative path to XSPEC_HOME from XSPEC_HOME/test/end-to-end/cases/*/*.html -->
+				<xsl:text>../../../../</xsl:text>
+
+				<!-- and down to the CSS source -->
+				<xsl:text>src/reporter/test-report.css</xsl:text>
+			</xsl:attribute>
+		</link>
+	</xsl:template>
+
+	<!--
+		Normalizes the link to the tested module
+			Example:
+				in:		<a href="file:/path/to/tested.xsl">/path/to/tested.xsl</a>
+				out:	<a href="tested.xsl">tested.xsl</a>
+	-->
+	<xsl:template as="element(a)" match="/html/body/p[1]/a" mode="local:normalize">
+		<xsl:copy>
+			<xsl:apply-templates mode="#current" select="attribute()" />
+			<xsl:attribute name="href" select="util:filename-and-extension(@href)" />
+
+			<xsl:value-of select="util:filename-and-extension(.)" />
+		</xsl:copy>
+	</xsl:template>
+
+	<!--
+		Normalizes datetime
+			Example:
+				in:		<p>Tested: 23 February 2017 at 11:18</p>
+				out:	<p>Tested: ONCE-UPON-A-TIME</p>
+	-->
+	<xsl:template as="text()" match="/html/body/p[2]/text()" mode="local:normalize">
+		<!-- Use analyze-string() so that the transformation will fail when nothing matches -->
+		<xsl:analyze-string regex="^(Tested:) .+$" select=".">
+			<xsl:matching-substring>
+				<xsl:value-of select="regex-group(1), 'ONCE-UPON-A-TIME'" />
+			</xsl:matching-substring>
+		</xsl:analyze-string>
+	</xsl:template>
+
+	<!-- Makes @id predictable -->
+	<xsl:template as="attribute(id)" match="@id" mode="local:normalize"
+		name="normalize-id-attribute">
+		<xsl:attribute name="{local-name()}" namespace="{namespace-uri()}"
+			select="local:generate-predictable-id(parent::element())" />
+	</xsl:template>
+
+	<!--
+		Makes the in-page link follow its target element
+			@id of the target element is normalized by the 'normalize-id-attribute' template. So @href has to follow it.
+	-->
+	<xsl:template as="attribute(href)" match="@href[starts-with(., '#')]" mode="local:normalize">
+		<!-- Substring after '#' -->
+		<xsl:variable as="xs:string" name="original-id" select="substring(., 2)" />
+
+		<xsl:variable as="element()?" name="target-element"
+			select="local:element-by-id(., $original-id)" />
+
+		<xsl:variable as="xs:string" name="predictable-id">
+			<xsl:choose>
+				<xsl:when test="$target-element">
+					<xsl:sequence select="local:generate-predictable-id($target-element)" />
+				</xsl:when>
+
+				<!-- @href's target element may not exist for pending scenarios: xspec/xspec#85 -->
+				<xsl:when test="parent::a/parent::th/parent::tr/@class eq 'pending'">
+					<!-- Assume that @href is always unique when the scenario is pending -->
+					<xsl:if test="count(//@href[. eq current()]) eq 1">
+						<!-- Use the current element's ID, prefixing 'PENDING_' to it -->
+						<xsl:sequence
+							select="concat('PENDING_', local:generate-predictable-id(parent::element()))"
+						 />
+					</xsl:if>
+				</xsl:when>
+			</xsl:choose>
+		</xsl:variable>
+
+		<xsl:attribute name="{local-name()}" namespace="{namespace-uri()}"
+			select="concat('#', $predictable-id)" />
+	</xsl:template>
+
+	<!--
+		Private utility functions
+	-->
+
+	<!-- Gets the positional index (1~) of element -->
+	<xsl:function as="xs:integer" name="local:element-index">
+		<xsl:param as="element()" name="element" />
+
+		<xsl:sequence select="count($element/preceding::element()) + 1" />
+	</xsl:function>
+
+	<!--
+		Returns the element whose original @id is equal to the specified ID
+			If multiple elements satisfy the condition, returns the first element.
+	-->
+	<xsl:function as="element()?" name="local:element-by-id">
+		<xsl:param as="node()" name="context-node" />
+		<xsl:param as="xs:string" name="id" />
+
+		<xsl:variable as="document-node()" name="doc" select="root($context-node)" />
+		<xsl:sequence select="$doc/descendant::element()[@id eq $id][1]" />
+	</xsl:function>
+
+	<!--
+		Generates ID for element
+			Unlike fn:generate-id(), ID is generated solely from the element's positional index. So the ID value is predictable.
+	-->
+	<xsl:function as="xs:string" name="local:generate-predictable-id">
+		<xsl:param as="element()" name="element" />
+
+		<!--
+			Unfortunately the original @id is not always unique: xspec/xspec#78
+			So, for calculating the element index, you can't simply use the specified element. You have to determine which element to use.
+		-->
+		<xsl:variable as="element()" name="index-element"
+			select="
+				if ($element/@id) then
+					local:element-by-id($element, $element/@id)
+				else
+					$element" />
+
+		<xsl:sequence select="concat('ELEM-', local:element-index($index-element))" />
+	</xsl:function>
+</xsl:stylesheet>

data/vendor/xspec-1.0.0/test/end-to-end/processor/_serializer.xsl

@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<xsl:stylesheet exclude-result-prefixes="#all" version="2.0"
+	xmlns:serializer="x-urn:xspec:test:end-to-end:processor:serializer"
+	xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
+
+	<!--
+		This stylesheet module helps serialize the report HTML.
+	-->
+
+	<!--
+		Set of serialization parameters
+			The parameters must be in sync with XSPEC_HOME/src/reporter/format-xspec-report.xsl.
+	-->
+	<xsl:output name="serializer:output" />
+</xsl:stylesheet>

data/vendor/xspec-1.0.0/test/end-to-end/processor/_util.xsl

@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<xsl:stylesheet exclude-result-prefixes="#all" version="2.0"
+	xmlns:util="x-urn:xspec:test:end-to-end:processor:util"
+	xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
+
+	<!--
+		This stylesheet module is a collection of utilities.
+	-->
+
+	<!--
+		Extracts filename (with extension) from slash-delimited path
+			Example:
+				in:		"file:/path/to/foo.bar.baz" or "/path/to/foo.bar.baz"
+				out:	"foo.bar.baz"
+	-->
+	<xsl:function as="xs:string" name="util:filename-and-extension">
+		<xsl:param as="xs:string" name="uri" />
+
+		<xsl:sequence select="tokenize($uri, '/')[last()]" />
+	</xsl:function>
+
+	<!--
+		Extracts filename (without extension) from slash-delimited path
+			Example:
+				in:		"file:/path/to/foo.bar.baz" or "/path/to/foo.bar.baz"
+				out:	"foo.bar"
+	-->
+	<xsl:function as="xs:string" name="util:filename-without-extension">
+		<xsl:param as="xs:string" name="uri" />
+
+		<xsl:variable as="xs:string+" name="except-last"
+			select="tokenize(util:filename-and-extension($uri), '\.')[position() lt last()]" />
+		<xsl:sequence select="string-join($except-last, '.')" />
+	</xsl:function>
+</xsl:stylesheet>

data/vendor/xspec-1.0.0/test/end-to-end/processor/compare.xsl

@@ -0,0 +1,88 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<xsl:stylesheet exclude-result-prefixes="#all" version="2.0"
+	xmlns:deserializer="x-urn:xspec:test:end-to-end:processor:deserializer"
+	xmlns:normalizer="x-urn:xspec:test:end-to-end:processor:normalizer"
+	xmlns:saxon="http://saxon.sf.net/"
+	xmlns:serializer="x-urn:xspec:test:end-to-end:processor:serializer"
+	xmlns:util="x-urn:xspec:test:end-to-end:processor:util"
+	xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
+
+	<!--
+		This master stylesheet normalizes the input document and compares the normalized document with the expected HTML file.
+			Note: Comparison is performed by fn:deep-equal() which may ignore some comments and processing instructions.
+	-->
+
+	<xsl:include href="_deserializer.xsl" />
+	<xsl:include href="_normalizer.xsl" />
+	<xsl:include href="_serializer.xsl" />
+	<xsl:include href="_util.xsl" />
+
+	<xsl:output method="text" />
+
+	<!--
+		URI of the expected HTML file
+			Its content must be already normalized by the 'normalizer:normalize' template.
+	-->
+	<xsl:param as="xs:anyURI" name="EXPECTED-HTML"
+		select="
+			resolve-uri(
+			concat('../expected/', util:filename-without-extension(base-uri()), '-norm.html'),
+			base-uri())" />
+
+	<xsl:param as="xs:boolean" name="DEBUG" select="false()" />
+
+	<xsl:template as="text()+" match="document-node()">
+		<!-- Load the expected HTML -->
+		<xsl:variable as="document-node()" name="expected-doc"
+			select="deserializer:unindent(doc($EXPECTED-HTML))" />
+
+		<!-- Normalize the input document -->
+		<xsl:variable as="document-node()" name="input-doc" select="deserializer:unindent(.)" />
+		<xsl:variable as="document-node()" name="normalized-input-doc"
+			select="normalizer:normalize($input-doc)" />
+
+		<!-- Compare the normalized input document with the expected document -->
+		<xsl:variable as="xs:boolean" name="comparison-result"
+			select="deep-equal($normalized-input-doc, $expected-doc)" />
+
+		<!-- Diagnostic output -->
+		<xsl:if test="not($comparison-result) or $DEBUG">
+			<!-- Save the normalized input document -->
+			<xsl:variable as="xs:anyURI" name="normalized-input-html"
+				select="
+					resolve-uri(
+					concat(util:filename-without-extension(base-uri()), '-norm.html'),
+					base-uri())" />
+			<xsl:result-document format="serializer:output" href="{$normalized-input-html}">
+				<xsl:sequence select="$normalized-input-doc" />
+			</xsl:result-document>
+			<xsl:message select="'Saved the normalized input:', $normalized-input-html" />
+
+			<!-- Print the documents -->
+			<xsl:message select="'[NORMALIZED INPUT]', $normalized-input-doc" />
+			<xsl:message select="'[EXPECTED]', $expected-doc" />
+
+			<!-- Print the diff by passing '?' flag to saxon:deep-equal()-->
+			<xsl:if
+				test="
+					saxon:deep-equal($normalized-input-doc, $expected-doc, (), '?')
+					ne $comparison-result"
+				use-when="function-available('saxon:deep-equal') (: Requires Saxon-PE :)">
+				<!-- Terminate if saxon:deep-equal() contradicts the comparison result -->
+				<xsl:message terminate="yes" />
+			</xsl:if>
+		</xsl:if>
+
+		<!-- Output the comparison result -->
+		<xsl:value-of select="
+				if ($comparison-result) then
+					'OK'
+				else
+					'FAILED'" />
+		<xsl:text>: Compared </xsl:text>
+		<xsl:value-of select="base-uri()" />
+		<xsl:text> with </xsl:text>
+		<xsl:value-of select="$EXPECTED-HTML" />
+		<xsl:text>&#x0A;</xsl:text>
+	</xsl:template>
+</xsl:stylesheet>

data/vendor/xspec-1.0.0/test/end-to-end/processor/normalize.xsl

@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<xsl:stylesheet exclude-result-prefixes="#all" version="2.0"
+	xmlns:deserializer="x-urn:xspec:test:end-to-end:processor:deserializer"
+	xmlns:normalizer="x-urn:xspec:test:end-to-end:processor:normalizer"
+	xmlns:serializer="x-urn:xspec:test:end-to-end:processor:serializer"
+	xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
+
+	<!--
+		This master stylesheet normalizes the input document.
+	-->
+
+	<xsl:include href="_deserializer.xsl" />
+	<xsl:include href="_normalizer.xsl" />
+	<xsl:include href="_serializer.xsl" />
+	<xsl:include href="_util.xsl" />
+
+	<xsl:template as="empty-sequence()" match="document-node()">
+		<xsl:message select="'Normalizing', base-uri()" />
+
+		<xsl:variable as="document-node()" name="input-doc" select="deserializer:unindent(.)" />
+
+		<xsl:result-document format="serializer:output">
+			<xsl:sequence select="normalizer:normalize($input-doc)" />
+		</xsl:result-document>
+
+		<xsl:message select="'Normalized'" />
+	</xsl:template>
+</xsl:stylesheet>

data/vendor/xspec-1.0.0/test/end-to-end/run-e2e-tests.cmd

@@ -0,0 +1,61 @@
+@echo off
+
+rem
+rem Begin localization of environment changes.
+rem Also make sure the command processor extensions are enabled.
+rem
+verify other 2> NUL
+setlocal enableextensions
+if errorlevel 1 (
+    echo Unable to enable extensions
+    exit /b %ERRORLEVEL%
+)
+
+rem
+rem Go to the directory where this script resides
+rem
+pushd "%~dp0"
+
+rem
+rem .xspec files directory
+rem
+set CASES_DIR=cases
+
+rem
+rem XSpec output directory (same as default)
+rem
+set TEST_DIR=%CASES_DIR%\xspec
+
+rem
+rem Run test cases
+rem
+for %%I in ("%CASES_DIR%\*.xspec") do (
+    if /i "%APPVEYOR%"=="True" appveyor AddTest "%%~I" -Framework custom -Filename "%~nx0" -Outcome Running
+
+    rem
+    rem Generate the report HTML
+    rem
+    "%COMSPEC%" /c ..\..\bin\xspec.bat "%%~I" > NUL 2>&1
+
+    rem
+    rem Compare with the expected HTML
+    rem
+    java -classpath "%SAXON_CP%" net.sf.saxon.Transform -s:"%TEST_DIR%\%%~nI-result.html" -xsl:processor\compare.xsl | findstr /b /l /c:"OK: Compared "
+    if errorlevel 1 (
+        echo FAILED: %%~I
+        if /i "%APPVEYOR%"=="True" appveyor UpdateTest "%%~I" -Framework custom -Filename "%~nx0" -Outcome Failed -Duration 0
+        exit /b 1
+    )
+
+    if /i "%APPVEYOR%"=="True" appveyor UpdateTest "%%~I" -Framework custom -Filename "%~nx0" -Outcome Passed -Duration 0
+)
+
+rem
+rem Go back to the initial directory
+rem
+popd
+
+rem
+rem Exit as success
+rem
+exit /b 0

data/vendor/xspec-1.0.0/test/end-to-end/run-e2e-tests.sh

@@ -0,0 +1,28 @@
+#!/bin/bash
+
+# This script must be run from the script's directory
+
+# .xspec files directory
+CASES_DIR=cases
+
+# XSpec output directory (same as default)
+export TEST_DIR=${CASES_DIR}/xspec
+
+# Run test cases
+for CASE_FILEPATH in ${CASES_DIR}/*.xspec
+do
+    # Generate the report HTML
+    ../../bin/xspec.sh ${CASE_FILEPATH} > /dev/null 2>&1
+
+    # Compare with the expected HTML
+    CASE_FILENAME=${CASE_FILEPATH##*/}
+    CASE_BASENAME=${CASE_FILENAME%.xspec}
+    if java -classpath ${SAXON_CP} net.sf.saxon.Transform -s:${TEST_DIR}/${CASE_BASENAME}-result.html -xsl:processor/compare.xsl | grep '^OK: Compared '
+        then
+            # OK, nothing to do
+            :
+        else
+            echo "FAILED: ${CASE_FILEPATH}"
+            exit 1
+    fi
+done