zad-cli 0.9.4

Command-line interface for zad — connects AI agents to external services (Discord, Slack, Google Calendar, Spotify, Telegram, YouTube Music, 1Password) via scoped service configurations.
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

//! Implementation of the `zad man [command]` subcommand mandated by
//! `OSS_SPEC.md` §12.3.
//!
//! Manpages under `man/*.md` are embedded via `include_str!`. The
//! command-to-file mapping is enumerated explicitly so the parity test
//! in `tests/manpage_parity_test.rs` can cross-check it against the
//! clap tree.
//!
//! Paths resolve through the `crates/zad-cli/man` symlink, which
//! points at `../../man` (the canonical manpage tree at the repo
//! root). The symlink is resolved when cargo packages the crate, so
//! the published tarball ships the manpage files as real entries and
//! the `cargo publish` verify step can compile the package outside
//! the workspace. Don't replace the symlink with copies — that would
//! immediately drift from the canonical manpages.

use std::fmt::Write as _;

use clap::Args;

use zad::error::{Result, ZadError};

#[derive(Debug, Args)]
pub struct ManArgs {
    /// Command name (e.g. `discord`, `service`). When omitted, lists the
    /// available manpages. `main` is the top-level overview.
    pub command: Option<String>,
}

pub const PAGES: &[(&str, &str)] = &[
    ("main", include_str!("../../man/main.md")),
    ("1pass", include_str!("../../man/1pass.md")),
    ("commands", include_str!("../../man/commands.md")),
    ("discord", include_str!("../../man/discord.md")),
    ("docs", include_str!("../../man/docs.md")),
    ("gcal", include_str!("../../man/gcal.md")),
    ("man", include_str!("../../man/man.md")),
    ("service", include_str!("../../man/service.md")),
    ("signing", include_str!("../../man/signing.md")),
    ("slack", include_str!("../../man/slack.md")),
    ("spotify", include_str!("../../man/spotify.md")),
    ("telegram", include_str!("../../man/telegram.md")),
    ("ymusic", include_str!("../../man/ymusic.md")),
];

pub fn run(args: ManArgs) -> Result<()> {
    match args.command {
        None => {
            let mut out = String::new();
            out.push_str("Available manpages (run `zad man <command>` to read):\n");
            for (name, _) in PAGES {
                let _ = writeln!(out, "  {name}");
            }
            print!("{out}");
            Ok(())
        }
        Some(command) => match PAGES.iter().find(|(n, _)| *n == command) {
            Some((_, body)) => {
                print!("{body}");
                Ok(())
            }
            None => Err(ZadError::Invalid(format!(
                "no manpage for: `{command}`. Run `zad man` to list available manpages."
            ))),
        },
    }
}