mirror of
https://github.com/go-task/task.git
synced 2026-09-02 12:16:04 +02:00
ed7a206e19
Bash, Fish, Zsh, Nushell and PowerShell now share a single backend: `task __complete` returns the suggestions plus a directive, and every wrapper is a thin shim around it. All five shells offer the same suggestions — task names, aliases, flags, flag values and per-task CLI variables. The Zsh `show-aliases` and `verbose` zstyles keep working, now backed by the `--no-aliases` and `--no-descriptions` completion flags. The engine is opt-in via `task --new-completion <shell>`, leaving `--completion` and the legacy scripts untouched; it will become the default in a future release. The new wrappers live under `completion/next/`. Completing a keystroke never reaches the network, never blocks on a stdin entrypoint, and honors every flag that decides how the Taskfile is loaded. Ref resolution shared by `requires` and enum completion moved to `internal/refs`. A cross-shell test suite exercises the protocol in Go with thin shell smoke tests, and runs in CI.
60 lines
1.5 KiB
Go
60 lines
1.5 KiB
Go
// Package complete implements the `task __complete` protocol consumed by the
|
|
// shell wrappers. It mirrors cobra v2 so a future migration stays cheap.
|
|
package complete
|
|
|
|
import "os"
|
|
|
|
const CommandName = "__complete"
|
|
|
|
func IsActive() bool {
|
|
return len(os.Args) >= 2 && os.Args[1] == CommandName
|
|
}
|
|
|
|
// Directive mirrors cobra's ShellCompDirective bitfield, emitted as `:<n>`.
|
|
type Directive int
|
|
|
|
const (
|
|
DirectiveDefault Directive = 0
|
|
// Never emitted: a failed Taskfile load still leaves flags worth completing.
|
|
DirectiveError Directive = 1 << 0
|
|
DirectiveNoSpace Directive = 1 << 1
|
|
DirectiveNoFileComp Directive = 1 << 2
|
|
DirectiveFilterFileExt Directive = 1 << 3
|
|
DirectiveFilterDirs Directive = 1 << 4
|
|
DirectiveKeepOrder Directive = 1 << 5
|
|
)
|
|
|
|
type Suggestion struct {
|
|
Value string
|
|
Description string
|
|
}
|
|
|
|
// Named after the control flags, so the zero value is the standard set.
|
|
type Options struct {
|
|
NoAliases bool
|
|
NoDescriptions bool
|
|
}
|
|
|
|
// Control flags the shell wrappers prepend to the __complete invocation.
|
|
const (
|
|
FlagNoAliases = "--no-aliases"
|
|
FlagNoDescriptions = "--no-descriptions"
|
|
)
|
|
|
|
// Only leading flags are consumed; a `--no-aliases` typed later is left alone.
|
|
func ParseOptions(args []string) (Options, []string) {
|
|
var opts Options
|
|
for len(args) > 0 {
|
|
switch args[0] {
|
|
case FlagNoAliases:
|
|
opts.NoAliases = true
|
|
case FlagNoDescriptions:
|
|
opts.NoDescriptions = true
|
|
default:
|
|
return opts, args
|
|
}
|
|
args = args[1:]
|
|
}
|
|
return opts, args
|
|
}
|