human_name 2.0.1

A library for parsing and comparing human names
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

use super::case::capitalize_word;

static UNCAPITALIZED_PARTICLES: phf::Set<&'static str> =
    include!(concat!(env!("OUT_DIR"), "/particles_and_conjunctions.rs"));

const MAC_EXCEPTIONS: [&str; 9] = [
    "Machin",
    "Machlin",
    "Machar",
    "Mackle",
    "Macklin",
    "Mackie",
    "Macevicius",
    "Maciulis",
    "Macias",
];

#[allow(clippy::if_same_then_else)]
fn capitalize_after_mac(word: &str) -> bool {
    if word.len() <= 4 {
        false
    } else if word.ends_with('o') && word != "Macmurdo" {
        false
    } else if ["a", "c", "i", "z", "j"].iter().any(|c| word.ends_with(c)) {
        false
    } else {
        !MAC_EXCEPTIONS.contains(&word)
    }
}

pub fn namecase(word: &str, ascii_alpha: bool, might_be_particle: bool) -> String {
    let result = capitalize_word(word, ascii_alpha);

    if might_be_particle && UNCAPITALIZED_PARTICLES.contains(&*result) {
        result.to_lowercase()
    } else if result.starts_with("Mac") && capitalize_after_mac(&result) {
        "Mac".to_string() + &capitalize_word(&result[3..], ascii_alpha)
    } else if result.starts_with("Mc") && result.len() > 3 {
        "Mc".to_string() + &capitalize_word(&result[2..], ascii_alpha)
    } else if result.starts_with("Al-") && result.len() > 3 {
        "al-".to_string() + &result[3..]
    } else {
        // Normal case
        result
    }
}

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

    #[test]
    fn simple() {
        assert_eq!("Doe", namecase("doe", true, true));
    }

    #[test]
    fn conjunction() {
        assert_eq!("y", namecase("y", true, true));
        assert_eq!("Y", namecase("y", true, false));
    }

    #[test]
    fn particle() {
        assert_eq!("de", namecase("de", true, true));
        assert_eq!("De", namecase("de", true, false));
        assert_eq!("dí", namecase("dí", false, true));
    }

    #[test]
    fn mcallen() {
        assert_eq!("McAllen", namecase("mcallen", true, true));
    }

    #[test]
    fn macmurdo() {
        assert_eq!("MacMurdo", namecase("macmurdo", true, true));
    }

    #[test]
    fn machlin() {
        assert_eq!("Machlin", namecase("machlin", true, true));
    }

    #[test]
    fn maciej() {
        assert_eq!("Maciej", namecase("maciej", true, true));
    }

    #[test]
    fn mach() {
        assert_eq!("Mach", namecase("mach", true, true));
    }

    #[test]
    fn macadaidh() {
        assert_eq!("MacAdaidh", namecase("macadaidh", true, true));
    }

    #[test]
    fn al_amir() {
        assert_eq!("al-Amir", namecase("al-amir", false, true));
    }
}