Documentation
¶
Index ¶
Examples ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Command ¶
type Command struct {
// Name is just a one-word.
Name string
// Description of the command.
Description string
// Do will be invoked.
Do func(ctx context.Context, args []string) error
}
Command specifies a sub-command for a program's command-line interface.
type Config ¶
type Config struct {
// AppName is an optional name for the app, if empty os.Args[0] will be used.
AppName string
// AppDescription is an optional description. default is empty.
AppDescription string
// Version of the application.
Version string
// Output is a destionation where result will be printed.
// Exported for testing purpose only, if nil os.Stderr is used.
Output io.Writer
// Context for commands, if nil context based on os.Interrupt will be used.
Context context.Context
// Args passed to the executable, if nil os.Args[1:] will be used.
Args []string
// Usage of the application, if nil default will be used,
Usage func(cfg Config, cmds []Command)
}
Config for the runner.
type Runner ¶
type Runner struct {
// contains filtered or unexported fields
}
Runner of the sub-commands.
Example ¶
package main
import (
"context"
"fmt"
"net/http"
"time"
"github.com/cristalhq/acmd"
)
func main() {
const format = "15:04:05"
now, _ := time.Parse("15:04:05", "10:20:30")
cmds := []acmd.Command{
{
Name: "now",
Description: "prints current time",
Do: func(ctx context.Context, args []string) error {
fmt.Printf("now: %s\n", now.Format(format))
return nil
},
},
{
Name: "status",
Description: "prints status of the system",
Do: func(ctx context.Context, args []string) error {
req, _ := http.NewRequestWithContext(ctx, http.MethodGet, "https://www.githubstatus.com/", http.NoBody)
resp, err := http.DefaultClient.Do(req)
if err != nil {
return err
}
defer resp.Body.Close()
fmt.Print()
return nil
},
},
}
r := acmd.RunnerOf(cmds, acmd.Config{
AppName: "acmd-example",
AppDescription: "Example of acmd package",
Version: "the best v0.x.y",
Context: nil,
Args: []string{"now"},
Usage: nil,
})
if err := r.Run(); err != nil {
panic(err)
}
}
Output: now: 10:20:30
Click to show internal directories.
Click to hide internal directories.