chordparser 4.0.4

A parser library to generate Jazz/Pop/Rock chords from string inputs
Documentation 
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

const ALL_NOTES: [&str; 21] = [
    "Cb", "C#", "Db", "D", "D#", "Eb", "E", "E#", "Fb", "F", "F#", "Gb", "G", "G#", "Ab", "A",
    "Ab", "B", "Bb", "A#", "B#",
];

/// Exhaustively covers chords that should not produce errors during parsing.  
/// The main purpose is to validate that all symbols can be parsed and to detect some corner cases derived from its combinations.
/// Tests in `should_parse.rs` contains checked results and is the place where to put both corner cases and main use cases.
#[cfg(test)]
mod tests {
    use chordparser::parsing::Parser;

    use crate::ALL_NOTES;

    #[test]
    fn test_should_parse_major() {
        let mut parser = Parser::new();
        let symbols = [
            "", "MAJ", "Maj", "maj", "MAJOR", "Major", "major", "MA", "Ma", "ma", "M", "△", "^",
        ];
        let descriptors = [
            "", "7", "79", "79#11", "79#1113", "79#11b13", "9", "#11", "13", "b13", "6", "b6",
            "69", "6/9", "sus", "sus2", "sus4", "sus#4", "+", "+5", "#5", "b5", "-5",
        ];

        for note in ALL_NOTES {
            for sym in &symbols {
                for desc in &descriptors {
                    let mut base = String::new();
                    base.push_str(note);
                    base.push_str(&sym);
                    base.push_str(&desc);
                    assert!(parser.parse(&base).is_ok(), "Failed to parse `{}`", base);
                }
            }
        }
    }

    #[test]
    fn test_should_parse_minor() {
        let mut parser = Parser::new();
        let symbols = [
            "MIN", "Min", "min", "MINOR", "Minor", "minor", "MI", "Mi", "mi", "m",
        ];
        let sevenths = ["", "△", "^", "△7", "^7", "7"];
        let descriptors = [
            "911", "91113", "9", "11", "#11", "13", "b13", "6", "b6", "69", "6/9", "sus", "sus2",
            "sus4", "sus#4", "+", "+5", "#5", "b5", "-5",
        ];

        for note in ALL_NOTES {
            for sym in &symbols {
                for seven in &sevenths {
                    for desc in &descriptors {
                        let mut base = String::new();
                        base.push_str(note);
                        base.push_str(sym);
                        base.push_str(seven);
                        base.push_str(desc);
                        assert!(parser.parse(&base).is_ok(), "Failed to parse `{}`", base);
                    }
                }
            }
        }
    }

    #[test]
    fn test_should_parse_dominant() {
        let mut parser = Parser::new();
        let symbols = ["7"];
        let descriptors = [
            "9", "9#11", "9#1113", "b9b13", "9", "#11", "13", "b13", "6", "b6", "sus", "sus2",
            "susb2", "sus#4", "sus4", "+", "+5", "#5", "b5", "-5",
        ];

        for note in ALL_NOTES {
            for sym in &symbols {
                for desc in &descriptors {
                    let mut base = String::new();
                    base.push_str(note);
                    base.push_str(&sym);
                    base.push_str(&desc);
                    assert!(parser.parse(&base).is_ok(), "Failed to parse `{}`", base);
                }
            }
        }
    }

    #[test]
    fn test_should_parse_other() {
        let mut parser = Parser::new();
        let symbols = [
            "SUS",
            "Sus",
            "sus",
            "DIM",
            "Dim",
            "dim",
            "diminished",
            "ALT",
            "Alt",
            "alt",
            "AUG",
            "Aug",
            "aug",
            "ADD9",
            "Add11",
            "add13",
            "O",
            "o",
            "°",
            "OMIT3",
            "Omit5",
            "omit3",
            "NO5",
            "No3",
            "no3",
            "Bass",
        ];

        for note in ALL_NOTES {
            for sym in &symbols {
                let mut base = String::new();
                base.push_str(note);
                base.push_str(&sym);
                assert!(parser.parse(&base).is_ok(), "Failed to parse `{}`", base);
            }
        }
    }
}