boundary/internal/cmd/commands/groups/funcs.go

package groups

import (
	"fmt"
	"strings"
	"time"

	"github.com/hashicorp/boundary/api/groups"
	"github.com/hashicorp/boundary/internal/cmd/base"
	"github.com/hashicorp/boundary/internal/cmd/common"
	"github.com/hashicorp/boundary/internal/types/resource"
	"github.com/mitchellh/go-wordwrap"
)

func memberSynopsisFunc(inFunc string) string {
	var in string
	switch {
	case strings.HasPrefix(inFunc, "add"):
		in = "Add users to"
	case strings.HasPrefix(inFunc, "set"):
		in = "Set the full contents of the users on"
	case strings.HasPrefix(inFunc, "remove"):
		in = "Remove users from"
	}
	return wordwrap.WrapString(fmt.Sprintf("%s a group within Boundary", in), base.TermWidth)
}

func addMembersHelp() string {
	return base.WrapForHelpText([]string{
		"Usage: boundary groups add-members [options] [args]",
		"",
		`  Adds members (users) to a group given its ID. The "user" flag can be specified multiple times. Example:`,
		"",
		`    $ boundary groups add-members -id g_1234567890 -user u_1234567890`,
	})
}

func setMembersHelp() string {
	return base.WrapForHelpText([]string{
		"Usage: boundary groups set-members [options] [args]",
		"",
		`  Sets the complete set of members (users) on a group given its ID. The "user" flag can be specified multiple times. Example:`,
		"",
		`    $ boundary groups set-principals -id g_1234567890 -user u_anon -user u_1234567890`,
	})
}

func removeMembersHelp() string {
	return base.WrapForHelpText([]string{
		"Usage: boundary groups remove-members [options] [args]",
		"",
		`  Removes members (users) from a group given its ID. The "user" flag can be specified multiple times. Example:`,
		"",
		`    $ boundary groups remove-members -id g_1234567890 -user u_1234567890`,
	})
}

func populateFlags(c *Command, f *base.FlagSet, flagNames []string) {
	common.PopulateCommonFlags(c.Command, f, resource.Group.String(), flagNames)

	for _, name := range flagNames {
		switch name {
		case "member":
			f.StringSliceVar(&base.StringSliceVar{
				Name:   "member",
				Target: &c.flagMembers,
				Usage:  "The members (users) to add, remove, or set. May be specified multiple times.",
			})
		}
	}
}

func generateGroupTableOutput(in *groups.Group) string {
	nonAttributeMap := map[string]interface{}{
		"ID":           in.Id,
		"Version":      in.Version,
		"Created Time": in.CreatedTime.Local().Format(time.RFC1123),
		"Updated Time": in.UpdatedTime.Local().Format(time.RFC1123),
	}

	if in.Name != "" {
		nonAttributeMap["Name"] = in.Name
	}
	if in.Description != "" {
		nonAttributeMap["Description"] = in.Description
	}

	maxLength := base.MaxAttributesLength(nonAttributeMap, nil, nil)

	var groupMaps []map[string]interface{}
	if len(in.Members) > 0 {
		for _, member := range in.Members {
			m := map[string]interface{}{
				"ID":       member.Id,
				"Scope ID": member.ScopeId,
			}
			groupMaps = append(groupMaps, m)
		}
		if l := len("Scope ID"); l > maxLength {
			maxLength = l
		}
	}

	ret := []string{
		"",
		"Group information:",
		base.WrapMap(2, maxLength+2, nonAttributeMap),
		"  Scope:",
		base.ScopeInfoForOutput(in.Scope, maxLength),
	}

	if len(in.Members) > 0 {
		ret = append(ret,
			"",
			"  Members:",
		)
		for _, m := range groupMaps {
			ret = append(ret,
				base.WrapMap(4, maxLength, m),
				"",
			)
		}
	}

	return base.WrapForHelpText(ret)
}