terraform/vendor/github.com/mitchellh/cli
Radek Simko dd252355c5
vendor: github.com/mitchellh/cli@v1.0.0
go get github.com/mitchellh/cli@v1.0.0
go mod tidy
go mod vendor
2019-02-21 08:56:05 +00:00
..
.travis.yml vendor: github.com/mitchellh/cli@v1.0.0 2019-02-21 08:56:05 +00:00
LICENSE
Makefile Update mitchellh/cli to fix GH-7983 2016-08-15 12:00:05 -07:00
README.md vendor: Bump github.com/mitchellh/cli to latest 2017-08-14 17:17:48 +02:00
autocomplete.go vendor: Bump github.com/mitchellh/cli to latest 2017-08-14 17:17:48 +02:00
cli.go vendor: github.com/mitchellh/cli@v1.0.0 2019-02-21 08:56:05 +00:00
command.go vendor: Bump github.com/mitchellh/cli to latest 2017-08-14 17:17:48 +02:00
command_mock.go vendor: Bump github.com/mitchellh/cli to latest 2017-08-14 17:17:48 +02:00
go.mod vendor: github.com/mitchellh/cli@v1.0.0 2019-02-21 08:56:05 +00:00
go.sum vendor: github.com/mitchellh/cli@v1.0.0 2019-02-21 08:56:05 +00:00
help.go vendor: Bump github.com/mitchellh/cli to latest 2017-08-14 17:17:48 +02:00
ui.go
ui_colored.go vendor: github.com/mitchellh/cli@v1.0.0 2019-02-21 08:56:05 +00:00
ui_concurrent.go
ui_mock.go vendor: Bump github.com/mitchellh/cli to latest 2017-08-14 17:17:48 +02:00
ui_writer.go

README.md

Go CLI Library GoDoc

cli is a library for implementing powerful command-line interfaces in Go. cli is the library that powers the CLI for Packer, Serf, Consul, Vault, Terraform, and Nomad.

Features

  • Easy sub-command based CLIs: cli foo, cli bar, etc.

  • Support for nested subcommands such as cli foo bar.

  • Optional support for default subcommands so cli does something other than error.

  • Support for shell autocompletion of subcommands, flags, and arguments with callbacks in Go. You don't need to write any shell code.

  • Automatic help generation for listing subcommands

  • Automatic help flag recognition of -h, --help, etc.

  • Automatic version flag recognition of -v, --version.

  • Helpers for interacting with the terminal, such as outputting information, asking for input, etc. These are optional, you can always interact with the terminal however you choose.

  • Use of Go interfaces/types makes augmenting various parts of the library a piece of cake.

Example

Below is a simple example of creating and running a CLI

package main

import (
	"log"
	"os"

	"github.com/mitchellh/cli"
)

func main() {
	c := cli.NewCLI("app", "1.0.0")
	c.Args = os.Args[1:]
	c.Commands = map[string]cli.CommandFactory{
		"foo": fooCommandFactory,
		"bar": barCommandFactory,
	}

	exitStatus, err := c.Run()
	if err != nil {
		log.Println(err)
	}

	os.Exit(exitStatus)
}