Testing Using Sample Command Line Driver

The provided sample command-line driver can be used to experiment using REST from the command-line.

The command-line driver was written as proof of concept to demonstrate use of the REST API, and is not intended as a primary way of interacting with it.

Source code for the command-line driver is available as an IntelliJ/Maven project in a Bitbucket repository - https://bitbucket.org/deltaxml/docbook-compare-rest-java-cli/. Please customize as needed. This client uses XPath to process results.

For example:

CODE

java -jar deltaxml-docbook-rest-client-10.0.0.jar compare docbookFile1.xml docbookFile2.xml out.xml

 Docbook Compare REST command-line driver. (C) 2022 DeltaXML Ltd.  All rights reserved.

 Job running: http://0.0.0.0:8080/api/docbook-compare/v1/jobs/150b9897-d429-4322-928f-2e5272c9366a

 Progress:  
 QUEUED
 SUBMITTED
 STARTED
 INPUTS_LOADING_A
 INPUTS_LOADING_B
 INPUT_FILTERS
 COMPARISON_RUNNING
 OUTPUT_FILTERS
 SAVING
 FINISHED
Result written to out.xml

The client defaults to http://localhost:8080 but this can be changed by using the host property.

For example, if the REST service is running on port 1234 instead of 8080:

CODE

java -Dhost=http://localhost:1234 -jar deltaxml-docbook-rest-client-10.0.0.jar

In these samples, references to the deltaxml-docbook-rest-client-10.0.0.jar should be modified to match the major.minor.patch version of DocBook Compare you are using.

Also, if using a Windows terminal, the '\' line-continuation character should be replaced with '^' character.