Index: chrome/common/extensions/docs/server2/local_git_util.py |
diff --git a/chrome/common/extensions/docs/server2/local_git_util.py b/chrome/common/extensions/docs/server2/local_git_util.py |
new file mode 100644 |
index 0000000000000000000000000000000000000000..47b351c0899da66fc5f477e8a4b97b9ec8a9200b |
--- /dev/null |
+++ b/chrome/common/extensions/docs/server2/local_git_util.py |
@@ -0,0 +1,79 @@ |
+# Copyright 2015 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 os |
+import re |
+ |
+from file_system import FileNotFoundError |
+ |
+ |
+# This provides utilities for extracting information from the local git |
+# repository to which it belongs. |
+ |
+ |
+# Regex to match ls-tree output. |
+_LS_TREE_REGEX = re.compile( |
+ '\d+\s(?P<type>\w+)\s(?P<id>[0-9a-f]{40})\s(?P<name>.*)') |
+ |
+ |
+def _GetRoot(): |
+ return os.path.join(os.path.dirname(os.path.realpath(__file__)), |
+ os.pardir, os.pardir, os.pardir, os.pardir, os.pardir) |
+ |
+ |
+def _RelativePath(path): |
+ return os.path.join(_GetRoot(), path) |
+ |
+ |
+def RunGit(command, args=[]): |
+ # We import subprocess symbols lazily because they aren't available on |
+ # AppEngine, and the frontend may load (but should never execute) this module. |
+ from subprocess import check_output |
+ with open(os.devnull, 'w') as dev_null: |
+ return check_output(['git', command] + args, stderr=dev_null, |
+ cwd=_GetRoot()) |
+ |
+ |
+def ParseRevision(name): |
+ return RunGit('rev-parse', [name]).rstrip() |
+ |
+ |
+def GetParentRevision(revision): |
+ return RunGit('show', ['-s', '--format=%P', revision]).rstrip() |
+ |
+ |
+def GetRootTree(revision): |
+ return RunGit('show', ['-s', '--format=%T', revision]).rstrip() |
+ |
+ |
+def ListDir(path, revision='HEAD'): |
+ '''Retrieves a directory listing for the specified path and optional revision |
+ (default is HEAD.) Returns a list of objects with the following properties: |
+ |
+ |type|: the type of entry; 'blob' (file) or 'tree' (directory) |
+ |id|: the hash of the directory entry. This is either tree hash or blob hash |
+ |name|: the name of the directory entry. |
+ ''' |
+ from subprocess import CalledProcessError |
+ try: |
+ ref = '%s:%s' % (ParseRevision(revision), path.lstrip('/')) |
+ listing = RunGit('ls-tree', [ref]).rstrip().splitlines() |
+ except CalledProcessError: |
+ raise FileNotFoundError('%s not found in revision %s' % (path, revision)) |
+ |
+ def parse_line(line): |
+ return re.match(_LS_TREE_REGEX, line).groupdict() |
+ |
+ return map(parse_line, listing) |
+ |
+ |
+def ReadFile(path, revision='HEAD'): |
+ '''Retrieves the contents of a file at the specified path and optional |
+ revision (default is HEAD.) Returns its contents as a string. |
+ ''' |
+ from subprocess import CalledProcessError |
+ try: |
+ return RunGit('show', ['%s:%s' % (ParseRevision(revision), path)]) |
+ except CalledProcessError: |
+ raise FileNotFoundError('%s not found in revision %s' % (path, revision)) |