11 releases (1 stable)

1.0.0 Mar 12, 2024
0.1.12 Jul 17, 2023
0.1.11 Mar 25, 2023
0.1.9 Oct 24, 2022

#264 in Command-line interface

Download history 18/week @ 2024-02-13 39/week @ 2024-02-20 28/week @ 2024-02-27 16/week @ 2024-03-05 173/week @ 2024-03-12 20/week @ 2024-03-19 13/week @ 2024-03-26 46/week @ 2024-04-02 11/week @ 2024-04-09 13/week @ 2024-04-16 16/week @ 2024-04-23 7/week @ 2024-04-30 17/week @ 2024-05-07 36/week @ 2024-05-14 55/week @ 2024-05-21 51/week @ 2024-05-28

160 downloads per month
Used in 7 crates (2 directly)

MIT license

13KB
229 lines

carapace-spec-clap

Crates.io

Spec generation for clap-rs/clap

asciicast

use carapace_spec_clap::Spec;
use clap::{Arg, ArgAction, Command, ValueHint};
use clap_complete::generate;
use std::io;

fn main() {
    let mut cmd = Command::new("example")
        .aliases(["alias1", "alias2"])
        .about("example command")
        .arg(
            Arg::new("help")
                .long("help")
                .short('h')
                .help("show help")
                .action(ArgAction::SetTrue),
        )
        .arg(
            Arg::new("optional")
                .long("optional")
                .help("optional argument")
                .require_equals(true)
                .value_hint(ValueHint::Username),
        )
        .arg(
            Arg::new("value")
                .short('v')
                .help("takes argument")
                .value_parser(["one", "two", "three"]),
        )
        .subcommand(
            Command::new("subcommand")
                .about("example subcommand")
                .arg(
                    Arg::new("command")
                        .long("command")
                        .short('c')
                        .help("execute command")
                        .value_hint(ValueHint::CommandName),
                )
                .arg(
                    Arg::new("pos1")
                        .value_parser(["four", "five", "six"])
                        .value_hint(ValueHint::DirPath),
                )
                .arg(
                    Arg::new("posAny")
                        .num_args(1..)
                        .value_hint(ValueHint::Hostname),
                ),
        );

    generate(Spec, &mut cmd, "example", &mut io::stdout());
}
name: example
aliases:
- alias1
- alias2
description: example command
flags:
  -h, --help: show help
  --optional?: optional argument
  -v=: takes argument
completion:
  flag:
    optional:
    - $_os.Users
    v:
    - one
    - two
    - three
commands:
- name: subcommand
  description: example subcommand
  flags:
    -c, --command=: execute command
  completion:
    flag:
      command:
      - $_os.PathExecutables
      - $files
    positional:
    - - $directories
      - four
      - five
      - six
    positionalany:
    - $_net.Hosts

Dependencies

~4MB
~76K SLoC