lumen 2.22.0

lumen is a command-line tool that uses AI to generate commit messages, summarise git diffs or past commits, and more.
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
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183

use std::str::FromStr;
use thiserror::Error;

#[derive(Debug, PartialEq, Eq, Clone)]
pub enum CommitReference {
    Single(String),
    Range { from: String, to: String },
    TripleDots { from: String, to: String },
}

#[derive(Debug, Error)]
pub enum ReferenceParseError {
    #[error("empty reference string")]
    Empty,
}

impl FromStr for CommitReference {
    type Err = ReferenceParseError;

    fn from_str(s: &str) -> Result<Self, Self::Err> {
        if s.is_empty() {
            return Err(ReferenceParseError::Empty);
        }

        // Handle the ... and .. cases
        if let Some((from, to)) = s.split_once("...") {
            let from = if from.is_empty() { "HEAD" } else { from };
            let to = if to.is_empty() { "HEAD" } else { to };

            Ok(CommitReference::TripleDots {
                from: from.to_string(),
                to: to.to_string(),
            })
        } else if let Some((from, to)) = s.split_once("..") {
            let from = if from.is_empty() { "HEAD" } else { from };
            let to = if to.is_empty() { "HEAD" } else { to };

            Ok(CommitReference::Range {
                from: from.to_string(),
                to: to.to_string(),
            })
        } else {
            Ok(CommitReference::Single(s.to_string()))
        }
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use clap::Parser;

    #[derive(Parser, Debug)]
    struct TestCli {
        reference: CommitReference,
    }

    #[test]
    fn test_single_commit() {
        assert_eq!(
            "HEAD".parse::<CommitReference>().unwrap(),
            CommitReference::Single("HEAD".to_string())
        );
    }

    #[test]
    fn test_full_range() {
        assert_eq!(
            "main..feature".parse::<CommitReference>().unwrap(),
            CommitReference::Range {
                from: "main".to_string(),
                to: "feature".to_string(),
            }
        );
    }

    #[test]
    fn test_from_only_range() {
        assert_eq!(
            "develop..".parse::<CommitReference>().unwrap(),
            CommitReference::Range {
                from: "develop".to_string(),
                to: "HEAD".to_string(),
            }
        );
    }

    #[test]
    fn test_to_only_range() {
        assert_eq!(
            "..feature".parse::<CommitReference>().unwrap(),
            CommitReference::Range {
                from: "HEAD".to_string(),
                to: "feature".to_string(),
            }
        );
    }

    #[test]
    fn test_clap_integration() {
        // Test full range
        let cli = TestCli::try_parse_from(["test", "main..feature"]).unwrap();
        assert!(matches!(
            cli.reference,
            CommitReference::Range { from, to }
            if from == "main" && to == "feature"
        ));

        // Test from-only range
        let cli = TestCli::try_parse_from(["test", "develop.."]).unwrap();
        assert!(matches!(
            cli.reference,
            CommitReference::Range { from, to }
            if from == "develop" && to == "HEAD"
        ));

        // Test to-only range
        let cli = TestCli::try_parse_from(["test", "..feature"]).unwrap();
        assert!(matches!(
            cli.reference,
            CommitReference::Range { from, to }
            if from == "HEAD" && to == "feature"
        ));
    }

    #[test]
    fn test_empty_reference() {
        assert!(matches!(
            "".parse::<CommitReference>(),
            Err(ReferenceParseError::Empty)
        ));
    }

    // jj-style ref syntax tests
    #[test]
    fn test_jj_working_copy_ref() {
        assert_eq!(
            "@".parse::<CommitReference>().unwrap(),
            CommitReference::Single("@".to_string())
        );
    }

    #[test]
    fn test_jj_parent_ref() {
        assert_eq!(
            "@-".parse::<CommitReference>().unwrap(),
            CommitReference::Single("@-".to_string())
        );
    }

    #[test]
    fn test_jj_grandparent_ref() {
        assert_eq!(
            "@--".parse::<CommitReference>().unwrap(),
            CommitReference::Single("@--".to_string())
        );
    }

    #[test]
    fn test_jj_change_id_prefix() {
        // jj change IDs are short alphanumeric prefixes
        assert_eq!(
            "xyz".parse::<CommitReference>().unwrap(),
            CommitReference::Single("xyz".to_string())
        );
        assert_eq!(
            "ksrm".parse::<CommitReference>().unwrap(),
            CommitReference::Single("ksrm".to_string())
        );
    }

    #[test]
    fn test_jj_range_syntax() {
        // jj supports @ in ranges
        assert_eq!(
            "@-..@".parse::<CommitReference>().unwrap(),
            CommitReference::Range {
                from: "@-".to_string(),
                to: "@".to_string(),
            }
        );
    }
}