Pulse/scripts/tests/integration/README.md
2026-03-18 16:06:30 +00:00

29 lines
1.2 KiB
Markdown

# Integration Tests
The scripts in this directory exercise the Pulse installer scripts inside isolated
environments (typically Linux containers). They are intended to catch regressions
that unit-style smoke tests cannot detect (e.g., filesystem layout, systemd unit
generation, binary placement).
## Prerequisites
- Docker or another container runtime supported by the test script. When Docker
is unavailable the test will skip gracefully.
- Internet access is **not** required; HTTP interactions are stubbed.
## Adding New Integration Tests
1. Place new test scripts in this directory. They should follow the pattern of
detecting required tooling, skipping when prerequisites are missing, and
producing clear PASS/FAIL output.
2. Prefer running inside an ephemeral container to avoid modifying the host
system.
3. Use repository-relative paths (`/workspace` inside the container) and avoid
relying on network resources.
4. Clean up all temporary files even when the test fails (use traps).
## Reporting
Each integration script is self-contained and prints a concise summary at the
end. CI jobs or developers can invoke them individually without modifying
the top-level smoke test harness.