38 lines
No EOL
804 B
Markdown
38 lines
No EOL
804 B
Markdown
### The "Help" package
|
|
|
|
This package provides --help flag feature to your cli.
|
|
It recognize both short and long flags.
|
|
|
|
-------------
|
|
|
|
### Usage
|
|
1. Download the package by **go get** command:
|
|
```shell
|
|
go get code.foilhatguy.casa/pub/help
|
|
```
|
|
2. Add the package as a tool dependency to your project in
|
|
tools.go:
|
|
```go
|
|
// +build tools
|
|
|
|
package tools
|
|
|
|
import (
|
|
_ "code.foilhatguy.casa/pub/help"
|
|
)
|
|
```
|
|
3. In the main package add a go:generate directive:
|
|
```go
|
|
//go:generate go run code.foilhatguy.casa/pub/help
|
|
```
|
|
4. Run code generator by **go generate** command:
|
|
```shell
|
|
go generate ./...
|
|
```
|
|
The package will generate a **help.go** file as a part of
|
|
the main package. It will contain code for --help flag detection.
|
|
|
|
5. Build and run your application with the --help flag.
|
|
```shell
|
|
go run . --help
|
|
``` |