Merge pull request #17 from agunawan/master

Implement the List repository tree API method

Author: Raphaël Benitte

repositories.go

@@ -14,6 +14,13 @@ const (
 	repo_url_raw_file = "/projects/:id/repository/blobs/:sha"       // Get raw file content for specific commit/branch
 )
 
+type TreeNode struct {
+	Name string
+	Type string
+	Mode string
+	Id   string
+}
+
 type BranchCommit struct {
 	Id               string  `json:"id,omitempty"`
 	Tree             string  `json:"tree,omitempty"`
@@ -52,6 +59,36 @@ type Commit struct {
 	CreatedAt    time.Time
 }
 
+/*
+Get a list of repository files and directories in a project.
+
+    GET /projects/:id/repository/tree
+
+Parameters:
+
+    id (required) The ID of a project
+    path (optional) The path inside repository. Used to get contend of subdirectories
+		ref_name (optional) The name of a repository branch or tag or if not given the default branch
+
+Usage:
+		pass nil when not using optional parameters
+*/
+func (g *Gitlab) RepoTree(id, path, ref_name string) ([]*TreeNode, error) {
+
+	url, opaque := g.ResourceUrlRaw(repo_url_tree, map[string]string{":id": id})
+	url += "&path=" + path
+	url += "&ref_name=" + ref_name
+
+	var treeNodes []*TreeNode
+
+	contents, err := g.buildAndExecRequestRaw("GET", url, opaque, nil)
+	if err == nil {
+		err = json.Unmarshal(contents, &treeNodes)
+	}
+
+	return treeNodes, err
+}
+
 /*
 Get a list of repository branches from a project, sorted by name alphabetically.
 

repositories_test.go

@@ -41,3 +41,12 @@ func TestRepoCommits(t *testing.T) {
 	assert.Equal(t, len(commits), 2)
 	defer ts.Close()
 }
+
+func TestRepoTree(t *testing.T) {
+	ts, gitlab := Stub("stubs/trees/show.json")
+	tree, err := gitlab.RepoTree("1", "path", "ref_name")
+
+	assert.Equal(t, err, nil)
+	assert.Equal(t, len(tree), 6)
+	defer ts.Close()
+}

stubs/trees/show.json

@@ -0,0 +1,38 @@
+[
+  {
+    "name": "assets",
+    "type": "tree",
+    "mode": "040000",
+    "id": "6229c43a7e16fcc7e95f923f8ddadb8281d9c6c6"
+  },
+  {
+    "name": "contexts",
+    "type": "tree",
+    "mode": "040000",
+    "id": "faf1cdf33feadc7973118ca42d35f1e62977e91f"
+  },
+  {
+    "name": "controllers",
+    "type": "tree",
+    "mode": "040000",
+    "id": "95633e8d258bf3dfba3a5268fb8440d263218d74"
+  },
+  {
+    "name": "Rakefile",
+    "type": "blob",
+    "mode": "100644",
+    "id": "35b2f05cbb4566b71b34554cf184a9d0bd9d46d6"
+  },
+  {
+    "name": "VERSION",
+    "type": "blob",
+    "mode": "100644",
+    "id": "803e4a4f3727286c3093c63870c2b6524d30ec4f"
+  },
+  {
+    "name": "config.ru",
+    "type": "blob",
+    "mode": "100644",
+    "id": "dfd2d862237323aa599be31b473d70a8a817943b"
+  }
+]