git_prole/git/
commit_hash.rs

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
use std::fmt::Display;
use std::str::FromStr;

use derive_more::{AsRef, Constructor, Deref, DerefMut, From, Into};
use miette::miette;
use winnow::combinator::repeat;
use winnow::token::one_of;
use winnow::PResult;
use winnow::Parser;

/// A Git commit hash.
#[derive(
    Debug, Clone, PartialEq, Eq, PartialOrd, Ord, Into, AsRef, Deref, DerefMut, Constructor,
)]
pub struct CommitHash(String);

impl CommitHash {
    /// A fake commit hash for testing purposes.
    #[cfg(test)]
    pub fn fake() -> Self {
        Self("a".repeat(40))
    }

    /// Get an abbreviated 8-character Git hash.
    pub fn abbrev(&self) -> &str {
        &self.0[..8]
    }

    pub fn parser(input: &mut &str) -> PResult<Self> {
        Ok(Self::from(
            repeat(40, one_of(('0'..='9', 'a'..='f')))
                .map(|()| ())
                .take()
                .parse_next(input)?,
        ))
    }
}

impl Display for CommitHash {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        if f.alternate() {
            Display::fmt(&self.0, f)
        } else {
            Display::fmt(self.abbrev(), f)
        }
    }
}

impl<S> From<S> for CommitHash
where
    S: AsRef<str>,
{
    fn from(value: S) -> Self {
        Self(value.as_ref().into())
    }
}

impl FromStr for CommitHash {
    type Err = miette::Report;

    fn from_str(s: &str) -> Result<Self, Self::Err> {
        Self::parser.parse(s).map_err(|err| miette!("{err}"))
    }
}

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

    #[test]
    fn test_parse_commit_hash() {
        assert_eq!(
            CommitHash::from_str("1233def1234def1234def1234def1234def1234b").unwrap(),
            CommitHash::new("1233def1234def1234def1234def1234def1234b".into()),
        );

        // Too short
        assert!(CommitHash::from_str("1233def1234def1234def1234def1234def1234").is_err());

        // Too long
        assert!(CommitHash::from_str("1233def1234def1234def1234def1234def1234ab").is_err());

        // Uppercase not allowed
        assert!(CommitHash::from_str("1233DEF1234DEF1234DEF1234DEF1234DEF1234B").is_err());

        // Illegal character
        assert!(CommitHash::from_str("1233def1234def1234gef1234def1234def1234b").is_err());
    }
}