command

Documentation

Overview

Package command should not be imported by external consumers. It was not designed for external use.

Index

• Constants
• func CheckVersionOutdated(current string, minimum string) (bool, error)
• func DisplayNotLoggedInText(binaryName string, ui UI)
• func MinimumCCAPIVersionCheck(current string, minimum string, customCommand ...string) error
• func MinimumUAAAPIVersionCheck(current string, minimum string, customCommand ...string) error
• func WarnIfAPIVersionBelowSupportedMinimum(apiVersion string, ui UI) error
• func WarnIfCLIVersionBelowAPIDefinedMinimum(config Config, apiVersion string, ui UI) error
• type APIVersionTooHighError
  • func (a APIVersionTooHighError) Error() string
• type Config
• type ExtendedCommander
• type SharedActor
• type UI

Constants

const ExperimentalWarning = "This command is in EXPERIMENTAL stage and may change without notice"

Functions

func CheckVersionOutdated

func CheckVersionOutdated(current string, minimum string) (bool, error)

func DisplayNotLoggedInText

func DisplayNotLoggedInText(binaryName string, ui UI)

func MinimumCCAPIVersionCheck

func MinimumCCAPIVersionCheck(current string, minimum string, customCommand ...string) error

func MinimumUAAAPIVersionCheck

func MinimumUAAAPIVersionCheck(current string, minimum string, customCommand ...string) error

func WarnIfAPIVersionBelowSupportedMinimum

func WarnIfAPIVersionBelowSupportedMinimum(apiVersion string, ui UI) error

func WarnIfCLIVersionBelowAPIDefinedMinimum

func WarnIfCLIVersionBelowAPIDefinedMinimum(config Config, apiVersion string, ui UI) error

Types

type APIVersionTooHighError

type APIVersionTooHighError struct{}

func (APIVersionTooHighError) Error

func (a APIVersionTooHighError) Error() string

type Config

type Config interface {
	AccessToken() string
	AddPlugin(configv3.Plugin)
	AddPluginRepository(name string, url string)
	AuthorizationEndpoint() string
	APIVersion() string
	B3TraceID() string
	BinaryName() string
	BinaryVersion() string
	CFPassword() string
	CFUsername() string
	ColorEnabled() configv3.ColorSetting
	CurrentUser() (configv3.User, error)
	CurrentUserName() (string, error)
	DialTimeout() time.Duration
	DockerPassword() string
	CNBCredentials() (map[string]interface{}, error)
	Experimental() bool
	GetPlugin(pluginName string) (configv3.Plugin, bool)
	GetPluginCaseInsensitive(pluginName string) (configv3.Plugin, bool)
	HasTargetedOrganization() bool
	HasTargetedSpace() bool
	IsTTY() bool
	Locale() string
	LogCacheEndpoint() string
	MinCLIVersion() string
	NOAARequestRetryCount() int
	NetworkPolicyV1Endpoint() string
	OverallPollingTimeout() time.Duration
	PluginHome() string
	PluginRepositories() []configv3.PluginRepository
	Plugins() []configv3.Plugin
	PollingInterval() time.Duration
	RefreshToken() string
	RemovePlugin(string)
	RequestRetryCount() int
	RoutingEndpoint() string
	SetAsyncTimeout(timeout int)
	SetAccessToken(token string)
	SetColorEnabled(enabled string)
	SetLocale(locale string)
	SetMinCLIVersion(version string)
	SetOrganizationInformation(guid string, name string)
	SetRefreshToken(token string)
	SetSpaceInformation(guid string, name string, allowSSH bool)
	V7SetSpaceInformation(guid string, name string)
	SetTargetInformation(args configv3.TargetInformationArgs)
	SetTokenInformation(accessToken string, refreshToken string, sshOAuthClient string)
	SetTrace(trace string)
	SetUAAClientCredentials(client string, clientSecret string)
	SetUAAEndpoint(uaaEndpoint string)
	SetUAAGrantType(uaaGrantType string)
	SkipSSLValidation() bool
	SSHOAuthClient() string
	StagingTimeout() time.Duration
	StartupTimeout() time.Duration
	// TODO: Rename to APITarget()
	Target() string
	TargetedOrganization() configv3.Organization
	TargetedOrganizationName() string
	TargetedSpace() configv3.Space
	TerminalWidth() int
	UAADisableKeepAlives() bool
	UAAEndpoint() string
	UAAGrantType() string
	UAAOAuthClient() string
	UAAOAuthClientSecret() string
	UnsetOrganizationAndSpaceInformation()
	UnsetSpaceInformation()
	UnsetUserInformation()
	Verbose() (bool, []string)
	WritePluginConfig() error
	WriteConfig() error
	IsCFOnK8s() bool
	SetKubernetesAuthInfo(authInfo string)
}

