use std::collections::BTreeSet;
use std::sync::OnceLock;
#[cfg_attr(not(test), allow(dead_code))]
pub(crate) const FILES: &[&str] = &[
"api",
"errors",
"fluxweir",
"logs",
"rag",
"validation",
"workers",
];
const EN_API: &str = include_str!("../../locales/en-US/api.ftl");
const EN_ERRORS: &str = include_str!("../../locales/en-US/errors.ftl");
const EN_FLUXWEIR: &str = include_str!("../../locales/en-US/fluxweir.ftl");
const EN_LOGS: &str = include_str!("../../locales/en-US/logs.ftl");
const EN_RAG: &str = include_str!("../../locales/en-US/rag.ftl");
const EN_VALIDATION: &str = include_str!("../../locales/en-US/validation.ftl");
const EN_WORKERS: &str = include_str!("../../locales/en-US/workers.ftl");
const ZH_API: &str = include_str!("../../locales/zh-CN/api.ftl");
const ZH_ERRORS: &str = include_str!("../../locales/zh-CN/errors.ftl");
const ZH_FLUXWEIR: &str = include_str!("../../locales/zh-CN/fluxweir.ftl");
const ZH_LOGS: &str = include_str!("../../locales/zh-CN/logs.ftl");
const ZH_RAG: &str = include_str!("../../locales/zh-CN/rag.ftl");
const ZH_VALIDATION: &str = include_str!("../../locales/zh-CN/validation.ftl");
const ZH_WORKERS: &str = include_str!("../../locales/zh-CN/workers.ftl");
const EN_SOURCES: &[&str] = &[
EN_API,
EN_ERRORS,
EN_FLUXWEIR,
EN_LOGS,
EN_RAG,
EN_VALIDATION,
EN_WORKERS,
];
const ZH_SOURCES: &[&str] = &[
ZH_API,
ZH_ERRORS,
ZH_FLUXWEIR,
ZH_LOGS,
ZH_RAG,
ZH_VALIDATION,
ZH_WORKERS,
];
pub(crate) fn sources_for(locale: &str) -> Option<&'static [&'static str]> {
match locale {
"en-US" => Some(EN_SOURCES),
"zh-CN" => Some(ZH_SOURCES),
_ => None,
}
}
pub(crate) fn parse_entries(source: &'static str) -> Vec<(&'static str, &'static str)> {
source
.lines()
.filter_map(|line| {
if line.len() != line.trim_start().len() || line.starts_with('#') {
return None;
}
let (key, value) = line.split_once('=')?;
let key = key.trim_end();
if key.is_empty() || !is_message_name(key) {
return None;
}
Some((key, value.trim()))
})
.collect()
}
fn is_message_name(name: &str) -> bool {
name.chars()
.all(|c| c.is_ascii_lowercase() || c.is_ascii_digit() || c == '-')
}
pub(crate) fn placeholders(value: &'static str) -> BTreeSet<&'static str> {
let mut names = BTreeSet::new();
let mut rest = value;
while let Some(open) = rest.find('{') {
let Some(close_rel) = rest[open..].find('}') else {
break;
};
let inner = rest[open + 1..open + close_rel].trim();
if let Some(name) = inner.strip_prefix('$') {
let name = name.trim();
if !name.is_empty() && is_message_name(name) {
names.insert(name);
}
}
rest = &rest[open + close_rel + 1..];
}
names
}
pub fn register_all() {
static REGISTERED: OnceLock<()> = OnceLock::new();
REGISTERED.get_or_init(|| {
for (locale, sources) in [("en-US", EN_SOURCES), ("zh-CN", ZH_SOURCES)] {
for source in sources {
for (key, value) in parse_entries(source) {
sdforge::i18n::register_translation(locale, key, value);
}
}
}
});
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn parse_entries_extracts_key_value_pairs() {
let entries = parse_entries(
"# comment\nkey-a = value a\n indented = skipped\nkey-b= value b\ninvalid key = x\n\nbare line\n",
);
let keys: Vec<&str> = entries.iter().map(|(k, _)| *k).collect();
assert_eq!(keys, vec!["key-a", "key-b"]);
assert_eq!(entries[0].1, "value a");
assert_eq!(entries[1].1, "value b");
}
#[test]
fn placeholders_extracts_dollar_names() {
let names = placeholders("Error: { $message } at { $url } ({$status}) no {literal}");
assert_eq!(
names.into_iter().collect::<Vec<_>>(),
vec!["message", "status", "url"]
);
}
#[test]
fn embedded_sources_are_non_empty_and_parseable() {
for locale in ["en-US", "zh-CN"] {
let sources = sources_for(locale).expect("embedded locale source");
assert!(!sources.is_empty());
for source in sources {
assert!(
!parse_entries(source).is_empty(),
"embedded source for {locale} parsed to zero entries"
);
}
}
}
#[test]
fn unsupported_locale_has_no_sources() {
assert!(sources_for("fr-FR").is_none());
}
#[test]
fn files_manifest_matches_disk_directory() {
for locale in ["en-US", "zh-CN"] {
let disk_dir = std::path::Path::new(env!("CARGO_MANIFEST_DIR"))
.join("locales")
.join(locale);
let mut disk_files: Vec<String> = std::fs::read_dir(&disk_dir)
.unwrap_or_else(|e| panic!("read {}: {e}", disk_dir.display()))
.filter_map(|e| e.ok())
.filter(|e| e.path().extension().is_some_and(|x| x == "ftl"))
.filter_map(|e| {
e.path()
.file_stem()
.map(|s| s.to_string_lossy().into_owned())
})
.collect();
disk_files.sort();
assert!(
!disk_files.is_empty(),
"disk directory {} is empty",
disk_dir.display()
);
assert_eq!(
FILES, disk_files.as_slice(),
"locales/{locale}/*.ftl 与 catalog::FILES 不一致(新文件须同时登记 FILES 与 *_SOURCES)"
);
let sources = sources_for(locale).expect("embedded locale source");
assert_eq!(sources.len(), FILES.len());
}
}
}