cmd

Documentation

Index

• Constants
• func AddCommonQueryFlag(flags *pflag.FlagSet, parameters *query.Parameters)
• func AddFormatFlag(flags *pflag.FlagSet)
• func AddFormatFlagDefault(flags *pflag.FlagSet, defValue string)
• func AddModeFlag(flags *pflag.FlagSet, defValue string)
• func AddQueryingFlags(flags *pflag.FlagSet, parameters *query.Parameters)
• func AddSupportedEnvironmentFlag(flags *pflag.FlagSet, parameters *query.Parameters, description string)
• func BuildRootCommand(ctx *Context) *cobra.Command
• func CommonConfirmationPrompt(message string, ctx *Context, input io.Reader) (bool, error)
• func CommonHandleAsyncExecution(ctx *Context, location string, message string)
• func CommonPrepare(cmd Command, ctx *Context) func(*cobra.Command, []string) error
• func CommonPrintDeclineMessage(wr io.Writer)
• func Execute(cmd *cobra.Command)
• func RunE(cmd Command) func(*cobra.Command, []string) error
• func SmPrepare(cmd Command, ctx *Context) func(*cobra.Command, []string) error
• type Command
• type CommandPreparator
• type ConfirmedCommand
• type Context
• type FormattedCommand
• type Group
• type HiddenUsageCommand
• type PrepareFunc
• type ValidatedCommand

Constants

const FOUND_TOO_MANY_INSTANCES = "Found more than one instance with the name \"%s\". Use the --id flag to specify which instance to %s."

const INSTANCE_ID_DESCRIPTION = "The instance ID. Required if there is more than one instance with the same name."

const NO_INSTANCES_FOUND = "Couldn't find an instance with the name \"%s\"."

Functions

func AddCommonQueryFlag

func AddCommonQueryFlag(flags *pflag.FlagSet, parameters *query.Parameters)

AddCommonQueryFlag adds the CLI param that provides general query parameters

func AddFormatFlag

func AddFormatFlag(flags *pflag.FlagSet)

AddFormatFlag adds the --output (-o) flag.

func AddFormatFlagDefault

func AddFormatFlagDefault(flags *pflag.FlagSet, defValue string)

AddFormatFlagDefault is same as AddFormatFlag but allows to set default value.

func AddModeFlag

func AddModeFlag(flags *pflag.FlagSet, defValue string)

AddModeFlag adds the --mode flag for SM calls.

func AddQueryingFlags

func AddQueryingFlags(flags *pflag.FlagSet, parameters *query.Parameters)

AddQueryingFlags adds --field-query (-f) and --label-query (-l) flags

func AddSupportedEnvironmentFlag

func AddSupportedEnvironmentFlag(flags *pflag.FlagSet, parameters *query.Parameters, description string)

func BuildRootCommand

func BuildRootCommand(ctx *Context) *cobra.Command

BuildRootCommand builds a new SM root command with context

func CommonConfirmationPrompt

func CommonConfirmationPrompt(message string, ctx *Context, input io.Reader) (bool, error)

CommonConfirmationPrompt provides common logic for confirmation of an operation

func CommonHandleAsyncExecution

func CommonHandleAsyncExecution(ctx *Context, location string, message string)

CommonHandleAsyncExecution handles async execution of SM calls

func CommonPrepare

func CommonPrepare(cmd Command, ctx *Context) func(*cobra.Command, []string) error

CommonPrepare provides common pre-run logic for SM commands

func CommonPrintDeclineMessage

func CommonPrintDeclineMessage(wr io.Writer)

CommonPrintDeclineMessage provides common confirmation declined message

func Execute

func Execute(cmd *cobra.Command)

Execute executes the root command

func RunE

func RunE(cmd Command) func(*cobra.Command, []string) error

RunE provides common run logic for SM commands

func SmPrepare

func SmPrepare(cmd Command, ctx *Context) func(*cobra.Command, []string) error

SmPrepare creates a SM client for SM commands

Types

type Command

type Command interface {
	Run() error
}

Command provides common logic for SM commands

type CommandPreparator

type CommandPreparator interface {
	Prepare(PrepareFunc) *cobra.Command
}

CommandPreparator used to wrap CLI commands

type ConfirmedCommand

type ConfirmedCommand interface {
	// AskForConfirmation asks user to confirm the execution of desired operation
	AskForConfirmation() (bool, error)
	// PrintDeclineMessage prints message to the user if the confirmation is declined
	PrintDeclineMessage()
}

ConfirmedCommand should be implemented if the command should ask for user confirmation prior execution

type Context

type Context struct {
	Ctx context.Context

	// Output should be used when printing in commands, instead of directly writing to stdout/stderr, to enable unit testing.
	Output io.Writer

	Client smclient.Client

	Verbose bool

	Configuration configuration.Configuration

	Parameters query.Parameters
}

Context is used as a context for the commands

type FormattedCommand

type FormattedCommand interface {
	// SetOutputFormat sets the command's output format
	SetOutputFormat(output.Format)
}

FormattedCommand should be implemented if the command supports different output formatting through a --format or -f flag

type Group

type Group struct {
	PrepareFn PrepareFunc
	Commands  []CommandPreparator
}

Group contains commands which have common prepare function

type HiddenUsageCommand

type HiddenUsageCommand interface {
	// HideUsage returns true when usage should be hidden and false otherwise
	HideUsage() bool
}

HiddenUsageCommand should be implemented if the command should not print its usage

type PrepareFunc

type PrepareFunc func(cmd Command, ctx *Context) func(*cobra.Command, []string) error

PrepareFunc is function type which executes common prepare logic for commands

type ValidatedCommand

type ValidatedCommand interface {
	// Validate command usage in the implementation of this method
	Validate([]string) error
}

ValidatedCommand should be implemented if the command will have validation