81f4f2c793
The canonical bug format is TODO(crbug.com/<id>). TODOs of the following forms will all be migrated to the new format: - TODO(crbug.com/<old id>) - TODO(https://crbug.com/<old id>) - TODO(crbug/<old id>) - TODO(crbug/monorail/<old id>) - TODO(<old id>) - TODO(issues.chromium.org/<old id>) - TODO(https://issues.chromium.org/<old id>) - TODO(https://issues.chromium.org/u/1/issues/<old id>) - TODO(bugs.chromium.org/<old id>) Bug id mapping is sourced from go/chrome-on-buganizer-prod-issues. See go/crbug-todo-migration for details. #crbug-todo-migration Bug: b/321899722 Change-Id: Iee14d10d544e9f0ec046117cc4ec8a55c427adc0 Reviewed-on: https://chromium-review.googlesource.com/c/chromium/src/+/5469947 Reviewed-by: Darryl James <dljames@chromium.org> Owners-Override: Alison Gale <agale@chromium.org> Commit-Queue: Alison Gale <agale@chromium.org> Cr-Commit-Position: refs/heads/main@{#1290838}
1.4 KiB
Test Wrapper API
In order to simplify the calling conventions for tests that we run on our continuous integration system, we require them to follow a simple API convention. For a given GN label //X:Y and build directory //Z in a checkout (e.g., //url:url_unittests and //out/Release), we expect there to be:
* A file `$Z/$Y.runtime_deps` containing a list of files needed to run
the test (in the format produced by `gn desc //Z //X:Y runtime_deps`,
which is a newline-separated list of paths relative to Z)
* An executable file `$Z/bin/run_$Y` which does everything needed to set
up and run the test with all of the appropriate flags. This will usually
be a vpython script.
* (on Windows) A file `$Z/bin/run_$Y.bat` file that will turn around
and invoke the corresponding run_$ vpython script.
If you create a directory snapshot with the files listed in the .runtime_deps file, cd to $Z, and run bin/run_$Y, then the test should run to completion successfully.
The script file MUST honor the GTEST_SHARD_INDEX and GTEST_TOTAL_SHARDS
environment variables as documented in
the Test Executable API and SHOULD conform to
the Test Executable API in other respects (i.e., honor the
--isolated-script-test-filter arg and other command line flags specified
in that API).
TODO(crbug.com/40564748): Convert everything to the Test Executable API, and change the above SHOULD to a MUST.