Add RenameOrg endpoint for Org Admin API (google#1480)

Fixes google#1479.

Author: nightlark

github/admin_orgs.go

@@ -5,7 +5,10 @@
 
 package github
 
-import "context"
+import (
+	"context"
+	"fmt"
+)
 
 // createOrgRequest is a subset of Organization and is used internally
 // by CreateOrg to pass only the known fields for the endpoint.
@@ -41,3 +44,46 @@ func (s *AdminService) CreateOrg(ctx context.Context, org *Organization, admin s
 
 	return o, resp, nil
 }
+
+// renameOrgRequest is a subset of Organization and is used internally
+// by RenameOrg and RenameOrgByName to pass only the known fields for the endpoint.
+type renameOrgRequest struct {
+	Login *string `json:"login,omitempty"`
+}
+
+// RenameOrgResponse is the response given when renaming an Organization.
+type RenameOrgResponse struct {
+	Message *string `json:"message,omitempty"`
+	URL     *string `json:"url,omitempty"`
+}
+
+// RenameOrg renames an organization in GitHub Enterprise.
+//
+// GitHub Enterprise API docs: https://developer.github.com/enterprise/v3/enterprise-admin/orgs/#rename-an-organization
+func (s *AdminService) RenameOrg(ctx context.Context, org *Organization, newName string) (*RenameOrgResponse, *Response, error) {
+	return s.RenameOrgByName(ctx, *org.Login, newName)
+}
+
+// RenameOrgByName renames an organization in GitHub Enterprise using its current name.
+//
+// GitHub Enterprise API docs: https://developer.github.com/enterprise/v3/enterprise-admin/orgs/#rename-an-organization
+func (s *AdminService) RenameOrgByName(ctx context.Context, org, newName string) (*RenameOrgResponse, *Response, error) {
+	u := fmt.Sprintf("admin/organizations/%v", org)
+
+	orgReq := &renameOrgRequest{
+		Login: &newName,
+	}
+
+	req, err := s.client.NewRequest("PATCH", u, orgReq)
+	if err != nil {
+		return nil, nil, err
+	}
+
+	o := new(RenameOrgResponse)
+	resp, err := s.client.Do(ctx, req, o)
+	if err != nil {
+		return nil, resp, err
+	}
+
+	return o, resp, nil
+}

github/admin_orgs_test.go

@@ -45,3 +45,63 @@ func TestAdminOrgs_Create(t *testing.T) {
 		t.Errorf("Admin.CreateOrg returned %+v, want %+v", org, want)
 	}
 }
+
+func TestAdminOrgs_Rename(t *testing.T) {
+	client, mux, _, teardown := setup()
+	defer teardown()
+
+	input := &Organization{
+		Login: String("o"),
+	}
+
+	mux.HandleFunc("/admin/organizations/o", func(w http.ResponseWriter, r *http.Request) {
+		v := new(renameOrgRequest)
+		json.NewDecoder(r.Body).Decode(v)
+
+		testMethod(t, r, "PATCH")
+		want := &renameOrgRequest{Login: String("the-new-octocats")}
+		if !reflect.DeepEqual(v, want) {
+			t.Errorf("Request body = %+v, want %+v", v, want)
+		}
+
+		fmt.Fprint(w, `{"message":"Job queued to rename organization. It may take a few minutes to complete.","url":"https://<hostname>/api/v3/organizations/1"}`)
+	})
+
+	resp, _, err := client.Admin.RenameOrg(context.Background(), input, "the-new-octocats")
+	if err != nil {
+		t.Errorf("Admin.RenameOrg returned error: %v", err)
+	}
+
+	want := &RenameOrgResponse{Message: String("Job queued to rename organization. It may take a few minutes to complete."), URL: String("https://<hostname>/api/v3/organizations/1")}
+	if !reflect.DeepEqual(resp, want) {
+		t.Errorf("Admin.RenameOrg returned %+v, want %+v", resp, want)
+	}
+}
+
+func TestAdminOrgs_RenameByName(t *testing.T) {
+	client, mux, _, teardown := setup()
+	defer teardown()
+
+	mux.HandleFunc("/admin/organizations/o", func(w http.ResponseWriter, r *http.Request) {
+		v := new(renameOrgRequest)
+		json.NewDecoder(r.Body).Decode(v)
+
+		testMethod(t, r, "PATCH")
+		want := &renameOrgRequest{Login: String("the-new-octocats")}
+		if !reflect.DeepEqual(v, want) {
+			t.Errorf("Request body = %+v, want %+v", v, want)
+		}
+
+		fmt.Fprint(w, `{"message":"Job queued to rename organization. It may take a few minutes to complete.","url":"https://<hostname>/api/v3/organizations/1"}`)
+	})
+
+	resp, _, err := client.Admin.RenameOrgByName(context.Background(), "o", "the-new-octocats")
+	if err != nil {
+		t.Errorf("Admin.RenameOrg returned error: %v", err)
+	}
+
+	want := &RenameOrgResponse{Message: String("Job queued to rename organization. It may take a few minutes to complete."), URL: String("https://<hostname>/api/v3/organizations/1")}
+	if !reflect.DeepEqual(resp, want) {
+		t.Errorf("Admin.RenameOrg returned %+v, want %+v", resp, want)
+	}
+}