Astroblahhh.Com - Software Blog Post - How to get the Schematron Testing Framework (stf) to run in Lighthouse 64 Puppy Linux 6.02 Beta 2

Post Below
✼	2/3/2017 - How to get the Schematron Testing Framework (stf) to run in Lighthouse 64 Puppy Linux 6.02 Beta 2 (Software)

How to get the Schematron Testing Framework (stf) to run in Lighthouse 64 Puppy Linux 6.02 Beta 2

Friday, February 3rd, 2017
22:56:21 GMT

The operating system with which I accomplished the below was Lighthouse 64 Puppy Linux 6.02 Beta 2.

I've been messing around with XML and XSLT lately, since I want to use XSLT to do some clever things with VUE: Visual Understanding Environment concept maps. (Here's my slightly modified version of VUE.)

So, I've been trying to figure how to use the XML-validation language Schematron, so I'll have a way to validate concept map files I generate or modify with XSLT instead of VUE.

In addition to Schematron, I also stumbled across some Java software called the Schematron Testing Framework (stf), which I'm not yet sure I'm going to need, but, figured out how to run anyway just in case I ever do need it.

It took me a while, but I finally figured out I needed to download some other Java software, and edit the "properties.xml" file included with the Schematron Testing Framework (stf) to tell it where to find that other software in my system.

Here's my entire "properties.xml" file:

<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties version="1.0">
<comment>Local properties for 'stf' system.</comment>
<!-- NOTE: Use ${stf.basedir.converted} for files located relative
     to the 'stf' system directory. -->

<!-- NOTE: It is an Ant convention that Ant-style property references
     in property values, e.g., "${stf.basedir.converted}", will
     resolve to that property's value, provided the property was
     previously declared either earlier in the build process or
     earlier in the current property file. -->

<entry key="saxon.jar">/root/00-ApWorkspace/SaxonHE/saxon9he.jar</entry>
<entry key="calabash.jar">/usr/local/xmlcalabash-1.1.15-97/xmlcalabash-1.1.15-97.jar</entry>
<entry key="resolver.jar">/root/Downloads/xml-commons-resolver-1.2/resolver.jar</entry>
</properties>

In addition to the Schematron Testing Framework (stf) itself, I had to download the following three Java programs. I lazily downloaded binaries instead of compiling anything from scratch. (Possibly other versions than the ones I used would work.)

Saxon-HE 9.7.0.14. You can get the "saxon9he.jar" file you need simply by unzipping "SaxonHE9-7-0-14J.zip".
Quoted from the official web page about libre, open-source editions of Saxon:

"Saxon-HE (Home Edition) is the open-source version of the Saxon XSLT and XQuery processor."
XML Calabash 1.1.15-97. The "xmlcalabash-1.1.15-97.jar" file is an installer, which you can run either by double-clicking on it, or opening a console at its folder, and using this command:

java -jar xmlcalabash-1.1.15-97.jar
Quoted from the official XML Calabash web page:

"XML Calabash is an implementation of XProc: An XML Pipeline Language."
xml-commons-resolver-1.2.zip - Another file you can just unzip and don't have to install in any special place. The file you need for the Schematron Testing Framework (stf) is "resolver.jar".
Here's the official Apache xml-commons web page.

I also used:

The Java Development Kit (JDK) 1.8.0_51 for 64-bit Linuxes.
Apache Ant v1.10.0.
Quoted from the official Apache Ant home page:

"Apache Ant is a Java library and command-line tool whose mission is to drive processes described in build files as targets and extension points dependent upon each other."

With everything installed and the "properties.xml" properly configured, all I had to do to run Schematron Testing Framework (stf) was go to stf's "example" folder, open a console there, and type:

ant

That resulted in this output:

sh-4.1# ant
Buildfile: /root/Downloads/stf-master/example/build.xml

test.stf-errors:
     [java] <errors><result><file>file:/root/Downloads/stf-master/example/stf-errors/nogo/foo-2.xml</file><error>Should be no reports or asserts.
     [java] Unexpected: ERROR_FOO:1</error></result><result><file>file:/root/Downloads/stf-master/example/stf-errors/nogo/foo-1.xml</file><error>Should be 1 reports or asserts for ERROR_QUX.  Found 0.</error><error>Unexpected: ERROR_FOO:1</error></result></errors>

test.no-stf-errors:
     [java] ERROR: err:XC0012:XC0012
     [java] ERROR: It is a dynamic error if the contents of the directory path are not available to the step due to access restrictions in the environment in which the pipeline is run.
     [java] Java Result: 1

test.all:

BUILD SUCCESSFUL
Total time: 4 seconds

To confirm that Schematron Testing Framework (stf) was really reading the example XML files "foo-1.xml" and "foo-2.xml", I edited them, which, as expected, changed the output of the "ant" command a bit:

sh-4.1# ant
Buildfile: /root/Downloads/stf-master/example/build.xml

test.stf-errors:
     [java] <errors><result><file>file:/root/Downloads/stf-master/example/stf-errors/nogo/foo-1.xml</file><error>Should be 1 reports or asserts for ERROR_BAR.  Found 0.</error><error>Should be 1 reports or asserts for ERROR_QUX.  Found 0.</error></result></errors>

test.no-stf-errors:
     [java] ERROR: err:XC0012:XC0012
     [java] ERROR: It is a dynamic error if the contents of the directory path are not available to the step due to access restrictions in the environment in which the pipeline is run.
     [java] Java Result: 1

test.all:

BUILD SUCCESSFUL
Total time: 4 seconds

▲ Top ▼ Bottom △ TOC

Software Blog Post:

How to get the Schematron Testing Framework (stf) to run in Lighthouse 64 Puppy Linux 6.02 Beta 2
2/3/2017

Software Blog Post:

How to get the Schematron Testing Framework (stf) to run in Lighthouse 64 Puppy Linux 6.02 Beta 22/3/2017

How to get the Schematron Testing Framework (stf) to run in Lighthouse 64 Puppy Linux 6.02 Beta 2
2/3/2017