cs-codex-dist-tests/Tests/CodexTests
Ben c204ab09d1
combinatorial tests for finding issue
2024-03-14 14:30:00 +01:00
..
BasicTests combinatorial tests for finding issue 2024-03-14 14:30:00 +01:00
DownloadConnectivityTests Speed up basic tests 2024-02-27 13:55:05 +01:00
Helpers Sets up transferSpeed class 2023-12-06 09:59:45 +01:00
PeerDiscoveryTests Speed up basic tests 2024-02-27 13:55:05 +01:00
AutoBootstrapDistTest.cs Remove run ID and introduce deploy ID (#93) 2024-02-22 10:41:07 -03:00
CodexDistTest.cs Adds check for block verification failures 2023-12-12 14:18:26 +01:00
CodexTests.csproj Restores project references. 2023-09-20 10:59:52 +02:00
MetricsAccessExtensions.cs adds block exchange tests. Updates namespaces 2023-10-09 16:59:52 +02:00
Parallelism.cs adds block exchange tests. Updates namespaces 2023-10-09 16:59:52 +02:00
README.md Adds dockertag description 2023-09-29 10:40:48 +02:00

README.md

Codex Tests

This is an NUnit test assembly that can be used with the standard dotnet test runner. For all its CLI options, run dotnet test --help.

Example tests

Running all the tests in the assembly can take a while. In order to check basic viability of your setup as well as the Codex image you're using, consider running only the example tests using the filter option: dotnet test --filter=Example.

Output

The test runner will produce a folder named CodexTestLogs with all the test logs. They are sorted by timestamp and reflect the names of the test fixtures and individual tests. When a test fails, the log file for that specific test will be postfixed with _FAILED. The same applies to the fixture log file. The STATUS files contain the test results in JSON, for easy machine reading.

Overrides

The following environment variables allow you to override specific aspects of the behaviour of the tests.

Variable Description
RUNID A pod-label 'runid' is added to each pod created during the tests. Use this to set the value of that label.
TESTID Similar to RUNID, except the label is 'testid'.
CODEXDOCKERIMAGE If set, this will be used instead of the default Codex docker image.

Using a local Codex repository

If you have a clone of the Codex git repository, and you want to run the tests using your local modifications, the following environment variable options are for you. Please note that any changes made in Codex's 'vendor' directory will be discarded during the build process.

Variable Description
CODEXREPOPATH Path to the Codex repository.
DOCKERUSERNAME Username of your Dockerhub account.
DOCKERPASSWORD Password OR access-token for your Dockerhub account. You can omit this variable to use your system-default account.
DOCKERTAG Optional. Tag used for docker image that will be built and pushed to the Dockerhub account. Random ID used when not set.