package cli

import "github.com/docker/cli/cli"

Index ¶

• func DisableFlagsInUseLine(cmd *cobra.Command)
• func ExactArgs(number int) cobra.PositionalArgs
• func FlagErrorFunc(cmd *cobra.Command, err error) error
• func HasCompletionArg(args []string) bool
• func NoArgs(cmd *cobra.Command, args []string) error
• func RequiresMaxArgs(maxArgs int) cobra.PositionalArgs
• func RequiresMinArgs(minArgs int) cobra.PositionalArgs
• func RequiresRangeArgs(minArgs int, maxArgs int) cobra.PositionalArgs
• func SetupPluginRootCommand(rootCmd *cobra.Command) (*cliflags.ClientOptions, *pflag.FlagSet)
• func SetupRootCommand(rootCmd *cobra.Command) (opts *cliflags.ClientOptions, helpCmd *cobra.Command)
• func VisitAll(root *cobra.Command, fn func(*cobra.Command))
• type Errors
• func (errList Errors) Error() string
• type StatusError
• func (e StatusError) Error() string
• type TopLevelCommand
• func NewTopLevelCommand(cmd *cobra.Command, dockerCli *command.DockerCli, opts *cliflags.ClientOptions, flags *pflag.FlagSet) *TopLevelCommand
• func (tcmd *TopLevelCommand) HandleGlobalFlags() (*cobra.Command, []string, error)
• func (tcmd *TopLevelCommand) Initialize(ops ...command.CLIOption) error
• func (tcmd *TopLevelCommand) SetArgs(args []string)
• func (tcmd *TopLevelCommand) SetFlag(name, value string)

Functions ¶

func DisableFlagsInUseLine ¶

func DisableFlagsInUseLine(cmd *cobra.Command)

DisableFlagsInUseLine sets the DisableFlagsInUseLine flag on all commands within the tree rooted at cmd.

func ExactArgs ¶

func ExactArgs(number int) cobra.PositionalArgs

ExactArgs returns an error if there is not the exact number of args

func FlagErrorFunc ¶

func FlagErrorFunc(cmd *cobra.Command, err error) error

FlagErrorFunc prints an error message which matches the format of the docker/cli/cli error messages

func HasCompletionArg ¶

func HasCompletionArg(args []string) bool

HasCompletionArg returns true if a cobra completion arg request is found.

func NoArgs ¶

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

NoArgs validates args and returns an error if there are any args

func RequiresMaxArgs ¶

func RequiresMaxArgs(maxArgs int) cobra.PositionalArgs

RequiresMaxArgs returns an error if there is not at most max args

func RequiresMinArgs ¶

func RequiresMinArgs(minArgs int) cobra.PositionalArgs

RequiresMinArgs returns an error if there is not at least min args

func RequiresRangeArgs ¶

func RequiresRangeArgs(minArgs int, maxArgs int) cobra.PositionalArgs

RequiresRangeArgs returns an error if there is not at least min args and at most max args

func SetupPluginRootCommand ¶

func SetupPluginRootCommand(rootCmd *cobra.Command) (*cliflags.ClientOptions, *pflag.FlagSet)

SetupPluginRootCommand sets default usage, help and error handling for a plugin root command.

func SetupRootCommand ¶

func SetupRootCommand(rootCmd *cobra.Command) (opts *cliflags.ClientOptions, helpCmd *cobra.Command)

SetupRootCommand sets default usage, help, and error handling for the root command.

func VisitAll ¶

func VisitAll(root *cobra.Command, fn func(*cobra.Command))

VisitAll will traverse all commands from the root. This is different from the VisitAll of cobra.Command where only parents are checked.

Types ¶

type Errors ¶

type Errors []error

Errors is a list of errors. Useful in a loop if you don't want to return the error right away and you want to display after the loop, all the errors that happened during the loop.

Deprecated: use errors.Join instead; will be removed in the next release.

func (Errors) Error ¶

func (errList Errors) Error() string

type StatusError ¶

type StatusError struct {
	Status     string
	StatusCode int
}

StatusError reports an unsuccessful exit by a command.

func (StatusError) Error ¶

func (e StatusError) Error() string

type TopLevelCommand ¶

type TopLevelCommand struct {
	// contains filtered or unexported fields
}

TopLevelCommand encapsulates a top-level cobra command (either docker CLI or a plugin) and global flag handling logic necessary for plugins.

func NewTopLevelCommand ¶

func NewTopLevelCommand(cmd *cobra.Command, dockerCli *command.DockerCli, opts *cliflags.ClientOptions, flags *pflag.FlagSet) *TopLevelCommand

NewTopLevelCommand returns a new TopLevelCommand object

func (*TopLevelCommand) HandleGlobalFlags ¶

func (tcmd *TopLevelCommand) HandleGlobalFlags() (*cobra.Command, []string, error)

HandleGlobalFlags takes care of parsing global flags defined on the command, it returns the underlying cobra command and the args it will be called with (or an error).

On success the caller is responsible for calling Initialize() before calling `Execute` on the returned command.

func (*TopLevelCommand) Initialize ¶

func (tcmd *TopLevelCommand) Initialize(ops ...command.CLIOption) error

Initialize finalises global option parsing and initializes the docker client.

func (*TopLevelCommand) SetArgs ¶

func (tcmd *TopLevelCommand) SetArgs(args []string)

SetArgs sets the args (default os.Args[:1] used to invoke the command

func (*TopLevelCommand) SetFlag ¶

func (tcmd *TopLevelCommand) SetFlag(name, value string)

SetFlag sets a flag in the local flag set of the top-level command

Source Files ¶

cobra.go error.go required.go

Directories ¶