What zriz tests and what it does not
zriz tests HTTP APIs, Postgres, and MySQL. On a deployed runner it also tests browser flows and command-line tools. It tests nothing else.
- Which resource types does zriz have?
- Can zriz test an HTTP API?
- Can zriz test a Postgres database?
- Can zriz test a MySQL database?
- Can zriz test a different database?
- Can zriz test a browser flow?
- Can zriz test a command-line tool?
- Which operating systems does zz run on?
- Can zriz run in CI?
Which resource types does zriz have?
Four: http, sql, browser, and cli. There is no other type. Each run needs a runner.
| Type | Tests | Runner needs the worker |
|---|---|---|
http |
An HTTP API | No |
sql |
A Postgres or MySQL database | No |
browser |
A web page in a browser | Yes |
cli |
A command-line tool | Yes |
With no runner, zz run gives the error runner-unavailable and the hint zz runners init --start. The runner guide tells how to get a runner.
Can zriz test an HTTP API?
Yes. A step calls an action of an http resource. A check reads the status and the body of the reply.
Can zriz test a Postgres database?
Yes. A step runs a query of an sql resource. A check reads rows and row-count.
The connection string has this form:
postgres://user:pass@host:5432/db
Can zriz test a MySQL database?
Yes. A step runs a query of an sql resource. A check reads rows and row-count.
The connection string has this form:
user:pass@tcp(host:3306)/db
Can zriz test a different database?
No. zriz tests Postgres and MySQL. It tests no other database.
Can zriz test a browser flow?
Yes. The runner needs the worker, a second container. zz runners init adds the worker to compose.yml when the project has a browser resource.
Can zriz test a command-line tool?
Yes. The runner needs the worker. The runner runs only the commands that its config permits.
zz runners init leaves a cli resource out of the config and names it in a warning.
Which operating systems does zz run on?
macOS and Linux, on arm64 and x86_64. The install script stops on each other system. There is no install for Windows.
Can zriz run in CI?
Yes. zz asks no question, and each command prints one JSON object. zz run ends with exit code 0 only when the status is pass.