ZaStoGram_desktop/Telegram/SourceFiles/test/docs/helpers/test_agent.md
John Preston cee5c94af7 [ai] Add a stress kit runner and a Release test harness
Task: 2026/10/30/run-the-widget-stress-kit-at-v0-4-0-on-a-release-build-without-lto
2026-11-05 17:12:56 +04:00

1.6 KiB

test_agent

Harness guide · Helper index

Type: Harness API (may include self-tests).

Source contract: test_agent.h.

Use when

Runtime gate, startup overrides and fixture access. Read the contract below and the source header before use.

Contract and usage

Runtime gate, startup scale override, the macOS App Nap hold (ApplyStartupOverrides() begins one NSActivityUserInitiatedAllowingIdleSystemSleep | NSActivityLatencyCritical NSProcessInfo activity early in Application::run(), before Test::Start(), and holds it until the process exits, logging one NOTE: TDESKTOP_TEST_APP_NAP=[<value>] applied: hold=<active|off> source=<default|environment> - <reason> row; TDESKTOP_TEST_APP_NAP=allow leaves it off and any other value is rejected; nothing off macOS), sticky named events, scenario start, account fixture secrets (TwoStepPassword() reads 2svpassword.txt, GramAccount() reads test_gram_account.txt, RewriteGramAccountWords() rewrites the live and golden copies at the rotated wallet's address after a confirmed rotation, StageGramAccountLiveWords() stages a proper prefix of the live copy's own words for a self-test and RestoreGramAccountLiveWords() lengthens such a staged copy back to the words it was cut from, neither touching the golden sibling; GramAccountLivePath() / GramAccountGoldenPath() name the two copies for metadata-only checks).

Launch and background behavior; account fixtures. Release builds with the harness: when Active() can be true outside Debug.