script

type DynamicCommand struct {
	Cmd        any
	Tags       []string
	Help       string
	Predictors map[string]complete.Predictor
}

type DynamicCommands map[string]DynamicCommand

type InputEnvVar string

type InstallCompletions bool

type Options struct {
	// command line options specification, as accepted by kong library
	CLI             interface{}
	Description     string
	DynamicCommands DynamicCommands
	// additional structs for CLI, they will be merged with CLI
	Plugins Plugins
	// map of variables you can use in a subset of CLI / Plugins tags (default, enum, help) in the form of ${varName}
	Vars Vars
	// Writers change stdout and stderr targets. Useful for testing.
	Writers Writers
	// ExitFunc custom "exit program in case of parsing error" function. Default os.Exit. Useful for testing
	ExitFunc func(code int)

	// Used for predicting script args in terminal.
	// map of predictor-name -> predictor. To use them, include `predictor:"name"` in kong struct field tag.
	//  Check kongplete README for info
	Predictors map[string]complete.Predictor
	// contains filtered or unexported fields
}

type Plugins = kong.Plugins

type Script interface {
	// Dir directory where *.go script (with main() method) is located. Absolute path
	Dir() string
	// ScriptFileName filename of *.go script (with main() method)
	ScriptFileName() string
	// ScriptAlias returns script alias that is used as app name in help text, and also installed by GetInstallCompletionsScript
	// as an alias user can run and receive completions
	ScriptAlias() string
	// Cwd directory from where go script was called
	Cwd() string
	// RunCommand run command selected by Kong CLI based on command line arguments
	RunCommand(context ...any) error
	// GetInstallCompletionsScript returns script lines you can execute in bash, or put in .bashrc file to have an alias, and autocompletions for
	// this script
	GetInstallCompletionsScript() string
	// PrintUsage print usage - specific for app arguments provided
	PrintUsage()
	// PrintAppUsageAndExit print usage and exit - not specific to arguments provided - just like running 'app --help'
	PrintAppUsageAndExit()
}

type Vars = kong.Vars

type Writers struct {
	Stdout io.Writer
	Stderr io.Writer
}