11# cite-runner
22
3- Simplify testing your OGC implementation server against [ CITE] ( https://github.com/opengeospatial/cite/wiki ) . This repo
4- contains a CITE runner that can be called as a github action. It can also be used standalone, which allows integration
5- with other CI platforms or running locally.
3+ Simplify testing your OGC implementation server against [ CITE] ( https://github.com/opengeospatial/cite/wiki ) . This
4+ repository contains a CITE runner that can be called as a github action. It can also be used standalone, which allows
5+ integration with other CI platforms or running locally.
66
77This code can either:
88
9- - Spin up a docker container with the [ ogc teamengine image] ( https://hub.docker.com/r/ogccite/teamengine-production ) ,
9+ - Spin up a docker container with the [ OGC TeamEngine image] ( https://hub.docker.com/r/ogccite/teamengine-production ) ,
1010 running test suites in an isolated CI environment
11- - Use an existing teamengine deployment
11+ - Use an existing TeamEngine deployment
1212
1313
14- ## Running as a github action
14+ ## Running as a GitHub action
1515
1616### Inputs
1717
1818This action expects the following inputs to be provided:
1919
20- - ` test_suite_identfier ` - Identifier of the test suite to be executed. Test suite identifiers can be gotten from the
20+ - ` test_suite_identifier ` - Identifier of the test suite to be executed. Test suite identifiers can be gotten from the
2121 documentation at < http://cite.opengeospatial.org/teamengine/ > . Example:
2222
2323 ``` yaml
2424 test_suite_identifier : ' ogcapi-features-1.0'
2525 ` ` `
2626
27- - ` test_session_arguments` - Test session arguments to be passed to teamengine . These depend on the test suite that is
27+ - ` test_session_arguments` - Test session arguments to be passed to TeamEngine . These depend on the test suite that is
2828 going to be executed. Must be provided as a space-separated list of `key=value` pairs. Examples :
2929
3030 - A simple yaml string
@@ -40,17 +40,17 @@ This action expects the following inputs to be provided:
4040 noofcollections=-1
4141 ` ` `
4242
43- - ` teamengine_url` - **OPTIONAL** - URL of the teamengine instance to be used for running tests. If this parameter
44- is not specified then the action will spin up a local teamengine docker container and use it for testing. If you
45- specify a custom teamengine URL this action will also try to find authentication-related env variables and use
46- them. These env variables must be named `teamengine_username` and `teamengine_password`
43+ - ` teamengine_url` - **OPTIONAL** - URL of the TeamEngine instance to be used for running tests. If this parameter
44+ is not specified then the action will spin up a local TeamEngine docker container and use it for testing. If you
45+ specify a custom TeamEngine URL this action will also try to find authentication-related environment variables and
46+ use them. These environment variables must be named `teamengine_username` and `teamengine_password`
4747
48- That the value of this paramenter must be the URL of the landing page of the teamengine service, which usually is
48+ Note that the value of this parameter must be the URL of the landing page of the TeamEngine service, which usually is
4949 located at the `/teamengine` path. Examples :
5050
5151 - When spinning up a local docker instance there is no need to supply this argument
5252
53- - When using the remote teamengine instance located at `https://my-server` with a pre-existing user `myself` and
53+ - When using the remote TeamEngine instance located at `https://my-server` with a pre-existing user `myself` and
5454 a password of `something` :
5555
5656 ` ` ` yaml
@@ -59,11 +59,11 @@ This action expects the following inputs to be provided:
5959 teamengine_password: 'something'
6060 ` ` `
6161
62- - ` teamengine_username` - **OPTIONAL** - Username to be used when logging in to a remote teamengine instance.
63- Defaults to `ogctest`, which is a user that is pre-created on the official teamengine docker image.
62+ - ` teamengine_username` - **OPTIONAL** - Username to be used when logging in to a remote TeamEngine instance.
63+ Defaults to `ogctest`, which is a user that is pre-created on the official TeamEngine docker image.
6464
65- - ` teamengine_password` - **OPTIONAL** - Password to be used when logging in to a remote teamengine instance.
66- Defaults to `ogctest`, which is the password used for the pre-created user on the official teamengine docker image
65+ - ` teamengine_password` - **OPTIONAL** - Password to be used when logging in to a remote TeamEngine instance.
66+ Defaults to `ogctest`, which is the password used for the pre-created user on the official TeamEngine docker image
6767
6868- ` treat_skipped_tests_as_failures` - **OPTIONAL** - Whether the presence of skipped tests should be interpreted as
6969 an overall failure of the test suite or not. Defaults to `false`
@@ -72,7 +72,7 @@ This action expects the following inputs to be provided:
7272
7373# ## Usage
7474
75- The below examples define a github workflow for testing pygeoapi.
75+ The below examples define a GitHub workflow for testing pygeoapi.
7676
7777Simple usage, running the `ogcapi-features-1.0` test suite whenever there is a `push` :
7878
@@ -184,7 +184,7 @@ This action's code can also be installed locally:
184184
185185- Start your service to be tested. Let's assume it is already running on `http://localhost:5000`
186186
187- - Run the teamengine docker image locally :
187+ - Run the TeamEngine docker image locally :
188188
189189 ` ` ` shell
190190 docker run \
@@ -201,7 +201,7 @@ This action's code can also be installed locally:
201201 ` ` `
202202
203203There are additional commands and options which can be used when running locally, which allow controlling the output
204- format and how the inputs are supplied. Read the online
204+ format and how the inputs are supplied. Read the online documentation for more details.
205205
206206
207207# # Test suites which are known to work
@@ -262,20 +262,20 @@ format and how the inputs are supplied. Read the online
262262
263263# # Development
264264
265- After having clone this repo , install the code with dev dependencies by running :
265+ After having clone this repository , install the code with dev dependencies by running :
266266
267267` ` ` shell
268268poetry install --with dev
269269` ` `
270270
271- Enable the pre-commit hooks by running
271+ Enable the pre-commit hooks by running :
272272
273273` ` ` shell
274274poetry run pre-commit install
275275` ` `
276276
277277Optionally, do a first run of pre-commit on all files, which will also initialize
278- pre-commit's hooks
278+ pre-commit's hooks :
279279
280280` ` ` shell
281281poetry run pre-commit run --all-files
0 commit comments