Files
suitelinkclient/tests/SuiteLink.Client.IntegrationTests/README.md
2026-03-17 11:04:19 -04:00

41 lines
1.3 KiB
Markdown

# SuiteLink Integration Tests
These tests are intentionally safe by default and run only when explicitly enabled.
## Enable
Set:
- `SUITELINK_IT_ENABLED=true`
Required connection variables:
- `SUITELINK_IT_HOST`
- `SUITELINK_IT_APPLICATION`
- `SUITELINK_IT_TOPIC`
- `SUITELINK_IT_CLIENT_NAME`
- `SUITELINK_IT_CLIENT_NODE`
- `SUITELINK_IT_USER_NAME`
- `SUITELINK_IT_SERVER_NODE`
Optional connection variables:
- `SUITELINK_IT_PORT` (default `5413`)
- `SUITELINK_IT_TIMEZONE` (defaults to `UTC` via `SuiteLinkConnectionOptions`)
Optional tag variables (tests run only for the tags provided):
- `SUITELINK_IT_BOOL_TAG`
- `SUITELINK_IT_INT_TAG`
- `SUITELINK_IT_FLOAT_TAG`
- `SUITELINK_IT_STRING_TAG`
## Notes
- If integration settings are missing, tests return immediately and do not perform network calls.
- These tests are intended as a live harness, not deterministic CI tests.
- The client runtime now uses a background receive loop with automatic reconnect, durable subscription replay, and optional best-effort latest-value catch-up replay after reconnect.
- Reconnect timing is policy-based and jittered by default.
- These live tests still need validation against a real AVEVA server that allows legacy or mixed-mode SuiteLink traffic.
- Writes are intentionally rejected while the client is in `Reconnecting`.