commands

Documentation

Index

• Variables
• type Args
  • func NewArgs(args []string) *Args
  • func (a *Args) After(command ...string)
  • func (a *Args) AfterFn(fn func() error)
  • func (a *Args) AppendParams(params ...string)
  • func (a *Args) Before(command ...string)
  • func (a *Args) Commands() []*cmd.Cmd
  • func (a *Args) FirstParam() string
  • func (a *Args) GetParam(i int) string
  • func (a *Args) HasFlags(flags ...string) bool
  • func (a *Args) HasSubcommand() bool
  • func (a *Args) IndexOfParam(param string) int
  • func (a *Args) InsertParam(i int, items ...string)
  • func (a *Args) IsParamsEmpty() bool
  • func (a *Args) LastParam() string
  • func (a *Args) NoForward()
  • func (a *Args) ParamsSize() int
  • func (a *Args) PrependParams(params ...string)
  • func (a *Args) RemoveParam(i int) string
  • func (a *Args) Replace(executable, command string, params ...string)
  • func (a *Args) ReplaceParam(i int, item string)
  • func (a *Args) ToCmd() *cmd.Cmd
  • func (a *Args) Words() []string
• type Command
  • func (c *Command) Arg(idx int) string
  • func (c *Command) Call(args *Args) (err error)
  • func (c *Command) FlagPassed(name string) bool
  • func (c *Command) HelpText() string
  • func (c *Command) Name() string
  • func (c *Command) Runnable() bool
  • func (c *Command) Synopsis() string
  • func (c *Command) Use(subCommand *Command)
• type ExecError
  • func (execError *ExecError) Error() string
• type Runner
  • func NewRunner() *Runner
  • func (r *Runner) All() map[string]*Command
  • func (r *Runner) Call(cmd *Command, args *Args) ExecError
  • func (r *Runner) Execute() ExecError
  • func (r *Runner) Lookup(name string) *Command
  • func (r *Runner) Use(command *Command, aliases ...string)

Variables

var (
	NameRe          = "[\\w.][\\w.-]*"
	OwnerRe         = "[a-zA-Z0-9][a-zA-Z0-9-]*"
	NameWithOwnerRe = fmt.Sprintf("^(?:%s|%s\\/%s)$", NameRe, OwnerRe, NameRe)

	CmdRunner = NewRunner()
)

Types

type Args

type Args struct {
	Executable  string
	GlobalFlags []string
	Command     string
	ProgramPath string
	Params      []string

	Noop       bool
	Terminator bool

	Callbacks []func() error
	// contains filtered or unexported fields
}

func NewArgs

func NewArgs(args []string) *Args

func (*Args) After

func (a *Args) After(command ...string)

func (*Args) AfterFn

func (a *Args) AfterFn(fn func() error)

func (*Args) AppendParams

func (a *Args) AppendParams(params ...string)

func (*Args) Before

func (a *Args) Before(command ...string)

func (*Args) Commands

func (a *Args) Commands() []*cmd.Cmd

func (*Args) FirstParam

func (a *Args) FirstParam() string

func (*Args) GetParam

func (a *Args) GetParam(i int) string

func (*Args) HasFlags

func (a *Args) HasFlags(flags ...string) bool

func (*Args) HasSubcommand

func (a *Args) HasSubcommand() bool

func (*Args) IndexOfParam

func (a *Args) IndexOfParam(param string) int

func (*Args) InsertParam

func (a *Args) InsertParam(i int, items ...string)

func (*Args) IsParamsEmpty

func (a *Args) IsParamsEmpty() bool

func (*Args) LastParam

func (a *Args) LastParam() string

func (*Args) NoForward

func (a *Args) NoForward()

func (*Args) ParamsSize

func (a *Args) ParamsSize() int

func (*Args) PrependParams

func (a *Args) PrependParams(params ...string)

func (*Args) RemoveParam

func (a *Args) RemoveParam(i int) string

func (*Args) Replace

func (a *Args) Replace(executable, command string, params ...string)

func (*Args) ReplaceParam

func (a *Args) ReplaceParam(i int, item string)

func (*Args) ToCmd

func (a *Args) ToCmd() *cmd.Cmd

func (*Args) Words

func (a *Args) Words() []string

type Command

type Command struct {
	Run  func(cmd *Command, args *Args)
	Flag flag.FlagSet

	Key          string
	Usage        string
	Long         string
	GitExtension bool
	// contains filtered or unexported fields
}

func (*Command) Arg

func (c *Command) Arg(idx int) string

func (*Command) Call

func (c *Command) Call(args *Args) (err error)

func (*Command) FlagPassed

func (c *Command) FlagPassed(name string) bool

func (*Command) HelpText

func (c *Command) HelpText() string

func (*Command) Name

func (c *Command) Name() string

func (*Command) Runnable

func (c *Command) Runnable() bool

func (*Command) Synopsis

func (c *Command) Synopsis() string

func (*Command) Use

func (c *Command) Use(subCommand *Command)

type ExecError

type ExecError struct {
	Err      error
	Ran      bool
	ExitCode int
}

func (*ExecError) Error

func (execError *ExecError) Error() string

type Runner

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

func NewRunner

func NewRunner() *Runner

func (*Runner) All

func (r *Runner) All() map[string]*Command

func (*Runner) Call

func (r *Runner) Call(cmd *Command, args *Args) ExecError

func (*Runner) Execute

func (r *Runner) Execute() ExecError

func (*Runner) Lookup

func (r *Runner) Lookup(name string) *Command

func (*Runner) Use

func (r *Runner) Use(command *Command, aliases ...string)