Go CLI Library ![GoDoc](https://camo.githubusercontent.com/e0090a382e721d1c885a5a7696428bdd477102e75178d6af2a2a547bc14c8310/68747470733a2f2f676f646f632e6f72672f6769746875622e636f6d2f6d69746368656c6c682f636c693f7374617475732e706e67)
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. -
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)
}