From 73f285c618163df585a256b6246b81d58762ad2e Mon Sep 17 00:00:00 2001 From: umarcor Date: Mon, 5 Oct 2020 01:00:12 +0200 Subject: [PATCH] site: rework structure and headers --- README.md | 130 +--- site/content/completions/_index.md | 213 +----- site/content/completions/bash.md | 63 +- site/content/completions/fish.md | 33 +- site/content/completions/powershell.md | 81 ++- site/content/completions/zsh.md | 51 +- site/content/concepts.md | 50 ++ .../content/contributing.md | 4 + site/content/docgen/_index.md | 10 +- site/content/docgen/man.md | 6 +- site/content/docgen/md.md | 12 +- site/content/docgen/rest.md | 12 +- site/content/docgen/yaml.md | 12 +- site/content/getting_started.md | 648 ++++++++++++++++++ site/content/installing.md | 17 + site/content/license.md | 7 + site/content/overview.md | 27 + site/content/projects_using_cobra.md | 6 +- site/static/images/logo.png | Bin 0 -> 58138 bytes 19 files changed, 1047 insertions(+), 335 deletions(-) create mode 100644 site/content/concepts.md rename CONTRIBUTING.md => site/content/contributing.md (99%) create mode 100644 site/content/getting_started.md create mode 100644 site/content/installing.md create mode 100644 site/content/license.md create mode 100644 site/content/overview.md create mode 100644 site/static/images/logo.png diff --git a/README.md b/README.md index 6444f4b7f6..ea1e1ddf14 100644 --- a/README.md +++ b/README.md @@ -1,112 +1,24 @@ -![cobra logo](assets/CobraMain.png) +

+ +

+ +

+ + Slack + GoDoc + Go Report Card + GitHub release (latest by date including pre-releases) + GitHub release (latest by date including pre-releases) +

