History

John Stiles d836f84ab8 Generate SkSL golden output files from test inputs during the build. Golden SkSL outputs are intended to eventually replace the majority of our unit tests, since they can automatically update themselves when we change implementation details of the compiler. If you change the compiler output without updating the Golden files, the CheckGeneratedFiles housekeeper will be triggered. Set `skia_compile_processors` or `skia_compile_sksl_tests` to true in your GN args to regenerate them. Almost all of the tests from SkSLFPTests.cpp and SkSLGLSLTests.cpp can be migrated into separate unit-test .fp/.sksl files in a followup CL. hcm@ has signed off on removing the copyright boilerplate preamble from our unit test files. Change-Id: I9e24a944bbac8f8efd62c92481b022a0b1ecdd0b Bug: skia:10694 Reviewed-on: https://skia-review.googlesource.com/c/skia/+/316336 Commit-Queue: John Stiles <johnstiles@google.com> Auto-Submit: John Stiles <johnstiles@google.com> Reviewed-by: Brian Osman <brianosman@google.com>		2020-09-14 14:54:12 +00:00
..
build	Generate SkSL golden output files from test inputs during the build.	2020-09-14 14:54:12 +00:00
builder_name_schema	Rename G3 framework bot to Canary-G3	2020-07-16 15:32:38 +00:00
checkout	[infra] Update recipe dependencies	2020-08-03 11:34:57 +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	[infra] Target Android10 for GalaxyS9	2020-09-09 18:06:37 +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	Remove some non-inclusive language in recipes	2020-07-31 19:29:54 +00:00
run	[recipes] Minor import cleanup	2020-03-06 19:06:10 +00:00
vars	Remove some non-inclusive language in recipes	2020-07-31 19:29:54 +00:00
README.md	Increase ClangTidy code coverage by enabling features.	2020-08-03 15:37:30 +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/infra_tests.py --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.