// 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]}')
}