mirror of
https://github.com/interviewstreet/go-jira.git
synced 2024-11-30 08:47:11 +02:00
131 lines
3.7 KiB
Go
131 lines
3.7 KiB
Go
package jira
|
|
|
|
import (
|
|
"fmt"
|
|
)
|
|
|
|
// GroupService handles Groups for the JIRA instance / API.
|
|
//
|
|
// JIRA API docs: https://docs.atlassian.com/jira/REST/server/#api/2/group
|
|
type GroupService struct {
|
|
client *Client
|
|
}
|
|
|
|
// groupMembersResult is only a small wrapper around the Group* methods
|
|
// to be able to parse the results
|
|
type groupMembersResult struct {
|
|
StartAt int `json:"startAt"`
|
|
MaxResults int `json:"maxResults"`
|
|
Total int `json:"total"`
|
|
Members []GroupMember `json:"values"`
|
|
IsLast bool `json:"isLast"`
|
|
NextPage string `json:"nextPage"`
|
|
}
|
|
|
|
// Group represents a JIRA group
|
|
type Group struct {
|
|
ID string `json:"id"`
|
|
Title string `json:"title"`
|
|
Type string `json:"type"`
|
|
Properties groupProperties `json:"properties"`
|
|
AdditionalProperties bool `json:"additionalProperties"`
|
|
}
|
|
|
|
type groupProperties struct {
|
|
Name groupPropertiesName `json:"name"`
|
|
}
|
|
|
|
type groupPropertiesName struct {
|
|
Type string `json:"type"`
|
|
}
|
|
|
|
// GroupMember reflects a single member of a group
|
|
type GroupMember struct {
|
|
Self string `json:"self,omitempty"`
|
|
Name string `json:"name,omitempty"`
|
|
Key string `json:"key,omitempty"`
|
|
EmailAddress string `json:"emailAddress,omitempty"`
|
|
DisplayName string `json:"displayName,omitempty"`
|
|
Active bool `json:"active,omitempty"`
|
|
TimeZone string `json:"timeZone,omitempty"`
|
|
}
|
|
|
|
// Get returns a paginated list of users who are members of the specified group and its subgroups.
|
|
// Users in the page are ordered by user names.
|
|
// User of this resource is required to have sysadmin or admin permissions.
|
|
//
|
|
// JIRA API docs: https://docs.atlassian.com/jira/REST/server/#api/2/group-getUsersFromGroup
|
|
func (s *GroupService) Get(name string) ([]GroupMember, *Response, error) {
|
|
apiEndpoint := fmt.Sprintf("/rest/api/2/group/member?groupname=%s", name)
|
|
req, err := s.client.NewRequest("GET", apiEndpoint, nil)
|
|
if err != nil {
|
|
return nil, nil, err
|
|
}
|
|
|
|
group := new(groupMembersResult)
|
|
resp, err := s.client.Do(req, group)
|
|
if err != nil {
|
|
return nil, resp, err
|
|
}
|
|
|
|
result := group.Members
|
|
for group.IsLast != true {
|
|
apiEndpoint = group.NextPage
|
|
req, err = s.client.NewRequest("GET", apiEndpoint, nil)
|
|
if err != nil {
|
|
return nil, nil, err
|
|
}
|
|
|
|
group = new(groupMembersResult)
|
|
resp, err = s.client.Do(req, group)
|
|
if err != nil {
|
|
return nil, resp, err
|
|
}
|
|
result = append(result, group.Members...)
|
|
}
|
|
return result, resp, nil
|
|
}
|
|
|
|
// Add adds user to group
|
|
//
|
|
// JIRA API docs: https://docs.atlassian.com/jira/REST/cloud/#api/2/group-addUserToGroup
|
|
func (s *GroupService) Add(groupname string, username string) (*Group, *Response, error) {
|
|
apiEndpoint := fmt.Sprintf("/rest/api/2/group/user?groupname=%s", groupname)
|
|
var user struct {
|
|
Name string `json:"name"`
|
|
}
|
|
user.Name = username
|
|
req, err := s.client.NewRequest("POST", apiEndpoint, &user)
|
|
if err != nil {
|
|
return nil, nil, err
|
|
}
|
|
|
|
responseGroup := new(Group)
|
|
resp, err := s.client.Do(req, responseGroup)
|
|
if err != nil {
|
|
jerr := NewJiraError(resp, err)
|
|
return nil, resp, jerr
|
|
}
|
|
|
|
return responseGroup, resp, nil
|
|
}
|
|
|
|
// Remove removes user from group
|
|
//
|
|
// JIRA API docs: https://docs.atlassian.com/jira/REST/cloud/#api/2/group-removeUserFromGroup
|
|
func (s *GroupService) Remove(groupname string, username string) (*Response, error) {
|
|
apiEndpoint := fmt.Sprintf("/rest/api/2/group/user?groupname=%s&username=%s", groupname, username)
|
|
req, err := s.client.NewRequest("DELETE", apiEndpoint, nil)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
resp, err := s.client.Do(req, nil)
|
|
if err != nil {
|
|
jerr := NewJiraError(resp, err)
|
|
return resp, jerr
|
|
}
|
|
|
|
return resp, nil
|
|
}
|