vscli 1.3.0

A CLI tool to launch vscode projects, which supports devcontainers.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80

use std::{ffi::OsString, path::PathBuf};

use clap::{Args, Parser, Subcommand, command};

use crate::launch::ContainerStrategy;

/// Main CLI arguments
#[derive(Parser, Debug)]
#[command(
    name = "vscli",
    about = "A CLI tool to launch vscode projects, which supports dev containers.",
    author,
    version,
    about
)]
pub(crate) struct Opts {
    /// Overwrite the default path to the history file
    #[arg(short = 's', long, env, global = true)]
    pub history_path: Option<PathBuf>,

    /// Whether to launch in dry-run mode (not actually open vscode)
    #[arg(short, long, alias = "dry", env, global = true)]
    pub dry_run: bool,

    /// The verbosity of the output
    #[command(flatten)]
    pub verbose: clap_verbosity_flag::Verbosity<clap_verbosity_flag::InfoLevel>,

    /// The command to run
    #[command(subcommand)]
    pub command: Commands,
}

/// Arguments for launching an editor
#[derive(Args, Debug, Clone)]
pub(crate) struct LaunchArgs {
    /// The editor command to use (e.g. "code", "code-insiders", "cursor")
    #[arg(short, long, env)]
    pub command: Option<String>,

    /// Launch behavior
    #[arg(short, long, ignore_case = true)]
    pub behavior: Option<ContainerStrategy>,

    /// Overwrites the path to the dev container config file
    #[arg(long, env)]
    pub config: Option<PathBuf>,

    /// Additional arguments to pass to the editor
    #[arg(value_parser, env)]
    pub args: Vec<OsString>,
}

#[derive(Subcommand, Debug)]
pub(crate) enum Commands {
    /// Opens a dev container.
    #[clap(alias = "o")]
    Open {
        /// The path of the vscode project to open
        #[arg(value_parser, default_value = ".")]
        path: PathBuf,

        #[command(flatten)]
        launch: LaunchArgs,
    },
    /// Opens an interactive list of recently used workspaces.
    #[clap(alias = "ui")]
    Recent {
        /// Hide the instruction message in the UI
        #[arg(long)]
        hide_instructions: bool,

        /// Hide additional information like strategy, command, args and dev container path in the UI
        #[arg(long)]
        hide_info: bool,

        #[command(flatten)]
        launch: LaunchArgs,
    },
}