libv8 5.7.492.65.1 → 5.9.211.38.0beta0

data/vendor/depot_tools/owners_finder.py

@@ -25,7 +25,8 @@ class OwnersFinder(object):
   def __init__(self, files, local_root, author,
                fopen, os_path,
                email_postfix='@chromium.org',
-               disable_color=False):
+               disable_color=False,
+               override_files=None):
     self.email_postfix = email_postfix
 
     if os.name == 'nt' or disable_color:
@@ -35,6 +36,7 @@ class OwnersFinder(object):
       self.COLOR_RESET = ''
 
     self.db = owners_module.Database(local_root, fopen, os_path)
+    self.db.override_files = override_files or {}
     self.db.load_data_needed_for(files)
 
     self.os_path = os_path
@@ -52,6 +54,7 @@ class OwnersFinder(object):
       files = filtered_files
       # Reload the database.
       self.db = owners_module.Database(local_root, fopen, os_path)
+      self.db.override_files = override_files or {}
       self.db.load_data_needed_for(files)
 
     self.all_possible_owners = self.db.all_possible_owners(files, None)
@@ -207,8 +210,17 @@ class OwnersFinder(object):
     else:
       self.writeln(self.bold_name(owner) + ' is commented as:')
       self.indent()
+      if owners_module.GLOBAL_STATUS in self.comments[owner]:
+        self.writeln(
+            self.greyed(self.comments[owner][owners_module.GLOBAL_STATUS]) +
+            ' (global status)')
+        if len(self.comments[owner]) == 1:
+          self.unindent()
+          return
       for path in self.comments[owner]:
-        if len(self.comments[owner][path]) > 0:
+        if path == owners_module.GLOBAL_STATUS:
+          continue
+        elif len(self.comments[owner][path]) > 0:
           self.writeln(self.greyed(self.comments[owner][path]) +
                        ' (at ' + self.bold(path or '<root>') + ')')
         else:

data/vendor/depot_tools/presubmit_canned_checks.py

@@ -39,39 +39,13 @@ BLACKLIST_LINT_FILTERS = [
 
 ### Description checks
 
-def CheckChangeHasTestField(input_api, output_api):
-  """Requires that the changelist have a TEST= field."""
-  if input_api.change.TEST:
-    return []
-  else:
-    return [output_api.PresubmitNotifyResult(
-        'If this change requires manual test instructions to QA team, add '
-        'TEST=[instructions].')]
-
-
 def CheckChangeHasBugField(input_api, output_api):
-  """Requires that the changelist have a BUG= field."""
-  if input_api.change.BUG:
+  """Requires that the changelist have a Bug: field."""
+  if input_api.change.BugsFromDescription():
     return []
   else:
     return [output_api.PresubmitNotifyResult(
-        'If this change has an associated bug, add BUG=[bug number].')]
-
-
-def CheckChangeHasTestedField(input_api, output_api):
-  """Requires that the changelist have a TESTED= field."""
-  if input_api.change.TESTED:
-    return []
-  else:
-    return [output_api.PresubmitError('Changelist must have a TESTED= field.')]
-
-
-def CheckChangeHasQaField(input_api, output_api):
-  """Requires that the changelist have a QA= field."""
-  if input_api.change.QA:
-    return []
-  else:
-    return [output_api.PresubmitError('Changelist must have a QA= field.')]
+        'If this change has an associated bug, add Bug: [bug number].')]
 
 
 def CheckDoNotSubmitInDescription(input_api, output_api):
@@ -361,7 +335,7 @@ def CheckLongLines(input_api, output_api, maxlen, source_file_filter=None):
   CPP_FILE_EXTS = ('c', 'cc')
   CPP_EXCEPTIONS = ('#define', '#endif', '#if', '#include', '#pragma')
   HTML_FILE_EXTS = ('html',)
-  HTML_EXCEPTIONS = ('<link',)
+  HTML_EXCEPTIONS = ('<g ', '<link ', '<path ',)
   JAVA_FILE_EXTS = ('java',)
   JAVA_EXCEPTIONS = ('import ', 'package ')
   JS_FILE_EXTS = ('js',)
@@ -383,7 +357,7 @@ def CheckLongLines(input_api, output_api, maxlen, source_file_filter=None):
 
   def no_long_lines(file_extension, line):
     # Check for language specific exceptions.
-    if any(file_extension in exts and line.startswith(exceptions)
+    if any(file_extension in exts and line.lstrip().startswith(exceptions)
            for exts, exceptions in LANGUAGE_EXCEPTIONS):
       return True
 
@@ -525,7 +499,8 @@ def GetUnitTestsInDirectory(
       continue
     unit_tests.append(input_api.os_path.join(directory, filename))
     to_run += 1
-  input_api.logging.debug('Found %d files, running %d' % (found, to_run))
+  input_api.logging.debug('Found %d files, running %d unit tests'
+                          % (found, to_run))
   if not to_run:
     return [
         output_api.PresubmitPromptWarning(
@@ -675,6 +650,9 @@ def _FetchAllFiles(input_api, white_list, black_list):
   # can break another unmodified file.
   # Use code similar to InputApi.FilterSourceFile()
   def Find(filepath, filters):
+    if input_api.platform == 'win32':
+      filepath = filepath.replace('\\', '/')
+
     for item in filters:
       if input_api.re.match(item, filepath):
         return True
@@ -879,6 +857,7 @@ def CheckOwners(input_api, output_api, source_file_filter=None):
       input_api.change.AffectedFiles(file_filter=source_file_filter)])
 
   owners_db = input_api.owners_db
+  owners_db.override_files = input_api.change.OriginalOwnersFiles()
   owner_email, reviewers = GetCodereviewOwnerAndReviewers(
       input_api,
       owners_db.email_regexp,
@@ -899,9 +878,20 @@ def CheckOwners(input_api, output_api, source_file_filter=None):
                   (needed, '\n    '.join(sorted(missing_files))))]
     if not input_api.is_committing:
       suggested_owners = owners_db.reviewers_for(missing_files, owner_email)
+      finder = input_api.owners_finder(
+          missing_files, input_api.change.RepositoryRoot(),
+          owner_email, fopen=file, os_path=input_api.os_path,
+          email_postfix='', disable_color=True,
+          override_files=input_api.change.OriginalOwnersFiles())
+      owners_with_comments = []
+      def RecordComments(text):
+        owners_with_comments.append(finder.print_indent() + text)
+      finder.writeln = RecordComments
+      for owner in suggested_owners:
+        finder.print_comments(owner)
       output_list.append(output_fn('Suggested OWNERS: ' +
           '(Use "git-cl owners" to interactively select owners.)\n    %s' %
-          ('\n    '.join(suggested_owners or []))))
+          ('\n    '.join(owners_with_comments))))
     return output_list
 
   if input_api.is_committing and not reviewers:
@@ -932,10 +922,8 @@ def _GetRietveldIssueProps(input_api, messages):
 def _ReviewersFromChange(change):
   """Return the reviewers specified in the |change|, if any."""
   reviewers = set()
-  if change.R:
-    reviewers.update(set([r.strip() for r in change.R.split(',')]))
-  if change.TBR:
-    reviewers.update(set([r.strip() for r in change.TBR.split(',')]))
+  reviewers.update(change.ReviewersFromDescription())
+  reviewers.update(change.TBRsFromDescription())
 
   # Drop reviewers that aren't specified in email address format.
   return set(reviewer for reviewer in reviewers if '@' in reviewer)
@@ -988,33 +976,6 @@ def _GerritOwnerAndReviewers(input_api, email_regexp, approval_needed=False):
   return owner_email, reviewers
 
 