Cobra is a library for creating powerful modern CLI applications. -Cobra is used in many Go projects such as [Kubernetes](https://kubernetes.io/), -[Hugo](https://gohugo.io), and [GitHub CLI](https://github.com/cli/cli) to -name a few. [This list](site/content/projects_using_cobra.md) contains a more extensive list of projects using Cobra. - -[![](https://img.shields.io/github/actions/workflow/status/spf13/cobra/test.yml?branch=main&longCache=true&label=Test&logo=github%20actions&logoColor=fff)](https://github.com/spf13/cobra/actions?query=workflow%3ATest) -[![Go Reference](https://pkg.go.dev/badge/github.com/spf13/cobra.svg)](https://pkg.go.dev/github.com/spf13/cobra) -[![Go Report Card](https://goreportcard.com/badge/github.com/spf13/cobra)](https://goreportcard.com/report/github.com/spf13/cobra) -[![Slack](https://img.shields.io/badge/Slack-cobra-brightgreen)](https://gophers.slack.com/archives/CD3LP1199) - -# Overview - -Cobra is a library providing a simple interface to create powerful modern CLI -interfaces similar to git & go tools. - -Cobra provides: -* Easy subcommand-based CLIs: `app server`, `app fetch`, etc. -* Fully POSIX-compliant flags (including short & long versions) -* Nested subcommands -* Global, local and cascading flags -* Intelligent suggestions (`app srver`... did you mean `app server`?) -* Automatic help generation for commands and flags -* Grouping help for subcommands -* Automatic help flag recognition of `-h`, `--help`, etc. -* Automatically generated shell autocomplete for your application (bash, zsh, fish, powershell) -* Automatically generated man pages for your application -* Command aliases so you can change things without breaking them -* The flexibility to define your own help, usage, etc. -* Optional seamless integration with [viper](https://github.com/spf13/viper) for 12-factor apps - -# Concepts - -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 - -## Commands - -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. - -[More about cobra.Command](https://pkg.go.dev/github.com/spf13/cobra#Command) - -## Flags - -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](https://golang.org/pkg/flag/). -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](https://github.com/spf13/pflag), a fork of the flag standard library -which maintains the same interface while adding POSIX compliance. - -# Installing -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: - -```go -import "github.com/spf13/cobra" -``` - -# Usage -`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](https://github.com/spf13/cobra-cli/blob/main/README.md) - -For complete details on using the Cobra library, please read the [The Cobra User Guide](site/content/user_guide.md). - -# License - -Cobra is released under the Apache 2.0 license. See [LICENSE.txt](LICENSE.txt) +Cobra is used in many Go projects such as [Kubernetes](http://kubernetes.io/), +[Hugo](https://gohugo.io), and [Github CLI](https://github.com/cli/cli) to +name a few. [This list](./site/content/projects_using_cobra.md) contains a more extensive list of projects using Cobra. diff --git a/site/content/completions/_index.md b/site/content/completions/_index.md index 4efad2907b..e4734382bf 100644 --- a/site/content/completions/_index.md +++ b/site/content/completions/_index.md @@ -1,4 +1,8 @@ -# Generating shell completions +--- +weight: 10 +--- + +# Shell completions Cobra can generate shell completions for multiple shells. The currently supported shells are: @@ -114,13 +118,13 @@ To tell Cobra to completely disable descriptions for completions: rootCmd.CompletionOptions.DisableDescriptions = true ``` -# Customizing completions +## Customizing completions The generated completion scripts will automatically handle completing commands and flags. However, you can make your completions much more powerful by providing information to complete your program's nouns and flag values. -## Completion of nouns +### Completion of nouns -### Static completion of nouns +#### Static completion of nouns Cobra allows you to provide a pre-defined list of completion choices for your nouns using the `ValidArgs` field. For example, if you want `kubectl get [tab][tab]` to show a list of valid "nouns" you have to set them. @@ -148,7 +152,7 @@ $ kubectl get [tab][tab] node pod replicationcontroller service ``` -#### Aliases for nouns +##### Aliases for nouns If your nouns have aliases, you can define them alongside `ValidArgs` using `ArgAliases`: @@ -164,7 +168,7 @@ cmd := &cobra.Command{ The aliases are shown to the user on tab completion only if no completions were found within sub-commands or `ValidArgs`. -### Dynamic completion of nouns +#### Dynamic completion of nouns In some cases it is not possible to provide a list of completions in advance. Instead, the list of completions must be determined at execution-time. In a similar fashion as for static completions, you can use the `ValidArgsFunction` field to provide a Go function that Cobra will execute when it needs the list of completion choices for the nouns of a command. Note that either `ValidArgs` or `ValidArgsFunction` can be used for a single cobra command, but not both. Simplified code from `helm status` looks like: @@ -236,7 +240,7 @@ ShellCompDirectiveKeepOrder ***Note***: When using the `ValidArgsFunction`, Cobra will call your registered function after having parsed all flags and arguments provided in the command-line. You therefore don't need to do this parsing yourself. For example, when a user calls `helm status --namespace my-rook-ns [tab][tab]`, Cobra will call your registered `ValidArgsFunction` after having parsed the `--namespace` flag, as it would have done when calling the `RunE` function. -#### Debugging +##### Debugging Cobra achieves dynamic completion through the use of a hidden command called by the completion script. To debug your Go completion code, you can call this hidden command directly: ```bash @@ -269,9 +273,9 @@ cobra.CompErrorln(msg string) ``` ***Important:*** You should **not** leave traces that print directly to stdout in your completion code as they will be interpreted as completion choices by the completion script. Instead, use the cobra-provided debugging traces functions mentioned above. -## Completions for flags +### Completions for flags -### Mark flags as required +#### Mark flags as required Most of the time completions will only show sub-commands. But if a flag is required to make a sub-command work, you probably want it to show up when the user types [tab][tab]. You can mark a flag as 'Required' like so: @@ -287,7 +291,7 @@ $ kubectl exec [tab][tab] -c --container= -p --pod= ``` -### Specify dynamic flag completion +#### Specify dynamic flag completion As for nouns, Cobra provides a way of defining dynamic completion of flags. To provide a Go function that Cobra will execute when it needs the list of completion choices for a flag, you must register the function using the `command.RegisterFlagCompletionFunc()` function. @@ -304,7 +308,7 @@ $ helm status --output [tab][tab] json table yaml ``` -#### Debugging +##### Debugging You can also easily debug your Go completion code for flags: ```bash @@ -317,7 +321,7 @@ Completion ended with directive: ShellCompDirectiveNoFileComp # This is on stder ``` ***Important:*** You should **not** leave traces that print to stdout in your completion code as they will be interpreted as completion choices by the completion script. Instead, use the cobra-provided debugging traces functions mentioned further above. -### Specify valid filename extensions for flags that take a filename +#### Specify valid filename extensions for flags that take a filename To limit completions of flag values to file names with certain extensions you can either use the different `MarkFlagFilename()` functions or a combination of `RegisterFlagCompletionFunc()` and `ShellCompDirectiveFilterFileExt`, like so: ```go @@ -331,7 +335,7 @@ cmd.RegisterFlagCompletionFunc(flagName, func(cmd *cobra.Command, args []string, return []string{"yaml", "json"}, ShellCompDirectiveFilterFileExt}) ``` -### Limit flag completions to directory names +#### Limit flag completions to directory names To limit completions of flag values to directory names you can either use the `MarkFlagDirname()` functions or a combination of `RegisterFlagCompletionFunc()` and `ShellCompDirectiveFilterDirs`, like so: ```go @@ -352,7 +356,7 @@ cmd.RegisterFlagCompletionFunc(flagName, func(cmd *cobra.Command, args []string, return []string{"themes"}, cobra.ShellCompDirectiveFilterDirs }) ``` -### Descriptions for completions +#### Descriptions for completions Cobra provides support for completion descriptions. Such descriptions are supported for each shell (however, for bash, it is only available in the [completion V2 version](#bash-completion-v2)). @@ -393,184 +397,3 @@ $ source <(helm completion bash --no-descriptions) $ helm completion [tab][tab] bash fish powershell zsh ``` -## Bash completions - -### Dependencies - -The bash completion script generated by Cobra requires the `bash_completion` package. You should update the help text of your completion command to show how to install the `bash_completion` package ([Kubectl docs](https://kubernetes.io/docs/tasks/tools/install-kubectl/#enabling-shell-autocompletion)) - -### Aliases - -You can also configure `bash` aliases for your program and they will also support completions. - -```bash -alias aliasname=origcommand -complete -o default -F __start_origcommand aliasname - -# and now when you run `aliasname` completion will make -# suggestions as it did for `origcommand`. - -$ aliasname -completion firstcommand secondcommand -``` -### Bash legacy dynamic completions - -For backward compatibility, Cobra still supports its bash legacy dynamic completion solution. -Please refer to [Bash Completions](bash.md) for details. - -### Bash completion V2 - -Cobra provides two versions for bash completion. The original bash completion (which started it all!) can be used by calling -`GenBashCompletion()` or `GenBashCompletionFile()`. - -A new V2 bash completion version is also available. This version can be used by calling `GenBashCompletionV2()` or -`GenBashCompletionFileV2()`. The V2 version does **not** support the legacy dynamic completion -(see [Bash Completions](bash.md)) but instead works only with the Go dynamic completion -solution described in this document. -Unless your program already uses the legacy dynamic completion solution, it is recommended that you use the bash -completion V2 solution which provides the following extra features: -- Supports completion descriptions (like the other shells) -- Small completion script of less than 300 lines (v1 generates scripts of thousands of lines; `kubectl` for example has a bash v1 completion script of over 13K lines) -- Streamlined user experience thanks to a completion behavior aligned with the other shells - -`Bash` completion V2 supports descriptions for completions. When calling `GenBashCompletionV2()` or `GenBashCompletionFileV2()` -you must provide these functions with a parameter indicating if the completions should be annotated with a description; Cobra -will provide the description automatically based on usage information. You can choose to make this option configurable by -your users. - -``` -# With descriptions -$ helm s[tab][tab] -search (search for a keyword in charts) status (display the status of the named release) -show (show information of a chart) - -# Without descriptions -$ helm s[tab][tab] -search show status -``` -**Note**: Cobra's default `completion` command uses bash completion V2. If for some reason you need to use bash completion V1, you will need to implement your own `completion` command. -## Zsh completions - -Cobra supports native zsh completion generated from the root `cobra.Command`. -The generated completion script should be put somewhere in your `$fpath` and be named -`_`. You will need to start a new shell for the completions to become available. - -Zsh supports descriptions for completions. Cobra will provide the description automatically, -based on usage information. Cobra provides a way to completely disable such descriptions by -using `GenZshCompletionNoDesc()` or `GenZshCompletionFileNoDesc()`. You can choose to make -this a configurable option to your users. -``` -# With descriptions -$ helm s[tab] -search -- search for a keyword in charts -show -- show information of a chart -status -- displays the status of the named release - -# Without descriptions -$ helm s[tab] -search show status -``` -*Note*: Because of backward-compatibility requirements, we were forced to have a different API to disable completion descriptions between `zsh` and `fish`. - -### Limitations - -* Custom completions implemented in Bash scripting (legacy) are not supported and will be ignored for `zsh` (including the use of the `BashCompCustom` flag annotation). - * You should instead use `ValidArgsFunction` and `RegisterFlagCompletionFunc()` which are portable to the different shells (`bash`, `zsh`, `fish`, `powershell`). -* The function `MarkFlagCustom()` is not supported and will be ignored for `zsh`. - * You should instead use `RegisterFlagCompletionFunc()`. - -### Zsh completions standardization - -Cobra 1.1 standardized its zsh completion support to align it with its other shell completions. Although the API was kept backward-compatible, some small changes in behavior were introduced. -Please refer to [Zsh Completions](zsh.md) for details. - -## fish completions - -Cobra supports native fish completions generated from the root `cobra.Command`. You can use the `command.GenFishCompletion()` or `command.GenFishCompletionFile()` functions. You must provide these functions with a parameter indicating if the completions should be annotated with a description; Cobra will provide the description automatically based on usage information. You can choose to make this option configurable by your users. -``` -# With descriptions -$ helm s[tab] -search (search for a keyword in charts) show (show information of a chart) status (displays the status of the named release) - -# Without descriptions -$ helm s[tab] -search show status -``` -*Note*: Because of backward-compatibility requirements, we were forced to have a different API to disable completion descriptions between `zsh` and `fish`. - -### Limitations - -* Custom completions implemented in bash scripting (legacy) are not supported and will be ignored for `fish` (including the use of the `BashCompCustom` flag annotation). - * You should instead use `ValidArgsFunction` and `RegisterFlagCompletionFunc()` which are portable to the different shells (`bash`, `zsh`, `fish`, `powershell`). -* The function `MarkFlagCustom()` is not supported and will be ignored for `fish`. - * You should instead use `RegisterFlagCompletionFunc()`. -* The following flag completion annotations are not supported and will be ignored for `fish`: - * `BashCompFilenameExt` (filtering by file extension) - * `BashCompSubdirsInDir` (filtering by directory) -* The functions corresponding to the above annotations are consequently not supported and will be ignored for `fish`: - * `MarkFlagFilename()` and `MarkPersistentFlagFilename()` (filtering by file extension) - * `MarkFlagDirname()` and `MarkPersistentFlagDirname()` (filtering by directory) -* Similarly, the following completion directives are not supported and will be ignored for `fish`: - * `ShellCompDirectiveFilterFileExt` (filtering by file extension) - * `ShellCompDirectiveFilterDirs` (filtering by directory) - -## PowerShell completions - -Cobra supports native PowerShell completions generated from the root `cobra.Command`. You can use the `command.GenPowerShellCompletion()` or `command.GenPowerShellCompletionFile()` functions. To include descriptions use `command.GenPowerShellCompletionWithDesc()` and `command.GenPowerShellCompletionFileWithDesc()`. Cobra will provide the description automatically based on usage information. You can choose to make this option configurable by your users. - -The script is designed to support all three PowerShell completion modes: - -* TabCompleteNext (default windows style - on each key press the next option is displayed) -* Complete (works like bash) -* MenuComplete (works like zsh) - -You set the mode with `Set-PSReadLineKeyHandler -Key Tab -Function `. Descriptions are only displayed when using the `Complete` or `MenuComplete` mode. - -Users need PowerShell version 5.0 or above, which comes with Windows 10 and can be downloaded separately for Windows 7 or 8.1. They can then write the completions to a file and source this file from their PowerShell profile, which is referenced by the `$Profile` environment variable. See `Get-Help about_Profiles` for more info about PowerShell profiles. - -``` -# With descriptions and Mode 'Complete' -$ helm s[tab] -search (search for a keyword in charts) show (show information of a chart) status (displays the status of the named release) - -# With descriptions and Mode 'MenuComplete' The description of the current selected value will be displayed below the suggestions. -$ helm s[tab] -search show status - -search for a keyword in charts - -# Without descriptions -$ helm s[tab] -search show status -``` -### Aliases - -You can also configure `powershell` aliases for your program and they will also support completions. - -``` -$ sal aliasname origcommand -$ Register-ArgumentCompleter -CommandName 'aliasname' -ScriptBlock $__origcommandCompleterBlock - -# and now when you run `aliasname` completion will make -# suggestions as it did for `origcommand`. - -$ aliasname -completion firstcommand secondcommand -``` -The name of the completer block variable is of the form `$__CompleterBlock` where every `-` and `:` in the program name have been replaced with `_`, to respect powershell naming syntax. - -### Limitations - -* Custom completions implemented in bash scripting (legacy) are not supported and will be ignored for `powershell` (including the use of the `BashCompCustom` flag annotation). - * You should instead use `ValidArgsFunction` and `RegisterFlagCompletionFunc()` which are portable to the different shells (`bash`, `zsh`, `fish`, `powershell`). -* The function `MarkFlagCustom()` is not supported and will be ignored for `powershell`. - * You should instead use `RegisterFlagCompletionFunc()`. -* The following flag completion annotations are not supported and will be ignored for `powershell`: - * `BashCompFilenameExt` (filtering by file extension) - * `BashCompSubdirsInDir` (filtering by directory) -* The functions corresponding to the above annotations are consequently not supported and will be ignored for `powershell`: - * `MarkFlagFilename()` and `MarkPersistentFlagFilename()` (filtering by file extension) - * `MarkFlagDirname()` and `MarkPersistentFlagDirname()` (filtering by directory) -* Similarly, the following completion directives are not supported and will be ignored for `powershell`: - * `ShellCompDirectiveFilterFileExt` (filtering by file extension) - * `ShellCompDirectiveFilterDirs` (filtering by directory) diff --git a/site/content/completions/bash.md b/site/content/completions/bash.md index 6838a3a6bc..4f4b0bb361 100644 --- a/site/content/completions/bash.md +++ b/site/content/completions/bash.md @@ -1,8 +1,65 @@ -# Generating Bash Completions For Your cobra.Command +--- +weight: 11 +--- -Please refer to [Shell Completions](_index.md) for details. +## Bash completions -## Bash legacy dynamic completions +#### Dependencies + +The bash completion script generated by Cobra requires the `bash_completion` package. You should update the help text of your completion command to show how to install the `bash_completion` package ([Kubectl docs](https://kubernetes.io/docs/tasks/tools/install-kubectl/#enabling-shell-autocompletion)) + +#### Aliases + +You can also configure `bash` aliases for your program and they will also support completions. + +```bash +alias aliasname=origcommand +complete -o default -F __start_origcommand aliasname + +# and now when you run `aliasname` completion will make +# suggestions as it did for `origcommand`. + +$ aliasname +completion firstcommand secondcommand +``` +#### Bash legacy dynamic completions + +For backward compatibility, Cobra still supports its bash legacy dynamic completion solution. +Please refer to [Bash Completions](bash.md) for details. + +### Bash completion V2 + +Cobra provides two versions for bash completion. The original bash completion (which started it all!) can be used by calling +`GenBashCompletion()` or `GenBashCompletionFile()`. + +A new V2 bash completion version is also available. This version can be used by calling `GenBashCompletionV2()` or +`GenBashCompletionFileV2()`. The V2 version does **not** support the legacy dynamic completion +(see [Bash Completions](bash.md)) but instead works only with the Go dynamic completion +solution described in this document. +Unless your program already uses the legacy dynamic completion solution, it is recommended that you use the bash +completion V2 solution which provides the following extra features: +- Supports completion descriptions (like the other shells) +- Small completion script of less than 300 lines (v1 generates scripts of thousands of lines; `kubectl` for example has a bash v1 completion script of over 13K lines) +- Streamlined user experience thanks to a completion behavior aligned with the other shells + +`Bash` completion V2 supports descriptions for completions. When calling `GenBashCompletionV2()` or `GenBashCompletionFileV2()` +you must provide these functions with a parameter indicating if the completions should be annotated with a description; Cobra +will provide the description automatically based on usage information. You can choose to make this option configurable by +your users. + +``` +# With descriptions +$ helm s[tab][tab] +search (search for a keyword in charts) status (display the status of the named release) +show (show information of a chart) + +# Without descriptions +$ helm s[tab][tab] +search show status +``` +**Note**: Cobra's default `completion` command uses bash completion V2. If for some reason you need to use bash completion V1, you will need to implement your own `completion` command. + +### Bash legacy dynamic completions For backward compatibility, Cobra still supports its legacy dynamic completion solution (described below). Unlike the `ValidArgsFunction` solution, the legacy solution will only work for Bash shell-completion and not for other shells. This legacy solution can be used along-side `ValidArgsFunction` and `RegisterFlagCompletionFunc()`, as long as both solutions are not used for the same command. This provides a path to gradually migrate from the legacy solution to the new solution. diff --git a/site/content/completions/fish.md b/site/content/completions/fish.md index 5253f7d49f..2e9373ca42 100644 --- a/site/content/completions/fish.md +++ b/site/content/completions/fish.md @@ -1,4 +1,33 @@ -## Generating Fish Completions For Your cobra.Command +--- +weight: 12 +--- -Please refer to [Shell Completions](_index.md) for details. +# Fish completions +Cobra supports native fish completions generated from the root `cobra.Command`. You can use the `command.GenFishCompletion()` or `command.GenFishCompletionFile()` functions. You must provide these functions with a parameter indicating if the completions should be annotated with a description; Cobra will provide the description automatically based on usage information. You can choose to make this option configurable by your users. +``` +# With descriptions +$ helm s[tab] +search (search for a keyword in charts) show (show information of a chart) status (displays the status of the named release) + +# Without descriptions +$ helm s[tab] +search show status +``` +*Note*: Because of backward-compatibility requirements, we were forced to have a different API to disable completion descriptions between `zsh` and `fish`. + +## Limitations + +* Custom completions implemented in bash scripting (legacy) are not supported and will be ignored for `fish` (including the use of the `BashCompCustom` flag annotation). + * You should instead use `ValidArgsFunction` and `RegisterFlagCompletionFunc()` which are portable to the different shells (`bash`, `zsh`, `fish`, `powershell`). +* The function `MarkFlagCustom()` is not supported and will be ignored for `fish`. + * You should instead use `RegisterFlagCompletionFunc()`. +* The following flag completion annotations are not supported and will be ignored for `fish`: + * `BashCompFilenameExt` (filtering by file extension) + * `BashCompSubdirsInDir` (filtering by directory) +* The functions corresponding to the above annotations are consequently not supported and will be ignored for `fish`: + * `MarkFlagFilename()` and `MarkPersistentFlagFilename()` (filtering by file extension) + * `MarkFlagDirname()` and `MarkPersistentFlagDirname()` (filtering by directory) +* Similarly, the following completion directives are not supported and will be ignored for `fish`: + * `ShellCompDirectiveFilterFileExt` (filtering by file extension) + * `ShellCompDirectiveFilterDirs` (filtering by directory) diff --git a/site/content/completions/powershell.md b/site/content/completions/powershell.md index 024b119a02..c130f0240d 100644 --- a/site/content/completions/powershell.md +++ b/site/content/completions/powershell.md @@ -1,3 +1,80 @@ -# Generating PowerShell Completions For Your Own cobra.Command +--- +weight: 13 +--- -Please refer to [Shell Completions](_index.md#powershell-completions) for details. +# PowerShell completions + +Cobra can generate PowerShell completion scripts. Users need PowerShell version 5.0 or above, which comes with Windows 10 and can be downloaded separately for Windows 7 or 8.1. They can then write the completions to a file and source this file from their PowerShell profile, which is referenced by the `$Profile` environment variable. See `Get-Help about_Profiles` for more info about PowerShell profiles. + +*Note*: PowerShell completions have not (yet?) been aligned to Cobra's generic shell completion support. This implies the PowerShell completions are not as rich as for other shells (see [What's not yet supported](#whats-not-yet-supported)), and may behave slightly differently. They are still very useful for PowerShell users. + +Cobra supports native PowerShell completions generated from the root `cobra.Command`. You can use the `command.GenPowerShellCompletion()` or `command.GenPowerShellCompletionFile()` functions. To include descriptions use `command.GenPowerShellCompletionWithDesc()` and `command.GenPowerShellCompletionFileWithDesc()`. Cobra will provide the description automatically based on usage information. You can choose to make this option configurable by your users. + +The script is designed to support all three PowerShell completion modes: + +* TabCompleteNext (default windows style - on each key press the next option is displayed) +* Complete (works like bash) +* MenuComplete (works like zsh) + +You set the mode with `Set-PSReadLineKeyHandler -Key Tab -Function `. Descriptions are only displayed when using the `Complete` or `MenuComplete` mode. + +Users need PowerShell version 5.0 or above, which comes with Windows 10 and can be downloaded separately for Windows 7 or 8.1. They can then write the completions to a file and source this file from their PowerShell profile, which is referenced by the `$Profile` environment variable. See `Get-Help about_Profiles` for more info about PowerShell profiles. + +``` +# With descriptions and Mode 'Complete' +$ helm s[tab] +search (search for a keyword in charts) show (show information of a chart) status (displays the status of the named release) + +# With descriptions and Mode 'MenuComplete' The description of the current selected value will be displayed below the suggestions. +$ helm s[tab] +search show status + +search for a keyword in charts + +# Without descriptions +$ helm s[tab] +search show status +``` + +## Aliases + +You can also configure `powershell` aliases for your program and they will also support completions. + +``` +$ sal aliasname origcommand +$ Register-ArgumentCompleter -CommandName 'aliasname' -ScriptBlock $__origcommandCompleterBlock + +# and now when you run `aliasname` completion will make +# suggestions as it did for `origcommand`. + +$ aliasname +completion firstcommand secondcommand +``` +The name of the completer block variable is of the form `$__CompleterBlock` where every `-` and `:` in the program name have been replaced with `_`, to respect powershell naming syntax. + +## Limitations + +* Custom completions implemented in bash scripting (legacy) are not supported and will be ignored for `powershell` (including the use of the `BashCompCustom` flag annotation). + * You should instead use `ValidArgsFunction` and `RegisterFlagCompletionFunc()` which are portable to the different shells (`bash`, `zsh`, `fish`, `powershell`). +* The function `MarkFlagCustom()` is not supported and will be ignored for `powershell`. + * You should instead use `RegisterFlagCompletionFunc()`. +* The following flag completion annotations are not supported and will be ignored for `powershell`: + * `BashCompFilenameExt` (filtering by file extension) + * `BashCompSubdirsInDir` (filtering by directory) +* The functions corresponding to the above annotations are consequently not supported and will be ignored for `powershell`: + * `MarkFlagFilename()` and `MarkPersistentFlagFilename()` (filtering by file extension) + * `MarkFlagDirname()` and `MarkPersistentFlagDirname()` (filtering by directory) +* Similarly, the following completion directives are not supported and will be ignored for `powershell`: + * `ShellCompDirectiveFilterFileExt` (filtering by file extension) + * `ShellCompDirectiveFilterDirs` (filtering by directory) + +## What's supported + +- Completion for subcommands using their `.Short` description +- Completion for non-hidden flags using their `.Name` and `.Shorthand` + +## What's not yet supported + +- Command aliases +- Required, filename or custom flags (they will work like normal flags) +- Custom completion scripts diff --git a/site/content/completions/zsh.md b/site/content/completions/zsh.md index 3e27208b71..ea3fad018b 100644 --- a/site/content/completions/zsh.md +++ b/site/content/completions/zsh.md @@ -1,12 +1,48 @@ -## Generating Zsh Completion For Your cobra.Command +--- +weight: 14 +--- + +# Zsh completions + +Cobra supports native zsh completion generated from the root `cobra.Command`. +The generated completion script should be put somewhere in your `$fpath` and be named +`_`. You will need to start a new shell for the completions to become available. + +Zsh supports descriptions for completions. Cobra will provide the description automatically, +based on usage information. Cobra provides a way to completely disable such descriptions by +using `GenZshCompletionNoDesc()` or `GenZshCompletionFileNoDesc()`. You can choose to make +this a configurable option to your users. +``` +# With descriptions +$ helm s[tab] +search -- search for a keyword in charts +show -- show information of a chart +status -- displays the status of the named release + +# Without descriptions +$ helm s[tab] +search show status +``` +*Note*: Because of backward-compatibility requirements, we were forced to have a different API to disable completion descriptions between `zsh` and `fish`. + +## Limitations + +* Custom completions implemented in Bash scripting (legacy) are not supported and will be ignored for `zsh` (including the use of the `BashCompCustom` flag annotation). + * You should instead use `ValidArgsFunction` and `RegisterFlagCompletionFunc()` which are portable to the different shells (`bash`, `zsh`, `fish`, `powershell`). +* The function `MarkFlagCustom()` is not supported and will be ignored for `zsh`. + * You should instead use `RegisterFlagCompletionFunc()`. + +## Zsh completions standardization + +Cobra 1.1 standardized its zsh completion support to align it with its other shell completions. Although the API was kept backward-compatible, some small changes in behavior were introduced. +Please refer to [Zsh Completions](zsh.md) for details. -Please refer to [Shell Completions](_index.md) for details. ## Zsh completions standardization Cobra 1.1 standardized its zsh completion support to align it with its other shell completions. Although the API was kept backwards-compatible, some small changes in behavior were introduced. -### Deprecation summary +## Deprecation summary See further below for more details on these deprecations. @@ -16,9 +52,10 @@ See further below for more details on these deprecations. * `cmd.MarkZshCompPositionalArgumentWords()` is **deprecated** and silently ignored. * Instead use `ValidArgsFunction`. -### Behavioral changes +## Behavioral changes + +### Noun completion* -**Noun completion** |Old behavior|New behavior| |---|---| |No file completion by default (opposite of bash)|File completion by default; use `ValidArgsFunction` with `ShellCompDirectiveNoFileComp` to turn off file completion on a per-argument basis| @@ -27,7 +64,7 @@ See further below for more details on these deprecations. |`cmd.MarkZshCompPositionalArgumentFile(pos, glob[])` used to turn on file completion **with glob filtering** on a per-argument position basis (zsh-specific)|`cmd.MarkZshCompPositionalArgumentFile()` is **deprecated** and silently ignored; use `ValidArgsFunction` with `ShellCompDirectiveFilterFileExt` for file **extension** filtering (not full glob filtering)| |`cmd.MarkZshCompPositionalArgumentWords(pos, words[])` used to provide completion choices on a per-argument position basis (zsh-specific)|`cmd.MarkZshCompPositionalArgumentWords()` is **deprecated** and silently ignored; use `ValidArgsFunction` to achieve the same behavior| -**Flag-value completion** +### Flag-value completion |Old behavior|New behavior| |---|---| @@ -38,7 +75,7 @@ See further below for more details on these deprecations. |Completion of a flag name does not repeat, unless flag is of type `*Array` or `*Slice` (not supported by bash)|Retained for `zsh` and added to `fish`| |Completion of a flag name does not provide the `=` form (unlike bash)|Retained for `zsh` and added to `fish`| -**Improvements** +## Improvements * Custom completion support (`ValidArgsFunction` and `RegisterFlagCompletionFunc()`) * File completion by default if no other completions found diff --git a/site/content/concepts.md b/site/content/concepts.md new file mode 100644 index 0000000000..b5126fc152 --- /dev/null +++ b/site/content/concepts.md @@ -0,0 +1,50 @@ +--- +weight: 2 +--- + +# Concepts + +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 + +## Commands + +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. + +[More about cobra.Command](https://godoc.org/github.com/spf13/cobra#Command) + +## Flags + +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](https://golang.org/pkg/flag/). +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](https://github.com/spf13/pflag), a fork of the flag standard library +which maintains the same interface while adding POSIX compliance. diff --git a/CONTRIBUTING.md b/site/content/contributing.md similarity index 99% rename from CONTRIBUTING.md rename to site/content/contributing.md index 6f356e6a82..b31fc7e558 100644 --- a/CONTRIBUTING.md +++ b/site/content/contributing.md @@ -1,3 +1,7 @@ +--- +weight: 30 +--- + # Contributing to Cobra Thank you so much for contributing to Cobra. We appreciate your time and help. diff --git a/site/content/docgen/_index.md b/site/content/docgen/_index.md index eba2a5fce7..6f8aecb523 100644 --- a/site/content/docgen/_index.md +++ b/site/content/docgen/_index.md @@ -1,3 +1,7 @@ +--- +weight: 20 +--- + # Documentation generation - [Man page docs](man.md) @@ -6,11 +10,11 @@ - [Yaml docs](yaml.md) ## Options + ### `DisableAutoGenTag` -You may set `cmd.DisableAutoGenTag = true` -to _entirely_ remove the auto generated string "Auto generated by spf13/cobra..." -from any documentation source. +You may set `cmd.DisableAutoGenTag = true` to _entirely_ remove the auto generated string +"Auto generated by spf13/cobra..." from any documentation source. ### `InitDefaultCompletionCmd` diff --git a/site/content/docgen/man.md b/site/content/docgen/man.md index 3709160f34..6a9e1f0390 100644 --- a/site/content/docgen/man.md +++ b/site/content/docgen/man.md @@ -1,4 +1,8 @@ -# Generating Man Pages For Your Own cobra.Command +--- +weight: 21 +--- + +## Man Pages Generating man pages from a cobra command is incredibly easy. An example is as follows: diff --git a/site/content/docgen/md.md b/site/content/docgen/md.md index 1659175cfd..6c9ea81292 100644 --- a/site/content/docgen/md.md +++ b/site/content/docgen/md.md @@ -1,4 +1,8 @@ -# Generating Markdown Docs For Your Own cobra.Command +--- +weight: 22 +--- + +## Markdown Docs Generating Markdown pages from a cobra command is incredibly easy. An example is as follows: @@ -26,7 +30,7 @@ func main() { That will get you a Markdown document `/tmp/test.md` -## Generate markdown docs for the entire command tree +### The entire command tree This program can actually generate docs for the kubectl command in the kubernetes project @@ -55,7 +59,7 @@ func main() { This will generate a whole series of files, one for each command in the tree, in the directory specified (in this case "./") -## Generate markdown docs for a single command +### For a single command You may wish to have more control over the output, or only generate for a single command, instead of the entire command tree. If this is the case you may prefer to `GenMarkdown` instead of `GenMarkdownTree` @@ -69,7 +73,7 @@ You may wish to have more control over the output, or only generate for a single This will write the markdown doc for ONLY "cmd" into the out, buffer. -## Customize the output +### Customize the output Both `GenMarkdown` and `GenMarkdownTree` have alternate versions with callbacks to get some control of the output: diff --git a/site/content/docgen/rest.md b/site/content/docgen/rest.md index 3041c573ab..c8e11ca42c 100644 --- a/site/content/docgen/rest.md +++ b/site/content/docgen/rest.md @@ -1,4 +1,8 @@ -# Generating ReStructured Text Docs For Your Own cobra.Command +--- +weight: 23 +--- + +## ReStructured Text Docs Generating ReST pages from a cobra command is incredibly easy. An example is as follows: @@ -26,7 +30,7 @@ func main() { That will get you a ReST document `/tmp/test.rst` -## Generate ReST docs for the entire command tree +### The entire command tree This program can actually generate docs for the kubectl command in the kubernetes project @@ -55,7 +59,7 @@ func main() { This will generate a whole series of files, one for each command in the tree, in the directory specified (in this case "./") -## Generate ReST docs for a single command +### For a single command You may wish to have more control over the output, or only generate for a single command, instead of the entire command tree. If this is the case you may prefer to `GenReST` instead of `GenReSTTree` @@ -69,7 +73,7 @@ You may wish to have more control over the output, or only generate for a single This will write the ReST doc for ONLY "cmd" into the out, buffer. -## Customize the output +### Customize the output Both `GenReST` and `GenReSTTree` have alternate versions with callbacks to get some control of the output: diff --git a/site/content/docgen/yaml.md b/site/content/docgen/yaml.md index 172e61d121..f3dd39b6a6 100644 --- a/site/content/docgen/yaml.md +++ b/site/content/docgen/yaml.md @@ -1,4 +1,8 @@ -# Generating Yaml Docs For Your Own cobra.Command +--- +weight: 24 +--- + +## Yaml Docs Generating yaml files from a cobra command is incredibly easy. An example is as follows: @@ -26,7 +30,7 @@ func main() { That will get you a Yaml document `/tmp/test.yaml` -## Generate yaml docs for the entire command tree +### The entire command tree This program can actually generate docs for the kubectl command in the kubernetes project @@ -55,7 +59,7 @@ func main() { This will generate a whole series of files, one for each command in the tree, in the directory specified (in this case "./") -## Generate yaml docs for a single command +### For a single command You may wish to have more control over the output, or only generate for a single command, instead of the entire command tree. If this is the case you may prefer to `GenYaml` instead of `GenYamlTree` @@ -66,7 +70,7 @@ You may wish to have more control over the output, or only generate for a single This will write the yaml doc for ONLY "cmd" into the out, buffer. -## Customize the output +### Customize the output Both `GenYaml` and `GenYamlTree` have alternate versions with callbacks to get some control of the output: diff --git a/site/content/getting_started.md b/site/content/getting_started.md new file mode 100644 index 0000000000..d1cf608d69 --- /dev/null +++ b/site/content/getting_started.md @@ -0,0 +1,648 @@ +--- +weight: 4 +--- + +# Getting Started + +While you are welcome to provide your own organization, typically a Cobra-based +application will follow the following organizational structure: + +``` + ▾ appName/ + ▾ cmd/ + add.go + your.go + commands.go + here.go + main.go +``` + +In a Cobra app, typically the main.go file is very bare. It serves one purpose: to initialize Cobra. + +```go +package main + +import ( + "{pathToYourApp}/cmd" +) + +func main() { + cmd.Execute() +} +``` + +## Using the Cobra Generator + +Cobra provides its own program that will create your application and add any +commands you want. It's the easiest way to incorporate Cobra into your application. + +[Here](https://github.com/spf13/cobra/blob/master/cobra/README.md) you can find more information about it. + +## Using the Cobra Library + +To manually implement Cobra you need to create a bare main.go file and a rootCmd file. +You will optionally provide additional commands as you see fit. + +### Create rootCmd + +Cobra doesn't require any special constructors. Simply create your commands. + +Ideally you place this in app/cmd/root.go: + +```go +var rootCmd = &cobra.Command{ + Use: "hugo", + Short: "Hugo is a very fast static site generator", + Long: `A Fast and Flexible Static Site Generator built with + love by spf13 and friends in Go. + Complete documentation is available at http://hugo.spf13.com`, + Run: func(cmd *cobra.Command, args []string) { + // Do Stuff Here + }, +} + +func Execute() { + if err := rootCmd.Execute(); err != nil { + fmt.Fprintln(os.Stderr, err) + os.Exit(1) + } +} +``` + +You will additionally define flags and handle configuration in your init() function. + +For example cmd/root.go: + +```go +package cmd + +import ( + "fmt" + "os" + + homedir "github.com/mitchellh/go-homedir" + "github.com/spf13/cobra" + "github.com/spf13/viper" +) + +var ( + // Used for flags. + cfgFile string + userLicense string + + rootCmd = &cobra.Command{ + Use: "cobra", + Short: "A generator for Cobra based Applications", + Long: `Cobra is a CLI library for Go that empowers applications. +This application is a tool to generate the needed files +to quickly create a Cobra application.`, + } +) + +// Execute executes the root command. +func Execute() error { + return rootCmd.Execute() +} + +func init() { + cobra.OnInitialize(initConfig) + + rootCmd.PersistentFlags().StringVar(&cfgFile, "config", "", "config file (default is $HOME/.cobra.yaml)") + rootCmd.PersistentFlags().StringP("author", "a", "YOUR NAME", "author name for copyright attribution") + rootCmd.PersistentFlags().StringVarP(&userLicense, "license", "l", "", "name of license for the project") + rootCmd.PersistentFlags().Bool("viper", true, "use Viper for configuration") + viper.BindPFlag("author", rootCmd.PersistentFlags().Lookup("author")) + viper.BindPFlag("useViper", rootCmd.PersistentFlags().Lookup("viper")) + viper.SetDefault("author", "NAME HERE ") + viper.SetDefault("license", "apache") + + rootCmd.AddCommand(addCmd) + rootCmd.AddCommand(initCmd) +} + +func er(msg interface{}) { + fmt.Println("Error:", msg) + os.Exit(1) +} + +func initConfig() { + if cfgFile != "" { + // Use config file from the flag. + viper.SetConfigFile(cfgFile) + } else { + // Find home directory. + home, err := homedir.Dir() + if err != nil { + er(err) + } + + // Search config in home directory with name ".cobra" (without extension). + viper.AddConfigPath(home) + viper.SetConfigName(".cobra") + } + + viper.AutomaticEnv() + + if err := viper.ReadInConfig(); err == nil { + fmt.Println("Using config file:", viper.ConfigFileUsed()) + } +} +``` + +### Create your main.go + +With the root command you need to have your main function execute it. +Execute should be run on the root for clarity, though it can be called on any command. + +In a Cobra app, typically the main.go file is very bare. It serves, one purpose, to initialize Cobra. + +```go +package main + +import ( + "{pathToYourApp}/cmd" +) + +func main() { + cmd.Execute() +} +``` + +### Create additional commands + +Additional commands can be defined and typically are each given their own file +inside of the cmd/ directory. + +If you wanted to create a version command you would create cmd/version.go and +populate it with the following: + +```go +package cmd + +import ( + "fmt" + + "github.com/spf13/cobra" +) + +func init() { + rootCmd.AddCommand(versionCmd) +} + +var versionCmd = &cobra.Command{ + Use: "version", + Short: "Print the version number of Hugo", + Long: `All software has versions. This is Hugo's`, + Run: func(cmd *cobra.Command, args []string) { + fmt.Println("Hugo Static Site Generator v0.9 -- HEAD") + }, +} +``` + +### Returning and handling errors + +If you wish to return an error to the caller of a command, `RunE` can be used. + +```go +package cmd + +import ( + "fmt" + + "github.com/spf13/cobra" +) + +func init() { + rootCmd.AddCommand(tryCmd) +} + +var tryCmd = &cobra.Command{ + Use: "try", + Short: "Try and possibly fail at something", + RunE: func(cmd *cobra.Command, args []string) error { + if err := someFunc(); err != nil { + return err + } + return nil + }, +} +``` + +The error can then be caught at the execute function call. + +## Working with Flags + +Flags provide modifiers to control how the action command operates. + +### Assign flags to a command + +Since the flags are defined and used in different locations, we need to +define a variable outside with the correct scope to assign the flag to +work with. + +```go +var Verbose bool +var Source string +``` + +There are two different approaches to assign a flag. + +### Persistent Flags + +A flag can be 'persistent', meaning that this flag will be available to the +command it's assigned to as well as every command under that command. For +global flags, assign a flag as a persistent flag on the root. + +```go +rootCmd.PersistentFlags().BoolVarP(&Verbose, "verbose", "v", false, "verbose output") +``` + +### Local Flags + +A flag can also be assigned locally, which will only apply to that specific command. + +```go +localCmd.Flags().StringVarP(&Source, "source", "s", "", "Source directory to read from") +``` + +### Local Flag on Parent Commands + +By default, Cobra only parses local flags on the target command, and any local flags on +parent commands are ignored. By enabling `Command.TraverseChildren`, Cobra will +parse local flags on each command before executing the target command. + +```go +command := cobra.Command{ + Use: "print [OPTIONS] [COMMANDS]", + TraverseChildren: true, +} +``` + +### Bind Flags with Config + +You can also bind your flags with [viper](https://github.com/spf13/viper): +```go +var author string + +func init() { + rootCmd.PersistentFlags().StringVar(&author, "author", "YOUR NAME", "Author name for copyright attribution") + viper.BindPFlag("author", rootCmd.PersistentFlags().Lookup("author")) +} +``` + +In this example, the persistent flag `author` is bound with `viper`. +**Note**: the variable `author` will not be set to the value from config, +when the `--author` flag is not provided by user. + +More in [viper documentation](https://github.com/spf13/viper#working-with-flags). + +### Required flags + +Flags are optional by default. If instead you wish your command to report an error +when a flag has not been set, mark it as required: +```go +rootCmd.Flags().StringVarP(&Region, "region", "r", "", "AWS region (required)") +rootCmd.MarkFlagRequired("region") +``` + +Or, for persistent flags: +```go +rootCmd.PersistentFlags().StringVarP(&Region, "region", "r", "", "AWS region (required)") +rootCmd.MarkPersistentFlagRequired("region") +``` + +## Positional and Custom Arguments + +Validation of positional arguments can be specified using the `Args` field +of `Command`. + +The following validators are built in: + +- `NoArgs` - the command will report an error if there are any positional args. +- `ArbitraryArgs` - the command will accept any args. +- `OnlyValidArgs` - the command will report an error if there are any positional args that are not in the `ValidArgs` field of `Command`. +- `MinimumNArgs(int)` - the command will report an error if there are not at least N positional args. +- `MaximumNArgs(int)` - the command will report an error if there are more than N positional args. +- `ExactArgs(int)` - the command will report an error if there are not exactly N positional args. +- `ExactValidArgs(int)` - the command will report an error if there are not exactly N positional args OR if there are any positional args that are not in the `ValidArgs` field of `Command` +- `RangeArgs(min, max)` - the command will report an error if the number of args is not between the minimum and maximum number of expected args. + +An example of setting the custom validator: + +```go +var cmd = &cobra.Command{ + Short: "hello", + Args: func(cmd *cobra.Command, args []string) error { + if len(args) < 1 { + return errors.New("requires a color argument") + } + if myapp.IsValidColor(args[0]) { + return nil + } + return fmt.Errorf("invalid color specified: %s", args[0]) + }, + Run: func(cmd *cobra.Command, args []string) { + fmt.Println("Hello, World!") + }, +} +``` + +## Example + +In the example below, we have defined three commands. Two are at the top level +and one (cmdTimes) is a child of one of the top commands. In this case the root +is not executable, meaning that a subcommand is required. This is accomplished +by not providing a 'Run' for the 'rootCmd'. + +We have only defined one flag for a single command. + +More documentation about flags is available at https://github.com/spf13/pflag + +```go +package main + +import ( + "fmt" + "strings" + + "github.com/spf13/cobra" +) + +func main() { + var echoTimes int + + var cmdPrint = &cobra.Command{ + Use: "print [string to print]", + Short: "Print anything to the screen", + Long: `print is for printing anything back to the screen. +For many years people have printed back to the screen.`, + Args: cobra.MinimumNArgs(1), + Run: func(cmd *cobra.Command, args []string) { + fmt.Println("Print: " + strings.Join(args, " ")) + }, + } + + var cmdEcho = &cobra.Command{ + Use: "echo [string to echo]", + Short: "Echo anything to the screen", + Long: `echo is for echoing anything back. +Echo works a lot like print, except it has a child command.`, + Args: cobra.MinimumNArgs(1), + Run: func(cmd *cobra.Command, args []string) { + fmt.Println("Echo: " + strings.Join(args, " ")) + }, + } + + var cmdTimes = &cobra.Command{ + Use: "times [string to echo]", + Short: "Echo anything to the screen more times", + Long: `echo things multiple times back to the user by providing +a count and a string.`, + Args: cobra.MinimumNArgs(1), + Run: func(cmd *cobra.Command, args []string) { + for i := 0; i < echoTimes; i++ { + fmt.Println("Echo: " + strings.Join(args, " ")) + } + }, + } + + cmdTimes.Flags().IntVarP(&echoTimes, "times", "t", 1, "times to echo the input") + + var rootCmd = &cobra.Command{Use: "app"} + rootCmd.AddCommand(cmdPrint, cmdEcho) + cmdEcho.AddCommand(cmdTimes) + rootCmd.Execute() +} +``` + +For a more complete example of a larger application, please checkout [Hugo](http://gohugo.io/). + +## Help Command + +Cobra automatically adds a help command to your application when you have subcommands. +This will be called when a user runs 'app help'. Additionally, help will also +support all other commands as input. Say, for instance, you have a command called +'create' without any additional configuration; Cobra will work when 'app help +create' is called. Every command will automatically have the '--help' flag added. + +### Example + +The following output is automatically generated by Cobra. Nothing beyond the +command and flag definitions are needed. + + $ cobra help + + Cobra is a CLI library for Go that empowers applications. + This application is a tool to generate the needed files + to quickly create a Cobra application. + + Usage: + cobra [command] + + Available Commands: + add Add a command to a Cobra Application + help Help about any command + init Initialize a Cobra Application + + Flags: + -a, --author string author name for copyright attribution (default "YOUR NAME") + --config string config file (default is $HOME/.cobra.yaml) + -h, --help help for cobra + -l, --license string name of license for the project + --viper use Viper for configuration (default true) + + Use "cobra [command] --help" for more information about a command. + + +Help is just a command like any other. There is no special logic or behavior +around it. In fact, you can provide your own if you want. + +### Defining your own help + +You can provide your own Help command or your own template for the default command to use +with following functions: + +```go +cmd.SetHelpCommand(cmd *Command) +cmd.SetHelpFunc(f func(*Command, []string)) +cmd.SetHelpTemplate(s string) +``` + +The latter two will also apply to any children commands. + +## Usage Message + +When the user provides an invalid flag or invalid command, Cobra responds by +showing the user the 'usage'. + +### Example +You may recognize this from the help above. That's because the default help +embeds the usage as part of its output. + + $ cobra --invalid + Error: unknown flag: --invalid + Usage: + cobra [command] + + Available Commands: + add Add a command to a Cobra Application + help Help about any command + init Initialize a Cobra Application + + Flags: + -a, --author string author name for copyright attribution (default "YOUR NAME") + --config string config file (default is $HOME/.cobra.yaml) + -h, --help help for cobra + -l, --license string name of license for the project + --viper use Viper for configuration (default true) + + Use "cobra [command] --help" for more information about a command. + +### Defining your own usage +You can provide your own usage function or template for Cobra to use. +Like help, the function and template are overridable through public methods: + +```go +cmd.SetUsageFunc(f func(*Command) error) +cmd.SetUsageTemplate(s string) +``` + +## Version Flag + +Cobra adds a top-level '--version' flag if the Version field is set on the root command. +Running an application with the '--version' flag will print the version to stdout using +the version template. The template can be customized using the +`cmd.SetVersionTemplate(s string)` function. + +## PreRun and PostRun Hooks + +It is possible to run functions before or after the main `Run` function of your command. The `PersistentPreRun` and `PreRun` functions will be executed before `Run`. `PersistentPostRun` and `PostRun` will be executed after `Run`. The `Persistent*Run` functions will be inherited by children if they do not declare their own. These functions are run in the following order: + +- `PersistentPreRun` +- `PreRun` +- `Run` +- `PostRun` +- `PersistentPostRun` + +An example of two commands which use all of these features is below. When the subcommand is executed, it will run the root command's `PersistentPreRun` but not the root command's `PersistentPostRun`: + +```go +package main + +import ( + "fmt" + + "github.com/spf13/cobra" +) + +func main() { + + var rootCmd = &cobra.Command{ + Use: "root [sub]", + Short: "My root command", + PersistentPreRun: func(cmd *cobra.Command, args []string) { + fmt.Printf("Inside rootCmd PersistentPreRun with args: %v\n", args) + }, + PreRun: func(cmd *cobra.Command, args []string) { + fmt.Printf("Inside rootCmd PreRun with args: %v\n", args) + }, + Run: func(cmd *cobra.Command, args []string) { + fmt.Printf("Inside rootCmd Run with args: %v\n", args) + }, + PostRun: func(cmd *cobra.Command, args []string) { + fmt.Printf("Inside rootCmd PostRun with args: %v\n", args) + }, + PersistentPostRun: func(cmd *cobra.Command, args []string) { + fmt.Printf("Inside rootCmd PersistentPostRun with args: %v\n", args) + }, + } + + var subCmd = &cobra.Command{ + Use: "sub [no options!]", + Short: "My subcommand", + PreRun: func(cmd *cobra.Command, args []string) { + fmt.Printf("Inside subCmd PreRun with args: %v\n", args) + }, + Run: func(cmd *cobra.Command, args []string) { + fmt.Printf("Inside subCmd Run with args: %v\n", args) + }, + PostRun: func(cmd *cobra.Command, args []string) { + fmt.Printf("Inside subCmd PostRun with args: %v\n", args) + }, + PersistentPostRun: func(cmd *cobra.Command, args []string) { + fmt.Printf("Inside subCmd PersistentPostRun with args: %v\n", args) + }, + } + + rootCmd.AddCommand(subCmd) + + rootCmd.SetArgs([]string{""}) + rootCmd.Execute() + fmt.Println() + rootCmd.SetArgs([]string{"sub", "arg1", "arg2"}) + rootCmd.Execute() +} +``` + +Output: +``` +Inside rootCmd PersistentPreRun with args: [] +Inside rootCmd PreRun with args: [] +Inside rootCmd Run with args: [] +Inside rootCmd PostRun with args: [] +Inside rootCmd PersistentPostRun with args: [] + +Inside rootCmd PersistentPreRun with args: [arg1 arg2] +Inside subCmd PreRun with args: [arg1 arg2] +Inside subCmd Run with args: [arg1 arg2] +Inside subCmd PostRun with args: [arg1 arg2] +Inside subCmd PersistentPostRun with args: [arg1 arg2] +``` + +## Suggestions when "unknown command" happens + +Cobra will print automatic suggestions when "unknown command" errors happen. This allows Cobra to behave similarly to the `git` command when a typo happens. For example: + +``` +$ hugo srever +Error: unknown command "srever" for "hugo" + +Did you mean this? + server + +Run 'hugo --help' for usage. +``` + +Suggestions are automatic based on every subcommand registered and use an implementation of [Levenshtein distance](http://en.wikipedia.org/wiki/Levenshtein_distance). Every registered command that matches a minimum distance of 2 (ignoring case) will be displayed as a suggestion. + +If you need to disable suggestions or tweak the string distance in your command, use: + +```go +command.DisableSuggestions = true +``` + +or + +```go +command.SuggestionsMinimumDistance = 1 +``` + +You can also explicitly set names for which a given command will be suggested using the `SuggestFor` attribute. This allows suggestions for strings that are not close in terms of string distance, but makes sense in your set of commands and for some which you don't want aliases. Example: + +``` +$ kubectl remove +Error: unknown command "remove" for "kubectl" + +Did you mean this? + delete + +Run 'kubectl help' for usage. +``` + +## Generating documentation for your command + +Cobra can generate documentation based on subcommands, flags, etc. Read more about it in the [docs generation documentation](doc/README.md). + +## Generating shell completions + +Cobra can generate a shell-completion file for the following shells: Bash, Zsh, Fish, Powershell. If you add more information to your commands, these completions can be amazingly powerful and flexible. Read more about it in [Shell Completions](shell_completions.md). diff --git a/site/content/installing.md b/site/content/installing.md new file mode 100644 index 0000000000..29cda2888e --- /dev/null +++ b/site/content/installing.md @@ -0,0 +1,17 @@ +--- +weight: 3 +--- + +# Installing + +Using Cobra is easy. First, use `go get` to install the latest version +of the library. This command will install the `cobra` generator executable +along with the library and its dependencies: + + go get -u github.com/spf13/cobra + +Next, include Cobra in your application: + +```go +import "github.com/spf13/cobra" +``` diff --git a/site/content/license.md b/site/content/license.md new file mode 100644 index 0000000000..5093296ec8 --- /dev/null +++ b/site/content/license.md @@ -0,0 +1,7 @@ +--- +weight: 33 +--- + +# License + +Cobra is released under the Apache 2.0 license. See [LICENSE.txt](https://github.com/spf13/cobra/blob/master/LICENSE.txt) diff --git a/site/content/overview.md b/site/content/overview.md new file mode 100644 index 0000000000..f3d9a95484 --- /dev/null +++ b/site/content/overview.md @@ -0,0 +1,27 @@ +--- +weight: 1 +--- + +# Overview + +Cobra is a library providing a simple interface to create powerful modern CLI +interfaces similar to git & go tools. + +Cobra is also an application that will generate your application scaffolding to rapidly +develop a Cobra-based application. + +Cobra provides: + +* Easy subcommand-based CLIs: `app server`, `app fetch`, etc. +* Fully POSIX-compliant flags (including short & long versions) +* Nested subcommands +* Global, local and cascading flags +* Easy generation of applications & commands with `cobra init appname` & `cobra add cmdname` +* Intelligent suggestions (`app srver`... did you mean `app server`?) +* Automatic help generation for commands and flags +* Automatic help flag recognition of `-h`, `--help`, etc. +* Automatically generated shell autocomplete for your application (bash, zsh, fish, powershell) +* Automatically generated man pages for your application +* Command aliases so you can change things without breaking them +* The flexibility to define your own help, usage, etc. +* Optional tight integration with [viper](http://github.com/spf13/viper) for 12-factor apps diff --git a/site/content/projects_using_cobra.md b/site/content/projects_using_cobra.md index 8a291eb20e..eb82f0907e 100644 --- a/site/content/projects_using_cobra.md +++ b/site/content/projects_using_cobra.md @@ -1,4 +1,8 @@ -## Projects using Cobra +--- +weight: 32 +--- + +# Projects using Cobra - [Allero](https://github.com/allero-io/allero) - [Arewefastyet](https://benchmark.vitess.io) diff --git a/site/static/images/logo.png b/site/static/images/logo.png new file mode 100644 index 0000000000000000000000000000000000000000..a6174acc8ac693747cacc71f8c7c1da3834c7a6d GIT binary patch literal 58138 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