git recipe_module: git new-branch.

recipe_modules/git/example.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.
 
 DEPS = [
   'git',
   'recipe_engine/path',
   'recipe_engine/platform',
   'recipe_engine/properties',
   'recipe_engine/raw_io',
@@ skipping 49 matching lines @@
   # If you need to run more arbitrary git commands, you can use api.git itself,
   # which behaves like api.step(), but automatically sets the name of the step.
   api.git('status', cwd=api.path['checkout'])
 
   api.git('status', name='git status can_fail_build',
           can_fail_build=True)
 
   api.git('status', name='git status cannot_fail_build',
           can_fail_build=False)
 
+  # You should run git new-branch before you upload something with git cl.
+  api.git.new_branch('refactor')  # Upstream is origin/master by default.
+  # And use upstream kwarg to set up different upstream for tracking.
+  api.git.new_branch('feature', upstream='refactor')
+
   # You can use api.git.rebase to rebase the current branch onto another one
   api.git.rebase(name_prefix='my repo', branch='origin/master',
                  dir_path=api.path['checkout'],
                  remote_name=api.properties.get('remote_name'))
 
   if api.properties.get('cat_file', None):
     step_result = api.git.cat_file_at_commit(api.properties['cat_file'],
                                              api.properties['revision'],
                                              stdout=api.raw_io.output())
     if 'TestOutput' in step_result.stdout:
@@ skipping 63 matching lines @@
       api.properties(count_objects_can_fail_build=True))
   yield (
       api.test('cat-file_test') +
       api.step_data('git cat-file abcdef12345:TestFile',
                     stdout=api.raw_io.output('TestOutput')) +
       api.properties(revision='abcdef12345', cat_file='TestFile'))
 
   yield (
       api.test('git-cache-checkout') +
       api.properties(use_git_cache=True))