Adds bot_update to depot_tools.

recipe_modules/bot_update/example.py

Index: recipe_modules/bot_update/example.py
diff --git a/recipe_modules/bot_update/example.py b/recipe_modules/bot_update/example.py
new file mode 100644
index 0000000000000000000000000000000000000000..d866c0cebd567c875572e02ec0bd5bae83db12be
--- /dev/null
+++ b/recipe_modules/bot_update/example.py
@@ -0,0 +1,155 @@
+# 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.
+
+DEPS = [
+  'bot_update',
+  'gclient',
+  'recipe_engine/path',
+  'recipe_engine/properties',
+]
+
+def RunSteps(api):

[iannucci, 2016/01/30 00:40:17]

We need to re-think these examples... in particular, we should probably make
them look like real examples. Some folks look at these as the canonical way to
do stuff.

For now, can we switch to PROPERTIES at least?

+  api.gclient.use_mirror = True
+
+  src_cfg = api.gclient.make_config()
+  soln = src_cfg.solutions.add()
+  soln.name = 'src'
+  soln.url = 'svn://svn.chromium.org/chrome/trunk/src'
+  soln.revision = api.properties.get('revision')
+  api.gclient.c = src_cfg
+  api.gclient.c.revisions = api.properties.get('revisions', {})
+  api.gclient.c.got_revision_mapping['src'] = 'got_cr_revision'
+  patch = api.properties.get('patch', True)
+  clobber = True if api.properties.get('clobber') else False
+  force = True if api.properties.get('force') else False
+  no_shallow = True if api.properties.get('no_shallow') else False
+  output_manifest = api.properties.get('output_manifest', False)
+  with_branch_heads = api.properties.get('with_branch_heads', False)
+  refs = api.properties.get('refs', [])
+  oauth2 = api.properties.get('oauth2', False)
+  root_solution_revision = api.properties.get('root_solution_revision')
+  suffix = api.properties.get('suffix')
+  api.bot_update.ensure_checkout(force=force,
+                                 no_shallow=no_shallow,
+                                 patch=patch,
+                                 with_branch_heads=with_branch_heads,
+                                 output_manifest=output_manifest,
+                                 refs=refs, patch_oauth2=oauth2,
+                                 clobber=clobber,
+                                 root_solution_revision=root_solution_revision,
+                                 suffix=suffix)
+
+
+def GenTests(api):
+  yield api.test('basic') + api.properties(
+      mastername='chromium.linux',
+      buildername='Linux Builder',
+      slavename='totallyaslave-m1',
+      patch=False,
+      revision='abc'
+  )
+  yield api.test('basic_with_branch_heads') + api.properties(
+      mastername='chromium.linux',
+      buildername='Linux Builder',
+      slavename='totallyaslave-m1',
+      with_branch_heads=True,
+      suffix='with branch heads'
+  )
+  yield api.test('basic_output_manifest') + api.properties(
+      mastername='chromium.linux',
+      buildername='Linux Builder',
+      slavename='totallyaslave-m1',
+      output_manifest=True,
+  )
+  yield api.test('tryjob') + api.properties(
+      mastername='tryserver.chromium.linux',
+      buildername='linux_rel',
+      slavename='totallyaslave-c4',
+      issue=12345,
+      patchset=654321,
+      patch_url='http://src.chromium.org/foo/bar'
+  )
+  yield api.test('trychange') + api.properties(
+      mastername='tryserver.chromium.linux',
+      buildername='linux_rel',
+      slavename='totallyaslave-c4',
+      refs=['+refs/change/1/2/333'],
+  )
+  yield api.test('trychange_oauth2') + api.properties(
+      mastername='tryserver.chromium.linux',
+      buildername='linux_rel',
+      slavename='totallyaslave-c4',
+      oauth2=True,
+  )
+  yield api.test('tryjob_fail') + api.properties(
+      mastername='tryserver.chromium.linux',
+      buildername='linux_rel',
+      slavename='totallyaslave-c4',
+      issue=12345,
+      patchset=654321,
+      patch_url='http://src.chromium.org/foo/bar',
+  ) + api.step_data('bot_update', retcode=1)
+  yield api.test('tryjob_fail_patch') + api.properties(
+      mastername='tryserver.chromium.linux',
+      buildername='linux_rel',
+      slavename='totallyaslave-c4',
+      issue=12345,
+      patchset=654321,
+      patch_url='http://src.chromium.org/foo/bar',
+      fail_patch='apply',
+  ) + api.step_data('bot_update', retcode=88)
+  yield api.test('tryjob_fail_patch_download') + api.properties(
+      mastername='tryserver.chromium.linux',
+      buildername='linux_rel',
+      slavename='totallyaslave-c4',
+      issue=12345,
+      patchset=654321,
+      patch_url='http://src.chromium.org/foo/bar',
+      fail_patch='download'
+  ) + api.step_data('bot_update', retcode=87)
+  yield api.test('forced') + api.properties(
+      mastername='experimental',
+      buildername='Experimental Builder',
+      slavename='somehost',
+      force=1
+  )
+  yield api.test('no_shallow') + api.properties(
+      mastername='experimental',
+      buildername='Experimental Builder',
+      slavename='somehost',
+      no_shallow=1
+  )
+  yield api.test('off') + api.properties(
+      mastername='experimental',
+      buildername='Experimental Builder',
+      slavename='somehost',
+  )
+  yield api.test('svn_mode') + api.properties(
+      mastername='experimental.svn',
+      buildername='Experimental SVN Builder',
+      slavename='somehost',
+      force=1
+  )
+  yield api.test('clobber') + api.properties(
+      mastername='experimental',
+      buildername='Experimental Builder',
+      slavename='somehost',
+      clobber=1
+  )
+  yield api.test('reset_root_solution_revision') + api.properties(
+      mastername='experimental',
+      buildername='Experimental Builder',
+      slavename='somehost',
+      root_solution_revision='revision',
+  )
+  yield api.test('tryjob_v8') + api.properties(
+      mastername='tryserver.chromium.linux',
+      buildername='linux_rel',
+      slavename='totallyaslave-c4',
+      issue=12345,
+      patchset=654321,
+      patch_url='http://src.chromium.org/foo/bar',
+      patch_project='v8',
+      revisions={'src/v8': 'abc'}
+  )