fixups and commit listing api

schacon · schacon · commit 030aa91e545e · 2011-05-12T17:40:58.000-07:00
diff --git a/content/v3/git/commits.md b/content/v3/git/commits.md
@@ -6,7 +6,42 @@ title: Git DB Commits API v3 | developer.github.com
 
 ## List commits
 
-    GET /repos/:user/:repo/git/commits?start=:ref&max=:max
+    GET /repos/:user/:repo/git/commits
+
+### Parameters
+
+start
+: _String_ of the reference or SHA to start at, or an _Array_ of them if
+you want multiple starting points. Defaults to the default branch on the
+server.
+
+not
+: _String_ of the reference or SHA to end at, or an _Array_ of them if
+you want multiple ending points
+
+after
+: _Timestamp_ to return commits only authored after the specified date
+
+before
+: _Timestamp_ to return commits only authored before the specified date
+
+grep
+: _String_ of regex to match against the commit messages
+
+author
+: _String_ of regex to match against the author names and email addresses
+
+max
+: _Integer_ of maximum number of results to return
+
+path
+: _String_ of path limiter - only return commits that modified the given
+path
+
+### Response
+
+<%= headers 200, :pagination => true %>
+<%= json :commits %>
 
 ## Get a Commit
 
diff --git a/content/v3/git/import.md b/content/v3/git/import.md
@@ -0,0 +1,8 @@
+---
+title: Git DB Import API v3 | developer.github.com
+---
+
+# Import API
+
+`git fast-import` input parser
+
diff --git a/content/v3/git/refs.md b/content/v3/git/refs.md
@@ -64,3 +64,8 @@ out or setting it to `false` will make sure you're not overwriting work.
 <%= json :ref => "refs/heads/master", "type" => "commit", \
          "sha"=>"827efc6d56897b048c772eb4087f854f46256132" %>
 
+## Get the Reference History
+
+    GET /repos/:user/:repo/git/reflogs
+
+
diff --git a/layouts/default.html b/layouts/default.html
@@ -64,13 +64,14 @@ <h3><a href="/v3/users/">Users</a></h3>
             </ul>
           </li>
           <li>
-            <h3><a href="/v3/git/">Git DB</a></h3>
+            <h3><a href="/v3/git/">Git Data</a></h3>
             <ul>
               <li><a href="/v3/git/blobs/">Blobs</a></li>
               <li><a href="/v3/git/trees/">Trees</a></li>
               <li><a href="/v3/git/commits/">Commits</a></li>
               <li><a href="/v3/git/tags/">Tags</a></li>
               <li><a href="/v3/git/refs/">References</a></li>
+              <li><a href="/v3/git/import/">Import</a></li>
             </ul>
           </li>
         </ul>
diff --git a/lib/resources.rb b/lib/resources.rb
@@ -335,6 +335,41 @@ def json(key)
       "parents"  => ["7d1b31e74ee336d15cbd21741bc88a537ed063a0"]
     }
 
+    COMMITS_REST = [
+      { "sha" => "7d1b31e74ee336d15cbd21741bc88a537ed063a0",
+        "author" => {
+          "name"  => "Scott Chacon",
+          "email" => "scott@github.com",
+          "date"  => "2008-07-08T16:13:30+12:00"
+        },
+        "committer" => {
+          "name"  => "Scott Chacon",
+          "email" => "scott@github.com",
+          "date"  => "2008-07-08T16:13:30+12:00"
+        },
+        "message"  => "my older commit message",
+        "tree"     => "392662aae29f314a428bfc6b619d97bd4ad4a727",
+        "parents"  => ["afc99de753646e2c438203430e97671971740d35"]
+      },
+      { "sha" => "afc99de753646e2c438203430e97671971740d35",
+        "author" => {
+          "name"  => "Scott Chacon",
+          "email" => "scott@github.com",
+          "date"  => "2008-07-07T16:13:30+12:00"
+        },
+        "committer" => {
+          "name"  => "Scott Chacon",
+          "email" => "scott@github.com",
+          "date"  => "2008-07-07T16:13:30+12:00"
+        },
+        "message"  => "my first commit message",
+        "tree"     => "8bcac778496eb77c1928aa9778f5112c6a822a19",
+        "parents"  => []
+      }
+    ]
+
+    COMMITS = [COMMIT] + COMMITS_REST
+
     TAG = {
       "sha" => "b8d04eddde9f53f3bc76dd048f3477062a27c91a",
       "tag" => "v1.0",
