Files
mic-check/tests/api/MicCheck.Api.Tests.Integration/readme.md
James Wampler 6887d09f9c version-0.1 (#1)
Squash and merge of version-0.1

Co-authored-by: James Wampler <james@wamp.dev>
Co-committed-by: James Wampler <james@wamp.dev>
2026-07-01 13:30:07 -07:00

1.3 KiB
Executable File

MicCheck.Api.Tests.Integration

Black-box integration tests. Targets a running MicCheck.Api instance by URL and seeds/cleans data directly in the Postgres database.

Running against an environment

Two settings are required: BaseUrl and DbConnectionString.

dotnet test --settings local.runsettings

Copy local.runsettings to e.g. staging.runsettings and override the values for other environments.

Via command-line

dotnet test -- TestRunParameters.Parameter\(name=\"BaseUrl\",value=\"https://staging.example.com\"\) ^
             TestRunParameters.Parameter\(name=\"DbConnectionString\",value=\"Host=...\"\)

Via environment variables (overrides .runsettings)

MICCHECK_API_BASE_URL=...
MICCHECK_DB_CONNECTION_STRING=...
MICCHECK_ACCEPT_ANY_SERVER_CERTIFICATE=true|false

Patterns

  • Tests seed their own data directly in the database, never through the API.
  • Per-test data is seeded in [SetUp]. Reusable cross-test data goes in [OneTimeSetUp].
  • Cleanup runs in [TearDown] / [OneTimeTearDown], also directly in the database.
  • HTTP requests are defined in HttpFiles/*.http and executed via FlagApiHttpClient.
  • Assertion failure messages include a fresh snapshot of the relevant rows in the database.