opengeospatial / ets-wms13

Repository for the Exectutable Test Suite for WMS 1.3.0
Apache License 2.0
2 stars 4 forks source link

OGC Web Map Service (WMS) 1.3.0 Test-Suite

The OGC Web Map Service (WMS) 1.3.0 Test-Suite provides the Executable Test Script (ETS) to test implementations against the following specification(s):

Detailed information about this test suite is available [here] (http://opengeospatial.github.io/ets-wms13/).

License

Apache 2.0 License

Building

This test is build using Apache Maven To build the test suite run maven from the root directory. % mvn install

To test an application run: % mvn test

More information about how to build and install the test in TEAM Engine at the TEAM Engine project site

How to run the tests

Integrated development environment (IDE)

You can use a Java IDE such as Eclipse, NetBeans, or IntelliJ to run the test suite. Clone the repository and build the project. The runtime configuration is summarized below.

Main class: org.opengis.cite.wms13.CtlController

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

You can modify the default settings in the sample test-run-props.xml file. The value of the capabilities-url argument must be an absolute URI that adheres to the 'http' or 'file' schemes.

<?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 (ets-wms13)</comment>
    <entry key="capabilities-url">http://localhost:9090/wms13/capabilities.xml</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.

Command shell (terminal)

One of the build artifacts is an "all-in-one" JAR file that includes the test suite with all of its dependencies. This makes it very easy to execute the test suite in a command shell like so:

java -jar ets-wms13-${version}-aio.jar [test-run-props.xml]

Docker

This test suite comes with a Dockerfile which can be used to easily setup the OGC test harness with the test suite. Details can be found on https://github.com/opengeospatial/cite/wiki/How-to-create-Docker-Images-of-test-suites#create-docker-image-and-create-and-start-docker-container[Create Docker Image and create and start Docker Container].

OGC test harness

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

Bugs

Issue tracker is available at github

Mailing Lists

The cite-forum is where software developers discuss issues and solutions related to OGC tests.

More Information

Visit the CITE website to get more information about the CITE program and tools.