|
|
|
@ -41,6 +41,7 @@
|
|
|
|
|
* [presubmit:tests/prepare](#recipes-presubmit_tests_prepare)
|
|
|
|
|
* [tryserver:examples/full](#recipes-tryserver_examples_full)
|
|
|
|
|
* [tryserver:tests/gerrit_change_fetch_ref_timeout](#recipes-tryserver_tests_gerrit_change_fetch_ref_timeout)
|
|
|
|
|
* [tryserver:tests/gerrit_change_owner](#recipes-tryserver_tests_gerrit_change_owner)
|
|
|
|
|
* [tryserver:tests/gerrit_change_target_ref](#recipes-tryserver_tests_gerrit_change_target_ref)
|
|
|
|
|
* [windows_sdk:examples/full](#recipes-windows_sdk_examples_full)
|
|
|
|
|
## Recipe Modules
|
|
|
|
@ -780,31 +781,38 @@ Returns:
|
|
|
|
|
|
|
|
|
|
#### **class [TryserverApi](/recipes/recipe_modules/tryserver/api.py#11)([RecipeApi][recipe_engine/wkt/RecipeApi]):**
|
|
|
|
|
|
|
|
|
|
  **@property**<br>— **def [gerrit\_change](/recipes/recipe_modules/tryserver/api.py#32)(self):**
|
|
|
|
|
  **@property**<br>— **def [gerrit\_change](/recipes/recipe_modules/tryserver/api.py#33)(self):**
|
|
|
|
|
|
|
|
|
|
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#96)(self):**
|
|
|
|
|
  **@property**<br>— **def [gerrit\_change\_fetch\_ref](/recipes/recipe_modules/tryserver/api.py#110)(self):**
|
|
|
|
|
|
|
|
|
|
Returns gerrit patch ref, e.g. "refs/heads/45/12345/6, or None.
|
|
|
|
|
|
|
|
|
|
Populated iff gerrit_change is populated.
|
|
|
|
|
|
|
|
|
|
  **@property**<br>— **def [gerrit\_change\_repo\_url](/recipes/recipe_modules/tryserver/api.py#40)(self):**
|
|
|
|
|
  **@property**<br>— **def [gerrit\_change\_owner](/recipes/recipe_modules/tryserver/api.py#49)(self):**
|
|
|
|
|
|
|
|
|
|
Returns owner of the current Gerrit CL.
|
|
|
|
|
|
|
|
|
|
Populated iff gerrit_change is populated.
|
|
|
|
|
Is a dictionary with keys like "name".
|
|
|
|
|
|
|
|
|
|
  **@property**<br>— **def [gerrit\_change\_repo\_url](/recipes/recipe_modules/tryserver/api.py#41)(self):**
|
|
|
|
|
|
|
|
|
|
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#105)(self):**
|
|
|
|
|
  **@property**<br>— **def [gerrit\_change\_target\_ref](/recipes/recipe_modules/tryserver/api.py#119)(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#135)(self, patch_root, \*\*kwargs):**
|
|
|
|
|
— **def [get\_files\_affected\_by\_patch](/recipes/recipe_modules/tryserver/api.py#149)(self, patch_root, \*\*kwargs):**
|
|
|
|
|
|
|
|
|
|
Returns list of paths to files affected by the patch.
|
|
|
|
|
|
|
|
|
@ -814,36 +822,36 @@ Argument:
|
|
|
|
|
|
|
|
|
|
Returned paths will be relative to to patch_root.
|
|
|
|
|
|
|
|
|
|
— **def [get\_footer](/recipes/recipe_modules/tryserver/api.py#245)(self, tag, patch_text=None):**
|
|
|
|
|
— **def [get\_footer](/recipes/recipe_modules/tryserver/api.py#259)(self, tag, patch_text=None):**
|
|
|
|
|
|
|
|
|
|
Gets a specific tag from a CL description
|
|
|
|
|
|
|
|
|
|
— **def [get\_footers](/recipes/recipe_modules/tryserver/api.py#225)(self, patch_text=None):**
|
|
|
|
|
— **def [get\_footers](/recipes/recipe_modules/tryserver/api.py#239)(self, patch_text=None):**
|
|
|
|
|
|
|
|
|
|
Retrieves footers from the patch description.
|
|
|
|
|
|
|
|
|
|
footers are machine readable tags embedded in commit messages. See
|
|
|
|
|
git-footers documentation for more information.
|
|
|
|
|
|
|
|
|
|
— **def [initialize](/recipes/recipe_modules/tryserver/api.py#21)(self):**
|
|
|
|
|
— **def [initialize](/recipes/recipe_modules/tryserver/api.py#22)(self):**
|
|
|
|
|
|
|
|
|
|
  **@property**<br>— **def [is\_gerrit\_issue](/recipes/recipe_modules/tryserver/api.py#119)(self):**
|
|
|
|
|
  **@property**<br>— **def [is\_gerrit\_issue](/recipes/recipe_modules/tryserver/api.py#133)(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#129)(self):**
|
|
|
|
|
  **@property**<br>— **def [is\_patch\_in\_git](/recipes/recipe_modules/tryserver/api.py#143)(self):**
|
|
|
|
|
|
|
|
|
|
  **@property**<br>— **def [is\_tryserver](/recipes/recipe_modules/tryserver/api.py#114)(self):**
|
|
|
|
|
  **@property**<br>— **def [is\_tryserver](/recipes/recipe_modules/tryserver/api.py#128)(self):**
|
|
|
|
|
|
|
|
|
|
Returns true iff we have a change to check out.
|
|
|
|
|
|
|
|
|
|
— **def [normalize\_footer\_name](/recipes/recipe_modules/tryserver/api.py#249)(self, footer):**
|
|
|
|
|
— **def [normalize\_footer\_name](/recipes/recipe_modules/tryserver/api.py#263)(self, footer):**
|
|
|
|
|
|
|
|
|
|
— **def [set\_compile\_failure\_tryjob\_result](/recipes/recipe_modules/tryserver/api.py#188)(self):**
|
|
|
|
|
— **def [set\_compile\_failure\_tryjob\_result](/recipes/recipe_modules/tryserver/api.py#202)(self):**
|
|
|
|
|
|
|
|
|
|
Mark the tryjob result as a compile failure.
|
|
|
|
|
|
|
|
|
|
— **def [set\_invalid\_test\_results\_tryjob\_result](/recipes/recipe_modules/tryserver/api.py#200)(self):**
|
|
|
|
|
— **def [set\_invalid\_test\_results\_tryjob\_result](/recipes/recipe_modules/tryserver/api.py#214)(self):**
|
|
|
|
|
|
|
|
|
|
Mark the tryjob result as having invalid test results.
|
|
|
|
|
|
|
|
|
@ -851,32 +859,32 @@ 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#184)(self):**
|
|
|
|
|
— **def [set\_patch\_failure\_tryjob\_result](/recipes/recipe_modules/tryserver/api.py#198)(self):**
|
|
|
|
|
|
|
|
|
|
Mark the tryjob result as failure to apply the patch.
|
|
|
|
|
|
|
|
|
|
— **def [set\_subproject\_tag](/recipes/recipe_modules/tryserver/api.py#162)(self, subproject_tag):**
|
|
|
|
|
— **def [set\_subproject\_tag](/recipes/recipe_modules/tryserver/api.py#176)(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\_expired\_tryjob\_result](/recipes/recipe_modules/tryserver/api.py#217)(self):**
|
|
|
|
|
— **def [set\_test\_expired\_tryjob\_result](/recipes/recipe_modules/tryserver/api.py#231)(self):**
|
|
|
|
|
|
|
|
|
|
Mark the tryjob result as a test expiration.
|
|
|
|
|
|
|
|
|
|
This means a test task expired and was never scheduled, most likely due to
|
|
|
|
|
lack of capacity.
|
|
|
|
|
|
|
|
|
|
— **def [set\_test\_failure\_tryjob\_result](/recipes/recipe_modules/tryserver/api.py#192)(self):**
|
|
|
|
|
— **def [set\_test\_failure\_tryjob\_result](/recipes/recipe_modules/tryserver/api.py#206)(self):**
|
|
|
|
|
|
|
|
|
|
Mark the tryjob result as a test failure.
|
|
|
|
|
|
|
|
|
|
This means we started running actual tests (not prerequisite steps
|
|
|
|
|
like checkout or compile), and some of these tests have failed.
|
|
|
|
|
|
|
|
|
|
— **def [set\_test\_timeout\_tryjob\_result](/recipes/recipe_modules/tryserver/api.py#209)(self):**
|
|
|
|
|
— **def [set\_test\_timeout\_tryjob\_result](/recipes/recipe_modules/tryserver/api.py#223)(self):**
|
|
|
|
|
|
|
|
|
|
Mark the tryjob result as a test timeout.
|
|
|
|
|
|
|
|
|
@ -1035,6 +1043,11 @@ Move things around in a loop!
|
|
|
|
|
[DEPS](/recipes/recipe_modules/tryserver/tests/gerrit_change_fetch_ref_timeout.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_timeout.py#15)(api):**
|
|
|
|
|
### *recipes* / [tryserver:tests/gerrit\_change\_owner](/recipes/recipe_modules/tryserver/tests/gerrit_change_owner.py)
|
|
|
|
|
|
|
|
|
|
[DEPS](/recipes/recipe_modules/tryserver/tests/gerrit_change_owner.py#7): [gerrit](#recipe_modules-gerrit), [tryserver](#recipe_modules-tryserver), [recipe\_engine/buildbucket][recipe_engine/recipe_modules/buildbucket]
|
|
|
|
|
|
|
|
|
|
— **def [RunSteps](/recipes/recipe_modules/tryserver/tests/gerrit_change_owner.py#14)(api):**
|
|
|
|
|
### *recipes* / [tryserver:tests/gerrit\_change\_target\_ref](/recipes/recipe_modules/tryserver/tests/gerrit_change_target_ref.py)
|
|
|
|
|
|
|
|
|
|
[DEPS](/recipes/recipe_modules/tryserver/tests/gerrit_change_target_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], [recipe\_engine/step][recipe_engine/recipe_modules/step]
|
|
|
|
|