yui/
cli.rs

1use anyhow::Result;
2use camino::Utf8PathBuf;
3use clap::{Parser, Subcommand};
4
5use crate::cmd;
6use crate::config::IconsMode;
7
8#[derive(Parser, Debug)]
9#[command(version, about, long_about = None)]
10pub struct Cli {
11    /// Path to dotfiles source repository ($DOTFILES)
12    #[arg(short, long, env = "YUI_SOURCE", global = true)]
13    pub source: Option<Utf8PathBuf>,
14
15    /// Increase log verbosity (-v, -vv, -vvv)
16    #[arg(short, long, action = clap::ArgAction::Count, global = true)]
17    pub verbose: u8,
18
19    #[command(subcommand)]
20    pub command: Command,
21}
22
23#[derive(Subcommand, Debug)]
24pub enum Command {
25    /// Initialize source repo skeleton
26    Init {
27        /// Install git pre-commit/pre-push hooks for render-drift check
28        #[arg(long)]
29        git_hooks: bool,
30    },
31
32    /// Render templates + link targets + auto-absorb (default workflow)
33    Apply {
34        #[arg(long)]
35        dry_run: bool,
36    },
37
38    /// Render templates only
39    Render {
40        /// Fail with non-zero exit if rendered output diverges (CI hook)
41        #[arg(long)]
42        check: bool,
43        #[arg(long)]
44        dry_run: bool,
45    },
46
47    /// Link / relink targets only
48    Link {
49        #[arg(long)]
50        dry_run: bool,
51    },
52
53    /// Unlink targets
54    Unlink { paths: Vec<Utf8PathBuf> },
55
56    /// Show drift status (link-broken / replaced / template-drift)
57    Status,
58
59    /// List all src→dst link mappings (mount entries + .yuilink overrides)
60    List {
61        /// Include entries whose `when` evaluates false on the current host
62        #[arg(long)]
63        all: bool,
64        /// Override [ui] icons mode for this invocation
65        #[arg(long, value_name = "MODE")]
66        icons: Option<IconsMode>,
67        /// Disable color output (also respected via NO_COLOR env)
68        #[arg(long)]
69        no_color: bool,
70    },
71
72    /// Manually absorb a target into source (when auto-absorb skipped)
73    Absorb {
74        target: Utf8PathBuf,
75        #[arg(long)]
76        dry_run: bool,
77    },
78
79    /// Diagnose environment (symlink capability, source detection, etc)
80    Doctor,
81
82    /// Garbage-collect old backups
83    GcBackup {
84        /// e.g. "30d", "6m"
85        #[arg(long)]
86        older_than: Option<String>,
87    },
88}
89
90impl Cli {
91    pub fn run(self) -> Result<()> {
92        let source = self.source;
93        match self.command {
94            Command::Init { git_hooks } => cmd::init(source, git_hooks),
95            Command::Apply { dry_run } => cmd::apply(source, dry_run),
96            Command::Render { check, dry_run } => cmd::render(source, check, dry_run),
97            Command::Link { dry_run } => cmd::link(source, dry_run),
98            Command::Unlink { paths } => cmd::unlink(source, paths),
99            Command::Status => cmd::status(source),
100            Command::List {
101                all,
102                icons,
103                no_color,
104            } => cmd::list(source, all, icons, no_color),
105            Command::Absorb { target, dry_run } => cmd::absorb(source, target, dry_run),
106            Command::Doctor => cmd::doctor(source),
107            Command::GcBackup { older_than } => cmd::gc_backup(source, older_than),
108        }
109    }
110}
yui/cli.rs

yui/
cli.rs
