mirror of
https://github.com/directus/directus.git
synced 2026-02-19 10:14:33 -05:00
Co-authored-by: Azri Kahar <42867097+azrikahar@users.noreply.github.com> Co-authored-by: ian <licitdev@gmail.com> Co-authored-by: Rijk van Zanten <rijkvanzanten@me.com>
34 lines
1.2 KiB
Markdown
34 lines
1.2 KiB
Markdown
# Blackbox tests
|
|
|
|
## Setup
|
|
|
|
Make sure the containers for the databases are running by running `docker compose up -d` in this folder.
|
|
|
|
Directus needs to be deployed with `pnpm --filter directus deploy --prod dist`. When using the `test:blackbox` script in the workspace root (`pnpm -w run test:blackbox`) this is already done.
|
|
|
|
## Running tests locally
|
|
|
|
Run `pnpm -w run test:blackbox` to run the blackbox tests for every supported database vendor.
|
|
|
|
Prepend `TEST_SAVE_LOGS=trace` to get trace logs at `server-logs-*` in this folder.
|
|
|
|
### Testing a specific database
|
|
|
|
Provide a csv of database drivers in the `TEST_DB` environment variable to test specific databases:
|
|
|
|
```
|
|
TEST_DB=cockroachdb pnpm -w run test:blackbox
|
|
```
|
|
|
|
### Using an existing Directus instance
|
|
|
|
The test suite will spin up a fresh copy of the Directus API from the current build. To use an already running copy of
|
|
Directus, set the `TEST_LOCAL` flag:
|
|
|
|
```
|
|
TEST_DB=cockroachdb TEST_LOCAL=true pnpm -w run test:blackbox
|
|
```
|
|
|
|
This will use `127.0.0.1:8055` as the URL for every test. Note: make sure to connect your local Directus database
|
|
instance to the test database container found in docker-compose in this folder.
|