opt

Documentation

Index

• Constants
• type Args
  • func Parse(data interface{}) *Args
  • func (a *Args) Parse(data interface{}, in []string, parent string)
  • func (a *Args) RunCommand(all bool) error
  • func (a *Args) SetChoicesLong(name string, list []string)
  • func (a *Args) SetChoicesShort(name string, list []string)
  • func (a *Args) Usage()
• type DefaultHelp
• type Flag
  • func (f *Flag) AddChoice(c string)
  • func (f *Flag) SetChoices(list []string)
  • func (f *Flag) UsageString() (string, string)
• type Runner

Constants

const (
	// ErrorUsage should be returned from tool commands to show its options.
	ErrorUsage = "unknown options"
	// ErrorNoCommand is also used internally when something breaks.
	ErrorNoCommand = "no command specified"
)

Types

type Args

type Args struct {
	Program string

	Remaining []string
	// contains filtered or unexported fields
}

Args gets options and commands parsed into it.

func Parse

func Parse(data interface{}) *Args

Parse the command line for arguments and tool commands.

func (*Args) Parse

func (a *Args) Parse(data interface{}, in []string, parent string)

Parse an option structure and slice of arguments.

func (*Args) RunCommand

func (a *Args) RunCommand(all bool) error

RunCommand and recurse.

func (*Args) SetChoicesLong

func (a *Args) SetChoicesLong(name string, list []string)

SetChoicesLong sets the selectable options based on the long option name.

func (*Args) SetChoicesShort

func (a *Args) SetChoicesShort(name string, list []string)

SetChoicesShort sets the selectable options based on the short option name.

func (*Args) Usage

func (a *Args) Usage()

Usage printout.

type DefaultHelp

type DefaultHelp struct {
	Help bool `short:"h" help:"Show this help."`
}

DefaultHelp can be embedded in your options struct to save some typing.

type Flag

type Flag struct {
	Name        string
	Help        string
	Short       string
	Long        string
	Group       string
	Placeholder string
	CommandName string
	Default     string
	Choices     []string
	Aliases     []string
	Args        *Args

	IsCommand bool
	IsSlice   bool
	IsMap     bool
	Required  bool
	// contains filtered or unexported fields
}

Flag or command option.

func (*Flag) AddChoice

func (f *Flag) AddChoice(c string)

AddChoice to list. Makes the choice lowercase and trims leading and trailing spaces.

func (*Flag) SetChoices

func (f *Flag) SetChoices(list []string)

SetChoices to a new list.

func (*Flag) UsageString

func (f *Flag) UsageString() (string, string)

type Runner

type Runner interface {
	Run(args []string) error
}

Runner is the interface for tool commands to conform to.