/usr/lib/python2.7/dist-packages/paver/git.py is in python-paver 1.2.1-1.1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 | """Convenience functions for working with git.
This module does not include any tasks, only functions.
At this point, these functions do not use any kind of library. They require
the git binary on the path."""
from paver.easy import sh
import os, re
def _format_path(provided_path):
return provided_path or os.getcwd()
def _split_remote_branch_name(provided_name):
return provided_name.split("/")[1]
def clone(url, dest_folder):
sh("git clone %(url)s %(path)s" % dict(url=url, path=dest_folder) )
def pull(destination, remote="origin", branch="master"):
"""Perform a git pull. Destination must be absolute path.
"""
sh("cd %(destination)s; git pull %(remote)s %(branch)s" % dict(
destination=destination, remote=remote, branch=branch) )
def branch_list(path="", remote_branches_only=False, __override__=None):
"""
Lists git branches for the repository specified (or CWD).
If remote_branches_only is specified will list branches that exist
on the remote. These branches may, or may not, have corresponding remote
tracking branches.
Returns a Python tuple. The first item in the tuple will be the current
branch, and the other item will be a list of branches for the repository.
Optional parameter path: the path to the git repo. Else uses os.getcwd()
"""
remote_branches = ""
if remote_branches_only:
remote_branches = "-r"
if __override__ == None:
git_output = sh( "cd %(repo_path)s; git branch %(remote)s" % dict(
repo_path = _format_path(path), remote = remote_branches ), capture=True )
else:
git_output = __override__
if git_output == None:
return None, [] # should only hit this condition in testing...
current_branch = ""
branches = []
found_a_match = False
regex = re.compile(r"(\*?)\W*(.+)")
for line in git_output.split("\n"):
match_obj = regex.match(line)
if match_obj:
found_a_match = True
if match_obj.group(1):
current_branch = match_obj.group(2).strip()
if match_obj.group(2).strip():
branches.append( match_obj.group(2).strip() )
if found_a_match is False:
raise "git branch did not return output expected. Returned %s" % git_output
return current_branch, branches
def branch_checkout(branch_name, path=""):
"""Checkout a git branch.
Take the branch name to checkout, and optional path parameter
(the path to the git repo. Else uses os.getcwd())
"""
sh( "cd %(repo_path)s; git checkout %(branch_name)s" % dict(
repo_path = _format_path(path),
branch_name=branch_name) )
def branch_track_remote(remote_branch_name, local_branch_name=None, path=""):
local_branch_name = ( local_branch_name or _split_remote_branch_name(remote_branch_name) )
sh( "cd %(repo_path)s; git checkout -b %(branch_name)s --track %(remote_branch_name)s" % dict(
repo_path = _format_path(path),
branch_name=local_branch_name,
remote_branch_name=remote_branch_name) )
|