History

Eric Boren 25c1083e35 [recipes] Check out a separate depot_tools for syncing Chrome This is a hack to get around the fact that we can't update the normal version of depot_tools we receive through recipe deps, since we are not yet using kitchen (See skia:7050). Bug: skia:7609 Change-Id: I7d39e1e5db716960b2df2c8e3d4325c4b20c774e Reviewed-on: https://skia-review.googlesource.com/106720 Reviewed-by: Ravi Mistry <rmistry@google.com> Commit-Queue: Eric Boren <borenet@google.com>		2018-02-12 20:53:23 +00:00
..
builder_name_schema	Add a GPU calmbench bot	2017-11-02 19:04:21 +00:00
core	[recipes] Check out a separate depot_tools for syncing Chrome	2018-02-12 20:53:23 +00:00
ct	Update CT bots to Debian-9.2	2017-11-29 18:45:05 +00:00
env	Rename example.py -> examples/full.py for all modules	2017-06-02 11:40:36 +00:00
flavor	[recipes] Check out a separate depot_tools for syncing Chrome	2018-02-12 20:53:23 +00:00
git	Use chrome-infra Git CIPD package	2017-06-06 12:45:11 +00:00
gsutil	Upload multiple dm images at once	2018-01-17 12:29:26 +00:00
infra	Add new Bookmaker bot that runs nightly	2017-12-08 22:26:38 +00:00
isolate	Revert "Update isolate binaries and update isolate recipe"	2017-12-22 18:53:56 +00:00
run	Store skiaserve binary in GS from Release Android compile bots	2017-12-12 22:37:05 +00:00
skia_swarming	Manually roll recipe DEPS	2017-09-27 17:24:38 +00:00
swarming	Manually roll recipe DEPS	2017-09-27 17:24:38 +00:00
swarming_client	Manually roll recipe DEPS	2017-09-27 17:24:38 +00:00
vars	Separate compile task from calmbench task	2018-01-05 18:13:36 +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.