-def _CheckConstNSObject(input_api, output_api, source_file_filter):
-  """Checks to make sure no objective-c files have |const NSSomeClass*|."""
-  pattern = input_api.re.compile(
-    r'(?<!reinterpret_cast<)'
-    r'const\s+NS(?!(Point|Range|Rect|Size)\s*\*)\w*\s*\*')
-
-  def objective_c_filter(f):
-    return (source_file_filter(f) and
-            input_api.os_path.splitext(f.LocalPath())[1] in ('.h', '.m', '.mm'))
-
-  files = []
-  for f in input_api.AffectedSourceFiles(objective_c_filter):
-    contents = input_api.ReadFile(f)
-    if pattern.search(contents):
-      files.append(f)
-
-  if files:
-    if input_api.is_committing:
-      res_type = output_api.PresubmitPromptWarning
-    else:
-      res_type = output_api.PresubmitNotifyResult
-    return [ res_type('|const NSClass*| is wrong, see ' +
-                      'http://dev.chromium.org/developers/clang-mac',
-                      files) ]
-  return []
-
-
 def CheckSingletonInHeaders(input_api, output_api, source_file_filter=None):
   """Deprecated, must be removed."""
   return [
@@ -1105,9 +1066,6 @@ def PanProjectChecks(input_api, output_api,
   snapshot( "checking stray whitespace")
   results.extend(input_api.canned_checks.CheckChangeHasNoStrayWhitespace(
       input_api, output_api, source_file_filter=sources))
-  snapshot("checking nsobjects")
-  results.extend(_CheckConstNSObject(
-      input_api, output_api, source_file_filter=sources))
   snapshot("checking license")
   results.extend(input_api.canned_checks.CheckLicense(
       input_api, output_api, license_header, source_file_filter=sources))

data/vendor/depot_tools/presubmit_support.py

@@ -43,8 +43,10 @@ from warnings import warn
 import auth
 import fix_encoding
 import gclient_utils
+import git_footers
 import gerrit_util
 import owners
+import owners_finder
 import presubmit_canned_checks
 import rietveld
 import scm
@@ -200,8 +202,7 @@ class GerritAccessor(object):
     try:
       return gerrit_util.GetChangeDetail(
           self.host, str(issue),
-          ['ALL_REVISIONS', 'DETAILED_LABELS', 'ALL_COMMITS'],
-          ignore_404=False)
+          ['ALL_REVISIONS', 'DETAILED_LABELS', 'ALL_COMMITS'])
     except gerrit_util.GerritError as e:
       if e.http_status == 404:
         raise Exception('Either Gerrit issue %s doesn\'t exist, or '
@@ -286,21 +287,38 @@ class OutputApi(object):
         CQ_INCLUDE_TRYBOTS was updated.
     """
     description = cl.GetDescription(force=True)
-    all_bots = []
-    include_re = re.compile(r'^CQ_INCLUDE_TRYBOTS=(.*)', re.M | re.I)
-    m = include_re.search(description)
-    if m:
-      all_bots = [i.strip() for i in m.group(1).split(';') if i.strip()]
-    if set(all_bots) >= set(bots_to_include):
+    include_re = re.compile(r'^CQ_INCLUDE_TRYBOTS=(.*)$', re.M | re.I)
+
+    prior_bots = []
+    if cl.IsGerrit():
+      trybot_footers = git_footers.parse_footers(description).get(
+          git_footers.normalize_name('Cq-Include-Trybots'), [])
+      for f in trybot_footers:
+        prior_bots += [b.strip() for b in f.split(';') if b.strip()]
+    else:
+      trybot_tags = include_re.finditer(description)
+      for t in trybot_tags:
+        prior_bots += [b.strip() for b in t.group(1).split(';') if b.strip()]
+
+    if set(prior_bots) >= set(bots_to_include):
       return []
-    # Sort the bots to keep them in some consistent order -- not required.
-    all_bots = sorted(set(all_bots) | set(bots_to_include))
-    new_include_trybots = 'CQ_INCLUDE_TRYBOTS=%s' % ';'.join(all_bots)
-    if m:
-      new_description = include_re.sub(new_include_trybots, description)
+    all_bots = ';'.join(sorted(set(prior_bots) | set(bots_to_include)))
+
+    if cl.IsGerrit():
+      description = git_footers.remove_footer(
+          description, 'Cq-Include-Trybots')
+      description = git_footers.add_footer(
+          description, 'Cq-Include-Trybots', all_bots,
+          before_keys=['Change-Id'])
     else:
-      new_description = description + '\n' + new_include_trybots + '\n'
-    cl.UpdateDescription(new_description, force=True)
+      new_include_trybots = 'CQ_INCLUDE_TRYBOTS=%s' % all_bots
+      m = include_re.search(description)
+      if m:
+        description = include_re.sub(new_include_trybots, description)
+      else:
+        description = '%s\n%s\n' % (description, new_include_trybots)
+
+    cl.UpdateDescription(description, force=True)
     return [self.PresubmitNotifyResult(message)]
 
 
@@ -418,10 +436,12 @@ class InputApi(object):
     # We carry the canned checks so presubmit scripts can easily use them.
     self.canned_checks = presubmit_canned_checks
 
+
     # TODO(dpranke): figure out a list of all approved owners for a repo
     # in order to be able to handle wildcard OWNERS files?
     self.owners_db = owners.Database(change.RepositoryRoot(),
-        fopen=file, os_path=self.os_path)
+                                     fopen=file, os_path=self.os_path)
+    self.owners_finder = owners_finder.OwnersFinder
     self.verbose = verbose
     self.Command = CommandData
 
@@ -548,7 +568,7 @@ class InputApi(object):
   @property
   def tbr(self):
     """Returns if a change is TBR'ed."""
-    return 'TBR' in self.change.tags
+    return 'TBR' in self.change.tags or self.change.TBRsFromDescription()
 
   def RunTests(self, tests_mix, parallel=True):
     tests = []
@@ -663,8 +683,6 @@ class AffectedFile(object):
 
   def Action(self):
     """Returns the action on this opened file, e.g. A, M, D, etc."""
-    # TODO(maruel): Somewhat crappy, Could be "A" or "A  +" for svn but
-    # different for other SCM.
     return self._action
 
   def IsTestableFile(self):
@@ -855,6 +873,37 @@ class Change(object):
       raise AttributeError(self, attr)
     return self.tags.get(attr)
 
+  def BugsFromDescription(self):
+    """Returns all bugs referenced in the commit description."""
+    tags = [b.strip() for b in self.tags.get('BUG', '').split(',') if b.strip()]
+    footers = git_footers.parse_footers(self._full_description).get('Bug', [])
+    return sorted(set(tags + footers))
+
+  def ReviewersFromDescription(self):
+    """Returns all reviewers listed in the commit description."""
+    # We don't support a "R:" git-footer for reviewers; that is in metadata.
+    tags = [r.strip() for r in self.tags.get('R', '').split(',') if r.strip()]
+    return sorted(set(tags))
+
+  def TBRsFromDescription(self):
+    """Returns all TBR reviewers listed in the commit description."""
+    tags = [r.strip() for r in self.tags.get('TBR', '').split(',') if r.strip()]
+    # TODO(agable): Remove support for 'Tbr:' when TBRs are programmatically
+    # determined by self-CR+1s.
+    footers = git_footers.parse_footers(self._full_description).get('Tbr', [])
+    return sorted(set(tags + footers))
+
+  # TODO(agable): Delete these once we're sure they're unused.
+  @property
+  def BUG(self):
+    return ','.join(self.BugsFromDescription())
+  @property
+  def R(self):
+    return ','.join(self.ReviewersFromDescription())
+  @property
+  def TBR(self):
+    return ','.join(self.TBRsFromDescription())
+
   def AllFiles(self, root=None):
     """List all files under source control in the repo."""
     raise NotImplementedError()
@@ -873,8 +922,7 @@ class Change(object):
 
     if include_deletes:
       return affected
-    else:
-      return filter(lambda x: x.Action() != 'D', affected)
+    return filter(lambda x: x.Action() != 'D', affected)
 
   def AffectedTestableFiles(self, include_deletes=None):
     """Return a list of the existing text files in a change."""
@@ -916,6 +964,13 @@ class Change(object):
         x for x in self.AffectedFiles(include_deletes=False)
         if x.IsTestableFile())
 
+  def OriginalOwnersFiles(self):
+    """A map from path names of affected OWNERS files to their old content."""
+    def owners_file_filter(f):
+      return 'OWNERS' in os.path.split(f.LocalPath())[1]
+    files = self.AffectedFiles(file_filter=owners_file_filter)
+    return dict([(f.LocalPath(), f.OldContents()) for f in files])
+
 
 class GitChange(Change):
   _AFFECTED_FILES = GitAffectedFile
@@ -1342,17 +1397,17 @@ def DoPresubmitChecks(change,
 def ScanSubDirs(mask, recursive):
   if not recursive:
     return [x for x in glob.glob(mask) if x not in ('.svn', '.git')]
-  else:
-    results = []
-    for root, dirs, files in os.walk('.'):
-      if '.svn' in dirs:
-        dirs.remove('.svn')
-      if '.git' in dirs:
-        dirs.remove('.git')
-      for name in files:
-        if fnmatch.fnmatch(name, mask):
-          results.append(os.path.join(root, name))
-    return results
+
+  results = []
+  for root, dirs, files in os.walk('.'):
+    if '.svn' in dirs:
+      dirs.remove('.svn')
+    if '.git' in dirs:
+      dirs.remove('.git')
+    for name in files:
+      if fnmatch.fnmatch(name, mask):
+        results.append(os.path.join(root, name))
+  return results
 
 
 def ParseFiles(args, recursive):
@@ -1467,9 +1522,6 @@ def main(argv=None):
   parser.add_option("--rietveld_email_file", help=optparse.SUPPRESS_HELP)
   parser.add_option("--rietveld_private_key_file", help=optparse.SUPPRESS_HELP)
 
-  # TODO(phajdan.jr): Update callers and remove obsolete --trybot-json .
-  parser.add_option("--trybot-json",
-                    help="Output trybot information to the file specified.")
   auth.add_auth_options(parser)
   options, args = parser.parse_args(argv)
   auth_config = auth.extract_auth_config_from_options(options)

data/vendor/depot_tools/recipes/OWNERS

@@ -0,0 +1,2 @@
+dnj@chromium.org
+phajdan.jr@chromium.org

data/vendor/depot_tools/recipes/README.recipes.md

@@ -0,0 +1,842 @@
+<!--- AUTOGENERATED BY `./recipes.py test train` -->
+# Package documentation for [depot\_tools](https://chromium.googlesource.com/chromium/tools/depot_tools.git)
+## Table of Contents
+
+**[Recipe Modules](#Recipe-Modules)**
+  * [bot_update](#recipe_modules-bot_update) &mdash; Recipe module to ensure a checkout is consistent on a bot.
+  * [cipd](#recipe_modules-cipd)
+  * [depot_tools](#recipe_modules-depot_tools)
+  * [gclient](#recipe_modules-gclient)
+  * [gerrit](#recipe_modules-gerrit)
+  * [git](#recipe_modules-git)
+  * [git_cl](#recipe_modules-git_cl)
+  * [gitiles](#recipe_modules-gitiles)
+  * [gsutil](#recipe_modules-gsutil)
+  * [infra_paths](#recipe_modules-infra_paths)
+  * [presubmit](#recipe_modules-presubmit)
+  * [rietveld](#recipe_modules-rietveld)
+  * [tryserver](#recipe_modules-tryserver)
+
+**[Recipes](#Recipes)**
+  * [bot_update:examples/full](#recipes-bot_update_examples_full)
+  * [cipd:examples/full](#recipes-cipd_examples_full)
+  * [cipd:examples/platform_suffix](#recipes-cipd_examples_platform_suffix)
+  * [depot_tools:examples/full](#recipes-depot_tools_examples_full)
+  * [gclient:examples/full](#recipes-gclient_examples_full)
+  * [gclient:tests/patch_project](#recipes-gclient_tests_patch_project)
+  * [gerrit:examples/full](#recipes-gerrit_examples_full)
+  * [git:examples/full](#recipes-git_examples_full)
+  * [git_cl:examples/full](#recipes-git_cl_examples_full)
+  * [gitiles:examples/full](#recipes-gitiles_examples_full)
+  * [gsutil:examples/full](#recipes-gsutil_examples_full)
+  * [infra_paths:examples/full](#recipes-infra_paths_examples_full)
+  * [presubmit:examples/full](#recipes-presubmit_examples_full)
+  * [rietveld:examples/full](#recipes-rietveld_examples_full)
+  * [tryserver:examples/full](#recipes-tryserver_examples_full)
+## Recipe Modules
+
+### *recipe_modules* / [bot\_update](/recipes/recipe_modules/bot_update)
+
+[DEPS](/recipes/recipe_modules/bot_update/__init__.py#1): [depot\_tools](#recipe_modules-depot_tools), [gclient](#recipe_modules-gclient), [gerrit](#recipe_modules-gerrit), [rietveld](#recipe_modules-rietveld), [tryserver](#recipe_modules-tryserver), [recipe\_engine/context][recipe_engine/recipe_modules/context], [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]
+
+Recipe module to ensure a checkout is consistent on a bot.
+
+#### **class [BotUpdateApi](/recipes/recipe_modules/bot_update/api.py#11)([RecipeApi][recipe_engine/wkt/RecipeApi]):**
+
+&mdash; **def [\_\_call\_\_](/recipes/recipe_modules/bot_update/api.py#31)(self, name, cmd, \*\*kwargs):**
+
+Wrapper for easy calling of bot_update.
+
+&mdash; **def [\_\_init\_\_](/recipes/recipe_modules/bot_update/api.py#13)(self, issue, patch_issue, patchset, patch_set, patch_project, repository, patch_repository_url, gerrit_ref, patch_ref, patch_gerrit_url, rietveld, revision, parent_got_revision, deps_revision_overrides, fail_patch, \*args, \*\*kwargs):**
+
+&mdash; **def [apply\_gerrit\_ref](/recipes/recipe_modules/bot_update/api.py#49)(self, root, gerrit_no_reset=False, gerrit_no_rebase_patch_ref=False, \*\*kwargs):**
+
+&mdash; **def [deapply\_patch](/recipes/recipe_modules/bot_update/api.py#427)(self, bot_update_step):**
+
+Deapplies a patch, taking care of DEPS and solution revisions properly.
+    
+
+&mdash; **def [ensure\_checkout](/recipes/recipe_modules/bot_update/api.py#69)(self, gclient_config=None, suffix=None, patch=True, update_presentation=True, patch_root=None, no_shallow=False, with_branch_heads=False, with_tags=False, refs=None, patch_oauth2=False, oauth2_json=False, use_site_config_creds=True, clobber=False, root_solution_revision=None, rietveld=None, issue=None, patchset=None, gerrit_no_reset=False, gerrit_no_rebase_patch_ref=False, disable_syntax_validation=False, \*\*kwargs):**
+
+Args:
+  use_site_config_creds: If the oauth2 credentials are in the buildbot
+    site_config. See crbug.com/624212 for more information.
+  gclient_config: The gclient configuration to use when running bot_update.
+    If omitted, the current gclient configuration is used.
+  rietveld: The rietveld server to use. If omitted, will infer from
+    the 'rietveld' property.
+  issue: The rietveld issue number to use. If omitted, will infer from
+    the 'issue' property.
+  patchset: The rietveld issue patchset to use. If omitted, will infer from
+    the 'patchset' property.
+  disable_syntax_validation: (legacy) Disables syntax validation for DEPS.
+    Needed as migration paths for recipes dealing with older revisions,
+    such as bisect.
+
+&mdash; **def [get\_project\_revision\_properties](/recipes/recipe_modules/bot_update/api.py#404)(self, project_name, gclient_config=None):**
+
+Returns all property names used for storing the checked-out revision of
+a given project.
+
+Args:
+  project_name (str): The name of a checked-out project as deps path, e.g.
+      src or src/v8.
+  gclient_config: The gclient configuration to use. If omitted, the current
+      gclient configuration is used.
+
+Returns (list of str): All properties that'll hold the checked-out revision
+    of the given project. An empty list if no such properties exist.
+
+&emsp; **@property**<br>&mdash; **def [last\_returned\_properties](/recipes/recipe_modules/bot_update/api.py#43)(self):**
+### *recipe_modules* / [cipd](/recipes/recipe_modules/cipd)
+
+[DEPS](/recipes/recipe_modules/cipd/__init__.py#1): [infra\_paths](#recipe_modules-infra_paths), [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]
+
+#### **class [CIPDApi](/recipes/recipe_modules/cipd/api.py#148)([RecipeApi][recipe_engine/wkt/RecipeApi]):**
+
+CIPDApi provides basic support for CIPD.
+
+This assumes that `cipd` (or `cipd.exe` or `cipd.bat` on windows) has been
+installed somewhere in $PATH. This will be true if you use depot_tools, or if
+your recipe is running inside of chrome-infrastructure's systems (buildbot,
+swarming).
+
+&mdash; **def [build](/recipes/recipe_modules/cipd/api.py#221)(self, input_dir, output_package, package_name, install_mode=None):**
+
+Builds, but does not upload, a cipd package from a directory.
+
+Args:
+  input_dir (Path) - the directory to build the package from.
+  output_package (Path) - the file to write the package to.
+  package_name (str) - the name of the cipd package as it would appear when
+    uploaded to the cipd package server.
+  install_mode (None|'copy'|'symlink') - the mechanism that the cipd client
+    should use when installing this package. If None, defaults to the
+    platform default ('copy' on windows, 'symlink' on everything else).
+
+&mdash; **def [create\_from\_pkg](/recipes/recipe_modules/cipd/api.py#317)(self, pkg_def, refs=None, tags=None):**
+
+Builds and uploads a package based on a PackageDefinition object.
+
+This builds and uploads the package in one step.
+
+Args:
+  pkg_def (PackageDefinition) - The description of the package we want to
+    create.
+  refs (list(str)) - A list of ref names to set for the package instance.
+  tags (dict(str, str)) - A map of tag name -> value to set for the package
+                          instance.
+
+Returns the JSON 'result' section, e.g.: {
+  "package": "infra/tools/cipd/android-amd64",
+  "instance_id": "433bfdf86c0bb82d1eee2d1a0473d3709c25d2c4"
+}
+
+&mdash; **def [create\_from\_yaml](/recipes/recipe_modules/cipd/api.py#297)(self, pkg_def, refs=None, tags=None):**
+
+Builds and uploads a package based on on-disk YAML package definition
+file.
+
+This builds and uploads the package in one step.
+
+Args:
+  pkg_def (Path) - The path to the yaml file.
+  refs (list(str)) - A list of ref names to set for the package instance.
+  tags (dict(str, str)) - A map of tag name -> value to set for the package
+                          instance.
+
+Returns the JSON 'result' section, e.g.: {
+  "package": "infra/tools/cipd/android-amd64",
+  "instance_id": "433bfdf86c0bb82d1eee2d1a0473d3709c25d2c4"
+}
+
+&emsp; **@property**<br>&mdash; **def [default\_bot\_service\_account\_credentials](/recipes/recipe_modules/cipd/api.py#185)(self):**
+
+&mdash; **def [describe](/recipes/recipe_modules/cipd/api.py#424)(self, package_name, version, test_data_refs=None, test_data_tags=None):**
+
+&mdash; **def [ensure](/recipes/recipe_modules/cipd/api.py#339)(self, root, packages):**
+
+Ensures that packages are installed in a given root dir.
+
+packages must be a mapping from package name to its version, where
+  * name must be for right platform (see also ``platform_suffix``),
+  * version could be either instance_id, or ref, or unique tag.
+
+If installing a package requires credentials, call
+``set_service_account_credentials`` before calling this function.
+
+&emsp; **@property**<br>&mdash; **def [executable](/recipes/recipe_modules/cipd/api.py#181)(self):**
+
+&mdash; **def [initialize](/recipes/recipe_modules/cipd/api.py#175)(self):**
+
+&mdash; **def [platform\_suffix](/recipes/recipe_modules/cipd/api.py#194)(self, name=None, arch=None, bits=None):**
+
+Use to get full package name that is platform indepdent.
+
+Example:
+  >>> 'my/package/%s' % api.cipd.platform_suffix()
+  'my/package/linux-amd64'
+
+Optional platform bits and architecture may be supplied to generate CIPD
+suffixes for other platforms. If any are omitted, the current platform
+parameters will be used.
+
+&mdash; **def [register](/recipes/recipe_modules/cipd/api.py#249)(self, package_name, package_path, refs=None, tags=None):**
+
+&mdash; **def [search](/recipes/recipe_modules/cipd/api.py#406)(self, package_name, tag):**
+
+&mdash; **def [set\_ref](/recipes/recipe_modules/cipd/api.py#386)(self, package_name, version, refs):**
+
+&mdash; **def [set\_service\_account\_credentials](/recipes/recipe_modules/cipd/api.py#178)(self, path):**
+
+&mdash; **def [set\_tag](/recipes/recipe_modules/cipd/api.py#366)(self, package_name, version, tags):**
+### *recipe_modules* / [depot\_tools](/recipes/recipe_modules/depot_tools)
+
+[DEPS](/recipes/recipe_modules/depot_tools/__init__.py#1): [recipe\_engine/platform][recipe_engine/recipe_modules/platform]
+
+#### **class [DepotToolsApi](/recipes/recipe_modules/depot_tools/api.py#7)([RecipeApi][recipe_engine/wkt/RecipeApi]):**
+
+&emsp; **@property**<br>&mdash; **def [cros\_path](/recipes/recipe_modules/depot_tools/api.py#21)(self):**
+
+&emsp; **@property**<br>&mdash; **def [download\_from\_google\_storage\_path](/recipes/recipe_modules/depot_tools/api.py#8)(self):**
+
+&emsp; **@property**<br>&mdash; **def [gn\_py\_path](/recipes/recipe_modules/depot_tools/api.py#25)(self):**
+
+&emsp; **@property**<br>&mdash; **def [gsutil\_py\_path](/recipes/recipe_modules/depot_tools/api.py#31)(self):**
+
+&emsp; **@property**<br>&mdash; **def [ninja\_path](/recipes/recipe_modules/depot_tools/api.py#35)(self):**
+
+&emsp; **@property**<br>&mdash; **def [presubmit\_support\_py\_path](/recipes/recipe_modules/depot_tools/api.py#40)(self):**
+
+&emsp; **@property**<br>&mdash; **def [root](/recipes/recipe_modules/depot_tools/api.py#16)(self):**
+
+Returns (Path): The "depot_tools" root directory.
+
+&emsp; **@property**<br>&mdash; **def [upload\_to\_google\_storage\_path](/recipes/recipe_modules/depot_tools/api.py#12)(self):**
+### *recipe_modules* / [gclient](/recipes/recipe_modules/gclient)
+
+[DEPS](/recipes/recipe_modules/gclient/__init__.py#1): [infra\_paths](#recipe_modules-infra_paths), [tryserver](#recipe_modules-tryserver), [recipe\_engine/context][recipe_engine/recipe_modules/context], [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/step][recipe_engine/recipe_modules/step]
+
+#### **class [GclientApi](/recipes/recipe_modules/gclient/api.py#65)([RecipeApi][recipe_engine/wkt/RecipeApi]):**
+
+&mdash; **def [\_\_call\_\_](/recipes/recipe_modules/gclient/api.py#75)(self, name, cmd, infra_step=True, \*\*kwargs):**
+
+Wrapper for easy calling of gclient steps.
+
+&mdash; **def [\_\_init\_\_](/recipes/recipe_modules/gclient/api.py#70)(self, \*\*kwargs):**
+
+&mdash; **def [break\_locks](/recipes/recipe_modules/gclient/api.py#287)(self):**
+
+Remove all index.lock files. If a previous run of git crashed, bot was
+reset, etc... we might end up with leftover index.lock files.
+
+&mdash; **def [calculate\_patch\_root](/recipes/recipe_modules/gclient/api.py#309)(self, patch_project, gclient_config=None):**
+
+Returns path where a patch should be applied to based patch_project.
+
+Maps "patch_project" to a path of directories relative to checkout's root,
+which describe where to place the patch.
+
+For now, considers only first solution (c.solutions[0]), but in theory can
+be extended to all of them.
+
+See patch_projects solution config property.
+
+Returns:
+  Relative path, including solution's root.
+  If patch_project is not given or not recognized, it'll be just first
+  solution root.
+
+&mdash; **def [checkout](/recipes/recipe_modules/gclient/api.py#233)(self, gclient_config=None, revert=RevertOnTryserver, inject_parent_got_revision=True, with_branch_heads=False, \*\*kwargs):**
+
+Return a step generator function for gclient checkouts.
+
+&emsp; **@staticmethod**<br>&mdash; **def [config\_to\_pythonish](/recipes/recipe_modules/gclient/api.py#125)(cfg):**
+
+&mdash; **def [get\_config\_defaults](/recipes/recipe_modules/gclient/api.py#119)(self):**
+
+&emsp; **@staticmethod**<br>&mdash; **def [got\_revision\_reverse\_mapping](/recipes/recipe_modules/gclient/api.py#130)(cfg):**
+
+Returns the merged got_revision_reverse_mapping.
+
+Returns (dict): A mapping from property name -> project name. It merges the
+    values of the deprecated got_revision_mapping and the new
+    got_revision_reverse_mapping.
+
+&mdash; **def [inject\_parent\_got\_revision](/recipes/recipe_modules/gclient/api.py#208)(self, gclient_config=None, override=False):**
+
+Match gclient config to build revisions obtained from build_properties.
+
+Args:
+  gclient_config (gclient config object) - The config to manipulate. A value
+    of None manipulates the module's built-in config (self.c).
+  override (bool) - If True, will forcibly set revision and custom_vars
+    even if the config already contains values for them.
+
+&emsp; **@property**<br>&mdash; **def [is\_blink\_mode](/recipes/recipe_modules/gclient/api.py#274)(self):**
+
+Indicates wether the caller is to use the Blink config rather than the
+Chromium config. This may happen for one of two reasons:
+1. The builder is configured to always use TOT Blink. (factory property
+   top_of_tree_blink=True)
+2. A try job comes in that applies to the Blink tree. (patch_project is
+   blink)
+
+&mdash; **def [resolve\_revision](/recipes/recipe_modules/gclient/api.py#147)(self, revision):**
+
+&mdash; **def [runhooks](/recipes/recipe_modules/gclient/api.py#268)(self, args=None, name='runhooks', \*\*kwargs):**
+
+&mdash; **def [set\_patch\_project\_revision](/recipes/recipe_modules/gclient/api.py#336)(self, patch_project, gclient_config=None):**
+
+Updates config revision corresponding to patch_project.
+
+Useful for bot_update only, as this is the only consumer of gclient's config
+revision map. This doesn't overwrite the revision if it was already set.
+
+&emsp; **@spec_alias.deleter**<br>&mdash; **def [spec\_alias](/recipes/recipe_modules/gclient/api.py#115)(self):**
+
+&mdash; **def [sync](/recipes/recipe_modules/gclient/api.py#152)(self, cfg, with_branch_heads=False, \*\*kwargs):**
+
+&emsp; **@use_mirror.setter**<br>&mdash; **def [use\_mirror](/recipes/recipe_modules/gclient/api.py#102)(self, val):**
+### *recipe_modules* / [gerrit](/recipes/recipe_modules/gerrit)
+
+[DEPS](/recipes/recipe_modules/gerrit/__init__.py#1): [recipe\_engine/context][recipe_engine/recipe_modules/context], [recipe\_engine/json][recipe_engine/recipe_modules/json], [recipe\_engine/path][recipe_engine/recipe_modules/path], [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]
+
+#### **class [GerritApi](/recipes/recipe_modules/gerrit/api.py#7)([RecipeApi][recipe_engine/wkt/RecipeApi]):**
+
+Module for interact with gerrit endpoints
+
+&mdash; **def [\_\_call\_\_](/recipes/recipe_modules/gerrit/api.py#10)(self, name, cmd, infra_step=True, \*\*kwargs):**
+
+Wrapper for easy calling of gerrit_utils steps.
+
+&mdash; **def [create\_gerrit\_branch](/recipes/recipe_modules/gerrit/api.py#27)(self, host, project, branch, commit, \*\*kwargs):**
+
+Create a new branch from given project and commit
+
+Returns:
+  the ref of the branch created
+
+&mdash; **def [get\_change\_description](/recipes/recipe_modules/gerrit/api.py#93)(self, host, change, patchset):**
+
+Get the description for a given CL and patchset.
+
+Args:
+  host: Gerrit host to query.
+  change: The change number.
+  patchset: The patchset number.
+
+Returns:
+  The description corresponding to given CL and patchset.
+
+&mdash; **def [get\_change\_destination\_branch](/recipes/recipe_modules/gerrit/api.py#68)(self, host, change, \*\*kwargs):**
+
+Get the upstream branch for a given CL.
+
+Args:
+  host: Gerrit host to query.
+  change: The change number.
+
+Returns:
+  the name of the branch
+
+&mdash; **def [get\_changes](/recipes/recipe_modules/gerrit/api.py#122)(self, host, query_params, start=None, limit=None, o_params=None, \*\*kwargs):**
+
+Query changes for the given host.
+
+Args:
+  host: Gerrit host to query.
+  query_params: Query parameters as list of (key, value) tuples to form a
+      query as documented here:
+      https://gerrit-review.googlesource.com/Documentation/user-search.html#search-operators
+  start: How many changes to skip (starting with the most recent).
+  limit: Maximum number of results to return.
+  o_params: A list of additional output specifiers, as documented here:
+      https://gerrit-review.googlesource.com/Documentation/rest-api-changes.html#list-changes
+Returns:
+  A list of change dicts as documented here:
+      https://gerrit-review.googlesource.com/Documentation/rest-api-changes.html#list-changes
+
+&mdash; **def [get\_gerrit\_branch](/recipes/recipe_modules/gerrit/api.py#49)(self, host, project, branch, \*\*kwargs):**
+
+Get a branch from given project and commit
+
+Returns:
+  the revision of the branch
+### *recipe_modules* / [git](/recipes/recipe_modules/git)
+
+[DEPS](/recipes/recipe_modules/git/__init__.py#1): [infra\_paths](#recipe_modules-infra_paths), [recipe\_engine/context][recipe_engine/recipe_modules/context], [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]
+
+#### **class [GitApi](/recipes/recipe_modules/git/api.py#10)([RecipeApi][recipe_engine/wkt/RecipeApi]):**
+
+&mdash; **def [\_\_call\_\_](/recipes/recipe_modules/git/api.py#13)(self, \*args, \*\*kwargs):**
+
+Return a git command step.
+
+&mdash; **def [bundle\_create](/recipes/recipe_modules/git/api.py#366)(self, bundle_path, rev_list_args=None, \*\*kwargs):**
+
+Run 'git bundle create' on a Git repository.
+
+Args:
+  bundle_path (Path): The path of the output bundle.
+  refs (list): The list of refs to include in the bundle. If None, all
+      refs in the Git checkout will be bundled.
+  kwargs: Forwarded to '__call__'.
+
+&mdash; **def [cat\_file\_at\_commit](/recipes/recipe_modules/git/api.py#38)(self, file_path, commit_hash, remote_name=None, \*\*kwargs):**
+
+Outputs the contents of a file at a given revision.
+
+&mdash; **def [checkout](/recipes/recipe_modules/git/api.py#110)(self, url, ref=None, dir_path=None, recursive=False, submodules=True, submodule_update_force=False, keep_paths=None, step_suffix=None, curl_trace_file=None, can_fail_build=True, set_got_revision=False, remote_name=None, display_fetch_size=None, file_name=None, submodule_update_recursive=True, use_git_cache=False):**
+
+Performs a full git checkout and returns sha1 of checked out revision.
+
+Args:
+  url (str): url of remote repo to use as upstream
+  ref (str): ref to fetch and check out
+  dir_path (Path): optional directory to clone into
+  recursive (bool): whether to recursively fetch submodules or not
+  submodules (bool): whether to sync and update submodules or not
+  submodule_update_force (bool): whether to update submodules with --force
+  keep_paths (iterable of strings): paths to ignore during git-clean;
+      paths are gitignore-style patterns relative to checkout_path.
+  step_suffix (str): suffix to add to a each step name
+  curl_trace_file (Path): if not None, dump GIT_CURL_VERBOSE=1 trace to that
+      file. Useful for debugging git issue reproducible only on bots. It has
+      a side effect of all stderr output of 'git fetch' going to that file.
+  can_fail_build (bool): if False, ignore errors during fetch or checkout.
+  set_got_revision (bool): if True, resolves HEAD and sets got_revision
+      property.
+  remote_name (str): name of the git remote to use
+  display_fetch_size (bool): if True, run `git count-objects` before and
+    after fetch and display delta. Adds two more steps. Defaults to False.
+  file_name (str): optional path to a single file to checkout.
+  submodule_update_recursive (bool): if True, updates submodules
+      recursively.
+  use_git_cache (bool): if True, git cache will be used for this checkout.
+      WARNING, this is EXPERIMENTAL!!! This wasn't tested with:
+       * submodules
+       * since origin url is modified
+         to a local path, may cause problem with scripts that do
+         "git fetch origin" or "git push origin".
+       * arbitrary refs such refs/whatever/not-fetched-by-default-to-cache
+
+Returns: If the checkout was successful, this returns the commit hash of
+  the checked-out-repo. Otherwise this returns None.
+
+&mdash; **def [config\_get](/recipes/recipe_modules/git/api.py#339)(self, prop_name, \*\*kwargs):**
+
+Returns: (str) The Git config output, or None if no output was generated.
+
+Args:
+  prop_name: (str) The name of the config property to query.
+  kwargs: Forwarded to '__call__'.
+
+&mdash; **def [count\_objects](/recipes/recipe_modules/git/api.py#46)(self, previous_result=None, can_fail_build=False, \*\*kwargs):**
+
+Returns `git count-objects` result as a dict.
+
+Args:
+  previous_result (dict): the result of previous count_objects call.
+    If passed, delta is reported in the log and step text.
+  can_fail_build (bool): if True, may fail the build and/or raise an
+    exception. Defaults to False.
+
+Returns:
+  A dict of count-object values, or None if count-object run failed.
+
+&mdash; **def [fetch\_tags](/recipes/recipe_modules/git/api.py#32)(self, remote_name=None, \*\*kwargs):**
+
+Fetches all tags from the remote.
+
+&mdash; **def [get\_remote\_url](/recipes/recipe_modules/git/api.py#356)(self, remote_name=None, \*\*kwargs):**
+
+Returns: (str) The URL of the remote Git repository, or None.
+
+Args:
+  remote_name: (str) The name of the remote to query, defaults to 'origin'.
+  kwargs: Forwarded to '__call__'.
+
+&mdash; **def [get\_timestamp](/recipes/recipe_modules/git/api.py#311)(self, commit='HEAD', test_data=None, \*\*kwargs):**
+
+Find and return the timestamp of the given commit.
+
+&mdash; **def [new\_branch](/recipes/recipe_modules/git/api.py#379)(self, branch, name=None, upstream=None, \*\*kwargs):**
+
+Runs git new-branch on a Git repository, to be used before git cl upload.
+
+Args:
+  branch (str): new branch name, which must not yet exist.
+  name (str): step name.
+  upstream (str): to origin/master.
+  kwargs: Forwarded to '__call__'.
+
+&mdash; **def [rebase](/recipes/recipe_modules/git/api.py#320)(self, name_prefix, branch, dir_path, remote_name=None, \*\*kwargs):**
+
+Run rebase HEAD onto branch
+Args:
+name_prefix (str): a prefix used for the step names
+branch (str): a branch name or a hash to rebase onto
+dir_path (Path): directory to clone into
+remote_name (str): the remote name to rebase from if not origin
+### *recipe_modules* / [git\_cl](/recipes/recipe_modules/git_cl)
+
+[DEPS](/recipes/recipe_modules/git_cl/__init__.py#1): [recipe\_engine/context][recipe_engine/recipe_modules/context], [recipe\_engine/raw\_io][recipe_engine/recipe_modules/raw_io], [recipe\_engine/step][recipe_engine/recipe_modules/step]
+
+#### **class [GitClApi](/recipes/recipe_modules/git_cl/api.py#9)([RecipeApi][recipe_engine/wkt/RecipeApi]):**
+
+&mdash; **def [\_\_call\_\_](/recipes/recipe_modules/git_cl/api.py#10)(self, subcmd, args, name=None, \*\*kwargs):**
+
+&mdash; **def [get\_description](/recipes/recipe_modules/git_cl/api.py#23)(self, patch_url=None, codereview=None, \*\*kwargs):**
+
+DEPRECATED. Consider using gerrit.get_change_description instead.
+
+&mdash; **def [issue](/recipes/recipe_modules/git_cl/api.py#54)(self, \*\*kwargs):**
+
+&mdash; **def [set\_description](/recipes/recipe_modules/git_cl/api.py#34)(self, description, patch_url=None, codereview=None, \*\*kwargs):**
+
+&mdash; **def [upload](/recipes/recipe_modules/git_cl/api.py#47)(self, message, upload_args=None, \*\*kwargs):**
+### *recipe_modules* / [gitiles](/recipes/recipe_modules/gitiles)
+
+[DEPS](/recipes/recipe_modules/gitiles/__init__.py#1): [recipe\_engine/json][recipe_engine/recipe_modules/json], [recipe\_engine/path][recipe_engine/recipe_modules/path], [recipe\_engine/python][recipe_engine/recipe_modules/python], [recipe\_engine/raw\_io][recipe_engine/recipe_modules/raw_io], [recipe\_engine/url][recipe_engine/recipe_modules/url]
+
+#### **class [Gitiles](/recipes/recipe_modules/gitiles/api.py#10)([RecipeApi][recipe_engine/wkt/RecipeApi]):**
+
+Module for polling a git repository using the Gitiles web interface.
+
+&mdash; **def [commit\_log](/recipes/recipe_modules/gitiles/api.py#97)(self, url, commit, step_name=None, attempts=None):**
+
+Returns: (dict) the Gitiles commit log structure for a given commit.
+
+Args:
+  url (str): The base repository URL.
+  commit (str): The commit hash.
+  step_name (str): If not None, override the step name.
+  attempts (int): Number of times to try the request before failing.
+
+&mdash; **def [download\_file](/recipes/recipe_modules/gitiles/api.py#113)(self, repository_url, file_path, branch='master', step_name=None, attempts=None, \*\*kwargs):**
+
+Downloads raw file content from a Gitiles repository.
+
+Args:
+  repository_url (str): Full URL to the repository.
+  branch (str): Branch of the repository.
+  file_path (str): Relative path to the file from the repository root.
+  step_name (str): Custom name for this step (optional).
+  attempts (int): Number of times to try the request before failing.
+
+Returns:
+  Raw file content.
+
+&mdash; **def [log](/recipes/recipe_modules/gitiles/api.py#51)(self, url, ref, limit=0, cursor=None, step_name=None, attempts=None, \*\*kwargs):**
+
+Returns the most recent commits under the given ref with properties.
+
+Args:
+  url (str): URL of the remote repository.
+  ref (str): Name of the desired ref (see Gitiles.refs).
+  limit (int): Number of commits to limit the fetching to.
+    Gitiles does not return all commits in one call; instead paging is
+    used. 0 implies to return whatever first gerrit responds with.
+    Otherwise, paging will be used to fetch at least this many
+    commits, but all fetched commits will be returned.
+  cursor (str or None): The paging cursor used to fetch the next page.
+  step_name (str): Custom name for this step (optional).
+
+Returns:
+  A tuple of (commits, cursor).
+  Commits are a list of commits (as Gitiles dict structure) in reverse
+  chronological order. The number of commits may be higher than limit
+  argument.
+  Cursor can be used for subsequent calls to log for paging. If None,
+  signals that there are no more commits to fetch.
+
+&mdash; **def [refs](/recipes/recipe_modules/gitiles/api.py#39)(self, url, step_name='refs', attempts=None):**
+
+Returns a list of refs in the remote repository.
+### *recipe_modules* / [gsutil](/recipes/recipe_modules/gsutil)
+
+[DEPS](/recipes/recipe_modules/gsutil/__init__.py#1): [recipe\_engine/path][recipe_engine/recipe_modules/path], [recipe\_engine/python][recipe_engine/recipe_modules/python]
+
+#### **class [GSUtilApi](/recipes/recipe_modules/gsutil/api.py#9)([RecipeApi][recipe_engine/wkt/RecipeApi]):**
+
+&mdash; **def [\_\_call\_\_](/recipes/recipe_modules/gsutil/api.py#14)(self, cmd, name=None, use_retry_wrapper=True, version=None, parallel_upload=False, multithreaded=False, \*\*kwargs):**
+
+A step to run arbitrary gsutil commands.
+
+Note that this assumes that gsutil authentication environment variables
+(AWS_CREDENTIAL_FILE and BOTO_CONFIG) are already set, though if you want to
+set them to something else you can always do so using the env={} kwarg.
+
+Note also that gsutil does its own wildcard processing, so wildcards are
+valid in file-like portions of the cmd. See 'gsutil help wildcards'.
+
+Arguments:
+  cmd: list of (string) arguments to pass to gsutil.
+       Include gsutil-level options first (see 'gsutil help options').
+  name: the (string) name of the step to use.
+        Defaults to the first non-flag token in the cmd.
+
+&mdash; **def [cat](/recipes/recipe_modules/gsutil/api.py#98)(self, url, args=None, \*\*kwargs):**
+
+&mdash; **def [copy](/recipes/recipe_modules/gsutil/api.py#105)(self, source_bucket, source, dest_bucket, dest, args=None, link_name='gsutil.copy', metadata=None, unauthenticated_url=False, \*\*kwargs):**
+
+&mdash; **def [download](/recipes/recipe_modules/gsutil/api.py#84)(self, bucket, source, dest, args=None, \*\*kwargs):**
+
+&mdash; **def [download\_url](/recipes/recipe_modules/gsutil/api.py#91)(self, url, dest, args=None, \*\*kwargs):**
+
+&emsp; **@property**<br>&mdash; **def [gsutil\_py\_path](/recipes/recipe_modules/gsutil/api.py#10)(self):**
+
+&mdash; **def [list](/recipes/recipe_modules/gsutil/api.py#121)(self, url, args=None, \*\*kwargs):**
+
+&mdash; **def [remove\_url](/recipes/recipe_modules/gsutil/api.py#135)(self, url, args=None, \*\*kwargs):**
+
+&mdash; **def [signurl](/recipes/recipe_modules/gsutil/api.py#128)(self, private_key_file, bucket, dest, args=None, \*\*kwargs):**
+
+&mdash; **def [upload](/recipes/recipe_modules/gsutil/api.py#68)(self, source, bucket, dest, args=None, link_name='gsutil.upload', metadata=None, unauthenticated_url=False, \*\*kwargs):**
+### *recipe_modules* / [infra\_paths](/recipes/recipe_modules/infra_paths)
+
+[DEPS](/recipes/recipe_modules/infra_paths/__init__.py#1): [recipe\_engine/path][recipe_engine/recipe_modules/path], [recipe\_engine/properties][recipe_engine/recipe_modules/properties]
+
+#### **class [InfraPathsApi](/recipes/recipe_modules/infra_paths/api.py#8)([RecipeApi][recipe_engine/wkt/RecipeApi]):**
+
+infra_paths module is glue for design mistakes. It will be removed.
+
+&emsp; **@property**<br>&mdash; **def [default\_git\_cache\_dir](/recipes/recipe_modules/infra_paths/api.py#17)(self):**
+
+Returns the location of the default git cache directory.
+
+This property should be used instead of using path['git_cache'] directly.
+
+It returns git_cache path if it is defined (Buildbot world), otherwise
+uses the more generic [CACHE]/git path (LUCI world).
+
+&mdash; **def [initialize](/recipes/recipe_modules/infra_paths/api.py#11)(self):**
+### *recipe_modules* / [presubmit](/recipes/recipe_modules/presubmit)
+
+[DEPS](/recipes/recipe_modules/presubmit/__init__.py#1): [recipe\_engine/context][recipe_engine/recipe_modules/context], [recipe\_engine/path][recipe_engine/recipe_modules/path], [recipe\_engine/python][recipe_engine/recipe_modules/python], [recipe\_engine/step][recipe_engine/recipe_modules/step]
+
+#### **class [PresubmitApi](/recipes/recipe_modules/presubmit/api.py#7)([RecipeApi][recipe_engine/wkt/RecipeApi]):**
+
+&mdash; **def [\_\_call\_\_](/recipes/recipe_modules/presubmit/api.py#12)(self, \*args, \*\*kwargs):**
+
+Return a presubmit step.
+
+&emsp; **@property**<br>&mdash; **def [presubmit\_support\_path](/recipes/recipe_modules/presubmit/api.py#8)(self):**
+### *recipe_modules* / [rietveld](/recipes/recipe_modules/rietveld)
+
+[DEPS](/recipes/recipe_modules/rietveld/__init__.py#1): [recipe\_engine/path][recipe_engine/recipe_modules/path], [recipe\_engine/properties][recipe_engine/recipe_modules/properties], [recipe\_engine/python][recipe_engine/recipe_modules/python], [recipe\_engine/step][recipe_engine/recipe_modules/step]
+
+#### **class [RietveldApi](/recipes/recipe_modules/rietveld/api.py#10)([RecipeApi][recipe_engine/wkt/RecipeApi]):**
+
+&mdash; **def [apply\_issue](/recipes/recipe_modules/rietveld/api.py#53)(self, \*root_pieces, \*\*kwargs):**
+
+Call apply_issue from depot_tools.
+
+Args:
+  root_pieces (strings): location where to run apply_issue, relative to the
+    checkout root.
+  authentication (string or None): authentication scheme to use. Can be None
+    or 'oauth2'. See also apply_issue.py --help (-E and --no-auth options.)
+
+&mdash; **def [calculate\_issue\_root](/recipes/recipe_modules/rietveld/api.py#11)(self, extra_patch_project_roots=None):**
+
+Returns path where a patch should be applied to based on "patch_project".
+
+YOU SHOULD NOT USE THIS METHOD. Put this into gclient's config as
+patch_projects instead, and with luck you won't need to use
+calculate_patch_root from gclient api.
+TODO(tandrii): remove this method completely. See http://crbug.com/605563.
+
+Maps Rietveld's "patch_project" to a path of directories relative to
+api.gclient.c.solutions[0].name which describe where to place the patch.
+
+Args:
+  extra_patch_project_roots: Dict mapping project names to relative roots.
+
+Returns:
+  Relative path or empty string if patch_project is not set or path for a
+  given is unknown.
+### *recipe_modules* / [tryserver](/recipes/recipe_modules/tryserver)
+
+[DEPS](/recipes/recipe_modules/tryserver/__init__.py#5): [gerrit](#recipe_modules-gerrit), [git](#recipe_modules-git), [git\_cl](#recipe_modules-git_cl), [rietveld](#recipe_modules-rietveld), [recipe\_engine/context][recipe_engine/recipe_modules/context], [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]
+
+#### **class [TryserverApi](/recipes/recipe_modules/tryserver/api.py#12)([RecipeApi][recipe_engine/wkt/RecipeApi]):**
+
+&mdash; **def [\_\_init\_\_](/recipes/recipe_modules/tryserver/api.py#13)(self, \*args, \*\*kwargs):**
+
+&mdash; **def [add\_failure\_reason](/recipes/recipe_modules/tryserver/api.py#146)(self, reason):**
+
+Records a more detailed reason why build is failing.
+
+The reason can be any JSON-serializable object.
+
+&emsp; **@property**<br>&mdash; **def [can\_apply\_issue](/recipes/recipe_modules/tryserver/api.py#23)(self):**
+
+Returns true iff the properties exist to apply_issue from rietveld.
+
+&mdash; **def [get\_files\_affected\_by\_patch](/recipes/recipe_modules/tryserver/api.py#46)(self, patch_root=None, \*\*kwargs):**
+
+Returns list of paths to files affected by the patch.
+
+Argument:
+  patch_root: path relative to api.path['root'], usually obtained from
+    api.gclient.calculate_patch_root(patch_project)
+
+Returned paths will be relative to to patch_root.
+
+TODO(tandrii): remove this doc.
+Unless you use patch_root=None, in which case old behavior is used
+which returns paths relative to checkout aka solution[0].name.
+
+&mdash; **def [get\_footer](/recipes/recipe_modules/tryserver/api.py#209)(self, tag, patch_text=None):**
+
+Gets a specific tag from a CL description
+
+&mdash; **def [get\_footers](/recipes/recipe_modules/tryserver/api.py#182)(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.
+
+&emsp; **@property**<br>&mdash; **def [is\_gerrit\_issue](/recipes/recipe_modules/tryserver/api.py#30)(self):**
+
+Returns true iff the properties exist to match a Gerrit issue.
+
+&emsp; **@property**<br>&mdash; **def [is\_patch\_in\_git](/recipes/recipe_modules/tryserver/api.py#40)(self):**
+
+&emsp; **@property**<br>&mdash; **def [is\_tryserver](/recipes/recipe_modules/tryserver/api.py#17)(self):**
+
+Returns true iff we can apply_issue or patch.
+
+&mdash; **def [normalize\_footer\_name](/recipes/recipe_modules/tryserver/api.py#213)(self, footer):**
+
+&mdash; **def [set\_compile\_failure\_tryjob\_result](/recipes/recipe_modules/tryserver/api.py#125)(self):**
+
+Mark the tryjob result as a compile failure.
+
+&emsp; **@contextlib.contextmanager**<br>&mdash; **def [set\_failure\_hash](/recipes/recipe_modules/tryserver/api.py#155)(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.
+
+&mdash; **def [set\_invalid\_test\_results\_tryjob\_result](/recipes/recipe_modules/tryserver/api.py#137)(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).
+
+&mdash; **def [set\_patch\_failure\_tryjob\_result](/recipes/recipe_modules/tryserver/api.py#121)(self):**
+
+Mark the tryjob result as failure to apply the patch.
+
+&mdash; **def [set\_subproject\_tag](/recipes/recipe_modules/tryserver/api.py#103)(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.
+
+&mdash; **def [set\_test\_failure\_tryjob\_result](/recipes/recipe_modules/tryserver/api.py#129)(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.
+## Recipes
+
+### *recipes* / [bot\_update:examples/full](/recipes/recipe_modules/bot_update/examples/full.py)
+
+[DEPS](/recipes/recipe_modules/bot_update/examples/full.py#5): [bot\_update](#recipe_modules-bot_update), [gclient](#recipe_modules-gclient), [gerrit](#recipe_modules-gerrit), [recipe\_engine/path][recipe_engine/recipe_modules/path], [recipe\_engine/platform][recipe_engine/recipe_modules/platform], [recipe\_engine/properties][recipe_engine/recipe_modules/properties]
+
+&mdash; **def [RunSteps](/recipes/recipe_modules/bot_update/examples/full.py#14)(api):**
+### *recipes* / [cipd:examples/full](/recipes/recipe_modules/cipd/examples/full.py)
+
+[DEPS](/recipes/recipe_modules/cipd/examples/full.py#8): [cipd](#recipe_modules-cipd), [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/step][recipe_engine/recipe_modules/step]
+
+&mdash; **def [RunSteps](/recipes/recipe_modules/cipd/examples/full.py#27)(api, use_pkg, pkg_files, pkg_dirs, ver_files, install_mode):**
+### *recipes* / [cipd:examples/platform\_suffix](/recipes/recipe_modules/cipd/examples/platform_suffix.py)
+
+[DEPS](/recipes/recipe_modules/cipd/examples/platform_suffix.py#8): [cipd](#recipe_modules-cipd), [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/step][recipe_engine/recipe_modules/step]
+
+&mdash; **def [RunSteps](/recipes/recipe_modules/cipd/examples/platform_suffix.py#22)(api, arch_override, bits_override, expect_error):**
+### *recipes* / [depot\_tools:examples/full](/recipes/recipe_modules/depot_tools/examples/full.py)
+
+[DEPS](/recipes/recipe_modules/depot_tools/examples/full.py#5): [depot\_tools](#recipe_modules-depot_tools), [recipe\_engine/path][recipe_engine/recipe_modules/path], [recipe\_engine/platform][recipe_engine/recipe_modules/platform], [recipe\_engine/step][recipe_engine/recipe_modules/step]
+
+&mdash; **def [RunSteps](/recipes/recipe_modules/depot_tools/examples/full.py#13)(api):**
+### *recipes* / [gclient:examples/full](/recipes/recipe_modules/gclient/examples/full.py)
+
+[DEPS](/recipes/recipe_modules/gclient/examples/full.py#5): [gclient](#recipe_modules-gclient), [recipe\_engine/context][recipe_engine/recipe_modules/context], [recipe\_engine/path][recipe_engine/recipe_modules/path], [recipe\_engine/properties][recipe_engine/recipe_modules/properties], [recipe\_engine/step][recipe_engine/recipe_modules/step]
+
+&mdash; **def [RunSteps](/recipes/recipe_modules/gclient/examples/full.py#45)(api):**
+### *recipes* / [gclient:tests/patch\_project](/recipes/recipe_modules/gclient/tests/patch_project.py)
+
+[DEPS](/recipes/recipe_modules/gclient/tests/patch_project.py#9): [gclient](#recipe_modules-gclient), [recipe\_engine/properties][recipe_engine/recipe_modules/properties]
+
+&mdash; **def [RunSteps](/recipes/recipe_modules/gclient/tests/patch_project.py#20)(api, patch_project):**
+### *recipes* / [gerrit:examples/full](/recipes/recipe_modules/gerrit/examples/full.py)
+
+[DEPS](/recipes/recipe_modules/gerrit/examples/full.py#5): [gerrit](#recipe_modules-gerrit), [recipe\_engine/step][recipe_engine/recipe_modules/step]
+
+&mdash; **def [RunSteps](/recipes/recipe_modules/gerrit/examples/full.py#11)(api):**
+### *recipes* / [git:examples/full](/recipes/recipe_modules/git/examples/full.py)
+
+[DEPS](/recipes/recipe_modules/git/examples/full.py#5): [git](#recipe_modules-git), [recipe\_engine/context][recipe_engine/recipe_modules/context], [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/raw\_io][recipe_engine/recipe_modules/raw_io], [recipe\_engine/step][recipe_engine/recipe_modules/step]
+
+&mdash; **def [RunSteps](/recipes/recipe_modules/git/examples/full.py#16)(api):**
+### *recipes* / [git\_cl:examples/full](/recipes/recipe_modules/git_cl/examples/full.py)
+
+[DEPS](/recipes/recipe_modules/git_cl/examples/full.py#9): [git\_cl](#recipe_modules-git_cl), [recipe\_engine/path][recipe_engine/recipe_modules/path], [recipe\_engine/raw\_io][recipe_engine/recipe_modules/raw_io], [recipe\_engine/step][recipe_engine/recipe_modules/step]
+
+&mdash; **def [RunSteps](/recipes/recipe_modules/git_cl/examples/full.py#17)(api):**
+### *recipes* / [gitiles:examples/full](/recipes/recipe_modules/gitiles/examples/full.py)
+
+[DEPS](/recipes/recipe_modules/gitiles/examples/full.py#5): [gitiles](#recipe_modules-gitiles), [recipe\_engine/properties][recipe_engine/recipe_modules/properties]
+
+&mdash; **def [RunSteps](/recipes/recipe_modules/gitiles/examples/full.py#11)(api):**
+### *recipes* / [gsutil:examples/full](/recipes/recipe_modules/gsutil/examples/full.py)
+
+[DEPS](/recipes/recipe_modules/gsutil/examples/full.py#5): [gsutil](#recipe_modules-gsutil), [recipe\_engine/path][recipe_engine/recipe_modules/path]
+
+&mdash; **def [RunSteps](/recipes/recipe_modules/gsutil/examples/full.py#11)(api):**
+
+Move things around in a loop!
+### *recipes* / [infra\_paths:examples/full](/recipes/recipe_modules/infra_paths/examples/full.py)
+
+[DEPS](/recipes/recipe_modules/infra_paths/examples/full.py#7): [infra\_paths](#recipe_modules-infra_paths), [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/step][recipe_engine/recipe_modules/step]
+
+&mdash; **def [RunSteps](/recipes/recipe_modules/infra_paths/examples/full.py#16)(api):**
+### *recipes* / [presubmit:examples/full](/recipes/recipe_modules/presubmit/examples/full.py)
+
+[DEPS](/recipes/recipe_modules/presubmit/examples/full.py#5): [presubmit](#recipe_modules-presubmit)
+
+&mdash; **def [RunSteps](/recipes/recipe_modules/presubmit/examples/full.py#10)(api):**
+### *recipes* / [rietveld:examples/full](/recipes/recipe_modules/rietveld/examples/full.py)
+
+[DEPS](/recipes/recipe_modules/rietveld/examples/full.py#5): [infra\_paths](#recipe_modules-infra_paths), [rietveld](#recipe_modules-rietveld), [recipe\_engine/path][recipe_engine/recipe_modules/path], [recipe\_engine/properties][recipe_engine/recipe_modules/properties], [recipe\_engine/step][recipe_engine/recipe_modules/step]
+
+&mdash; **def [RunSteps](/recipes/recipe_modules/rietveld/examples/full.py#13)(api):**
+### *recipes* / [tryserver:examples/full](/recipes/recipe_modules/tryserver/examples/full.py)
+
+[DEPS](/recipes/recipe_modules/tryserver/examples/full.py#5): [tryserver](#recipe_modules-tryserver), [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]
+
+&mdash; **def [RunSteps](/recipes/recipe_modules/tryserver/examples/full.py#17)(api):**
+
+[recipe_engine/recipe_modules/context]: https://github.com/luci/recipes-py/blob/de3238ca6d8320585f5dbcf051cd96cbc72d4684/README.recipes.md#recipe_modules--context
+[recipe_engine/recipe_modules/json]: https://github.com/luci/recipes-py/blob/de3238ca6d8320585f5dbcf051cd96cbc72d4684/README.recipes.md#recipe_modules--json
+[recipe_engine/recipe_modules/path]: https://github.com/luci/recipes-py/blob/de3238ca6d8320585f5dbcf051cd96cbc72d4684/README.recipes.md#recipe_modules--path
+[recipe_engine/recipe_modules/platform]: https://github.com/luci/recipes-py/blob/de3238ca6d8320585f5dbcf051cd96cbc72d4684/README.recipes.md#recipe_modules--platform
+[recipe_engine/recipe_modules/properties]: https://github.com/luci/recipes-py/blob/de3238ca6d8320585f5dbcf051cd96cbc72d4684/README.recipes.md#recipe_modules--properties
+[recipe_engine/recipe_modules/python]: https://github.com/luci/recipes-py/blob/de3238ca6d8320585f5dbcf051cd96cbc72d4684/README.recipes.md#recipe_modules--python
+[recipe_engine/recipe_modules/raw_io]: https://github.com/luci/recipes-py/blob/de3238ca6d8320585f5dbcf051cd96cbc72d4684/README.recipes.md#recipe_modules--raw_io
+[recipe_engine/recipe_modules/step]: https://github.com/luci/recipes-py/blob/de3238ca6d8320585f5dbcf051cd96cbc72d4684/README.recipes.md#recipe_modules--step
+[recipe_engine/recipe_modules/url]: https://github.com/luci/recipes-py/blob/de3238ca6d8320585f5dbcf051cd96cbc72d4684/README.recipes.md#recipe_modules--url
+[recipe_engine/wkt/RecipeApi]: https://github.com/luci/recipes-py/blob/de3238ca6d8320585f5dbcf051cd96cbc72d4684/recipe_engine/recipe_api.py#L884