mirror of
https://github.com/opentffoundation/opentf.git
synced 2026-01-02 04:01:13 -05:00
6fe2703665
* Remove `make updatedeps` from Travis build. We'll follow up with more specific plans around dependency updating in subsequent PRs. * Update all `make` targets to set `GO15VENDOREXPERIMENT=1` and to filter out `/vendor/` from `./...` where appropriate. * Temporarily remove `vet` from the `make test` target until we can figure out how to get it to not vet `vendor/`. (Initial experimentation failed to yield the proper incantation.) Everything is pinned to current master, with the exception of: * Azure/azure-sdk-for-go which is pinned before the breaking change today * aws/aws-sdk-go which is pinned to the most recent tag The documentation still needs to be updated, which we can do in a follow up PR. The goal here is to unblock release.
48 lines
1.6 KiB
Go
48 lines
1.6 KiB
Go
package cli
|
|
|
|
const (
|
|
// RunResultHelp is a value that can be returned from Run to signal
|
|
// to the CLI to render the help output.
|
|
RunResultHelp = -18511
|
|
)
|
|
|
|
// A command is a runnable sub-command of a CLI.
|
|
type Command interface {
|
|
// Help should return long-form help text that includes the command-line
|
|
// usage, a brief few sentences explaining the function of the command,
|
|
// and the complete list of flags the command accepts.
|
|
Help() string
|
|
|
|
// Run should run the actual command with the given CLI instance and
|
|
// command-line arguments. It should return the exit status when it is
|
|
// finished.
|
|
//
|
|
// There are a handful of special exit codes this can return documented
|
|
// above that change behavior.
|
|
Run(args []string) int
|
|
|
|
// Synopsis should return a one-line, short synopsis of the command.
|
|
// This should be less than 50 characters ideally.
|
|
Synopsis() string
|
|
}
|
|
|
|
// CommandHelpTemplate is an extension of Command that also has a function
|
|
// for returning a template for the help rather than the help itself. In
|
|
// this scenario, both Help and HelpTemplate should be implemented.
|
|
//
|
|
// If CommandHelpTemplate isn't implemented, the Help is output as-is.
|
|
type CommandHelpTemplate interface {
|
|
// HelpTemplate is the template in text/template format to use for
|
|
// displaying the Help. The keys available are:
|
|
//
|
|
// * ".Help" - The help text itself
|
|
// * ".Subcommands"
|
|
//
|
|
HelpTemplate() string
|
|
}
|
|
|
|
// CommandFactory is a type of function that is a factory for commands.
|
|
// We need a factory because we may need to setup some state on the
|
|
// struct that implements the command itself.
|
|
type CommandFactory func() (Command, error)
|