iframe-proxy | Sunbelt Computer Software

229 lines (200 loc) · 6.33 KB
package codersdk
	"encoding/json"
	"net/http"
	"github.com/google/uuid"
	"golang.org/x/xerrors"
type GroupSource string
	GroupSourceUser GroupSource = "user"
	GroupSourceOIDC GroupSource = "oidc"
type CreateGroupRequest struct {
	Name           string `json:"name" validate:"required,group_name"`
	DisplayName    string `json:"display_name" validate:"omitempty,group_display_name"`
	AvatarURL      string `json:"avatar_url"`
	QuotaAllowance int    `json:"quota_allowance"`
type Group struct {
	ID             uuid.UUID     `json:"id" format:"uuid"`
	Name           string        `json:"name"`
	DisplayName    string        `json:"display_name"`
	OrganizationID uuid.UUID     `json:"organization_id" format:"uuid"`
	Members        []ReducedUser `json:"members"`
	// How many members are in this group. Shows the total count,
	// even if the user is not authorized to read group member details.
	// May be greater than `len(Group.Members)`.
	TotalMemberCount        int         `json:"total_member_count"`
	AvatarURL               string      `json:"avatar_url" format:"uri"`
	QuotaAllowance          int         `json:"quota_allowance"`
	Source                  GroupSource `json:"source"`
	OrganizationName        string      `json:"organization_name"`
	OrganizationDisplayName string      `json:"organization_display_name"`
type GroupMembersResponse struct {
	Users []ReducedUser `json:"users"`
	Count int           `json:"count"`
func (g Group) IsEveryone() bool {
	return g.ID == g.OrganizationID
func (c *Client) CreateGroup(ctx context.Context, orgID uuid.UUID, req CreateGroupRequest) (Group, error) {
	res, err := c.Request(ctx, http.MethodPost,
		fmt.Sprintf("/api/v2/organizations/%s/groups", orgID.String()),
	if err != nil {
		return Group{}, xerrors.Errorf("make request: %w", err)
	defer res.Body.Close()
	if res.StatusCode != http.StatusCreated {
		return Group{}, ReadBodyAsError(res)
	var resp Group
	return resp, json.NewDecoder(res.Body).Decode(&resp)
// GroupsByOrganization
// Deprecated: use Groups with GroupArguments instead.
func (c *Client) GroupsByOrganization(ctx context.Context, orgID uuid.UUID) ([]Group, error) {
	return c.Groups(ctx, GroupArguments{Organization: orgID.String()})
type GroupArguments struct {
	// Organization can be an org UUID or name
	Organization string
	// HasMember can be a user uuid or username
	HasMember string
	// GroupIDs is a list of group UUIDs to filter by.
	// If not set, all groups will be returned.
	GroupIDs []uuid.UUID
func (c *Client) Groups(ctx context.Context, args GroupArguments) ([]Group, error) {
	qp := url.Values{}
	if args.Organization != "" {
		qp.Set("organization", args.Organization)
	if args.HasMember != "" {
		qp.Set("has_member", args.HasMember)
	if len(args.GroupIDs) > 0 {
		idStrs := make([]string, 0, len(args.GroupIDs))
		for _, id := range args.GroupIDs {
			idStrs = append(idStrs, id.String())
		qp.Set("group_ids", strings.Join(idStrs, ","))
	res, err := c.Request(ctx, http.MethodGet,
		fmt.Sprintf("/api/v2/groups?%s", qp.Encode()),
	if err != nil {
		return nil, xerrors.Errorf("make request: %w", err)
	defer res.Body.Close()
	if res.StatusCode != http.StatusOK {
		return nil, ReadBodyAsError(res)
	var groups []Group
	return groups, json.NewDecoder(res.Body).Decode(&groups)
func (c *Client) GroupByOrgAndName(ctx context.Context, orgID uuid.UUID, name string) (Group, error) {
	res, err := c.Request(ctx, http.MethodGet,
		fmt.Sprintf("/api/v2/organizations/%s/groups/%s", orgID.String(), name),
	if err != nil {
		return Group{}, xerrors.Errorf("make request: %w", err)
	defer res.Body.Close()
	if res.StatusCode != http.StatusOK {
		return Group{}, ReadBodyAsError(res)
	var resp Group
	return resp, json.NewDecoder(res.Body).Decode(&resp)
type GroupRequest struct {
	ExcludeMembers bool `json:"exclude_members"`
func (p GroupRequest) asRequestOption() RequestOption {
	return func(r *http.Request) {
		q := r.URL.Query()
		if p.ExcludeMembers {
			q.Set("exclude_members", "true")
		r.URL.RawQuery = q.Encode()
func (c *Client) Group(ctx context.Context, group uuid.UUID, req GroupRequest) (Group, error) {
	res, err := c.Request(ctx, http.MethodGet,
		fmt.Sprintf("/api/v2/groups/%s", group.String()),
		req.asRequestOption(),
	if err != nil {
		return Group{}, xerrors.Errorf("make request: %w", err)
	defer res.Body.Close()
	if res.StatusCode != http.StatusOK {
		return Group{}, ReadBodyAsError(res)
	var resp Group
	return resp, json.NewDecoder(res.Body).Decode(&resp)
func (c *Client) GroupMembers(ctx context.Context, group uuid.UUID, req UsersRequest) (GroupMembersResponse, error) {
	res, err := c.Request(ctx, http.MethodGet,
		fmt.Sprintf("/api/v2/groups/%s/members", group.String()),
		req.Pagination.asRequestOption(),
		req.asRequestOption(),
	if err != nil {
		return GroupMembersResponse{}, xerrors.Errorf("make request: %w", err)
	defer res.Body.Close()
	if res.StatusCode != http.StatusOK {
		return GroupMembersResponse{}, ReadBodyAsError(res)
	var resp GroupMembersResponse
	return resp, json.NewDecoder(res.Body).Decode(&resp)
type PatchGroupRequest struct {
	AddUsers       []string `json:"add_users"`
	RemoveUsers    []string `json:"remove_users"`
	Name           string   `json:"name" validate:"omitempty,group_name"`
	DisplayName    *string  `json:"display_name" validate:"omitempty,group_display_name"`
	AvatarURL      *string  `json:"avatar_url"`
	QuotaAllowance *int     `json:"quota_allowance"`
func (c *Client) PatchGroup(ctx context.Context, group uuid.UUID, req PatchGroupRequest) (Group, error) {
	res, err := c.Request(ctx, http.MethodPatch,
		fmt.Sprintf("/api/v2/groups/%s", group.String()),
	if err != nil {
		return Group{}, xerrors.Errorf("make request: %w", err)
	defer res.Body.Close()
	if res.StatusCode != http.StatusOK {
		return Group{}, ReadBodyAsError(res)
	var resp Group
	return resp, json.NewDecoder(res.Body).Decode(&resp)
func (c *Client) DeleteGroup(ctx context.Context, group uuid.UUID) error {
	res, err := c.Request(ctx, http.MethodDelete,
		fmt.Sprintf("/api/v2/groups/%s", group.String()),
	if err != nil {
		return xerrors.Errorf("make request: %w", err)
	defer res.Body.Close()
	if res.StatusCode != http.StatusOK {
		return ReadBodyAsError(res)
	return nil
Sunbelt Computer Software

PL/B Language Development and Support

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Sunbelt Computer Software

PL/B Language Development and Support

Uh oh!

FilesExpand file tree

groups.go

Latest commit

History

groups.go

File metadata and controls
