History

Weston Tracey efebaa2a11 Run docker as current user and add option to copy directory structure to docker.run. Bug: skia:9438 Change-Id: I21ce6a1483a1def71f073aba9cc00f22f7d1de3b Reviewed-on: https://skia-review.googlesource.com/c/skia/+/283438 Commit-Queue: Weston Tracey <westont@google.com> Reviewed-by: Eric Boren <borenet@google.com>		2020-04-16 15:55:10 +00:00
..
build	Run docker as current user and add option to copy directory structure to docker.run.	2020-04-16 15:55:10 +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	Run docker as current user and add option to copy directory structure to docker.run.	2020-04-16 15:55:10 +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	Run docker as current user and add option to copy directory structure to docker.run.	2020-04-16 15:55:10 +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

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.