add folder support

Author: Gordon Irving

folder.go

@@ -0,0 +1,123 @@
+package gapi
+
+import (
+	"bytes"
+	"encoding/json"
+	"errors"
+	"fmt"
+	"io/ioutil"
+)
+
+type Folder struct {
+	Id    int64  `json:"id"`
+	Title string `json:"title"`
+}
+
+func (c *Client) Folders() ([]Folder, error) {
+	folders := make([]Folder, 0)
+
+	req, err := c.newRequest("GET", "/api/folders/", nil, nil)
+	if err != nil {
+		return folders, err
+	}
+	resp, err := c.Do(req)
+	if err != nil {
+		return folders, err
+	}
+	if resp.StatusCode != 200 {
+		return folders, errors.New(resp.Status)
+	}
+	data, err := ioutil.ReadAll(resp.Body)
+	if err != nil {
+		return folders, err
+	}
+	err = json.Unmarshal(data, &folders)
+	return folders, err
+}
+
+func (c *Client) Folder(id int64) (Folder, error) {
+	folder := Folder{}
+	req, err := c.newRequest("GET", fmt.Sprintf("/api/folders/%d", id), nil, nil)
+	if err != nil {
+		return folder, err
+	}
+	resp, err := c.Do(req)
+	if err != nil {
+		return folder, err
+	}
+	if resp.StatusCode != 200 {
+		return folder, errors.New(resp.Status)
+	}
+	data, err := ioutil.ReadAll(resp.Body)
+	if err != nil {
+		return folder, err
+	}
+	err = json.Unmarshal(data, &folder)
+	return folder, err
+}
+
+func (c *Client) NewFolder(name string) (int64, error) {
+	dataMap := map[string]string{
+		"name": name,
+	}
+	data, err := json.Marshal(dataMap)
+	id := int64(0)
+	req, err := c.newRequest("POST", "/api/folders", nil, bytes.NewBuffer(data))
+	if err != nil {
+		return id, err
+	}
+	resp, err := c.Do(req)
+	if err != nil {
+		return id, err
+	}
+	if resp.StatusCode != 200 {
+		return id, errors.New(resp.Status)
+	}
+	data, err = ioutil.ReadAll(resp.Body)
+	if err != nil {
+		return id, err
+	}
+	tmp := struct {
+		Id int64 `json:"id"`
+	}{}
+	err = json.Unmarshal(data, &tmp)
+	if err != nil {
+		return id, err
+	}
+	id = tmp.Id
+	return id, err
+}
+
+func (c *Client) UpdateFolder(id int64, name string) error {
+	dataMap := map[string]string{
+		"name": name,
+	}
+	data, err := json.Marshal(dataMap)
+	req, err := c.newRequest("PUT", fmt.Sprintf("/api/folders/%d", id), nil, bytes.NewBuffer(data))
+	if err != nil {
+		return err
+	}
+	resp, err := c.Do(req)
+	if err != nil {
+		return err
+	}
+	if resp.StatusCode != 200 {
+		return errors.New(resp.Status)
+	}
+	return err
+}
+
+func (c *Client) DeleteFolder(id int64) error {
+	req, err := c.newRequest("DELETE", fmt.Sprintf("/api/folders/%d", id), nil, nil)
+	if err != nil {
+		return err
+	}
+	resp, err := c.Do(req)
+	if err != nil {
+		return err
+	}
+	if resp.StatusCode != 200 {
+		return errors.New(resp.Status)
+	}
+	return err
+}

folder_test.go

