Merge pull request #41 from Etherdaemon/folder_by_uid

Add function to retrieve folders by UID

Author: julienduchesne

folder.go

@@ -35,6 +35,17 @@ func (c *Client) Folder(id int64) (*Folder, error) {
 	return folder, err
 }
 
+// Folder fetches and returns the Grafana folder whose UID it's passed.
+func (c *Client) FolderByUID(uid string) (*Folder, error) {
+	folder := &Folder{}
+	err := c.request("GET", fmt.Sprintf("/api/folders/%s", uid), nil, nil, folder)
+	if err != nil {
+		return folder, err
+	}
+
+	return folder, err
+}
+
 // NewFolder creates a new Grafana folder.
 func (c *Client) NewFolder(title string) (Folder, error) {
 	folder := Folder{}

folder_test.go

@@ -120,6 +120,23 @@ func TestFolder(t *testing.T) {
 	}
 }
 
+func TestFolderByUid(t *testing.T) {
+	server, client := gapiTestTools(t, 200, getFolderJSON)
+	defer server.Close()
+
+	folder := "nErXDvCkzz"
+	resp, err := client.FolderByUID(folder)
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	t.Log(pretty.PrettyFormat(resp))
+
+	if resp.UID != folder || resp.Title != "Departmenet ABC" {
+		t.Error("Not correctly parsing returned folder.")
+	}
+}
+
 func TestNewFolder(t *testing.T) {
 	server, client := gapiTestTools(t, 200, createdFolderJSON)
 	defer server.Close()