Skip to content

Home

cite-runner-logo

A test runner for OGC CITE.

Key features:

  • Runs as a github action: Can be integrated into existing CI workflows
  • Runs as a standalone CLI application: Can be run as a standalone tool
  • Multiple output formats: Can output test suite results as straight to the terminal, in Markdown, JSON or XML

This project aims to simplify the running of OGC CITE tests suites so that server implementations of OGC standards may ensure their compliance with them more frequently.

Examples

Integrate into your CI as a github action:

jobs:
  perform-cite-testing:
    runs-on: ubuntu-24.04
    steps:
      - name: test ogcapi-features compliancy
        uses: OSGeo/cite-runner@v0.2.0
        with:
          test_suite_identifier: ogcapi-features-1.0
          test_session_arguments: iut=http://localhost:5001

Run the same test suite as a standalone CLI application:

docker pull ogccite/teamengine-production:1.0-SNAPSHOT
docker run \
    --rm \
    --name=teamengine \
    --network=host \
    ogccite/teamengine-production:1.0-SNAPSHOT

pipx install cite-runner

cite-runner execute-test-suite \
    http://localhost:8080/teamengine \
    ogcapi-features-1.0 \
    --test-suite-input iut http://localhost:5001

License

cite-runner is published under an MIT license.