saferskills 0.2.0

Every AI capability, independently scanned — install Skills & MCP servers with a verified SaferSkills trust score.
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

//! `saferskills completion <shell>` + the hidden `man` generator. Both write
//! their artifact to **stdout** (it is machine data).

use std::io;

use clap::CommandFactory;

use crate::cli::output::OutputConfig;
use crate::cli::Cli;
use crate::core::error::{SsError, ERR_STATE_WRITE_FAILED};

/// Emit a shell completion script for `shell` to stdout.
pub fn run_completion(shell: clap_complete::Shell, _output: &OutputConfig) -> Result<(), SsError> {
    let mut cmd = Cli::command();
    clap_complete::generate(shell, &mut cmd, "saferskills", &mut io::stdout());
    Ok(())
}

/// Render the troff man page to stdout (consumed by packaging).
pub fn run_man(_output: &OutputConfig) -> Result<(), SsError> {
    let cmd = Cli::command();
    let man = clap_mangen::Man::new(cmd);
    man.render(&mut io::stdout()).map_err(|e| {
        SsError::new(
            ERR_STATE_WRITE_FAILED,
            format!("Failed to render man page: {e}"),
        )
    })
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::cli::output::OutputFormat;

    fn out() -> OutputConfig {
        OutputConfig {
            format: OutputFormat::Human,
            verbose: false,
            quiet: false,
            color: false,
        }
    }

    #[test]
    fn completion_generates_for_each_shell() {
        for shell in [
            clap_complete::Shell::Bash,
            clap_complete::Shell::Zsh,
            clap_complete::Shell::Fish,
            clap_complete::Shell::PowerShell,
        ] {
            run_completion(shell, &out()).unwrap();
        }
    }

    #[test]
    fn man_renders() {
        run_man(&out()).unwrap();
    }
}