zenops 0.17.0

Declarative system configuration management for shell config and dotfiles.
Documentation 
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
81
82
83
84
85
86
87
88
89
90
91
92
93

//! Binary entrypoint for `zenops`.
//!
//! Parses [`Cli`] with clap, picks a renderer based on `--output`
//! (`TerminalRenderer` for human-readable column-aligned text,
//! `JsonOutput` for newline-delimited JSON) and hands off to
//! [`zenops::real_main`].
//!
//! All structured output goes to stdout; `log::*!` and the top-level fatal
//! `eprintln!` go to stderr. `--output json` therefore stays parseable even
//! when `RUST_LOG=debug` is set.
//!
//! `Completions` is dispatched here rather than in `real_main` because it
//! needs the top-level [`Cli`] for `clap::CommandFactory::command`.

use std::io::{self, IsTerminal};

use clap::{CommandFactory, Parser};
use zenops::config_files::ConfigFileDirs;

#[derive(Parser, Debug)]
#[command(name = "zenops", about = "ZenOps: your system’s calm overseer")]
pub struct Cli {
    #[clap(flatten)]
    args: zenops::Args,

    /// How to render status and apply events.
    #[clap(long, short, global = true, value_enum, default_value_t = OutputMode::Human)]
    output: OutputMode,

    #[command(subcommand)]
    command: zenops::Cmd,
}

#[derive(Clone, Copy, Debug, clap::ValueEnum)]
#[clap(rename_all = "lower")]
pub enum OutputMode {
    /// Human-readable text to stdout, with optional ANSI color.
    Human,
    /// Newline-delimited JSON to stdout, one event per line.
    Json,
}

fn main() {
    let Cli {
        mut args,
        output,
        command,
    } = Cli::parse();
    args.stdin_is_terminal = io::stdin().is_terminal();

    if let zenops::Cmd::Completions { shell } = &command {
        let mut cmd = Cli::command();
        clap_complete::generate(*shell, &mut cmd, "zenops", &mut std::io::stdout());
        return;
    }

    // Kept so power users can set `RUST_LOG=debug` and see the remaining
    // diagnostic breadcrumbs (currently the unknown git-status-tag line
    // in `git.rs`). Zero-config beyond that.
    env_logger::init();

    let stdout = io::stdout();
    let stdout_is_terminal = stdout.is_terminal();
    let color = args.color.enabled(stdout_is_terminal);
    let show_diffs = matches!(command, zenops::Cmd::Status { diff: true, .. });
    let show_clean = matches!(command, zenops::Cmd::Status { all: true, .. });

    let mut lock = stdout.lock();
    let mut renderer: Box<dyn zenops::output::Output> = match output {
        OutputMode::Human => Box::new(zenops::output::TerminalRenderer::new(
            &mut lock, color, show_diffs, show_clean,
        )),
        OutputMode::Json => Box::new(zenops::output::JsonOutput::new(&mut lock)),
    };

    let home = match home::home_dir() {
        Some(h) => h,
        None => {
            eprintln!("error: {}", zenops::error::Error::NoHomeDir);
            std::process::exit(1);
        }
    };
    let dirs = ConfigFileDirs::load(home);

    if let Err(e) = zenops::real_main(&args, &command, &dirs, renderer.as_mut()) {
        eprintln!("error: {e}");
        std::process::exit(1);
    }
    if let Err(e) = renderer.finalize() {
        eprintln!("error: {e}");
        std::process::exit(1);
    }
}