xunit

Home > Books > NetKernel API and Services Reference > Accessor Listing > XUnit - Unit Test Framework > xunit

Module

The xunit accessor is exported by the urn:org:ten60:netkernel:ext:xunit module. Import this module to gain access to the accessor.

Syntax

URI

active:xunit

Argument	Rules	Description
testlist	Mandatory	the URI of the unit testlist to be run

Example Usage

DPML

<instr>
  <type>xunit</type>
  <testlist>ffcpl:/path/mytestlist.xml</testlist>
  <target>var:result</target>
</instr>

NetKernel Foundation API

req=context.createSubRequest("active:xunit");
req.addArgument("testlist", [resource representation, aspect, or URI] );
result=context.issueSubRequest(req);

Purpose

The xunit accessor runs a unit test list with the NetKernel Unit Test framework. The unit test engine will execute the tests specified by testlist argument. It will then perform optional assertions on the results. The results of the tests can be returned in either XHTML or XML format using the @output attribute on the testlist - default is XML which is required for dynamic integration in the control panel test framework.

A guide to using the unit test framework is available here.

TestList Format

A test list has the following form...

<testlist output="xml" title="XUnit Self Tests">
  <!--
An optional XHTML description
-->
  <desc />
  <!--
One or more tests or further groups of tests
-->
  <test>
    <uri>active:dpml+operand@ffcpl:/mytest.idoc</uri>
    <assert>
            ...Optional assertions on the results...
        </assert>
  </test>
    ...
    
  <group title="A Test Group">
    <uri>ffcpl:/mytestsuite.xml</uri>
  </group>
    ...

</testlist>