blob: 5029498d1245e95b4a06c786a4630d7c9f5b5689 [file] [log] [blame]
# Copyright 2014 The Chromium Authors. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
import contextlib
import hashlib
from recipe_engine import recipe_api
class TryserverApi(recipe_api.RecipeApi):
def __init__(self, *args, **kwargs):
super(TryserverApi, self).__init__(*args, **kwargs)
self._failure_reasons = []
self._gerrit_change = None # self.m.buildbucket.common_pb2.GerritChange
self._gerrit_change_repo_url = None
self._gerrit_info_initialized = False
self._gerrit_change_target_ref = None
self._gerrit_change_fetch_ref = None
def initialize(self):
changes =
if len(changes) == 1:
cl = changes[0]
self._gerrit_change = cl
git_host =
gs_suffix = ''
if git_host.endswith(gs_suffix):
git_host = '' % git_host[:-len(gs_suffix)]
self._gerrit_change_repo_url = 'https://%s/%s' % (git_host, cl.project)
def gerrit_change(self):
"""Returns current gerrit change, if there is exactly one.
Returns a self.m.buildbucket.common_pb2.GerritChange or None.
return self._gerrit_change
def gerrit_change_repo_url(self):
"""Returns canonical URL of the gitiles repo of the current Gerrit CL.
Populated iff gerrit_change is populated.
return self._gerrit_change_repo_url
def _ensure_gerrit_change_info(self):
"""Initializes extra info about gerrit_change, fetched from Gerrit server.
Initializes _gerrit_change_target_ref and _gerrit_change_fetch_ref.
May emit a step when called for the first time.
cl = self.gerrit_change
if not cl: # pragma: no cover
if self._gerrit_info_initialized:
td = self._test_data if self._test_data.enabled else {}
mock_res = [{
'branch': td.get('gerrit_change_target_ref', 'master'),
'revisions': {
'184ebe53805e102605d11f6b143486d15c23a09c': {
'_number': str(cl.patchset),
'ref': 'refs/changes/%02d/%d/%d' % (
cl.change % 100, cl.change, cl.patchset),
res = self.m.gerrit.get_changes(
host='https://' +,
query_params=[('change', cl.change)],
# This list must remain static/hardcoded.
# If you need extra info, either change it here (hardcoded) or
# fetch separetely.
name='fetch current CL info',
step_test_data=lambda: self.m.json.test_api.output(mock_res))[0]
self._gerrit_change_target_ref = res['branch']
if not self._gerrit_change_target_ref.startswith('refs/'):
self._gerrit_change_target_ref = (
'refs/heads/' + self._gerrit_change_target_ref)
for rev in res['revisions'].itervalues():
if int(rev['_number']) == self.gerrit_change.patchset:
self._gerrit_change_fetch_ref = rev['ref']
self._gerrit_info_initialized = True
def gerrit_change_fetch_ref(self):
"""Returns gerrit patch ref, e.g. "refs/heads/45/12345/6, or None.
Populated iff gerrit_change is populated.
return self._gerrit_change_fetch_ref
def gerrit_change_target_ref(self):
"""Returns gerrit change destination ref, e.g. "refs/heads/master".
Populated iff gerrit_change is populated.
return self._gerrit_change_target_ref
def is_tryserver(self):
"""Returns true iff we have a change to check out."""
return (self.is_patch_in_git or self.is_gerrit_issue)
def is_gerrit_issue(self):
"""Returns true iff the properties exist to match a Gerrit issue."""
if self.gerrit_change:
return True
# TODO(tandrii): remove this, once nobody is using buildbot Gerrit Poller.
return ('event.patchSet.ref' in and
'event.change.url' in and
'' in
def is_patch_in_git(self):
return ('patch_storage') == 'git' and'patch_repo_url') and'patch_ref'))
def get_files_affected_by_patch(self, patch_root, **kwargs):
"""Returns list of paths to files affected by the patch.
patch_root: path relative to api.path['root'], usually obtained from
Returned paths will be relative to to patch_root.
cwd = self.m.context.cwd or self.m.path['start_dir'].join(patch_root)
with self.m.context(cwd=cwd):
step_result = self.m.git(
'-c', 'core.quotePath=false', 'diff', '--cached', '--name-only',
name='git diff to analyze patch',
paths = [self.m.path.join(patch_root, p) for p in
if self.m.platform.is_win:
# Looks like "analyze" wants POSIX slashes even on Windows (since git
# uses that format even on Windows).
paths = [path.replace('\\', '/') for path in paths]
step_result.presentation.logs['files'] = paths
return paths
def set_subproject_tag(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.
assert self.is_tryserver
step_result = self.m.step.active_result['subproject_tag'] = subproject_tag
def _set_failure_type(self, failure_type):
if not self.is_tryserver:
step_result = self.m.step.active_result['failure_type'] = failure_type
def set_do_not_retry_build(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.
step_result = self.m.step.active_result['do_not_retry'] = True
def set_patch_failure_tryjob_result(self):
"""Mark the tryjob result as failure to apply the patch."""
def set_compile_failure_tryjob_result(self):
"""Mark the tryjob result as a compile failure."""
def set_test_failure_tryjob_result(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_invalid_test_results_tryjob_result(self):
"""Mark the tryjob result as having invalid test results.
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 add_failure_reason(self, reason):
Records a more detailed reason why build is failing.
The reason can be any JSON-serializable object.
assert self.m.json.is_serializable(reason)
def set_failure_hash(self):
Context manager that sets a failure_hash build property on StepFailure.
This can be used to easily compare whether two builds have failed
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.
except self.m.step.StepFailure as e:
step_result = self.m.step.active_result
except ValueError:
step_result = None
if step_result:
failure_hash = hashlib.sha1()
failure_hash.update(self.m.json.dumps(self._failure_reasons))['failure_hash'] = (
raise e
def get_footers(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.
if patch_text is None:
if self.gerrit_change:
# TODO: reuse _ensure_gerrit_change_info.
patch_text = self.m.gerrit.get_change_description(
'https://%s' %,
result = self.m.python(
'parse description', self.repo_resource(''),
args=['--json', self.m.json.output()],
return result.json.output
def get_footer(self, tag, patch_text=None):
"""Gets a specific tag from a CL description"""
return self.get_footers(patch_text).get(tag, [])
def normalize_footer_name(self, footer):
return '-'.join([ word.title() for word in footer.strip().split('-') ])