Alec Thomas
6408010083
Previously, there was a confusing mix of functionality shared between
the two wherein you would need to use the Kong type for printing errors,
etc. but it did not have access to the context in order to print
context-sensitive usage information. This has been fixed.
Additionally, there are now fuzzy correction suggestions for flags and
commands
Also added a server example which shows how Kong can be used for parsing
in interactive shells. Run with:
$ go run ./_examples/server/*.go
Then interact with:
$ ssh -p 6740 127.0.0.1
50 lines
911 B
Go
50 lines
911 B
Go
// nolint: govet
|
|
package main
|
|
|
|
import (
|
|
"fmt"
|
|
|
|
"github.com/alecthomas/kong"
|
|
)
|
|
|
|
// Ensure the grammar compiles.
|
|
var _ = kong.Must(&grammar{})
|
|
|
|
// Server interface.
|
|
type grammar struct {
|
|
Help helpCmd `cmd help:"Show help."`
|
|
Question helpCmd `cmd hidden name:"?" help:"Show help."`
|
|
|
|
Status statusCmd `cmd help:"Show server status."`
|
|
}
|
|
|
|
type statusCmd struct {
|
|
Verbose bool `short:"v" help:"Show verbose status information."`
|
|
}
|
|
|
|
func (s *statusCmd) Run(ctx *kong.Context) error {
|
|
ctx.Printf("OK")
|
|
return nil
|
|
}
|
|
|
|
type helpCmd struct {
|
|
Command []string `arg optional help:"Show help on command."`
|
|
}
|
|
|
|
// Run shows help.
|
|
func (h *helpCmd) Run(realCtx *kong.Context) error {
|
|
ctx, err := kong.Trace(realCtx.Kong, h.Command)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
if ctx.Error != nil {
|
|
return ctx.Error
|
|
}
|
|
err = ctx.PrintUsage(false)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
fmt.Fprintln(realCtx.Stdout)
|
|
return nil
|
|
}
|