Initial project import

tools/v/examples/cli_groups.v

@@ -0,0 +1,122 @@
+// This example demonstrates the `vlib/cli` features that show up automatically
+// in `--help` when you populate the optional `group`, `examples` and
+// `learn_more` fields of `Command`. No opt-in is required — leaving any of
+// them empty simply skips the corresponding section.
+//
+// Compile from the V repo root:
+//   v -o tasky examples/cli_groups.v
+//
+// Try it out:
+//   ./tasky --help          # root help with grouped commands and examples
+//   ./tasky issue --help    # sub-command help with INHERITED FLAGS
+//   ./tasky issue list -v
+//   ./tasky version
+module main
+
+import cli
+import os
+
+fn main() {
+	mut app := cli.Command{
+		name:        'tasky'
+		description: 'A tiny issue tracker CLI'
+		version:     '0.1.0'
+		posix_mode:  true
+		examples:    [
+			'\$ tasky issue list',
+			'\$ tasky issue create --title "Fix CI"',
+			'\$ tasky config get editor',
+		]
+		learn_more:  'Use `tasky <command> --help` for details about a command.\nDocumentation lives at https://example.test/tasky'
+	}
+	app.add_flag(cli.Flag{
+		flag:        .string
+		name:        'config'
+		abbrev:      'c'
+		description: 'Path to a tasky config file'
+		global:      true
+	})
+	app.add_command(issue_command())
+	app.add_command(config_command())
+	app.setup()
+	app.parse(os.args)
+}
+
+fn issue_command() cli.Command {
+	return cli.Command{
+		name:        'issue'
+		description: 'Work with issues'
+		group:       'Core commands'
+		commands:    [
+			cli.Command{
+				name:        'list'
+				description: 'List open issues'
+				execute:     issue_list
+				flags:       [
+					cli.Flag{
+						flag:        .bool
+						name:        'verbose'
+						abbrev:      'v'
+						description: 'Show issue bodies in addition to titles'
+					},
+				]
+			},
+			cli.Command{
+				name:        'create'
+				description: 'Create a new issue'
+				execute:     issue_create
+				flags:       [
+					cli.Flag{
+						flag:        .string
+						name:        'title'
+						abbrev:      't'
+						description: 'Title of the issue to create'
+						required:    true
+					},
+				]
+			},
+		]
+	}
+}
+
+fn config_command() cli.Command {
+	return cli.Command{
+		name:        'config'
+		description: 'Read or write tasky settings'
+		group:       'Additional commands'
+		commands:    [
+			cli.Command{
+				name:          'get'
+				description:   'Print the value of a config key'
+				usage:         '<key>'
+				required_args: 1
+				execute:       config_get
+			},
+			cli.Command{
+				name:          'set'
+				description:   'Update a config key'
+				usage:         '<key> <value>'
+				required_args: 2
+				execute:       config_set
+			},
+		]
+	}
+}
+
+fn issue_list(cmd cli.Command) ! {
+	verbose := cmd.flags.get_bool('verbose') or { false }
+	println('Listing issues (verbose=${verbose})')
+}
+
+fn issue_create(cmd cli.Command) ! {
+	title := cmd.flags.get_string('title')!
+	println('Created issue: ${title}')
+}
+
+fn config_get(cmd cli.Command) ! {
+	println('config get ${cmd.args[0]}')
+}
+
+fn config_set(cmd cli.Command) ! {
+	println('config set ${cmd.args[0]} = ${cmd.args[1]}')
+}