History

recipe-roller a8b0acb3dd Roll recipe dependencies (nontrivial). This is an automated CL created by the recipe roller. This CL rolls recipe changes from upstream projects (e.g. depot_tools) into downstream projects (e.g. tools/build). Please review the expectation changes, and LGTM+CQ. More info is at https://goo.gl/zkKdpD. Use https://goo.gl/noib3a to file a bug. build: https://crrev.com/44178cbebda775224e182b2fb0185b068dd0f72f WebRTC: Add additional solution for App Engine to Android perf bots. (kjellander@chromium.org) recipe_engine: https://crrev.com/944125e6d1e8c831d09517bde658a38d8f81db37 Sort step presentation properties (machenbach@chromium.org) Recipe-Tryjob-Bypass-Reason: Autoroller Bugdroid-Send-Email: False Change-Id: Ib2118f9d6c3e4a6877071694758b073623f88006 Reviewed-on: https://skia-review.googlesource.com/15159 Commit-Queue: Eric Boren <borenet@google.com> Reviewed-by: Michael Achenbach <machenbach@chromium.org> Reviewed-by: Eric Boren <borenet@google.com>		2017-05-03 11:58:11 +00:00
..
builder_name_schema	Recipes: remove some pragma: no cover	2017-04-19 19:14:46 +00:00
core	Roll recipe dependencies (nontrivial).	2017-05-03 11:58:11 +00:00
ct	Recipes: Use strict coverage, part 1	2017-04-19 11:24:24 +00:00
env	[recipes] Add env recipe module	2017-04-24 17:45:46 +00:00
flavor	Manually roll skia recipe deps.	2017-05-02 19:50:11 +00:00
infra	Change infra recipe module to use the Go asset	2017-04-13 16:26:22 +00:00
run	[recipes] Add env recipe module	2017-04-24 17:45:46 +00:00
swarming	Manually roll skia recipe deps.	2017-05-02 19:50:11 +00:00
vars	Manually roll skia recipe deps.	2017-05-02 19:50:11 +00:00
README.md	Use new recipes.py test command	2017-04-18 13:57:56 +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.