History

recipe-roller 51ab616bcf 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. recipe_engine: https://crrev.com/c2ae1f8b058dc210e2f8b1753aa7184973da36a6 Remove stdout and stderr from expectation files. (gbeaty@chromium.org) R=stephana@google.com Recipe-Tryjob-Bypass-Reason: Autoroller Bugdroid-Send-Email: False Change-Id: Idc32b8c2c426c0bc60b0c57476258b649d9620d1 Reviewed-on: https://skia-review.googlesource.com/c/skia/+/216355 Commit-Queue: Eric Boren <borenet@google.com> Reviewed-by: Robbie Iannucci <iannucci@google.com> Reviewed-by: Eric Boren <borenet@google.com>		2019-05-28 19:24:02 +00:00
..
build	Roll recipe dependencies (nontrivial).	2019-05-28 19:24:02 +00:00
builder_name_schema	Roll recipe dependencies (nontrivial).	2018-10-31 16:38:00 +00:00
checkout	Roll recipe dependencies (nontrivial).	2019-05-28 19:24:02 +00:00
doxygen	[recipes] Manual roll.	2019-02-17 21:24:01 +00:00
env	Roll recipe dependencies (nontrivial).	2018-10-31 16:38:00 +00:00
flavor	Roll recipe dependencies (nontrivial).	2019-05-28 19:24:02 +00:00
git	[recipes] Fix Windows pathsep; add Windows tests	2019-04-24 19:53:28 +00:00
gsutil	Manual recipe roll	2019-05-20 18:02:05 +00:00
infra	[infra] Pin infra code using Go modules	2019-05-06 17:53:19 +00:00
run	Roll recipe dependencies (nontrivial).	2019-05-20 12:33:25 +00:00
vars	Roll recipe dependencies (nontrivial).	2019-05-28 19:24:02 +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.