8 """Parse a DEPS file and git checkout all of the dependencies.
14   GIT_EXECUTABLE: path to "git" binary; if unset, will look for git in
22 Git Config:
25       git config sync-deps.disable true
29       git config --unset sync-deps.disable
40   """Find the git executable.
46   searchlist = ['git']
50     for git in searchlist:
52         subprocess.call([git, '--version'], stdout=devnull)
55       return git
76 def git_repository_sync_is_disabled(git, directory):  argument
79       [git, 'config', 'sync-deps.disable'], cwd=directory)
85 def is_git_toplevel(git, directory):  argument
86   """Return true iff the directory is the top level of a Git repository.
89     git (string) the git executable
96       [git, 'rev-parse', '--show-toplevel'], cwd=directory).strip()
115 def git_checkout_to_directory(git, repo, commithash, directory, verbose):  argument
116   """Checkout (and clone if needed) a Git repository.
119     git (string) the git executable
122          for passing to `git clone`.
124     commithash (string) a commit, suitable for passing to `git checkout`
131   Raises an exception if any calls to git fail.
135       [git, 'clone', '--quiet', '--no-checkout', repo, directory])
136     subprocess.check_call([git, 'checkout', '--quiet', commithash],
142   if not is_git_toplevel(git, directory):
143     # if the directory exists, but isn't a git repo, you will modify
145     sys.stdout.write('%s\n  IS NOT TOP-LEVEL GIT DIRECTORY.\n' % directory)
149   if git_repository_sync_is_disabled(git, directory):
156     if 0 == subprocess.call([git, 'checkout', '--quiet', commithash],
158       # if this succeeds, skip slow `git fetch`.
166       [git, 'remote', 'set-url', 'origin', repo], cwd=directory)
168   subprocess.check_call([git, 'fetch', '--quiet'], cwd=directory)
170   subprocess.check_call([git, 'checkout', '--quiet', commithash], cwd=directory)
198   Raises git Exceptions.
200   git = git_executable()
201   assert git
235       (git, repo, commithash, relative_directory, verbose))