commitlint_rs/rule/
description_empty.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
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
use crate::{message::Message, result::Violation, rule::Rule};
use serde::{Deserialize, Serialize};

use super::Level;

/// DescriptionEmpty represents the subject-empty rule.
#[derive(Clone, Debug, Deserialize, Serialize)]
#[cfg_attr(feature = "schemars", derive(schemars::JsonSchema))]
pub struct DescriptionEmpty {
    /// Level represents the level of the rule.
    ///
    // Note that currently the default literal is not supported.
    // See: https://github.com/serde-rs/serde/issues/368
    level: Option<Level>,
}

/// DescriptionEmpty represents the description-empty rule.
impl Rule for DescriptionEmpty {
    const NAME: &'static str = "description-empty";
    const LEVEL: Level = Level::Error;

    fn message(&self, _message: &Message) -> String {
        "description is empty or missing space in the beginning".to_string()
    }

    fn validate(&self, message: &Message) -> Option<Violation> {
        match message.description {
            None => Some(Violation {
                level: self.level.unwrap_or(Self::LEVEL),
                message: self.message(message),
            }),
            Some(ref desc) if desc.is_empty() => Some(Violation {
                level: self.level.unwrap_or(Self::LEVEL),
                message: self.message(message),
            }),
            _ => None,
        }
    }
}

/// Default implementation of DescriptionEmpty.
impl Default for DescriptionEmpty {
    fn default() -> Self {
        Self {
            level: Some(Self::LEVEL),
        }
    }
}

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

    #[test]
    fn test_non_empty_description() {
        let rule = DescriptionEmpty::default();
        let message = Message {
            body: None,
            description: Some("broadcast $destroy event on scope destruction".to_string()),
            footers: None,
            r#type: Some("feat".to_string()),
            raw: "feat(scope): broadcast $destroy event on scope destruction".to_string(),
            scope: Some("scope".to_string()),
            subject: None,
        };

        assert!(rule.validate(&message).is_none());
    }

    #[test]
    fn test_empty_description() {
        let rule = DescriptionEmpty::default();
        let message = Message {
            body: None,
            description: None,
            footers: None,
            r#type: Some("feat".to_string()),
            raw: "(scope):".to_string(),
            scope: Some("scope".to_string()),
            subject: None,
        };

        let violation = rule.validate(&message);
        assert!(violation.is_some());
        assert_eq!(violation.clone().unwrap().level, Level::Error);
        assert_eq!(
            violation.unwrap().message,
            "description is empty or missing space in the beginning".to_string()
        );
    }

    #[test]
    fn test_blank_description() {
        let rule = DescriptionEmpty::default();
        let message = Message {
            body: None,
            description: Some("".to_string()),
            footers: None,
            r#type: Some("feat".to_string()),
            raw: "(scope):".to_string(),
            scope: Some("scope".to_string()),
            subject: None,
        };

        let violation = rule.validate(&message);
        assert!(violation.is_some());
        assert_eq!(violation.clone().unwrap().level, Level::Error);
        assert_eq!(
            violation.unwrap().message,
            "description is empty or missing space in the beginning".to_string()
        );
    }
}