git recipe_module: git new-branch.

recipe_modules/git/api.py

 # Copyright 2013 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 itertools
 import re
 
 from recipe_engine import recipe_api
 
 class GitApi(recipe_api.RecipeApi):
@@ skipping 391 matching lines @@
 
     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__'.
     """
     if not rev_list_args:
       rev_list_args = ['--all']
     self('bundle', 'create', bundle_path, *rev_list_args, **kwargs)
+
+  def new_branch(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__'.
+    """
+    env = kwargs.pop('env', {})
+    env['PATH'] = self.m.path.pathsep.join([
+        str(self.package_repo_resource()), '%(PATH)s'])
+    args = ['new-branch', branch]
+    if upstream:
+      args.extend(['--upstream', upstream])
+    if not name:
+      name = 'git new-branch %s' % branch
+    return self(*args, name=name, env=env, **kwargs)