quarb 0.42.0

Query engine for arbors (arboreal graphs - tree-spanned or tree-dominated graphs)
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

//! Transliteration and historical spelling: thin wrappers over the
//! `transliteratio` crate, which holds every table (the ISO tables
//! per script, the national and library systems, the inverses, the
//! Latin-to-ASCII folds, the spelling tables). The engine enables
//! every table the crate has; the crate's typed errors become the
//! refusal texts here.

/// The readings library the lexicon tables need: Chinese characters
/// under pinyin and wade, kanji under hepburn and iso3602, Thai
/// under rtgs. Until it is mounted those texts are refused naming it.
pub const READINGS_LIBRARY: &str = "anagnosis";

/// Every table name the crate answers to.
pub fn schemes() -> Vec<&'static str> {
    transliteratio::TABLES.iter().map(|t| t.code).collect()
}

/// Transliterate `text` under `scheme` (`""` or `"iso"` for the
/// script's own ISO table). An unknown table, a table left out of
/// the build, or a lexicon table over text that needs the lexicon
/// is an error in the engine's refusal words.
pub fn translit(text: &str, scheme: &str) -> Result<String, String> {
    transliteratio::transliterate(text, scheme).map_err(|e| match e {
        transliteratio::Error::UnknownTable(t) => format!(
            "translit: unknown table '{t}' (one of {})",
            schemes().join(", ")
        ),
        transliteratio::Error::NeedsLexicon { table, text } => format!(
            "translit: {table} over {text} needs the readings library ({READINGS_LIBRARY}), \
             which is not mounted"
        ),
        transliteratio::Error::FeatureOff { table, feature } => {
            format!("translit: table '{table}' is not in this build (feature '{feature}')")
        }
        other => format!("translit: {other}"),
    })
}

/// A historical spelling folded to the modern one: `ru-1918` (the
/// pre-reform Russian alphabet, the final ъ dropped) and `long-s`
/// (the long s and the typographic ligatures).
pub fn modernize(text: &str, table: &str) -> Result<String, String> {
    transliteratio::modernize(text, table).map_err(|e| match e {
        transliteratio::Error::UnknownSpelling(t) => format!(
            "modernize: unknown spelling table '{t}' ({})",
            transliteratio::SPELLINGS.join(", ")
        ),
        other => format!("modernize: {other}"),
    })
}

#[cfg(test)]
mod tests {
    use super::{modernize, translit};

    #[test]
    fn the_wrapper_speaks_the_engines_refusals() {
        assert_eq!(translit("Щука", "iso9").unwrap(), "Ŝuka");
        assert_eq!(translit("Щука", "").unwrap(), "Ŝuka");
        assert_eq!(translit("Љубљана", "sr-latn").unwrap(), "Ljubljana");
        let e = translit("x", "klingon").unwrap_err();
        assert!(
            e.starts_with("translit: unknown table 'klingon' (one of iso, iso9,"),
            "{e}"
        );
        let e = translit("東京", "hepburn").unwrap_err();
        assert!(e.contains("kanji") && e.contains("anagnosis"), "{e}");
        assert_eq!(modernize("міръ", "ru-1918").unwrap(), "мир");
        assert!(modernize("x", "klingon").unwrap_err().contains("ru-1918"));
    }
}