|
|
|
@ -37,6 +37,7 @@
|
|
|
|
|
* [osx_sdk:examples/full](#recipes-osx_sdk_examples_full)
|
|
|
|
|
* [presubmit:examples/full](#recipes-presubmit_examples_full)
|
|
|
|
|
* [tryserver:examples/full](#recipes-tryserver_examples_full)
|
|
|
|
|
* [tryserver:tests/gerrit_change_fetch_ref](#recipes-tryserver_tests_gerrit_change_fetch_ref)
|
|
|
|
|
* [windows_sdk:examples/full](#recipes-windows_sdk_examples_full)
|
|
|
|
|
## Recipe Modules
|
|
|
|
|
|
|
|
|
@ -753,7 +754,7 @@ Return a presubmit step.
|
|
|
|
|
|
|
|
|
|
#### **class [TryserverApi](/recipes/recipe_modules/tryserver/api.py#11)([RecipeApi][recipe_engine/wkt/RecipeApi]):**
|
|
|
|
|
|
|
|
|
|
— **def [add\_failure\_reason](/recipes/recipe_modules/tryserver/api.py#220)(self, reason):**
|
|
|
|
|
— **def [add\_failure\_reason](/recipes/recipe_modules/tryserver/api.py#221)(self, reason):**
|
|
|
|
|
|
|
|
|
|
Records a more detailed reason why build is failing.
|
|
|
|
|
|
|
|
|
@ -765,7 +766,7 @@ Returns current gerrit change, if there is exactly one.
|
|
|
|
|
|
|
|
|
|
Returns a self.m.buildbucket.common_pb2.GerritChange or None.
|
|
|
|
|
|
|
|
|
|
  **@property**<br>— **def [gerrit\_change\_fetch\_ref](/recipes/recipe_modules/tryserver/api.py#97)(self):**
|
|
|
|
|
  **@property**<br>— **def [gerrit\_change\_fetch\_ref](/recipes/recipe_modules/tryserver/api.py#98)(self):**
|
|
|
|
|
|
|
|
|
|
Returns gerrit patch ref, e.g. "refs/heads/45/12345/6, or None.
|
|
|
|
|
|
|
|
|
@ -777,13 +778,13 @@ Returns canonical URL of the gitiles repo of the current Gerrit CL.
|
|
|
|
|
|
|
|
|
|
Populated iff gerrit_change is populated.
|
|
|
|
|
|
|
|
|
|
  **@property**<br>— **def [gerrit\_change\_target\_ref](/recipes/recipe_modules/tryserver/api.py#106)(self):**
|
|
|
|
|
  **@property**<br>— **def [gerrit\_change\_target\_ref](/recipes/recipe_modules/tryserver/api.py#107)(self):**
|
|
|
|
|
|
|
|
|
|
Returns gerrit change destination ref, e.g. "refs/heads/master".
|
|
|
|
|
|
|
|
|
|
Populated iff gerrit_change is populated.
|
|
|
|
|
|
|
|
|
|
— **def [get\_files\_affected\_by\_patch](/recipes/recipe_modules/tryserver/api.py#136)(self, patch_root, \*\*kwargs):**
|
|
|
|
|
— **def [get\_files\_affected\_by\_patch](/recipes/recipe_modules/tryserver/api.py#137)(self, patch_root, \*\*kwargs):**
|
|
|
|
|
|
|
|
|
|
Returns list of paths to files affected by the patch.
|
|
|
|
|
|
|
|
|
@ -793,11 +794,11 @@ Argument:
|
|
|
|
|
|
|
|
|
|
Returned paths will be relative to to patch_root.
|
|
|
|
|
|
|
|
|
|
— **def [get\_footer](/recipes/recipe_modules/tryserver/api.py#278)(self, tag, patch_text=None):**
|
|
|
|
|
— **def [get\_footer](/recipes/recipe_modules/tryserver/api.py#279)(self, tag, patch_text=None):**
|
|
|
|
|
|
|
|
|
|
Gets a specific tag from a CL description
|
|
|
|
|
|
|
|
|
|
— **def [get\_footers](/recipes/recipe_modules/tryserver/api.py#258)(self, patch_text=None):**
|
|
|
|
|
— **def [get\_footers](/recipes/recipe_modules/tryserver/api.py#259)(self, patch_text=None):**
|
|
|
|
|
|
|
|
|
|
Retrieves footers from the patch description.
|
|
|
|
|
|
|
|
|
@ -806,30 +807,30 @@ git-footers documentation for more information.
|
|
|
|
|
|
|
|
|
|
— **def [initialize](/recipes/recipe_modules/tryserver/api.py#23)(self):**
|
|
|
|
|
|
|
|
|
|
  **@property**<br>— **def [is\_gerrit\_issue](/recipes/recipe_modules/tryserver/api.py#120)(self):**
|
|
|
|
|
  **@property**<br>— **def [is\_gerrit\_issue](/recipes/recipe_modules/tryserver/api.py#121)(self):**
|
|
|
|
|
|
|
|
|
|
Returns true iff the properties exist to match a Gerrit issue.
|
|
|
|
|
|
|
|
|
|
  **@property**<br>— **def [is\_patch\_in\_git](/recipes/recipe_modules/tryserver/api.py#130)(self):**
|
|
|
|
|
  **@property**<br>— **def [is\_patch\_in\_git](/recipes/recipe_modules/tryserver/api.py#131)(self):**
|
|
|
|
|
|
|
|
|
|
  **@property**<br>— **def [is\_tryserver](/recipes/recipe_modules/tryserver/api.py#115)(self):**
|
|
|
|
|
  **@property**<br>— **def [is\_tryserver](/recipes/recipe_modules/tryserver/api.py#116)(self):**
|
|
|
|
|
|
|
|
|
|
Returns true iff we have a change to check out.
|
|
|
|
|
|
|
|
|
|
— **def [normalize\_footer\_name](/recipes/recipe_modules/tryserver/api.py#282)(self, footer):**
|
|
|
|
|
— **def [normalize\_footer\_name](/recipes/recipe_modules/tryserver/api.py#283)(self, footer):**
|
|
|
|
|
|
|
|
|
|
— **def [set\_compile\_failure\_tryjob\_result](/recipes/recipe_modules/tryserver/api.py#199)(self):**
|
|
|
|
|
— **def [set\_compile\_failure\_tryjob\_result](/recipes/recipe_modules/tryserver/api.py#200)(self):**
|
|
|
|
|
|
|
|
|
|
Mark the tryjob result as a compile failure.
|
|
|
|
|
|
|
|
|
|
— **def [set\_do\_not\_retry\_build](/recipes/recipe_modules/tryserver/api.py#185)(self):**
|
|
|
|
|
— **def [set\_do\_not\_retry\_build](/recipes/recipe_modules/tryserver/api.py#186)(self):**
|
|
|
|
|
|
|
|
|
|
A flag to indicate the build should not be retried by the CQ.
|
|
|
|
|
|
|
|
|
|
This mechanism is used to reduce CQ duration when retrying will likely
|
|
|
|
|
return an identical result.
|
|
|
|
|
|
|
|
|
|
  **@contextlib.contextmanager**<br>— **def [set\_failure\_hash](/recipes/recipe_modules/tryserver/api.py#229)(self):**
|
|
|
|
|
  **@contextlib.contextmanager**<br>— **def [set\_failure\_hash](/recipes/recipe_modules/tryserver/api.py#230)(self):**
|
|
|
|
|
|
|
|
|
|
Context manager that sets a failure_hash build property on StepFailure.
|
|
|
|
|
|
|
|
|
@ -838,7 +839,7 @@ for the same reason. For example, if a patch is bad (breaks something),
|
|
|
|
|
we'd expect it to always break in the same way. Different failures
|
|
|
|
|
for the same patch are usually a sign of flakiness.
|
|
|
|
|
|
|
|
|
|
— **def [set\_invalid\_test\_results\_tryjob\_result](/recipes/recipe_modules/tryserver/api.py#211)(self):**
|
|
|
|
|
— **def [set\_invalid\_test\_results\_tryjob\_result](/recipes/recipe_modules/tryserver/api.py#212)(self):**
|
|
|
|
|
|
|
|
|
|
Mark the tryjob result as having invalid test results.
|
|
|
|
|
|
|
|
|
@ -846,18 +847,18 @@ This means we run some tests, but the results were not valid
|
|
|
|
|
(e.g. no list of specific test cases that failed, or too many
|
|
|
|
|
tests failing, etc).
|
|
|
|
|
|
|
|
|
|
— **def [set\_patch\_failure\_tryjob\_result](/recipes/recipe_modules/tryserver/api.py#195)(self):**
|
|
|
|
|
— **def [set\_patch\_failure\_tryjob\_result](/recipes/recipe_modules/tryserver/api.py#196)(self):**
|
|
|
|
|
|
|
|
|
|
Mark the tryjob result as failure to apply the patch.
|
|
|
|
|
|
|
|
|
|
— **def [set\_subproject\_tag](/recipes/recipe_modules/tryserver/api.py#163)(self, subproject_tag):**
|
|
|
|
|
— **def [set\_subproject\_tag](/recipes/recipe_modules/tryserver/api.py#164)(self, subproject_tag):**
|
|
|
|
|
|
|
|
|
|
Adds a subproject tag to the build.
|
|
|
|
|
|
|
|
|
|
This can be used to distinguish between builds that execute different steps
|
|
|
|
|
depending on what was patched, e.g. blink vs. pure chromium patches.
|
|
|
|
|
|
|
|
|
|
— **def [set\_test\_failure\_tryjob\_result](/recipes/recipe_modules/tryserver/api.py#203)(self):**
|
|
|
|
|
— **def [set\_test\_failure\_tryjob\_result](/recipes/recipe_modules/tryserver/api.py#204)(self):**
|
|
|
|
|
|
|
|
|
|
Mark the tryjob result as a test failure.
|
|
|
|
|
|
|
|
|
@ -991,6 +992,11 @@ Move things around in a loop!
|
|
|
|
|
[DEPS](/recipes/recipe_modules/tryserver/examples/full.py#5): [gerrit](#recipe_modules-gerrit), [tryserver](#recipe_modules-tryserver), [recipe\_engine/buildbucket][recipe_engine/recipe_modules/buildbucket], [recipe\_engine/json][recipe_engine/recipe_modules/json], [recipe\_engine/path][recipe_engine/recipe_modules/path], [recipe\_engine/platform][recipe_engine/recipe_modules/platform], [recipe\_engine/properties][recipe_engine/recipe_modules/properties], [recipe\_engine/python][recipe_engine/recipe_modules/python], [recipe\_engine/raw\_io][recipe_engine/recipe_modules/raw_io], [recipe\_engine/step][recipe_engine/recipe_modules/step]
|
|
|
|
|
|
|
|
|
|
— **def [RunSteps](/recipes/recipe_modules/tryserver/examples/full.py#19)(api):**
|
|
|
|
|
### *recipes* / [tryserver:tests/gerrit\_change\_fetch\_ref](/recipes/recipe_modules/tryserver/tests/gerrit_change_fetch_ref.py)
|
|
|
|
|
|
|
|
|
|
[DEPS](/recipes/recipe_modules/tryserver/tests/gerrit_change_fetch_ref.py#7): [gerrit](#recipe_modules-gerrit), [tryserver](#recipe_modules-tryserver), [recipe\_engine/buildbucket][recipe_engine/recipe_modules/buildbucket], [recipe\_engine/properties][recipe_engine/recipe_modules/properties]
|
|
|
|
|
|
|
|
|
|
— **def [RunSteps](/recipes/recipe_modules/tryserver/tests/gerrit_change_fetch_ref.py#15)(api):**
|
|
|
|
|
### *recipes* / [windows\_sdk:examples/full](/recipes/recipe_modules/windows_sdk/examples/full.py)
|
|
|
|
|
|
|
|
|
|
[DEPS](/recipes/recipe_modules/windows_sdk/examples/full.py#5): [windows\_sdk](#recipe_modules-windows_sdk), [recipe\_engine/platform][recipe_engine/recipe_modules/platform], [recipe\_engine/properties][recipe_engine/recipe_modules/properties], [recipe\_engine/step][recipe_engine/recipe_modules/step]
|
|
|
|
|