|author||Ville Skyttä <email@example.com>||Wed May 18 00:57:08 2022|
|committer||GitHub <firstname.lastname@example.org>||Wed May 18 00:57:08 2022|
perf(bash-v2): read directly to COMPREPLY on descriptionless short circuit (#1700) Not that it'd really matter that much performancewise given the level we are at for this case, but this change makes the short circuit roughly twice as fast on my box as it was for the 1000 rounds done in marckhouzam/cobra-completion-testing. Perhaps more importantly, this makes the code arguably slightly cleaner.
Cobra is a library for creating powerful modern CLI applications.
Cobra is a library providing a simple interface to create powerful modern CLI interfaces similar to git & go tools.
app fetch, etc.
app srver... did you mean
Cobra is built on a structure of commands, arguments & flags.
Commands represent actions, Args are things and Flags are modifiers for those actions.
The best applications read like sentences when used, and as a result, users intuitively know how to interact with them.
The pattern to follow is
APPNAME VERB NOUN --ADJECTIVE. or
APPNAME COMMAND ARG --FLAG
A few good real world examples may better illustrate this point.
In the following example, ‘server’ is a command, and ‘port’ is a flag:
hugo server --port=1313
In this command we are telling Git to clone the url bare.
git clone URL --bare
Command is the central point of the application. Each interaction that the application supports will be contained in a Command. A command can have children commands and optionally run an action.
In the example above, ‘server’ is the command.
A flag is a way to modify the behavior of a command. Cobra supports fully POSIX-compliant flags as well as the Go flag package. A Cobra command can define flags that persist through to children commands and flags that are only available to that command.
In the example above, ‘port’ is the flag.
Flag functionality is provided by the pflag library, a fork of the flag standard library which maintains the same interface while adding POSIX compliance.
Using Cobra is easy. First, use
go get to install the latest version of the library.
go get -u github.com/spf13/cobra@latest
Next, include Cobra in your application:
cobra-cli is a command line program to generate cobra applications and command files. It will bootstrap your application scaffolding to rapidly develop a Cobra-based application. It is the easiest way to incorporate Cobra into your application.
It can be installed by running:
go install github.com/spf13/cobra-cli@latest
For complete details on using the Cobra-CLI generator, please read The Cobra Generator README
For complete details on using the Cobra library, please read the The Cobra User Guide.
Cobra is released under the Apache 2.0 license. See LICENSE.txt