Astroblahhh.Com - Software Blog Archive

Posts Below
✼	2/3/2017 - How to get the Schematron Testing Framework (stf) to run in Lighthouse 64 Puppy Linux 6.02 Beta 2
✼	2/5/2017 - A simple Schematron demo for PHP 5.6.28 and Saxon/C 1.0.2

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 ↓ Down

▲ Top ▼ Bottom △ TOC Up ↑
A simple Schematron demo for PHP 5.6.28 and Saxon/C 1.0.2
Sunday, February 5th, 2017
04:38:05 GMT

Today, I figured out how to use the XML-validation language Schematron with PHP 5.6.28 and the XSLT processor Saxon/C 1.0.2.

And since examples of using Schematron with PHP plus Saxon/C currently seem to be quite rare on the web - possibly even nonexistent, except for my own - I put together this GitHub repo:

Simple-Schematron-Demo-for-PHP-5.6.28-and-Saxon-C-1.0.2

I only authored the PHP script and the "README.md" file. The included Schematron schema and XML files are my slightly modified versions of things from the the official Schematron repo.

Everything else is unmodified stuff from the official Schematron repo.

Now that I can use Schematron, I'm guessing I'm probably going to have a much easier time with all of my current and future XSLT projects.

Soon, I'll be able to be far more sure I'm generating valid VUE: Visual Understanding Environment concept maps with tools other than VUE itself. (Here's my slightly modified version of VUE.)

▲ Top ▼ Bottom △ TOC Up ↑

Software Blog Archive - Feb 2017