docs: architecture notes for the screenshot gate, playback tests and language guard
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
This commit is contained in:
1 file changed
+6
-3
@@ -226,7 +226,7 @@ run as server jobs whose progress comes from the events.
|
||||
for PostgreSQL integration tests.
|
||||
- Classes run in parallel. A test that changes or observes process-wide state (the UI language, unobserved task
|
||||
exceptions, the managed heap) belongs in a `[Serial]` class; the App and Core test programs fail a test outside one
|
||||
that switches the language away from English (`TestContext.Current`).
|
||||
that switches the language away from English, after switching it back (`TestContext.Current`).
|
||||
- Put tests under `tests/Titano.<Area>.Tests/<Folder>/<Thing>Tests.cs`, mirroring the source folder.
|
||||
- `Titano.App.Tests` targets net10.0-windows and runs on Windows CI only: keep logic in plain classes.
|
||||
- Fixtures are synthetic and generated in code wherever possible; tiny binary fixtures may go in `tests/fixtures/`
|
||||
@@ -240,8 +240,11 @@ run as server jobs whose progress comes from the events.
|
||||
- `Titano.Tools.Tests` covers the tools whose output CI relies on (fixtures annotations and exit codes, the screenshot
|
||||
diff) and the test runner's outcomes.
|
||||
- Visual regression: CI compares the `--capture` screenshots with `tests/visual/baselines` (`Titano.Tools screenshots
|
||||
diff`; its README says how baselines are added). The capture draws the same pixels on any day: the sample's clock
|
||||
is fixed, formats are English and nothing animates.
|
||||
diff`; its README says how baselines are added). Once any baseline is committed, a screen without one fails too;
|
||||
before that the step warns that it compared nothing. The capture draws the same pixels on any day: the sample's
|
||||
clock is fixed, formats are English and nothing animates.
|
||||
- Media Foundation output plays back (`Titano.Core.Windows.Tests`): MediaPlayer opens it where Windows Media Player
|
||||
is installed (skipped, with the reason, where it is not) and a source reader decodes its first frame everywhere.
|
||||
- PostgreSQL: CI prepares the service containers with `.github/scripts/postgres-ci-setup.sh` (MD5, cleartext and
|
||||
trust roles, TLS), so every authentication method and TLS mode of BRIEF §6.3 runs; `TITANO_TEST_PG_TLS=1` makes a
|
||||
server without TLS fail the TLS tests.
|
||||
|
||||
Reference in new issue
Block a user