Test suite: ets-cdb10

Scope

This test suite validates the conformance level of a local CDB on the filesystem.

Visit the project documentation website for more information, including the API documentation.

How to run the tests

There are several options for executing the test suite.

1. OGC Test Harness

Use TEAM Engine, the official OGC test harness. The latest test suite release are usually available at the beta testing facility. You can also build and deploy the test harness yourself and use a local installation.

For a more detailed guide on installing TEAM Engine to test CDB, see the HOW TO Guide.

2. Integrated Development Environment (IDE)

Use a Java IDE such as Eclipse, NetBeans, or IntelliJ. Clone the repository and build the project.

Set the main class to run: org.opengis.cite.cdb10.TestNGController

Arguments: The first argument must refer to an XML properties file containing the required test run arguments. If not specified, the default location at $ {user.home}/test-run-props.xml will be used.

You can modify the sample file in src/main/config/test-run-props.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties version="1.0">
  <comment>Test run arguments</comment>
  <entry key="iut">/path/to/CDB</entry>
  <entry key="ics">1,2</entry>
</properties>

The TestNG results file (testng-results.xml) will be written to a subdirectory in ${user.home}/testng/ having a UUID value as its name.

For a more detailed guide on using Eclipse to test CDB, see the HOW TO Guide.

3. Command Shell (console)

One of the build artifacts is an "all-in-one" JAR file that includes the test suite and all of its dependencies; this makes it very easy to execute the test suite in a command shell:

java -jar ets-cdb10-0.2-SNAPSHOT-aio.jar [-o|--outputDir $TMPDIR] [test-run-props.xml]

For a more detailed guide on using a JAR to test CDB, see the HOW TO Guide.

Building

This test suite is compatible with Apache Maven. You can build the test suite from a local repository:

$ mvn install

The compiled JAR will be available at target/ets-cdb10-0.2-SNAPSHOT-aio.jar. For TEAM Engine, you will need target/ets-cdb10-0.2-SNAPSHOT-ctl.zip and target/ets-cdb10-0.2-SNAPSHOT-deps.zip.

Updating GitHub Pages Documentation

This repository contains a branch for the documentation generated for the project. To update with a new release:

$ mvn install
$ cp target/ets-cdb10-0.2-SNAPSHOT-site.jar $HOME
$ git checkout gh-pages
$ git rm -rf .
$ jar xf $HOME/ets-cdb10-0.2-SNAPSHOT-site.jar
$ git commit 

Building CTL

CTL is used by TEAM Engine and is generated in the target/ets-cdb10-0.2-SNAPSHOT-ctl.zip archive. The archive is built when the project is built by maven.

How to Contribute

If you would like to get involved, you can:

• Report an issue such as a defect or an enhancement request
• Help to resolve an open issue
• Fix a bug: Fork the repository, apply the fix, and create a pull request
• Add new tests: Fork the repository, implement and verify the tests on a new topic branch, and create a pull request (don't forget to periodically rebase long-lived branches so there are no extraneous conflicts)