checkmate-cli 0.4.1

Checkmate - API Testing Framework CLI
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
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132

//! Checkmate - API Testing Framework CLI

use clap::{Parser, Subcommand};

mod clove;
mod config;
mod diff;
mod docs;
mod history;
mod hooks;
mod init;
mod prime;
mod project;
mod report;
mod runner;
mod spec;
mod test;

#[derive(Parser)]
#[command(name = "cm")]
#[command(about = "Checkmate - API Testing Framework")]
#[command(version)]
#[command(propagate_version = true)]
struct Cli {
    #[command(subcommand)]
    command: Commands,
}

#[derive(Subcommand)]
enum Commands {
    /// Initialize Checkmate in current directory
    Init {
        /// Base URL for API tests (required in non-interactive mode)
        #[arg(short = 'L', long)]
        url: Option<String>,

        /// Stealth mode: add .checkmate/ to .git/info/exclude
        #[arg(long)]
        stealth: bool,
    },
    /// JSON query language operations
    Clove {
        #[command(subcommand)]
        command: clove::CloveCommands,
    },
    /// Run API tests
    Test {
        #[command(subcommand)]
        command: test::TestCommands,
    },
    /// Compare API responses across endpoints
    Diff {
        #[command(subcommand)]
        command: diff::DiffCommands,
    },
    /// Manage test specifications
    Spec {
        #[command(subcommand)]
        command: spec::SpecCommands,
    },
    /// Configuration management
    Config {
        #[command(subcommand)]
        command: config::ConfigCommands,
    },
    /// Report generation
    Report {
        #[command(subcommand)]
        command: report::ReportCommands,
    },
    /// Show documentation overview
    Docs,
    /// Show category-specific documentation
    Doc {
        /// Documentation category (assertions, requests, env, scopes, examples, cli)
        category: String,
    },
    /// Quick-start guide for AI agents
    Onboard,
    /// Show test run history
    History {
        /// Filter by git commit
        #[arg(long)]
        commit: Option<String>,
        /// Filter by spec file name
        #[arg(long)]
        spec: Option<String>,
        /// Maximum results to show
        #[arg(short = 'n', long, default_value = "10")]
        limit: usize,
    },
    /// Show details of a specific run
    Show {
        /// Run ID (e.g., cm-run-a3f)
        run_id: String,
    },
    /// Output project context for AI agents (used by hooks)
    Prime,
}

fn main() {
    rustls::crypto::ring::default_provider()
        .install_default()
        .expect("Failed to install rustls crypto provider");

    let cli = Cli::parse();

    let result = match cli.command {
        Commands::Init { url, stealth } => {
            init::run(init::InitOptions { url, stealth })
        }
        Commands::Clove { command } => clove::run(command),
        Commands::Test { command } => test::run(command),
        Commands::Diff { command } => diff::run(command),
        Commands::Spec { command } => spec::run(command),
        Commands::Config { command } => config::run(command),
        Commands::Report { command } => report::run(command),
        Commands::Docs => docs::run_docs(),
        Commands::Doc { category } => docs::run_doc(&category),
        Commands::Onboard => docs::run_onboard(),
        Commands::History { commit, spec, limit } => {
            history::run_history(commit.as_deref(), spec.as_deref(), limit)
        }
        Commands::Show { run_id } => history::run_show(&run_id),
        Commands::Prime => prime::run(),
    };

    if let Err(e) = result {
        eprintln!("Error: {}", e);
        std::process::exit(1);
    }
}