History

Ben Wagner ecd17b9e34 Add fast_unwind_on_malloc=0 to xSAN. It is slower, but gives useful stack traces for suppressions. Change-Id: I64e1b24951ffb87defd2201743ebb32f31b1f90f Reviewed-on: https://skia-review.googlesource.com/c/skia/+/282159 Reviewed-by: Ben Wagner <bungeman@google.com> Reviewed-by: Mike Klein <mtklein@google.com> Commit-Queue: Ben Wagner <bungeman@google.com>		2020-04-07 22:31:57 +00:00
..
build	remove SK_USE_SKVM_BLITTER	2020-04-07 17:51:57 +00:00
builder_name_schema	Changing ~everything (mostly recipe related stuff) to reference Debian10 jobs	2020-04-07 12:18:06 +00:00
checkout	Changing ~everything (mostly recipe related stuff) to reference Debian10 jobs	2020-04-07 12:18:06 +00:00
docker	Changing ~everything (mostly recipe related stuff) to reference Debian10 jobs	2020-04-07 12:18:06 +00:00
doxygen	[recipes] Minor import cleanup	2020-03-06 19:06:10 +00:00
env	Roll recipe dependencies (nontrivial).	2019-06-03 11:25:16 +00:00
flavor	Add fast_unwind_on_malloc=0 to xSAN.	2020-04-07 22:31:57 +00:00
git	Roll recipe dependencies (nontrivial).	2019-06-03 11:25:16 +00:00
gsutil	Roll recipe dependencies (nontrivial).	2019-06-03 11:25:16 +00:00
infra	[recipes] Minor import cleanup	2020-03-06 19:06:10 +00:00
run	[recipes] Minor import cleanup	2020-03-06 19:06:10 +00:00
vars	Changing ~everything (mostly recipe related stuff) to reference Debian10 jobs	2020-04-07 12:18:06 +00:00
README.md	Use new recipes.py test command	2017-04-18 13:57:56 +00:00

Skia Recipe Modules

This directory contains recipe modules designed to be used by recipes (see infra/bots/recipes). They are all Skia-specific and some are interrelated:

builder_name_schema - Helps to derive expected behavior from task (formerly builder) names.
core - Use as a starting point for most recipes: runs setup and sync steps.
ct - Shared Cluster Telemetry utilities.
flavor - Allows the caller to specify a high-level command to run, leaving the platform-specific details to be handled by the specific flavor module.
infra - Shared infrastructure-related utilities.
run - Utilities for running commands.
swarming - Utilities for running Swarming tasks.
vars - Common global variables used by Skia recipes/modules.

When you change a recipe module, you generally need to re-train the simulation test:

$ python infra/bots/recipes.py test run --train

Or:

$ cd infra/bots; make train

Each recipe module contains a few files:

api.py - This is the meat of the module.
__init__.py - Contains a single DEPS variable, indicating the other recipe modules on which this module depends.
example.py - Optional, this file contains examples which demonstrate how to use the module and should contain enough tests to achieve 100% coverage for the module. The tests are run using the recipes test command above.