1 """Python GIT interface
5 Copyright (C) 2005, Catalin Marinas <catalin.marinas@gmail.com>
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License version 2 as
9 published by the Free Software Foundation.
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with this program; if not, write to the Free Software
18 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
21 import sys, os, re, gitmergeonefile
22 from shutil import copyfile
24 from stgit.exception import *
25 from stgit import basedir
26 from stgit.utils import *
27 from stgit.out import *
28 from stgit.run import *
29 from stgit.config import config
32 class GitException(StgException):
35 # When a subprocess has a problem, we want the exception to be a
36 # subclass of GitException.
37 class GitRunException(GitException):
41 def __init__(self, *cmd):
42 """Initialise the Run object and insert the 'git' command name.
44 Run.__init__(self, 'git', *cmd)
52 """An author, committer, etc."""
53 def __init__(self, name = None, email = None, date = '',
55 self.name = self.email = self.date = None
56 if name or email or date:
62 assert not (name or email or date)
64 m = re.match(r'^(.+)<(.+)>(.*)$', s)
66 return [x.strip() or None for x in m.groups()]
67 self.name, self.email, self.date = parse_desc(desc)
68 def set_name(self, val):
71 def set_email(self, val):
74 def set_date(self, val):
78 if self.name and self.email:
79 return '%s <%s>' % (self.name, self.email)
81 raise GitException, 'not enough identity data'
84 """Handle the commit objects
86 def __init__(self, id_hash):
87 self.__id_hash = id_hash
89 lines = GRun('cat-file', 'commit', id_hash).output_lines()
90 for i in range(len(lines)):
93 break # we've seen all the header fields
94 key, val = line.split(' ', 1)
99 elif key == 'committer':
100 self.__committer = val
102 pass # ignore other headers
103 self.__log = '\n'.join(lines[i+1:])
105 def get_id_hash(self):
106 return self.__id_hash
111 def get_parent(self):
112 parents = self.get_parents()
118 def get_parents(self):
119 return GRun('rev-list', '--parents', '--max-count=1', self.__id_hash
120 ).output_one_line().split()[1:]
122 def get_author(self):
125 def get_committer(self):
126 return self.__committer
132 return self.get_id_hash()
134 # dictionary of Commit objects, used to avoid multiple calls to git
141 def get_commit(id_hash):
142 """Commit objects factory. Save/look-up them in the __commits
147 if id_hash in __commits:
148 return __commits[id_hash]
150 commit = Commit(id_hash)
151 __commits[id_hash] = commit
155 """Return the list of file conflicts
157 conflicts_file = os.path.join(basedir.get(), 'conflicts')
158 if os.path.isfile(conflicts_file):
159 f = file(conflicts_file)
160 names = [line.strip() for line in f.readlines()]
167 files = [os.path.join(basedir.get(), 'info', 'exclude')]
168 user_exclude = config.get('core.excludesfile')
170 files.append(user_exclude)
173 def ls_files(files, tree = None, full_name = True):
174 """Return the files known to GIT or raise an error otherwise. It also
175 converts the file to the full path relative the the .git directory.
182 args.append('--with-tree=%s' % tree)
184 args.append('--full-name')
188 return GRun('ls-files', '--error-unmatch', *args).output_lines()
189 except GitRunException:
190 # just hide the details of the 'git ls-files' command we use
191 raise GitException, \
192 'Some of the given paths are either missing or not known to GIT'
194 def tree_status(files = None, tree_id = 'HEAD', unknown = False,
195 noexclude = True, verbose = False, diff_flags = []):
196 """Get the status of all changed files, or of a selected set of
197 files. Returns a list of pairs - (status, filename).
199 If 'not files', it will check all files, and optionally all
200 unknown files. If 'files' is a list, it will only check the files
203 assert not files or not unknown
206 out.start('Checking for changes in the working directory')
214 cmd = ['ls-files', '-z', '--others', '--directory',
215 '--no-empty-directory']
217 cmd += ['--exclude=%s' % s for s in
218 ['*.[ao]', '*.pyc', '.*', '*~', '#*', 'TAGS', 'tags']]
219 cmd += ['--exclude-per-directory=.gitignore']
220 cmd += ['--exclude-from=%s' % fn
221 for fn in exclude_files()
222 if os.path.exists(fn)]
224 lines = GRun(*cmd).raw_output().split('\0')
225 cache_files += [('?', line) for line in lines if line]
228 conflicts = get_conflicts()
231 cache_files += [('C', filename) for filename in conflicts
232 if not files or filename in files]
235 args = diff_flags + [tree_id]
237 args += ['--'] + files
238 for line in GRun('diff-index', *args).output_lines():
239 fs = tuple(line.rstrip().split(' ',4)[-1].split('\t',1))
240 if fs[1] not in conflicts:
241 cache_files.append(fs)
248 def local_changes(verbose = True):
249 """Return true if there are local changes in the tree
251 return len(tree_status(verbose = verbose)) != 0
255 hr = re.compile(r'^[0-9a-f]{40} refs/heads/(.+)$')
256 for line in GRun('show-ref', '--heads').output_lines():
258 heads.append(m.group(1))
265 """Verifies the HEAD and returns the SHA1 id that represents it
270 __head = rev_parse('HEAD')
273 class DetachedHeadException(GitException):
275 GitException.__init__(self, 'Not on any branch')
278 """Return the name of the file pointed to by the HEAD symref.
279 Throw an exception if HEAD is detached."""
282 'refs/heads/', GRun('symbolic-ref', '-q', 'HEAD'
284 except GitRunException:
285 raise DetachedHeadException()
287 def set_head_file(ref):
288 """Resets HEAD to point to a new ref
290 # head cache flushing is needed since we might have a different value
294 GRun('symbolic-ref', 'HEAD', 'refs/heads/%s' % ref).run()
295 except GitRunException:
296 raise GitException, 'Could not set head to "%s"' % ref
298 def set_ref(ref, val):
299 """Point ref at a new commit object."""
301 GRun('update-ref', ref, val).run()
302 except GitRunException:
303 raise GitException, 'Could not update %s to "%s".' % (ref, val)
305 def set_branch(branch, val):
306 set_ref('refs/heads/%s' % branch, val)
309 """Sets the HEAD value
313 if not __head or __head != val:
317 # only allow SHA1 hashes
318 assert(len(__head) == 40)
320 def __clear_head_cache():
321 """Sets the __head to None so that a re-read is forced
328 """Refresh index with stat() information from the working directory.
330 GRun('update-index', '-q', '--unmerged', '--refresh').run()
332 def rev_parse(git_id):
333 """Parse the string and return a verified SHA1 id
336 return GRun('rev-parse', '--verify', git_id
337 ).discard_stderr().output_one_line()
338 except GitRunException:
339 raise GitException, 'Unknown revision: %s' % git_id
348 def branch_exists(branch):
349 return ref_exists('refs/heads/%s' % branch)
351 def create_branch(new_branch, tree_id = None):
352 """Create a new branch in the git repository
354 if branch_exists(new_branch):
355 raise GitException, 'Branch "%s" already exists' % new_branch
357 current_head = get_head()
358 set_head_file(new_branch)
359 __set_head(current_head)
361 # a checkout isn't needed if new branch points to the current head
365 if os.path.isfile(os.path.join(basedir.get(), 'MERGE_HEAD')):
366 os.remove(os.path.join(basedir.get(), 'MERGE_HEAD'))
368 def switch_branch(new_branch):
369 """Switch to a git branch
373 if not branch_exists(new_branch):
374 raise GitException, 'Branch "%s" does not exist' % new_branch
376 tree_id = rev_parse('refs/heads/%s^{commit}' % new_branch)
377 if tree_id != get_head():
380 GRun('read-tree', '-u', '-m', get_head(), tree_id).run()
381 except GitRunException:
382 raise GitException, 'read-tree failed (local changes maybe?)'
384 set_head_file(new_branch)
386 if os.path.isfile(os.path.join(basedir.get(), 'MERGE_HEAD')):
387 os.remove(os.path.join(basedir.get(), 'MERGE_HEAD'))
390 if not ref_exists(ref):
391 raise GitException, '%s does not exist' % ref
392 sha1 = GRun('show-ref', '-s', ref).output_one_line()
394 GRun('update-ref', '-d', ref, sha1).run()
395 except GitRunException:
396 raise GitException, 'Failed to delete ref %s' % ref
398 def delete_branch(name):
399 delete_ref('refs/heads/%s' % name)
401 def rename_ref(from_ref, to_ref):
402 if not ref_exists(from_ref):
403 raise GitException, '"%s" does not exist' % from_ref
404 if ref_exists(to_ref):
405 raise GitException, '"%s" already exists' % to_ref
407 sha1 = GRun('show-ref', '-s', from_ref).output_one_line()
409 GRun('update-ref', to_ref, sha1, '0'*40).run()
410 except GitRunException:
411 raise GitException, 'Failed to create new ref %s' % to_ref
413 GRun('update-ref', '-d', from_ref, sha1).run()
414 except GitRunException:
415 raise GitException, 'Failed to delete ref %s' % from_ref
417 def rename_branch(from_name, to_name):
418 """Rename a git branch."""
419 rename_ref('refs/heads/%s' % from_name, 'refs/heads/%s' % to_name)
421 if get_head_file() == from_name:
422 set_head_file(to_name)
423 except DetachedHeadException:
424 pass # detached HEAD, so the renamee can't be the current branch
425 reflog_dir = os.path.join(basedir.get(), 'logs', 'refs', 'heads')
426 if os.path.exists(reflog_dir) \
427 and os.path.exists(os.path.join(reflog_dir, from_name)):
428 rename(reflog_dir, from_name, to_name)
431 """Add the files or recursively add the directory contents
433 # generate the file list
436 if not os.path.exists(i):
437 raise GitException, 'Unknown file or directory: %s' % i
440 # recursive search. We only add files
441 for root, dirs, local_files in os.walk(i):
442 for name in [os.path.join(root, f) for f in local_files]:
443 if os.path.isfile(name):
444 files.append(os.path.normpath(name))
445 elif os.path.isfile(i):
446 files.append(os.path.normpath(i))
448 raise GitException, '%s is not a file or directory' % i
452 GRun('update-index', '--add', '--').xargs(files)
453 except GitRunException:
454 raise GitException, 'Unable to add file'
456 def __copy_single(source, target, target2=''):
457 """Copy file or dir named 'source' to name target+target2"""
459 # "source" (file or dir) must match one or more git-controlled file
460 realfiles = GRun('ls-files', source).output_lines()
461 if len(realfiles) == 0:
462 raise GitException, '"%s" matches no git-controled files' % source
464 if os.path.isdir(source):
465 # physically copy the files, and record them to add them in one run
467 re_string='^'+source+'/(.*)$'
468 prefix_regexp = re.compile(re_string)
469 for f in [f.strip() for f in realfiles]:
470 m = prefix_regexp.match(f)
472 raise Exception, '"%s" does not match "%s"' % (f, re_string)
473 newname = target+target2+'/'+m.group(1)
474 if not os.path.exists(os.path.dirname(newname)):
475 os.makedirs(os.path.dirname(newname))
477 newfiles.append(newname)
480 else: # files, symlinks, ...
481 newname = target+target2
482 copyfile(source, newname)
486 def copy(filespecs, target):
487 if os.path.isdir(target):
488 # target is a directory: copy each entry on the command line,
489 # with the same name, into the target
490 target = target.rstrip('/')
492 # first, check that none of the children of the target
493 # matching the command line aleady exist
494 for filespec in filespecs:
495 entry = target+ '/' + os.path.basename(filespec.rstrip('/'))
496 if os.path.exists(entry):
497 raise GitException, 'Target "%s" already exists' % entry
499 for filespec in filespecs:
500 filespec = filespec.rstrip('/')
501 basename = '/' + os.path.basename(filespec)
502 __copy_single(filespec, target, basename)
504 elif os.path.exists(target):
505 raise GitException, 'Target "%s" exists but is not a directory' % target
506 elif len(filespecs) != 1:
507 raise GitException, 'Cannot copy more than one file to non-directory'
510 # at this point: len(filespecs)==1 and target does not exist
512 # check target directory
513 targetdir = os.path.dirname(target)
514 if targetdir != '' and not os.path.isdir(targetdir):
515 raise GitException, 'Target directory "%s" does not exist' % targetdir
517 __copy_single(filespecs[0].rstrip('/'), target)
520 def rm(files, force = False):
521 """Remove a file from the repository
525 if os.path.exists(f):
526 raise GitException, '%s exists. Remove it first' %f
528 GRun('update-index', '--remove', '--').xargs(files)
531 GRun('update-index', '--force-remove', '--').xargs(files)
539 """Return the user information.
543 name=config.get('user.name')
544 email=config.get('user.email')
545 __user = Person(name, email)
549 """Return the author information.
554 # the environment variables take priority over config
556 date = os.environ['GIT_AUTHOR_DATE']
559 __author = Person(os.environ['GIT_AUTHOR_NAME'],
560 os.environ['GIT_AUTHOR_EMAIL'],
567 """Return the author information.
572 # the environment variables take priority over config
574 date = os.environ['GIT_COMMITTER_DATE']
577 __committer = Person(os.environ['GIT_COMMITTER_NAME'],
578 os.environ['GIT_COMMITTER_EMAIL'],
584 def update_cache(files = None, force = False):
585 """Update the cache information for the given files
587 cache_files = tree_status(files, verbose = False)
589 # everything is up-to-date
590 if len(cache_files) == 0:
593 # check for unresolved conflicts
594 if not force and [x for x in cache_files
595 if x[0] not in ['M', 'N', 'A', 'D']]:
596 raise GitException, 'Updating cache failed: unresolved conflicts'
599 add_files = [x[1] for x in cache_files if x[0] in ['N', 'A']]
600 rm_files = [x[1] for x in cache_files if x[0] in ['D']]
601 m_files = [x[1] for x in cache_files if x[0] in ['M']]
603 GRun('update-index', '--add', '--').xargs(add_files)
604 GRun('update-index', '--force-remove', '--').xargs(rm_files)
605 GRun('update-index', '--').xargs(m_files)
609 def commit(message, files = None, parents = None, allowempty = False,
610 cache_update = True, tree_id = None, set_head = False,
611 author_name = None, author_email = None, author_date = None,
612 committer_name = None, committer_email = None):
613 """Commit the current tree to repository
618 # Get the tree status
619 if cache_update and parents != []:
620 changes = update_cache(files)
621 if not changes and not allowempty:
622 raise GitException, 'No changes to commit'
624 # get the commit message
627 elif message[-1:] != '\n':
630 # write the index to repository
632 tree_id = GRun('write-tree').output_one_line()
638 env['GIT_AUTHOR_NAME'] = author_name
640 env['GIT_AUTHOR_EMAIL'] = author_email
642 env['GIT_AUTHOR_DATE'] = author_date
644 env['GIT_COMMITTER_NAME'] = committer_name
646 env['GIT_COMMITTER_EMAIL'] = committer_email
647 commit_id = GRun('commit-tree', tree_id,
648 *sum([['-p', p] for p in parents], [])
649 ).env(env).raw_input(message).output_one_line()
651 __set_head(commit_id)
655 def apply_diff(rev1, rev2, check_index = True, files = None):
656 """Apply the diff between rev1 and rev2 onto the current
657 index. This function doesn't need to raise an exception since it
658 is only used for fast-pushing a patch. If this operation fails,
659 the pushing would fall back to the three-way merge.
662 index_opt = ['--index']
669 diff_str = diff(files, rev1, rev2)
672 GRun('apply', *index_opt).raw_input(
673 diff_str).discard_stderr().no_output()
674 except GitRunException:
679 def merge(base, head1, head2, recursive = False):
680 """Perform a 3-way merge between base, head1 and head2 into the
687 # this operation tracks renames but it is slower (used in
688 # general when pushing or picking patches)
690 # discard output to mask the verbose prints of the tool
691 GRun('merge-recursive', base, '--', head1, head2
693 except GitRunException, ex:
697 # the fast case where we don't track renames (used when the
698 # distance between base and heads is small, i.e. folding or
699 # synchronising patches)
701 GRun('read-tree', '-u', '-m', '--aggressive',
702 base, head1, head2).run()
703 except GitRunException:
704 raise GitException, 'read-tree failed (local changes maybe?)'
706 # check the index for unmerged entries
708 stages_re = re.compile('^([0-7]+) ([0-9a-f]{40}) ([1-3])\t(.*)$', re.S)
710 for line in GRun('ls-files', '--unmerged', '--stage', '-z'
711 ).raw_output().split('\0'):
715 mode, hash, stage, path = stages_re.findall(line)[0]
717 if not path in files:
719 files[path]['1'] = ('', '')
720 files[path]['2'] = ('', '')
721 files[path]['3'] = ('', '')
723 files[path][stage] = (mode, hash)
725 if err_output and not files:
726 # if no unmerged files, there was probably a different type of
727 # error and we have to abort the merge
728 raise GitException, err_output
730 # merge the unmerged files
733 # remove additional files that might be generated for some
734 # newer versions of GIT
735 for suffix in [base, head1, head2]:
738 fname = path + '~' + suffix
739 if os.path.exists(fname):
743 if gitmergeonefile.merge(stages['1'][1], stages['2'][1],
744 stages['3'][1], path, stages['1'][0],
745 stages['2'][0], stages['3'][0]) != 0:
749 raise GitException, 'GIT index merging failed (possible conflicts)'
751 def diff(files = None, rev1 = 'HEAD', rev2 = None, diff_flags = []):
752 """Show the diff between rev1 and rev2
758 return GRun('diff-tree', '-p',
759 *(diff_flags + [rev1, rev2, '--'] + files)).raw_output()
763 return GRun('diff-index', '-p', '-R',
764 *(diff_flags + [rev2, '--'] + files)).raw_output()
766 return GRun('diff-index', '-p',
767 *(diff_flags + [rev1, '--'] + files)).raw_output()
771 # TODO: take another parameter representing a diff string as we
772 # usually invoke git.diff() form the calling functions
773 def diffstat(files = None, rev1 = 'HEAD', rev2 = None):
774 """Return the diffstat between rev1 and rev2."""
775 return GRun('apply', '--stat', '--summary'
776 ).raw_input(diff(files, rev1, rev2)).raw_output()
778 def files(rev1, rev2, diff_flags = []):
779 """Return the files modified between rev1 and rev2
783 for line in GRun('diff-tree', *(diff_flags + ['-r', rev1, rev2])
785 result.append('%s %s' % tuple(line.split(' ', 4)[-1].split('\t', 1)))
787 return '\n'.join(result)
789 def barefiles(rev1, rev2):
790 """Return the files modified between rev1 and rev2, without status info
794 for line in GRun('diff-tree', '-r', rev1, rev2).output_lines():
795 result.append(line.split(' ', 4)[-1].split('\t', 1)[-1])
797 return '\n'.join(result)
799 def pretty_commit(commit_id = 'HEAD', diff_flags = []):
800 """Return a given commit (log + diff)
802 return GRun('diff-tree',
804 + ['--cc', '--always', '--pretty', '-r', commit_id])
807 def checkout(files = None, tree_id = None, force = False):
808 """Check out the given or all files
812 GRun('read-tree', '--reset', tree_id).run()
813 except GitRunException:
814 raise GitException, 'Failed "git read-tree" --reset %s' % tree_id
816 cmd = ['checkout-index', '-q', '-u']
820 GRun(*(cmd + ['--'])).xargs(files)
822 GRun(*(cmd + ['-a'])).run()
824 def switch(tree_id, keep = False):
825 """Switch the tree to the given id
828 # only update the index while keeping the local changes
829 GRun('read-tree', tree_id).run()
833 GRun('read-tree', '-u', '-m', get_head(), tree_id).run()
834 except GitRunException:
835 raise GitException, 'read-tree failed (local changes maybe?)'
839 def reset(files = None, tree_id = None, check_out = True):
840 """Revert the tree changes relative to the given tree_id. It removes
847 cache_files = tree_status(files, tree_id)
848 # files which were added but need to be removed
849 rm_files = [x[1] for x in cache_files if x[0] in ['A']]
851 checkout(files, tree_id, True)
852 # checkout doesn't remove files
853 map(os.remove, rm_files)
855 # if the reset refers to the whole tree, switch the HEAD as well
859 def fetch(repository = 'origin', refspec = None):
860 """Fetches changes from the remote repository, using 'git fetch'
870 command = config.get('branch.%s.stgit.fetchcmd' % get_head_file()) or \
871 config.get('stgit.fetchcmd')
872 Run(*(command.split() + args)).run()
874 def pull(repository = 'origin', refspec = None):
875 """Fetches changes from the remote repository, using 'git pull'
885 command = config.get('branch.%s.stgit.pullcmd' % get_head_file()) or \
886 config.get('stgit.pullcmd')
887 Run(*(command.split() + args)).run()
889 def rebase(tree_id = None):
890 """Rebase the current tree to the give tree_id. The tree_id
891 argument may be something other than a GIT id if an external
894 command = config.get('branch.%s.stgit.rebasecmd' % get_head_file()) \
895 or config.get('stgit.rebasecmd')
901 raise GitException, 'Default rebasing requires a commit id'
903 # clear the HEAD cache as the custom rebase command will update it
905 Run(*(command.split() + args)).run()
908 reset(tree_id = tree_id)
911 """Repack all objects into a single pack
913 GRun('repack', '-a', '-d', '-f').run()
915 def apply_patch(filename = None, diff = None, base = None,
917 """Apply a patch onto the current or given index. There must not
918 be any local changes in the tree, otherwise the command fails
930 orig_head = get_head()
936 GRun('apply', '--index').raw_input(diff).no_output()
937 except GitRunException:
941 # write the failed diff to a file
942 f = file('.stgit-failed.patch', 'w+')
945 out.warn('Diff written to the .stgit-failed.patch file')
950 top = commit(message = 'temporary commit used for applying a patch',
953 merge(base, orig_head, top)
955 def clone(repository, local_dir):
956 """Clone a remote repository. At the moment, just use the
959 GRun('clone', repository, local_dir).run()
961 def modifying_revs(files, base_rev, head_rev):
962 """Return the revisions from the list modifying the given files."""
963 return GRun('rev-list', '%s..%s' % (base_rev, head_rev), '--', *files
966 def refspec_localpart(refspec):
967 m = re.match('^[^:]*:([^:]*)$', refspec)
971 raise GitException, 'Cannot parse refspec "%s"' % line
973 def refspec_remotepart(refspec):
974 m = re.match('^([^:]*):[^:]*$', refspec)
978 raise GitException, 'Cannot parse refspec "%s"' % line
981 def __remotes_from_config():
982 return config.sections_matching(r'remote\.(.*)\.url')
984 def __remotes_from_dir(dir):
985 d = os.path.join(basedir.get(), dir)
986 if os.path.exists(d):
992 """Return the list of remotes in the repository
994 return (set(__remotes_from_config())
995 | set(__remotes_from_dir('remotes'))
996 | set(__remotes_from_dir('branches')))
998 def remotes_local_branches(remote):
999 """Returns the list of local branches fetched from given remote
1003 if remote in __remotes_from_config():
1004 for line in config.getall('remote.%s.fetch' % remote):
1005 branches.append(refspec_localpart(line))
1006 elif remote in __remotes_from_dir('remotes'):
1007 stream = open(os.path.join(basedir.get(), 'remotes', remote), 'r')
1009 # Only consider Pull lines
1010 m = re.match('^Pull: (.*)\n$', line)
1012 branches.append(refspec_localpart(m.group(1)))
1014 elif remote in __remotes_from_dir('branches'):
1015 # old-style branches only declare one branch
1016 branches.append('refs/heads/'+remote);
1018 raise GitException, 'Unknown remote "%s"' % remote
1022 def identify_remote(branchname):
1023 """Return the name for the remote to pull the given branchname
1024 from, or None if we believe it is a local branch.
1027 for remote in remotes_list():
1028 if branchname in remotes_local_branches(remote):
1031 # if we get here we've found nothing, the branch is a local one
1035 """Return the git id for the tip of the parent branch as left by
1040 stream = open(os.path.join(basedir.get(), 'FETCH_HEAD'), "r")
1042 # Only consider lines not tagged not-for-merge
1043 m = re.match('^([^\t]*)\t\t', line)
1046 raise GitException, 'StGit does not support multiple FETCH_HEAD'
1048 fetch_head=m.group(1)
1052 out.warn('No for-merge remote head found in FETCH_HEAD')
1054 # here we are sure to have a single fetch_head
1058 """Return a list of all refs in the current repository.
1061 return [line.split()[1] for line in GRun('show-ref').output_lines()]