cli

Documentation

Overview

Package cli provides tools to create commands that support advanced configuration features, sub-commands, and allowing configuration from command-line flags, configuration files, and environment variables.

Index

• func Execute(cmd *Command) error
• func GetConfigFile(loaders []ResourceLoader) string
• func PrintHelp(w io.Writer, cmd *Command) error
• type Command
  • func (c *Command) AddCommand(cmd *Command) error
• type EnvLoader
  • func (e *EnvLoader) Load(_ []string, cmd *Command) (bool, error)
• type FileLoader
  • func (f *FileLoader) GetFilename() string
  • func (f *FileLoader) Load(args []string, cmd *Command) (bool, error)
• type Finder
  • func (f Finder) Find(configFile string) (string, error)
• type FlagLoader
  • func (*FlagLoader) Load(args []string, cmd *Command) (bool, error)
• type ResourceLoader

Functions

func Execute

func Execute(cmd *Command) error

Execute Executes a command.

func GetConfigFile

func GetConfigFile(loaders []ResourceLoader) string

GetConfigFile returns the configuration file corresponding to the first configuration file loader found in ResourceLoader, if any.

func PrintHelp

func PrintHelp(w io.Writer, cmd *Command) error

PrintHelp prints the help for the command given as argument.

Types

type Command

type Command struct {
	Name          string
	Description   string
	Configuration interface{}
	Resources     []ResourceLoader
	Run           func([]string) error
	Hidden        bool
	// AllowArg if not set, disallows any argument that is not a known command or a sub-command.
	AllowArg bool
	// contains filtered or unexported fields
}

Command structure contains program/command information (command name and description).

func (*Command) AddCommand

func (c *Command) AddCommand(cmd *Command) error

AddCommand Adds a sub command.

type EnvLoader

type EnvLoader struct{}

EnvLoader loads a configuration from all the environment variables prefixed with "TRAEFIK_".

func (*EnvLoader) Load

func (e *EnvLoader) Load(_ []string, cmd *Command) (bool, error)

Load loads the command's configuration from the environment variables.

type FileLoader

type FileLoader struct {
	ConfigFileFlag string
	// contains filtered or unexported fields
}

FileLoader loads a configuration from a file.

func (*FileLoader) GetFilename

func (f *FileLoader) GetFilename() string

GetFilename returns the configuration file if any.

func (*FileLoader) Load

func (f *FileLoader) Load(args []string, cmd *Command) (bool, error)

Load loads the command's configuration from a file either specified with the -traefik.configfile flag, or from default locations.

type Finder

type Finder struct {
	BasePaths  []string
	Extensions []string
}

Finder holds a list of file paths.

func (Finder) Find

func (f Finder) Find(configFile string) (string, error)

Find returns the first valid existing file among configFile and the paths already registered with Finder.

type FlagLoader

type FlagLoader struct{}

FlagLoader loads configuration from flags.

func (*FlagLoader) Load

func (*FlagLoader) Load(args []string, cmd *Command) (bool, error)

Load loads the command's configuration from flag arguments.

type ResourceLoader

type ResourceLoader interface {
	// Load populates cmd.Configuration, optionally using args to do so.
	Load(args []string, cmd *Command) (bool, error)
}

ResourceLoader is a configuration resource loader.