Config a way of getting basic CF configuration

type ExtendedCommander

type ExtendedCommander interface {
	flags.Commander
	Setup(Config, UI) error
}

ExtendedCommander extends the go-flags Command interface by forcing a Setup function on all commands. This setup function should setup all command dependencies.

type SharedActor

type SharedActor interface {
	IsLoggedIn() bool
	IsSpaceTargeted() bool
	IsOrgTargeted() bool

	CheckTarget(targetedOrganizationRequired bool, targetedSpaceRequired bool) error
	RequireCurrentUser() (string, error)
	RequireTargetedOrg() (string, error)
}

type UI

type UI interface {
	DeferText(template string, data ...map[string]interface{})
	DisplayBoolPrompt(defaultResponse bool, template string, templateValues ...map[string]interface{}) (bool, error)
	DisplayChangesForPush(changeSet []ui.Change) error
	DisplayDeprecationWarning()
	DisplayDiffAddition(line string, depth int, addHyphen bool)
	DisplayDiffRemoval(line string, depth int, addHyphen bool)
	DisplayDiffUnchanged(line string, depth int, addHyphen bool)
	DisplayError(err error)
	DisplayFileDeprecationWarning()
	DisplayHeader(text string)
	DisplayInstancesTableForApp(table [][]string)
	DisplayJSON(name string, jsonData interface{}) error
	DisplayKeyValueTable(prefix string, table [][]string, padding int)
	DisplayKeyValueTableForApp(table [][]string)
	DisplayLogMessage(message ui.LogMessage, displayHeader bool)
	DisplayNewline()
	DisplayNonWrappingTable(prefix string, table [][]string, padding int)
	DisplayOK()
	DisplayOptionalTextPrompt(defaultValue string, template string, templateValues ...map[string]interface{}) (string, error)
	DisplayPasswordPrompt(template string, templateValues ...map[string]interface{}) (string, error)
	DisplayTableWithHeader(prefix string, table [][]string, padding int)
	DisplayText(template string, data ...map[string]interface{})
	DisplayTextLiteral(text string)
	DisplayTextMenu(choices []string, promptTemplate string, templateValues ...map[string]interface{}) (string, error)
	DisplayTextPrompt(template string, templateValues ...map[string]interface{}) (string, error)
	DisplayTextWithBold(text string, keys ...map[string]interface{})
	DisplayTextWithFlavor(text string, keys ...map[string]interface{})
	DisplayWarning(formattedString string, keys ...map[string]interface{})
	DisplayWarnings(warnings []string)
	GetErr() io.Writer
	GetIn() io.Reader
	GetOut() io.Writer
	RequestLoggerFileWriter(filePaths []string) *ui.RequestLoggerFileWriter
	RequestLoggerTerminalDisplay() *ui.RequestLoggerTerminalDisplay
	TranslateText(template string, data ...map[string]interface{}) string
	UserFriendlyDate(input time.Time) string
	Writer() io.Writer
}

UI is the interface to STDOUT, STDERR, and STDIN.