@@ -0,0 +1,156 @@
+package gapi
+
+import (
+	"github.com/gobs/pretty"
+	"testing"
+)
+
+const (
+	getFoldersJSON = `
+[
+  {
+    "id":1,
+    "uid": "nErXDvCkzz",
+    "title": "Departmenet ABC",
+    "url": "/dashboards/f/nErXDvCkzz/department-abc",
+    "hasAcl": false,
+    "canSave": true,
+    "canEdit": true,
+    "canAdmin": true,
+    "createdBy": "admin",
+    "created": "2018-01-31T17:43:12+01:00",
+    "updatedBy": "admin",
+    "updated": "2018-01-31T17:43:12+01:00",
+    "version": 1
+  }
+]
+	`
+	getFolderJSON = `
+{
+  "id":1,
+  "uid": "nErXDvCkzz",
+  "title": "Departmenet ABC",
+  "url": "/dashboards/f/nErXDvCkzz/department-abc",
+  "hasAcl": false,
+  "canSave": true,
+  "canEdit": true,
+  "canAdmin": true,
+  "createdBy": "admin",
+  "created": "2018-01-31T17:43:12+01:00",
+  "updatedBy": "admin",
+  "updated": "2018-01-31T17:43:12+01:00",
+  "version": 1
+}
+`
+	createdFolderJSON = `
+{
+  "id":1,
+  "uid": "nErXDvCkzz",
+  "title": "Departmenet ABC",
+  "url": "/dashboards/f/nErXDvCkzz/department-abc",
+  "hasAcl": false,
+  "canSave": true,
+  "canEdit": true,
+  "canAdmin": true,
+  "createdBy": "admin",
+  "created": "2018-01-31T17:43:12+01:00",
+  "updatedBy": "admin",
+  "updated": "2018-01-31T17:43:12+01:00",
+  "version": 1
+}
+`
+	updatedFolderJSON = `
+{
+  "id":1,
+  "uid": "nErXDvCkzz",
+  "title": "Departmenet DEF",
+  "url": "/dashboards/f/nErXDvCkzz/department-def",
+  "hasAcl": false,
+  "canSave": true,
+  "canEdit": true,
+  "canAdmin": true,
+  "createdBy": "admin",
+  "created": "2018-01-31T17:43:12+01:00",
+  "updatedBy": "admin",
+  "updated": "2018-01-31T17:43:12+01:00",
+  "version": 1
+}
+`
+	deletedFolderJSON = `
+{
+  "message":"Folder deleted"
+}
+`
+)
+
+func TestFolders(t *testing.T) {
+	server, client := gapiTestTools(200, getFoldersJSON)
+	defer server.Close()
+
+	folders, err := client.Folders()
+	if err != nil {
+		t.Error(err)
+	}
+
+	t.Log(pretty.PrettyFormat(folders))
+
+	if len(folders) != 1 {
+		t.Error("Length of returned folders should be 1")
+	}
+	if folders[0].Id != 1 || folders[0].Title != "Departmenet ABC" {
+		t.Error("Not correctly parsing returned folders.")
+	}
+}
+
+func TestFolder(t *testing.T) {
+	server, client := gapiTestTools(200, getFolderJSON)
+	defer server.Close()
+
+	folder := int64(1)
+	resp, err := client.Folder(folder)
+	if err != nil {
+		t.Error(err)
+	}
+
+	t.Log(pretty.PrettyFormat(resp))
+
+	if resp.Id != folder || resp.Title != "Departmenet ABC" {
+		t.Error("Not correctly parsing returned folder.")
+	}
+}
+
+func TestNewFolder(t *testing.T) {
+	server, client := gapiTestTools(200, createdFolderJSON)
+	defer server.Close()
+
+	resp, err := client.NewFolder("test-folder")
+	if err != nil {
+		t.Error(err)
+	}
+
+	t.Log(pretty.PrettyFormat(resp))
+
+	if resp != 1 {
+		t.Error("Not correctly parsing returned creation message.")
+	}
+}
+
+func TestUpdateFolder(t *testing.T) {
+	server, client := gapiTestTools(200, updatedFolderJSON)
+	defer server.Close()
+
+	err := client.UpdateFolder(int64(1), "test-folder")
+	if err != nil {
+		t.Error(err)
+	}
+}
+
+func TestDeleteFolder(t *testing.T) {
+	server, client := gapiTestTools(200, deletedFolderJSON)
+	defer server.Close()
+
+	err := client.DeleteFolder(int64(1))
+	if err != nil {
+		t.Error(err)
+	}
+}