feat: implement tab completion support

README.md

@@ -120,6 +120,6 @@ if err := cmd.Run(context.TODO(), os.Args[1:]); err != nil {
 
 - [ ] Audit bare `err` returns
   - [ ] Two types of errors: config and parse
-- [ ] Tab completion
+- [x] Tab completion
 - [ ] Allow variadic arguments
 - [ ] Allow slice and map based flags?

command_options.go

@@ -1,6 +1,8 @@
 package cli
 
 import (
+	"context"
+	"fmt"
 	"sort"
 
 	"github.com/broothie/option"
@@ -91,3 +93,35 @@ func AddVersionFlag(options ...option.Option[*Flag]) option.Func[*Command] {
 	defaultOptions := option.NewOptions(setFlagIsVersion(true), SetFlagDefault(false))
 	return AddFlag(versionFlagName, "Print version.", append(defaultOptions, options...)...)
 }
+
+// EnableCompletion adds a hidden completion command to the root command
+func EnableCompletion() option.Func[*Command] {
+	return func(command *Command) (*Command, error) {
+		// Only add to root commands
+		if command.parent != nil {
+			return command, nil
+		}
+
+		completionCmd := CompletionCommand(command)
+		return MountSubCmd(completionCmd).Apply(command)
+	}
+}
+
+// AddCompletionCommand adds a "completion" subcommand that generates shell completion scripts
+func AddCompletionCommand() option.Func[*Command] {
+	return func(command *Command) (*Command, error) {
+		// Only add to root commands
+		if command.parent != nil {
+			return command, nil
+		}
+
+		return AddSubCmd("completion", "Generate shell completion scripts",
+			AddSubCmd("bash", "Generate bash completion script",
+				SetHandler(func(ctx context.Context) error {
+					fmt.Print(command.GenerateBashCompletion())
+					return nil
+				}),
+			),
+		).Apply(command)
+	}
+}