codewiki-cli 0.1.0

CLI for Google Code Wiki — query GitHub repo wikis (structure, full markdown, Q&A) without a browser. Built for LLM coding agents and humans.
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

use clap::{Parser, Subcommand};

#[derive(Parser)]
#[command(
    name = "codewiki",
    about = "Query GitHub repo wikis via Google Code Wiki"
)]
pub struct Cli {
    #[command(subcommand)]
    pub command: Command,
}

#[derive(Subcommand)]
pub enum Command {
    /// Ask an AI-powered question about a repository
    Ask {
        /// Repository name (e.g. facebook/react)
        repo: String,
        /// Question to ask
        question: String,
    },
    /// List wiki section titles for a repository
    Structure {
        /// Repository name (e.g. facebook/react)
        repo: String,
    },
    /// Read full wiki contents (Markdown) for a repository
    Read {
        /// Repository name (e.g. facebook/react)
        repo: String,
    },
}

#[cfg(test)]
mod tests {
    use super::{Cli, Command};
    use clap::Parser;

    #[test]
    fn parses_ask_command() {
        let cli = Cli::try_parse_from(["codewiki", "ask", "facebook/react", "How it works?"])
            .expect("ask command should parse");
        match cli.command {
            Command::Ask { repo, question } => {
                assert_eq!(repo, "facebook/react");
                assert_eq!(question, "How it works?");
            }
            _ => panic!("expected ask command"),
        }
    }

    #[test]
    fn parses_structure_command() {
        let cli = Cli::try_parse_from(["codewiki", "structure", "facebook/react"])
            .expect("structure command should parse");
        match cli.command {
            Command::Structure { repo } => assert_eq!(repo, "facebook/react"),
            _ => panic!("expected structure command"),
        }
    }

    #[test]
    fn parses_read_command() {
        let cli = Cli::try_parse_from(["codewiki", "read", "facebook/react"])
            .expect("read command should parse");
        match cli.command {
            Command::Read { repo } => assert_eq!(repo, "facebook/react"),
            _ => panic!("expected read command"),
        }
    }

    #[test]
    fn fails_when_required_args_are_missing() {
        let result = Cli::try_parse_from(["codewiki", "ask", "facebook/react"]);
        assert!(result.is_err());
    }
}