Added git tags support.

github/git_tags.go

@@ -0,0 +1,73 @@
+// Copyright 2013 The go-github AUTHORS. All rights reserved.
+//
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+package github
+
+import (
+	"fmt"
+)
+
+// Tag represents a tag object.
+type Tag struct {
+	Tag     *string       `json:"tag,omitempty"`
+	SHA     *string       `json:"sha,omitempty"`
+	URL     *string       `json:"url,omitempty"`
+	Message *string       `json:"message,omitempty"`
+	Tagger  *CommitAuthor `json:"tagger,omitempty"`
+	Object  *GitObject    `json:"object,omitempty"`
+}
+
+// createTagRequest represents the body of a CreateTag request.  This is mostly
+// identical to Tag with the exception that the object SHA and Type are
+// top-level fields, rather than being nested inside a JSON object.
+type createTagRequest struct {
+	Tag     *string       `json:"tag,omitempty"`
+	Message *string       `json:"message,omitempty"`
+	Object  *string       `json:"object,omitempty"`
+	Type    *string       `json:"type,omitempty"`
+	Tagger  *CommitAuthor `json:"tagger,omitempty"`
+}
+
+// GetTag fetchs a tag from a repo given a SHA.
+//
+// GitHub API docs: http://developer.github.com/v3/git/tags/#get-a-tag
+func (s *GitService) GetTag(owner string, repo string, sha string) (*Tag, *Response, error) {
+	u := fmt.Sprintf("repos/%v/%v/git/tags/%v", owner, repo, sha)
+	req, err := s.client.NewRequest("GET", u, nil)
+	if err != nil {
+		return nil, nil, err
+	}
+
+	tag := new(Tag)
+	resp, err := s.client.Do(req, tag)
+	return tag, resp, err
+}
+
+// CreateTag creates a tag object.
+//
+// GitHub API docs: http://developer.github.com/v3/git/tags/#create-a-tag-object
+func (s *GitService) CreateTag(owner string, repo string, tag *Tag) (*Tag, *Response, error) {
+	u := fmt.Sprintf("repos/%v/%v/git/tags", owner, repo)
+
+	// convert Tag into a createTagRequest
+	tagRequest := &createTagRequest{
+		Tag:     tag.Tag,
+		Message: tag.Message,
+		Tagger:  tag.Tagger,
+	}
+	if tag.Object != nil {
+		tagRequest.Object = tag.Object.SHA
+		tagRequest.Type = tag.Object.Type
+	}
+
+	req, err := s.client.NewRequest("POST", u, tagRequest)
+	if err != nil {
+		return nil, nil, err
+	}
+
+	t := new(Tag)
+	resp, err := s.client.Do(req, t)
+	return t, resp, err
+}

github/git_tags_test.go

@@ -0,0 +1,68 @@
+// Copyright 2013 The go-github AUTHORS. All rights reserved.
+//
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+package github
+
+import (
+	"encoding/json"
+	"fmt"
+	"net/http"
+	"reflect"
+	"testing"
+)
+
+func TestGitService_GetTag(t *testing.T) {
+	setup()
+	defer teardown()
+
+	mux.HandleFunc("/repos/o/r/git/tags/s", func(w http.ResponseWriter, r *http.Request) {
+		testMethod(t, r, "GET")
+
+		fmt.Fprint(w, `{"tag": "t"}`)
+	})
+
+	tag, _, err := client.Git.GetTag("o", "r", "s")
+
+	if err != nil {
+		t.Errorf("Git.GetTag returned error: %v", err)
+	}
+
+	want := &Tag{Tag: String("t")}
+	if !reflect.DeepEqual(tag, want) {
+		t.Errorf("Git.GetTag returned %+v, want %+v", tag, want)
+	}
+}
+
+func TestGitService_CreateTag(t *testing.T) {
+	setup()
+	defer teardown()
+
+	input := &createTagRequest{Tag: String("t"), Object: String("s")}
+
+	mux.HandleFunc("/repos/o/r/git/tags", func(w http.ResponseWriter, r *http.Request) {
+		v := new(createTagRequest)
+		json.NewDecoder(r.Body).Decode(v)
+
+		testMethod(t, r, "POST")
+		if !reflect.DeepEqual(v, input) {
+			t.Errorf("Request body = %+v, want %+v", v, input)
+		}
+
+		fmt.Fprint(w, `{"tag": "t"}`)
+	})
+
+	tag, _, err := client.Git.CreateTag("o", "r", &Tag{
+		Tag:    input.Tag,
+		Object: &GitObject{SHA: input.Object},
+	})
+	if err != nil {
+		t.Errorf("Git.CreateTag returned error: %v", err)
+	}
+
+	want := &Tag{Tag: String("t")}
+	if !reflect.DeepEqual(tag, want) {
+		t.Errorf("Git.GetTag returned %+v, want %+v", tag, want)
+	}
+}