mirror of
https://github.com/woodpecker-ci/woodpecker.git
synced 2024-12-25 18:00:30 +00:00
.. | ||
cli.go | ||
cli_test.go | ||
command.go | ||
command_mock.go | ||
command_mock_test.go | ||
help.go | ||
LICENSE | ||
README.md | ||
ui.go | ||
ui_colored.go | ||
ui_colored_test.go | ||
ui_concurrent.go | ||
ui_concurrent_test.go | ||
ui_mock.go | ||
ui_mock_test.go | ||
ui_test.go | ||
ui_writer.go | ||
ui_writer_test.go |
Go CLI Library
cli is a library for implementing powerful command-line interfaces in Go. cli is the library that powers the CLI for Packer, Serf, and Consul.
Features
-
Easy sub-command based CLIs:
cli foo
,cli bar
, etc. -
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)
}