gitiles: add Refs API.

common/api/gitiles/gitiles_test.go

 // Copyright 2017 The LUCI Authors.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
 // You may obtain a copy of the License at
 //
 //      http://www.apache.org/licenses/LICENSE-2.0
 //
 // Unless required by applicable law or agreed to in writing, software
 // distributed under the License is distributed on an "AS IS" BASIS,
@@ skipping 116 matching lines @@
                         commits, err := c.Log(ctx, "https://c.googlesource.com/repo",
                                 "master", 1)
                         So(err, ShouldBeNil)
                         So(cursor_sent, ShouldEqual, "")
                         So(len(commits), ShouldEqual, 1)
                         So(commits[0].Author.Name, ShouldEqual, "Author 1")
                 })
         })
 }
 
+func TestRefs(t *testing.T) {
+        t.Parallel()
+        ctx := context.Background()
+
+        Convey("Refs Bad RefsPath", t, func() {
+
+                c := Client{nil, "https://a.googlesource.com/a/repo"}
+                _, err := c.Refs(context.Background(), "https://c.googlesource.com/repo", "bad")
+                So(err, ShouldNotBeNil)
+        })
+
+        Convey("Refs All", t, func() {
+                srv, c := newMockClient(func(w http.ResponseWriter, r *http.Request) {
+                        w.WriteHeader(200)
+                        w.Header().Set("Content-Type", "application/json")
+                        fmt.Fprintln(w, `)]}'
+                                {
+                                        "refs/heads/master": { "value": "deadbeef" },
+                                        "refs/heads/infra/config": { "value": "0000beef" },
+                                        "refs/changes/01/123001/1": { "value": "123dead001beef1" },
+                                        "refs/other/ref": { "value": "ba6" },
+                                        "123deadbeef123": { "target": "f00" },
+                                        "HEAD": { "value": "deadbeef",
+                                                                                "target": "refs/heads/master" }
+                                }
+                        `)
+                })
+                defer srv.Close()
+                refs, err := c.Refs(ctx, "https://c.googlesource.com/repo", "refs")
+                So(err, ShouldBeNil)
+                So(refs, ShouldResemble, map[string]string{
+                        "HEAD":                     "refs/heads/master",
+                        "refs/heads/master":        "deadbeef",
+                        "refs/heads/infra/config":  "0000beef",
+                        "refs/other/ref":           "ba6",
+                        "refs/changes/01/123001/1": "123dead001beef1",
+                        // Skipping "123dead001beef1" which has no value.
+                })
+        })
+        Convey("Refs heads", t, func() {
+                srv, c := newMockClient(func(w http.ResponseWriter, r *http.Request) {
+                        w.WriteHeader(200)
+                        w.Header().Set("Content-Type", "application/json")
+                        fmt.Fprintln(w, `)]}'
+                                {
+                                        "master": { "value": "deadbeef" },
+                                        "infra/config": { "value": "0000beef" }
+                                }
+                        `)
+                })
+                defer srv.Close()
+                refs, err := c.Refs(ctx, "https://c.googlesource.com/repo", "refs/heads")
+                So(err, ShouldBeNil)
+                So(refs, ShouldResemble, map[string]string{
+                        "refs/heads/master":       "deadbeef",
+                        "refs/heads/infra/config": "0000beef",
+                })
+        })
+}
+
 ////////////////////////////////////////////////////////////////////////////////
 
 var (
         fake_commit1_str = `{
                 "commit": "0b2c5409e58a71c691b05454b55cc5580cc822d1",
                 "tree": "3c6f95bc757698cd6aca3c49f88f640fd145ea69",
                 "parents": [ "dc1dbf1aa56e4dd4cbfaab61c4d30a35adce5f40" ],
                 "author": {
                         "name": "Author 1",
                         "email": "author1@example.com",
@@ skipping 23 matching lines @@
                 "message": "[Web Payments] User weak ptr in Payment Request\u0027s error callback\\n\\nBug: 742329\\nReviewed-on: https://chromium-review.googlesource.com/570982\\nCr-Commit-Position: refs/heads/master@{#487077}"
   }`
 )
 
 ////////////////////////////////////////////////////////////////////////////////
 
 func newMockClient(handler func(w http.ResponseWriter, r *http.Request)) (*httptest.Server, *Client) {
         srv := httptest.NewServer(http.HandlerFunc(handler))
         return srv, &Client{Client: http.DefaultClient, mockRepoURL: srv.URL}
 }