XSLTunit

3.1. Getting started.

A XSLTunit set of tests is a XSLT transformation that imports the tested stylesheet and xsltunit.xsl, for instance:

<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" 
 xmlns:xsl="www.w3.org/1999/XSL/Transform" 
 xmlns:exsl="exslt.org/common" 
 extension-element-prefixes="exsl"
 xmlns:xsltu="xsltunit.org/0/"
 exclude-result-prefixes="exsl">
  <xsl:import class="library.xsl"/>
  <xsl:import class="xsltunit.xsl"/>
  <xsl:output method="xml" version="1.0" encoding="UTF-8" indent="yes"/>
.../...
</xsl:stylesheet>

This example will be using a EXSLT extension to convert result tree fragments into nodeset and that's the reason why we have included the declaration of the namespace for EXSLT.

The XSLTunit namespace is used to identify modes and named templates belonging to XSLTunit as well as the vocabulary used by the test report.

This transformation will gain control (typically using a template on the document element) and generate the test report.

The document element of the test report will typically be xsltu:tests.

  <xsl:template match="/">
    <xsltu:tests>
.../...
    </xsltu:tests>
  </xsl:template>

3.2. Our first test

Let's assume we want to test that the formatting of the title of a book described in a document will have a specific value. We will write this test as: :

<xsltu:test id="test-title">
        <xsl:call-template name="xsltu:assertEqual">
          <xsl:with-param name="id" select="'full-value'"/>
          <xsl:with-param name="nodes1">
            <xsl:apply-templates select="document('library.xml')/library/book[isbn='0836217462']/title"/>
          </xsl:with-param>
          <xsl:with-param name="nodes2">
            <h1>Being a Dog Is a Full-Time Job</h1>
          </xsl:with-param>
        </xsl:call-template>
      </xsltu:test>

The named template "xsltu:assertEqual" will compare the two parameters nodes1 (that will contain the result of the transformation of the title) and nodes2 (containing the expected value) and generate the report for this test using the id defined in its id parameter).

The result will be for instance (if the test passes):

<xsltu:test id="test-title">
   <xsltu:assert id="full-value" outcome="passed"/>
</xsltu:test>

Or (if the test fails because the transformation has added a "!"):

<xsltu:test id="test-title">
 <xsltu:assert id="full-value" outcome="failed">
   <xsltu:message>
      <xsltu:diff name="">
         <xsltu:diff name="h1">
            <xsltu:no-match>
               <xsltu:node>Being a Dog Is a Full-Time Job!</xsltu:node>
               <xsltu:node>Being a Dog Is a Full-Time Job</xsltu:node>
            </xsltu:no-match>
         </xsltu:diff>
      </xsltu:diff>
   </xsltu:message>
 </xsltu:assert>
</xsltu:test>

3.3. Testing that values are not equal

The test can also be reverted and we can test that two variables are different, for instance if we wanted to test that the result will not be an empty h1 element:

      <xsltu:test id="test-title-reverted">
        <xsl:call-template name="xsltu:assertNotEqual">
          <xsl:with-param name="id" select="'non-empty-h1'"/>
          <xsl:with-param name="nodes1">
            <xsl:apply-templates select="document('library.xml')/library/book[isbn='0836217462']/title"/>
          </xsl:with-param>
          <xsl:with-param name="nodes2">
            <h1/>
          </xsl:with-param>
        </xsl:call-template>
      </xsltu:test>

3.4. Testing XPath expressions

For those situations that require more flexibility, XPath expressions can be tested using the xsltu:assert named pattern, for instance:

      <xsltu:test id="XPath-expressions">
        <xsl:variable name="source">
          <title>My title</title>
        </xsl:variable>
        <xsl:variable name="result-rtf">
          <xsl:apply-templates select="exsl:node-set($source)/title"/>
        </xsl:variable>
        <xsl:variable name="result" select="exsl:node-set($result-rtf)"/>
        <xsl:call-template name="xsltu:assert">
          <xsl:with-param name="id" select="'h1'"/>
          <xsl:with-param name="test" select="$result/h1"/>
          <xsl:with-param name="message">This should be a h1!</xsl:with-param>
        </xsl:call-template>
        <xsl:call-template name="xsltu:assert">
          <xsl:with-param name="id" select="'value'"/>
          <xsl:with-param name="test" select="$result/h1=$source"/>
          <xsl:with-param name="message">h1 is "<xsl:value-of select="$result/h1"/>"</xsl:with-param>
        </xsl:call-template>
      </xsltu:test>

XSLTunit library

This library is imported into XSLTunit sets of tests.

This release must be run using a EXSLT compliant XSLT processor (such as Saxon, libxslt, 4xslt, Xalan-J, ...).

XSLTunit example

This XSLT unit suite is the one that is decribed in the tutorial.

Library instance document

This instance document is used as an example in the tutorial.

Library XSLT transformation.

This transformation is the one that is tested in the tutorial.

CSS Stylesheet

A CSS stylesheet borrowed from RDDL used to provide the "look-and-feel" of this document, suitable in general for RDDL documents.

CSS Stylesheet (original).

Original version of the previous CSS stylesheet on rddl.org.

V0.2

• Replaced the Saxon specific "saxon:nodeSet" extension by the EXSLT generic "exsl:node-set" extension (same parameters and semantic).

V0.1

• Creation