First major code push

Preparing for version 0.1.0
Contains a real README, the test framework, and the API implementation

bots_api.go

@@ -0,0 +1,142 @@
+package groupme
+
+import (
+	"errors"
+	"fmt"
+	"net/http"
+	"net/url"
+)
+
+// GroupMe documentation: https://dev.groupme.com/docs/v3#bots
+
+////////// Endpoints //////////
+const (
+	// Used to build other endpoints
+	botsEndpointRoot = "/bots"
+
+	// Actual Endpoints
+	createBotEndpoint      = botsEndpointRoot              // POST
+	postBotMessageEndpoint = botsEndpointRoot + "/post"    // POST
+	indexBotsEndpoint      = botsEndpointRoot              // GET
+	destroyBotEndpoint     = botsEndpointRoot + "/destroy" // POST
+)
+
+////////// API Requests //////////
+
+// Create
+
+/*
+CreateBot -
+
+Create a bot. See the Bots Tutorial (https://dev.groupme.com/tutorials/bots)
+for a full walkthrough.
+
+Parameters:
+	See Bot
+	Name - required
+	GroupID - required
+*/
+func (c *Client) CreateBot(bot *Bot) (*Bot, error) {
+	httpReq, err := http.NewRequest("POST", c.endpointBase+createBotEndpoint, nil)
+	if err != nil {
+		return nil, err
+	}
+
+	if bot == nil {
+		return nil, errors.New("bot cannot be nil")
+	}
+
+	data := url.Values{}
+	data.Add("bot", bot.String())
+
+	httpReq.PostForm = data
+
+	var resp Bot
+	err = c.do(httpReq, &resp)
+	if err != nil {
+		return nil, err
+	}
+
+	return &resp, nil
+}
+
+// PostMessage
+
+/*
+PostBotMessage -
+
+Post a message from a bot
+
+Parameters:
+	botID - required, ID(string)
+	text - required, string
+	pictureURL - string; image must be processed through image
+				service (https://dev.groupme.com/docs/image_service)
+*/
+func (c *Client) PostBotMessage(botID ID, text string, pictureURL *string) error {
+	URL := fmt.Sprintf(c.endpointBase + postBotMessageEndpoint)
+
+	httpReq, err := http.NewRequest("POST", URL, nil)
+	if err != nil {
+		return err
+	}
+
+	data := url.Values{}
+	data.Add("bot_id", string(botID))
+	data.Add("text", text)
+	if pictureURL != nil {
+		data.Add("picture_url", *pictureURL)
+	}
+
+	httpReq.PostForm = data
+
+	return c.do(httpReq, nil)
+}
+
+// Index
+
+/*
+IndexBots -
+
+List bots that you have created
+*/
+func (c *Client) IndexBots() ([]*Bot, error) {
+	httpReq, err := http.NewRequest("GET", c.endpointBase+indexBotsEndpoint, nil)
+	if err != nil {
+		return nil, err
+	}
+
+	var resp []*Bot
+	err = c.do(httpReq, &resp)
+	if err != nil {
+		return nil, err
+	}
+
+	return resp, nil
+}
+
+// Destroy
+
+/*
+DestroyBot -
+
+Remove a bot that you have created
+
+Parameters:
+	botID - required, ID(string)
+*/
+func (c *Client) DestroyBot(botID ID) error {
+	URL := fmt.Sprintf(c.endpointBase + destroyBotEndpoint)
+
+	httpReq, err := http.NewRequest("POST", URL, nil)
+	if err != nil {
+		return err
+	}
+
+	data := url.Values{}
+	data.Add("bot_id", string(botID))
+
+	httpReq.PostForm = data
+
+	return c.do(httpReq, nil)
+}