cranpose-localization 0.9.10

Scoped Fluent catalogs and localization tooling for Cranpose
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

use std::{collections::BTreeSet, fs, path::Path};

/// One ordered language entry from an application's `localization.toml`.
#[derive(Clone, Debug, PartialEq, Eq)]
pub struct LocaleMetadata {
    /// Canonical BCP 47 tag used by the matching catalog directory.
    pub tag: String,
    /// Name shown in the language's own writing system.
    pub native_name: String,
}

/// Loads the ordered `[[locale]]` entries from a localization manifest.
pub fn load_locale_manifest(path: &Path) -> Result<Vec<LocaleMetadata>, String> {
    let source =
        fs::read_to_string(path).map_err(|error| format!("{}: {error}", path.display()))?;
    let value: toml::Table = source
        .parse()
        .map_err(|error| format!("{}: {error}", path.display()))?;
    let entries = value
        .get("locale")
        .and_then(toml::Value::as_array)
        .ok_or_else(|| format!("{}: expected ordered [[locale]] entries", path.display()))?;
    if entries.is_empty() {
        return Err(format!(
            "{}: at least one [[locale]] entry is required",
            path.display()
        ));
    }
    let mut tags = BTreeSet::new();
    entries
        .iter()
        .map(|entry| {
            let tag = entry
                .get("tag")
                .and_then(toml::Value::as_str)
                .ok_or_else(|| "each [[locale]] needs a string `tag`".to_owned())?;
            let native_name = entry
                .get("native_name")
                .and_then(toml::Value::as_str)
                .ok_or_else(|| format!("locale `{tag}` needs a string `native_name`"))?;
            let parsed = crate::Locale::parse(tag).map_err(|error| error.to_string())?;
            if parsed.to_string() != tag {
                return Err(format!(
                    "locale tag `{tag}` must use canonical BCP 47 casing"
                ));
            }
            if native_name.trim().is_empty() {
                return Err(format!("locale `{tag}` has an empty native name"));
            }
            if !tags.insert(tag.to_owned()) {
                return Err(format!("duplicate locale `{tag}`"));
            }
            Ok(LocaleMetadata {
                tag: tag.to_owned(),
                native_name: native_name.to_owned(),
            })
        })
        .collect()
}