cmd

Documentation

Index

• Variables
• func Register(cmds ...*cli.Command)
• func Run()
• type Cmd
  • func New(opts ...Option) Cmd
• type Option
  • func Action(a func(*cli.Context) error) Option
  • func Before(f cli.BeforeFunc) Option
  • func Commands(c ...*cli.Command) Option
  • func Description(d string) Option
  • func Flags(f ...cli.Flag) Option
  • func Name(n string) Option
  • func SetupOnly() Option
  • func Version(v string) Option
• type Options

Variables

var (
	GitCommit string
	GitTag    string
	BuildDate string
)

Functions

func Register

func Register(cmds ...*cli.Command)

Register CLI commands

func Run

func Run()

Run the default command

Types

type Cmd

type Cmd interface {
	// Init initializes options
	// Note: Use Run to parse command line
	Init(opts ...Option) error
	// Options set within this command
	Options() Options
	// The cli app within this cmd
	App() *cli.App
	// Run executes the command
	Run() error
	// Implementation
	String() string
}

Cmd for core cmd interface

var (
	DefaultCmd Cmd = New()
)

Default value

func New

func New(opts ...Option) Cmd

New return a cmd

type Option

type Option func(o *Options)

Option set cmd Options

func Action

func Action(a func(*cli.Context) error) Option

Action to execute

func Before

func Before(f cli.BeforeFunc) Option

Before sets a function to be called before micro is setup

func Commands

func Commands(c ...*cli.Command) Option

Commands to add

func Description

func Description(d string) Option

Description Command line Description

func Flags

func Flags(f ...cli.Flag) Option

Flags to add

func Name

func Name(n string) Option

Name for Command line Name

func SetupOnly

func SetupOnly() Option

SetupOnly for to execute

func Version

func Version(v string) Option

Version Command line Version

type Options

type Options struct {
	// Name of the application
	Name string
	// Description of the application
	Description string
	// Version of the application
	Version string
	// Action to execute when Run is called and there is no subcommand
	Action func(*cli.Context) error
	// TODO replace with built in command definition
	Commands []*cli.Command
	// TODO replace with built in flags definition
	Flags []cli.Flag
	// Other options for implementations of the interface
	// can be stored in a context
	Context context.Context
}

Options for cmd