commando 1.1.0

An interactive CLI tool to help you write conventional commit messages with ease.
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

/// Header section — commit type, scope, description.
///
/// Each function validates its field immediately at prompt time.
/// A bad value is rejected before the user moves on — no post-hoc
/// validation needed for these fields.
use crate::domain::{CommitMessage, CommitType};
use crate::input::interactive::InteractiveError;
use crate::ports::ui::Ui;

pub fn collect_type<U: Ui>(ui: &U) -> Result<CommitType, InteractiveError> {
    ui.println("1. Commit type:");
    ui.println("   feat      — new feature");
    ui.println("   fix       — bug fix");
    ui.println("   docs      — documentation only");
    ui.println("   style     — formatting, whitespace");
    ui.println("   refactor  — code restructuring");
    ui.println("   perf      — performance improvement");
    ui.println("   test      — adding or fixing tests");
    ui.println("   build     — build system / dependencies");
    ui.println("   ci        — CI configuration");
    ui.println("   chore     — maintenance");
    ui.println("   revert    — revert a previous commit");
    ui.println("");

    loop {
        let input = ui.prompt("Type: ").map_err(InteractiveError::Ui)?;

        match CommitType::from_str(&input) {
            Ok(ct) => {
                ui.println("");
                return Ok(ct);
            }
            Err(_) => {
                ui.println(&format!(
                    "  ✗ '{}' is not valid. Choose from the list above.",
                    input
                ));
            }
        }
    }
}

pub fn collect_scope<U: Ui>(ui: &U) -> Result<Option<String>, InteractiveError> {
    ui.println("2. Scope (optional — press Enter to skip):");
    ui.println("   e.g. api, parser, auth-service");
    ui.println("");

    loop {
        let input = ui.prompt("Scope: ").map_err(InteractiveError::Ui)?;

        if input.is_empty() {
            ui.println("");
            return Ok(None);
        }

        match CommitMessage::validate_scope(&input) {
            Ok(()) => {
                ui.println("");
                return Ok(Some(input));
            }
            Err(_) => {
                ui.println("  ✗ Scope must be alphanumeric with hyphens/underscores only.");
            }
        }
    }
}

pub fn collect_description<U: Ui>(ui: &U) -> Result<String, InteractiveError> {
    ui.println("3. Description (max 72 characters):");
    ui.println("");

    loop {
        let input = ui.prompt("Description: ").map_err(InteractiveError::Ui)?;

        if input.is_empty() {
            ui.println("  ✗ Description cannot be empty.");
            continue;
        }

        if input.len() > 72 {
            ui.println(&format!(
                "  ✗ {}/72 characters — too long. Please shorten.",
                input.len()
            ));
            continue;
        }

        ui.println("");
        return Ok(input);
    }
}