Skip to content

PdfCraft: An open-source PDF reader and editor written by scratch in pure Rust

refactor(ui-egui): move i18n.rs's tests to i18n/tests.rs

aiongg6d8c0bb8dd13
diff --git a/crates/ui-egui/src/i18n.rs b/crates/ui-egui/src/i18n.rs
index 6214348f6..3f478b637 100644
--- a/crates/ui-egui/src/i18n.rs
+++ b/crates/ui-egui/src/i18n.rs
@@ -780,1235 +780,7 @@ fn name_sort_key(name: &str) -> String {
}
#[cfg(test)]
-mod tests {
- use super::catalog::{Entry, parse_entries, placeholders};
- use super::*;
-
- const JA: fn() -> Lang = || Lang::from_code("ja").expect("ja registered");
-
- #[test]
- fn keyboard_key_names_have_a_separate_context_and_english_fallback() {
- static KEYS: LangInfo = LangInfo {
- code: "keys",
- name: "Key name test catalog",
- source: "key\tDelete\tEntf\n\tDelete\tLöschen\n\tOpen\tÖffnen\n",
- plural: plural_one_other,
- rtl: false,
- catalog: OnceLock::new(),
- };
- let previous = current();
- set_current(Lang(&KEYS));
- assert_eq!(key_name("Delete"), "Entf");
- assert_eq!(t("Delete"), "Löschen");
- assert_eq!(key_name("Open"), "Open", "a missing key name must not borrow a command translation");
- set_current(Lang::EN);
- assert_eq!(key_name("Delete"), "Delete");
- set_current(previous);
- }
-
- /// Regression test: a language picker uses its native name only when a face can draw it, otherwise its
- /// English name.
- #[test]
- fn picker_names_fall_back_to_english_when_their_script_has_no_face() {
- let hi = Lang::from_code("hi").expect("hi registered");
- assert_eq!(hi.picker_name(|_| true), "हिन्दी", "the native name is kept when it can be drawn");
- assert_eq!(hi.picker_name(|_| false), "Hindi", "no Devanagari face: an English name, not an unrenderable label");
- assert_eq!(Lang::EN.picker_name(|_| false), "English");
- for language in Lang::all() {
- assert!(!language.english_name().is_empty(), "{}", language.code());
- assert_ne!(language.english_name(), language.code(), "{} needs an English picker fallback", language.code());
- }
- }
-
- #[test]
- fn tags_map_to_languages() {
- assert_eq!(lang_from_tag("ja_JP.UTF-8"), Some(JA()));
- assert_eq!(lang_from_tag("ja-JP"), Some(JA()));
- assert_eq!(lang_from_tag("en_US.UTF-8"), Some(Lang::EN));
- assert_eq!(lang_from_tag("C"), Some(Lang::EN));
- assert_eq!(lang_from_tag("POSIX"), Some(Lang::EN));
- assert_eq!(lang_from_tag("fr_FR"), Lang::from_code("fr"));
- assert_eq!(lang_from_tag("fr_CA.UTF-8"), Lang::from_code("fr"));
- assert_eq!(lang_from_tag("fr-BE"), Lang::from_code("fr"));
- assert_eq!(lang_from_tag("zh-TW"), Lang::from_code("zh-hant"));
- assert_eq!(lang_from_tag("zh_CN.UTF-8"), Lang::from_code("zh-hans"));
- assert_eq!(lang_from_tag("zh"), Lang::from_code("zh-hans"));
- assert_eq!(lang_from_tag("zh_HK.UTF-8"), Lang::from_code("zh-hant"));
- assert_eq!(lang_from_tag("zh-Hant-MO"), Lang::from_code("zh-hant"));
- assert_eq!(lang_from_tag("lo_LA.UTF-8"), Lang::from_code("lo"));
- assert_eq!(lang_from_tag("lo-LA"), Lang::from_code("lo"));
- assert_eq!(lang_from_tag("lo"), Lang::from_code("lo"));
- assert_eq!(lang_from_tag(""), None);
- assert_eq!(lang_from_tag("_"), None);
- }
-
- #[test]
- fn candidates_walk_from_specific_to_general() {
- assert_eq!(candidates("pt_BR.UTF-8"), ["pt-br", "pt"]);
- assert_eq!(candidates("pt_PT.UTF-8"), ["pt-pt", "pt-br", "pt"]);
- assert_eq!(candidates("pt"), ["pt-br", "pt"]);
- assert_eq!(candidates("zh_TW"), ["zh-tw", "zh-hant", "zh"]);
- assert_eq!(candidates("zh-CN"), ["zh-cn", "zh-hans", "zh"]);
- assert_eq!(candidates("zh-Hant-HK"), ["zh-hant-hk", "zh-hant", "zh"]);
- assert_eq!(candidates("lo_LA.UTF-8"), ["lo-la", "lo"]);
- assert_eq!(candidates("nb_NO.UTF-8"), ["nb-no", "nb"]);
- assert_eq!(candidates("no_NO.UTF-8"), ["no-no", "no", "nb"]);
- assert_eq!(candidates("nn-NO"), ["nn-no", "nn", "nb"]);
- }
-
- #[test]
- fn macos_language_list_is_parsed() {
- assert_eq!(first_supported("(\n \"ja-JP\",\n \"en-US\"\n)\n"), Some(JA()));
- assert_eq!(first_supported("(\n \"fr-FR\",\n \"en-US\"\n)\n"), Lang::from_code("fr"));
- assert_eq!(first_supported("("), None);
- }
-
- /// #2954: the web build's Auto language follows the browser's preferred languages in order,
- /// skipping ones without a catalog, and is English only when none is supported.
- #[test]
- fn browser_language_list_is_followed_in_order() {
- assert_eq!(first_supported_tag(["it-IT", "en-US"]), Lang::from_code("it"));
- assert_eq!(first_supported_tag(["xx-YY", "ja", "fr-FR"]), Some(JA()));
- assert_eq!(first_supported_tag(["zh-TW"]), Lang::from_code("zh-hant"));
- assert_eq!(first_supported_tag(["en-GB", "fr-FR"]), Some(Lang::EN));
- assert_eq!(first_supported_tag([" pt-PT "]), Lang::from_code("pt-br"));
- assert_eq!(first_supported_tag(["", "xx"]), None);
- assert_eq!(first_supported_tag(Vec::<String>::new()), None);
- let long = std::iter::repeat_n("xx", 10_000).chain(["fr"]);
- assert_eq!(first_supported_tag(long), None, "only the first tags are read");
- }
-
- #[test]
- fn windows_display_language_resolves_chinese_scripts() {
- for tag in ["zh-CN", "zh-SG", "zh-Hans", "zh-Hans-CN"] {
- assert_eq!(first_supported(&format!("{tag}\r\n")), Lang::from_code("zh-hans"));
- }
- for tag in ["zh-TW", "zh-HK", "zh-MO", "zh-Hant", "zh-Hant-HK"] {
- assert_eq!(first_supported(&format!("{tag}\r\n")), Lang::from_code("zh-hant"));
- }
- assert_eq!(first_supported("en-US\r\n"), Some(Lang::EN));
- assert_eq!(first_supported("fr-FR\r\n"), Lang::from_code("fr"));
- assert_eq!(first_supported("lo-LA\r\n"), Lang::from_code("lo"));
- assert_eq!(first_supported("\r\n"), None);
- }
-
- #[cfg(target_os = "windows")]
- #[test]
- fn neutral_locale_does_not_override_display_language() {
- let fr = Lang::from_code("fr").unwrap();
- for tag in ["C", "C.UTF-8", "POSIX", "posix.UTF-8", "", " C.UTF-8 ", "unsupported"] {
- assert_eq!(language_override(tag), None, "{tag}");
- assert_eq!(language_override(tag).or_else(|| first_supported("unsupported-XY\nfr-FR\nen-US")), Some(fr));
- }
- assert_eq!(["C.UTF-8", "POSIX", "fr_FR.UTF-8"].into_iter().find_map(language_override), Some(fr));
- assert_eq!(language_override("fr_FR.UTF-8"), Some(fr));
- assert_eq!(language_override("en_US.UTF-8"), Some(Lang::EN));
- assert_eq!(language_override("ja_JP.UTF-8"), Some(JA()));
- }
-
- #[cfg(target_os = "windows")]
- #[test]
- fn windows_display_language_query_returns_a_locale_tag() {
- // One tag per line, as `first_supported` reads them: a machine with several display
- // languages reports them all, so each line is checked rather than the list as a whole.
- let list = windows_ui_language().expect("Windows should report a display language");
- let tags: Vec<&str> = list.lines().map(str::trim).filter(|t| !t.is_empty()).collect();
- assert!(!tags.is_empty(), "no display language in {list:?}");
- for tag in tags {
- assert!(tag.split('-').all(|part| !part.is_empty() && part.bytes().all(|b| b.is_ascii_alphanumeric())), "not a locale tag: {tag:?}");
- }
- }
-
- #[test]
- fn preferences_resolve_with_fallback() {
- assert_eq!(Lang::from_pref("ja"), JA());
- assert_eq!(Lang::from_pref("JA"), JA());
- assert_eq!(Lang::from_pref("en"), Lang::EN);
- // `auto` and unknown codes follow the system (English under test).
- assert_eq!(Lang::from_pref(AUTO), Lang::EN);
- assert_eq!(Lang::from_pref("xx-unknown"), Lang::EN);
- assert_eq!(normalize_pref("JA"), Some("ja"));
- assert_eq!(normalize_pref("Auto"), Some(AUTO));
- assert_eq!(normalize_pref("xx"), None);
- }
-
- #[test]
- fn lookups_fall_back_to_english() {
- assert_eq!(tr(JA(), "no such label"), "no such label");
- assert_eq!(tr(Lang::EN, "File"), "File");
- assert_eq!(tr(JA(), "File"), "ファイル");
- assert_eq!(tr(JA(), "日本語の文書.pdf"), "日本語の文書.pdf");
- assert_eq!(tr_id(JA(), "no.such.id", "File"), "ファイル");
- assert_eq!(tr_ctx(JA(), "no such context", "File"), "ファイル");
- assert!(has(JA(), "Save") && !has(Lang::EN, "Save"));
- }
-
- #[test]
- fn catalog_kinds_are_parsed_and_looked_up() {
- let (c, errors) = Catalog::parse(
- "# c\n\tHello\tこんにちは\n@id\tfile.save\t保存する\nmenu\tWindows\tウィンドウ群\n@plural\t{n} file|{n} files\t{n} 個\n\n",
- 1,
- );
- assert!(errors.is_empty(), "{errors:?}");
- assert_eq!(c.plain("Hello"), Some("こんにちは"));
- assert_eq!(c.id("file.save"), Some("保存する"));
- assert_eq!(c.contextual("menu", "Windows"), Some("ウィンドウ群"));
- assert_eq!(c.contextual("other", "Windows"), None);
- assert_eq!(c.plural("{n} file", "{n} files", 0), Some("{n} 個"));
- assert_eq!(c.plural("{n} file", "{n} files", 5), Some("{n} 個"), "an index past the forms clamps");
- }
-
- #[test]
- fn malformed_lines_are_reported_not_fatal() {
- let (entries, errors) = parse_entries("\tok\tはい\nno tabs here\n\tonly\n\ta\tb\tc\textra\n\t\tempty source\n", 1);
- assert_eq!(entries.len(), 1);
- assert_eq!(errors.len(), 4, "{errors:?}");
- let (entries, errors) = parse_entries("\ta\\tb\tx\\ny\\\\z\n", 1);
- assert!(errors.is_empty(), "{errors:?}");
- assert_eq!(entries, [Entry { context: String::new(), source: "a\tb".into(), translation: "x\ny\\z".into() }]);
- }
-
- #[test]
- fn strict_validation_skips_only_the_bad_line() {
- for (text, forms, error) in [
- ("\tFile", 1, "context<TAB>"),
- ("\tFile\t", 1, "nonempty"),
- ("\tFile\\q\tFiles", 1, "unknown escape"),
- ("\tFile\tFiles\\", 1, "trailing backslash"),
- ("\tOpen…\tOpen", 1, "ellipsis"),
- ("\tOpen {file}\tOpen {name}", 1, "placeholders"),
- ("@plural\tpage\tPages", 1, "one|other"),
- ("@plural\t{n} page|{n} pages\t{n} pages", 2, "2 nonempty"),
- ("@plural\t{n} page|{n} pages\tPages", 1, "placeholders"),
- ("@unknown\tFile\tFiles", 1, "reserved context"),
- ] {
- // The bad line comes first; the good line after it still loads.
- let (catalog, errors) = Catalog::parse(&format!("{text}\n\tSave\t保存\n"), forms);
- assert_eq!(errors.len(), 1, "{text:?}: {errors:?}");
- assert!(errors[0].starts_with("line 1: ") && errors[0].contains(error), "{errors:?}");
- assert_eq!(catalog.plain("Save"), Some("保存"), "{text:?}");
- }
- let (catalog, errors) = Catalog::parse("\tFile\tファイル\n\tFile\t別\n", 1);
- assert!(errors.len() == 1 && errors[0].contains("line 2: duplicate"), "{errors:?}");
- assert_eq!(catalog.plain("File"), Some("ファイル"), "the first entry wins");
- }
-
- #[test]
- fn catalogs_handle_escapes_crlf_and_distinct_contexts() {
- let (catalog, errors) =
- Catalog::parse("# comment\r\n\r\n\tLine\\nTab\\tPath\\\\\tOther\\nTab\\tPath\\\\\r\nweight\tLight\tThin\r\ntheme\tLight\tPale\r\n", 1);
- assert!(errors.is_empty(), "{errors:?}");
- assert_eq!(catalog.plain("Line\nTab\tPath\\"), Some("Other\nTab\tPath\\"));
- assert_eq!(catalog.contextual("weight", "Light"), Some("Thin"));
- assert_eq!(catalog.contextual("theme", "Light"), Some("Pale"));
- }
-
- #[test]
- fn broken_catalog_falls_back_to_english() {
- static BROKEN: LangInfo = LangInfo {
- code: "broken",
- name: "Broken test catalog",
- source: "malformed\n\\",
- plural: plural_none,
- rtl: false,
- catalog: OnceLock::new(),
- };
- assert_eq!(tr(Lang(&BROKEN), "File"), "File");
- assert_eq!(trn(Lang(&BROKEN), 2, "{n} page", "{n} pages"), "2 pages");
- }
-
- #[test]
- fn contextual_id_and_plural_lookups_have_english_fallbacks() {
- static TEST: LangInfo = LangInfo {
- code: "test",
- name: "Test catalog",
- source: "\tLight\tPlain light\nweight\tLight\tThin\n@id\tfile.open\tOpen dialog…\n@plural\t{n} page|{n} pages\tOne page: {n}|Many pages: {n}\n",
- plural: plural_one_other,
- rtl: false,
- catalog: OnceLock::new(),
- };
- let l = Lang(&TEST);
- assert_eq!(tr_ctx(l, "weight", "Light"), "Thin");
- assert_eq!(tr_ctx(l, "theme", "Light"), "Plain light");
- assert_eq!(tr_ctx(l, "theme", "Unknown"), "Unknown");
- assert_eq!(tr_id(l, "file.open", "Reworded English…"), "Open dialog…");
- assert_eq!(tr_id(l, "unknown", "Light"), "Plain light");
- assert_eq!(tr_id(l, "unknown", "Unknown"), "Unknown");
- assert_eq!(trn(l, 1, "{n} page", "{n} pages"), "One page: 1");
- assert_eq!(trn(l, 0, "{n} page", "{n} pages"), "Many pages: 0");
- assert_eq!(trn(l, u64::MAX, "{n} page", "{n} pages"), format!("Many pages: {}", u64::MAX));
- }
-
- #[test]
- fn formatting_reorders_parameters_without_reinterpreting_user_text() {
- let args = [("file", "日本語-{n}.pdf"), ("n", "2")];
- assert_eq!(fmt("{n}: {file}; {unknown}", &args), "2: 日本語-{n}.pdf; {unknown}");
- assert_eq!(fmt("{file} / {file}", &args), "日本語-{n}.pdf / 日本語-{n}.pdf");
- assert_eq!(fmt("text {unfinished", &args), "text {unfinished");
- assert_eq!(fmt("}{n}{", &args), "}2{");
- assert_eq!(fmt("unchanged", &[]), "unchanged");
- }
-
- /// Every literal passed to `tl!(…)` or `crate::i18n::t(…)` in the UI source (test modules
- /// aside), unescaped, including literals on a line of their own.
- fn ui_literals() -> std::collections::BTreeSet<String> {
- let mut stack = vec![std::path::Path::new(env!("CARGO_MANIFEST_DIR")).join("src")];
- let mut literals = std::collections::BTreeSet::new();
- while let Some(dir) = stack.pop() {
- for entry in std::fs::read_dir(dir).expect("UI source directory") {
- let path = entry.expect("UI source entry").path();
- if path.is_dir() {
- if path.file_name().is_some_and(|name| name != "i18n") {
- stack.push(path);
- }
- } else if path.extension().is_some_and(|ext| ext == "rs") {
- let source = std::fs::read_to_string(path).expect("UI source file").replace("\r\n", "\n");
- let source = source.replace("crate::i18n::t(", "tl!(");
- let mut rest = source.split("#[cfg(test)]\nmod ").next().unwrap_or_default();
- while let Some((_, after)) = rest.split_once("tl!(") {
- let after = after.trim_start();
- let Some(after) = after.strip_prefix('"') else {
- rest = after;
- continue;
- };
- let mut escaped = false;
- let end = after
- .char_indices()
- .find_map(|(i, c)| {
- if c == '"' && !escaped {
- return Some(i);
- }
- escaped = c == '\\' && !escaped;
- None
- })
- .expect("closed tl! literal");
- let (raw, tail) = after.split_at(end);
- let argument_end = tail.strip_prefix('"').expect("closing quote").trim_start();
- let literal_call =
- argument_end.starts_with(')') || argument_end.strip_prefix(',').is_some_and(|rest| rest.trim_start().starts_with(')'));
- if literal_call {
- let label: String = serde_json::from_str(&format!("\"{raw}\"")).expect("UI literal escapes");
- literals.insert(label);
- }
- rest = tail.strip_prefix('"').expect("closing quote");
- }
- }
- }
- }
- literals
- }
-
- /// Each translated label of a visible signature that runs into its value keeps a separator
- /// at its end.
- #[test]
- fn signature_appearance_labels_keep_their_separator() {
- let english = pdfcraft_engine::sign::AppearanceLabels::default();
- for language in LANGUAGES.iter().filter(|language| !language.source.is_empty()) {
- let lang = Lang::from_code(language.code).expect("registered language");
- for (field, label) in english.fields() {
- let said = tr(lang, label);
- if field != "signed_by" && !lang.rtl() {
- assert!(said.ends_with(' ') || said.ends_with(':'), "{}: the {field} label runs into its value: {said:?}", language.code);
- }
- }
- }
- }
-
- /// With craft-fonts, every Japanese translation has glyphs: with all interface faces (desktop)
- /// and with BIZ UDPGothic Regular alone (the web build's only Japanese face).
- #[test]
- fn japanese_labels_have_glyphs() {
- let craft = pdfcraft_fonts::ui_japanese_fonts();
- let Some(web) = craft.iter().find(|f| f.family == "BIZ UDPGothic" && f.style == "Regular") else {
- eprintln!("skipping Japanese glyph checks: build with CRAFT_FONTS_DIR to run them");
- return;
- };
- let (entries, _) = parse_entries(JA().0.source, 1);
- let labels: String = entries.iter().flat_map(|e| e.translation.chars()).chain(JA().name().chars()).filter(|c| !c.is_control()).collect();
- let web_name = web.name();
- let mut web_only = crate::theme::font_definitions();
- for family in web_only.families.values_mut() {
- family.retain(|name| !pdfcraft_fonts::CRAFT_FONTS.iter().any(|face| face.name() == *name) || *name == web_name);
- }
- use egui::epaint::text::{Fonts, TextOptions};
- for (build, defs) in [("desktop", crate::theme::font_definitions()), ("web", web_only)] {
- let mut fonts = Fonts::new(TextOptions::default(), defs);
- for id in [egui::FontId::proportional(13.0), egui::FontId::monospace(13.0), crate::theme::medium(13.0), crate::theme::semibold(17.0)] {
- assert!(fonts.has_glyphs(&id, &labels), "{build}: {id:?} lacks a Japanese label glyph");
- }
- }
- }
-
- #[test]
- fn history_labels_keep_captured_names() {
- set_current(JA());
- assert_eq!(action_label("Insert pages from Save {e}.pdf"), "Save {e}.pdf からページを挿入");
- assert_eq!(command_label("Undo Insert pages from Save {e}.pdf"), "取り消し Save {e}.pdf からページを挿入");
- assert_eq!(action_label("Untranslated custom action"), "Untranslated custom action");
- assert_eq!(menu_label("file.open", "Open…"), "開く…");
- set_current(Lang::EN);
- assert_eq!(command_label("Undo Fill in Save {e}"), "Undo Fill in Save {e}");
- }
-
- #[test]
- fn current_language_is_per_thread() {
- set_current(JA());
- assert_eq!(t("File"), "ファイル");
- std::thread::spawn(|| assert_eq!(current(), Lang::EN)).join().unwrap();
- set_current(Lang::EN);
- assert_eq!(t("File"), "File");
- }
-
- #[test]
- fn plurals_and_placeholders() {
- assert_eq!(trn(Lang::EN, 1, "{n} item", "{n} items"), "1 item");
- assert_eq!(trn(Lang::EN, 0, "{n} item", "{n} items"), "0 items");
- assert_eq!(trn(Lang::EN, 7, "{n} item", "{n} items"), "7 items");
- // No catalog has this `@plural` entry: Japanese falls back to the English forms.
- assert_eq!(trn(JA(), 7, "{n} test item", "{n} test items"), "7 test items");
- assert_eq!(fmt("{b} before {a}", &[("a", "x"), ("b", "y"), ("c", "z")]), "y before x");
- assert_eq!(fmt("{missing}", &[]), "{missing}");
- assert_eq!(placeholders("a {x} b {y} {"), ["x", "y"]);
- }
-
- #[test]
- fn language_persists_and_invalid_input_keeps_current_language() {
- let mut app = crate::PdfCraftApp::default();
- assert_eq!(app.language, AUTO);
- app.set_option("language", "JA").unwrap();
- assert_eq!(app.language, "ja");
- assert!(app.set_option("language", "xx").is_err());
- assert_eq!(app.language, "ja");
- let mut restored = crate::PdfCraftApp::default();
- restored.restore(&app.persist());
- assert_eq!(restored.language, "ja");
- restored.restore(r#"{"language":"xx"}"#);
- assert_eq!(restored.language, "ja");
- app.set_option("language", AUTO).unwrap();
- assert_eq!(app.language, AUTO);
- // Settings written before the system-locale default (no key) follow the system.
- let mut legacy = crate::PdfCraftApp::default();
- legacy.restore("{}");
- assert_eq!(legacy.language, AUTO);
- }
-
- #[test]
- fn brazilian_portuguese_is_registered() {
- let pt = Lang::from_code("pt-br").expect("pt-br registered");
- assert_eq!(pt.name(), "Português (Brasil)");
- assert_eq!(Lang::from_code("PT-BR"), Some(pt));
- assert_eq!(normalize_pref("pt-BR"), Some("pt-br"));
- assert_eq!(normalize_pref("pt"), None, "only exact codes are preferences");
- assert_eq!(lang_from_tag("pt_BR.UTF-8"), Some(pt));
- assert_eq!(lang_from_tag("pt_PT"), Some(pt));
- assert_eq!(tr(pt, "Arquivo do usuário.pdf"), "Arquivo do usuário.pdf");
- assert_eq!((0..=3).map(|n| (pt.0.plural)(n)).collect::<Vec<_>>(), [0, 0, 1, 1]);
- let mut app = crate::PdfCraftApp::default();
- app.set_option("language", "pt-br").unwrap();
- assert_eq!(app.language, "pt-br");
- let mut restored = crate::PdfCraftApp::default();
- restored.restore(&app.persist());
- assert_eq!(restored.language, "pt-br");
- }
-
- #[test]
- fn spanish_is_registered() {
- let es = Lang::from_code("es").expect("es registered");
- assert_eq!(es.name(), "Español");
- assert_eq!(normalize_pref("ES"), Some("es"));
- assert_eq!(lang_from_tag("es_ES.UTF-8"), Some(es));
- assert_eq!(lang_from_tag("es-MX"), Some(es));
- assert_eq!(first_supported("es-ES\r\nen-US"), Some(es));
- assert_eq!(tr(es, "Informe del usuario.pdf"), "Informe del usuario.pdf");
- let mut app = crate::PdfCraftApp::default();
- app.set_option("language", "es").unwrap();
- assert_eq!(app.language, "es");
- let mut restored = crate::PdfCraftApp::default();
- restored.restore(&app.persist());
- assert_eq!(restored.language, "es");
- }
-
- /// Each sentence the engine words for itself keeps its holes when it is said in Spanish, so
- /// the document's own words still have somewhere to go: a translation that drops `{p}` or
- /// `{}` would read as a sentence about nothing in particular.
- #[test]
- fn spanish_keeps_the_holes_in_what_the_engine_says() {
- let es = Lang::from_code("es").expect("es registered");
- let lists: [&[&str]; 5] = [
- pdfcraft_engine::a11y::WORDINGS,
- pdfcraft_engine::pdfa::WORDINGS,
- pdfcraft_engine::sign::pdf::WORDINGS,
- pdfcraft_engine::print::WORDINGS,
- pdfcraft_engine::field_table::WORDINGS,
- ];
- for wording in lists.into_iter().flatten() {
- let said = tr(es, wording);
- // `{}` is one hole; `{name}` holes are named, and each name must survive by itself.
- assert_eq!(wording.matches("{}").count(), said.matches("{}").count(), "the Spanish of {wording:?} loses a hole: {said:?}");
- for hole in wording.split('{').skip(1).filter_map(|rest| rest.split_once('}')).map(|(name, _)| name).filter(|n| !n.is_empty()) {
- assert!(said.contains(&format!("{{{hole}}}")), "the Spanish of {wording:?} loses {{{hole}}}: {said:?}");
- }
- }
- }
-
- #[test]
- fn telugu_is_registered() {
- let te = Lang::from_code("te").expect("te registered");
- assert_eq!(te.name(), "తెలుగు");
- assert_eq!(normalize_pref("TE"), Some("te"));
- assert_eq!(lang_from_tag("te_IN.UTF-8"), Some(te));
- assert_eq!(first_supported("te-IN\r\nen-US"), Some(te));
- assert_eq!(tr(te, "నివేదిక.pdf"), "నివేదిక.pdf");
- let mut app = crate::PdfCraftApp::default();
- app.set_option("language", "te").unwrap();
- assert_eq!(app.language, "te");
- let mut restored = crate::PdfCraftApp::default();
- restored.restore(&app.persist());
- assert_eq!(restored.language, "te");
- }
-
- /// Telugu puts the verb last, so it translates "Undo {action}" as a whole phrase; a catalog
- /// without that entry (Spanish) keeps the verb in front of the action.
- #[test]
- fn undo_and_redo_labels_use_the_catalog_phrase_when_there_is_one() {
- let te = Lang::from_code("te").expect("te registered");
- set_current(te);
- assert_eq!(command_label("Undo"), "రద్దు చేయి");
- assert_eq!(command_label("Undo Untranslated custom action"), "రద్దు చేయి: Untranslated custom action");
- assert_eq!(command_label("Redo Untranslated custom action"), "మళ్లీ చేయి: Untranslated custom action");
- let es = Lang::from_code("es").expect("es registered");
- set_current(es);
- assert_eq!(command_label("Undo Untranslated custom action"), format!("{} Untranslated custom action", tr(es, "Undo")));
- set_current(Lang::EN);
- assert_eq!(command_label("Undo Untranslated custom action"), "Undo Untranslated custom action");
- }
-
- /// A label that reads differently by use has its own contextual entry where a language needs
- /// one; a language without it falls back to the plain translation.
- #[test]
- fn contextual_labels_fall_back_to_the_plain_translation() {
- let te = Lang::from_code("te").expect("te registered");
- assert_eq!(tr_ctx(te, "signature pad", "Type"), "టైప్ చేయి");
- assert_eq!(tr(te, "Type"), "రకం");
- // A context no catalog defines, so the fallback stays tested as catalogs fill their gaps.
- let es = Lang::from_code("es").expect("es registered");
- assert_eq!(tr_ctx(es, "no such context", "Type"), tr(es, "Type"));
- }
-
- /// With a craft-fonts Telugu face, every Telugu translation has glyphs: with all interface
- /// faces (desktop) and with the Telugu face as the only craft-fonts face (the web build keeps
- /// it; Telugu labels must not need a Japanese or Arabic face).
- #[test]
- fn telugu_labels_have_glyphs() {
- let telugu: Vec<String> = pdfcraft_fonts::ui_telugu_fonts().iter().map(|f| f.name()).collect();
- if telugu.is_empty() {
- eprintln!("skipping Telugu glyph checks: build with CRAFT_FONTS_DIR and a Telugu face to run them");
- return;
- }
- let te = Lang::from_code("te").expect("te registered");
- let (entries, _) = parse_entries(te.0.source, te.0.plural_forms());
- let labels: String = entries.iter().flat_map(|e| e.translation.chars()).chain(te.name().chars()).filter(|c| !c.is_control()).collect();
- let mut telugu_only = crate::theme::font_definitions();
- for family in telugu_only.families.values_mut() {
- family.retain(|name| !pdfcraft_fonts::CRAFT_FONTS.iter().any(|face| face.name() == *name) || telugu.contains(name));
- }
- use egui::epaint::text::{Fonts, TextOptions};
- for (build, defs) in [("all faces", crate::theme::font_definitions()), ("Telugu face only", telugu_only)] {
- let mut fonts = Fonts::new(TextOptions::default(), defs);
- for id in [egui::FontId::proportional(13.0), egui::FontId::monospace(13.0), crate::theme::medium(13.0), crate::theme::semibold(17.0)] {
- assert!(fonts.has_glyphs(&id, &labels), "{build}: {id:?} lacks a Telugu label glyph");
- }
- }
- }
-
- #[test]
- fn czech_is_registered_and_persists() {
- let cs = Lang::from_code("cs").expect("cs registered");
- assert_eq!(cs.name(), "Čeština");
- assert_eq!(tr(cs, "Žluťoučký kůň.pdf"), "Žluťoučký kůň.pdf");
- assert_eq!((0..=6).map(|n| (cs.0.plural)(n)).collect::<Vec<_>>(), [2, 0, 1, 1, 1, 2, 2]);
- let mut app = crate::PdfCraftApp::default();
- app.set_option("language", "cs").unwrap();
- assert!(app.set_option("language", "cz").is_err());
- assert_eq!(app.language, "cs");
- let mut restored = crate::PdfCraftApp::default();
- restored.restore(&app.persist());
- assert_eq!(restored.language, "cs");
- }
-
- #[test]
- fn turkish_is_registered_and_persists() {
- let tr_lang = Lang::from_code("tr").expect("tr registered");
- assert_eq!(tr_lang.name(), "Türkçe");
- assert_eq!(tr(tr_lang, "Türkçe Belge.pdf"), "Türkçe Belge.pdf");
- assert_eq!((0..=6).map(|n| (tr_lang.0.plural)(n)).collect::<Vec<_>>(), [0; 7]);
- let mut app = crate::PdfCraftApp::default();
- app.set_option("language", "tr").unwrap();
- assert!(app.set_option("language", "tu").is_err());
- assert_eq!(app.language, "tr");
- let mut restored = crate::PdfCraftApp::default();
- restored.restore(&app.persist());
- assert_eq!(restored.language, "tr");
- }
-
- /// The code joins some labels with a space at either end, so these catalogs keep exactly the
- /// source's, and write … rather than three dots.
- #[test]
- fn catalog_rows_keep_the_source_spacing_and_ellipsis() {
- let edges = |s: &str| (s.len() - s.trim_start().len(), s.len() - s.trim_end().len());
- for code in ["cs", "tr", "vi"] {
- let lang = Lang::from_code(code).expect("registered");
- let (entries, errors) = parse_entries(lang.0.source, lang.0.plural_forms());
- assert!(errors.is_empty(), "{code}: {errors:?}");
- for e in &entries {
- assert!(!e.translation.contains("..."), "{code}: use … rather than three dots: {:?}", e.translation);
- assert_eq!(edges(&e.translation), edges(&e.source), "{code}: stray whitespace: {:?}", e.translation);
- }
- }
- }
-
- #[test]
- fn simplified_chinese_is_registered() {
- let zh = Lang::from_code("zh-hans").expect("zh-hans registered");
- assert_eq!(zh.name(), "简体中文");
- assert_eq!(normalize_pref("zh-Hans"), Some("zh-hans"));
- assert_eq!(normalize_pref("zh"), None, "only exact codes are preferences");
- assert_eq!(tr(zh, "报告.pdf"), "报告.pdf");
- }
-
- #[test]
- fn traditional_chinese_is_registered() {
- let zh = Lang::from_code("zh-hant").expect("zh-hant registered");
- assert_eq!(zh.name(), "繁體中文");
- assert_eq!(normalize_pref("zh-Hant"), Some("zh-hant"));
- assert_eq!(tr(zh, "報告.pdf"), "報告.pdf");
- }
-
- #[test]
- fn french_is_registered() {
- let fr = Lang::from_code("fr").expect("fr registered");
- assert_eq!(fr.name(), "Français");
- assert_eq!(normalize_pref("FR"), Some("fr"));
- assert_eq!(lang_from_tag("fr_FR.UTF-8"), Some(fr));
- assert_eq!(lang_from_tag("fr-CA"), Some(fr));
- assert_eq!(first_supported("fr-FR\r\nen-US"), Some(fr));
- assert_eq!(tr(fr, "Rapport de l'utilisateur.pdf"), "Rapport de l'utilisateur.pdf");
- assert_eq!((0..=3).map(|n| (fr.0.plural)(n)).collect::<Vec<_>>(), [0, 0, 1, 1]);
- let mut app = crate::PdfCraftApp::default();
- app.set_option("language", "fr").unwrap();
- assert_eq!(app.language, "fr");
- let mut restored = crate::PdfCraftApp::default();
- restored.restore(&app.persist());
- assert_eq!(restored.language, "fr");
- }
-
- #[test]
- fn german_is_registered() {
- let de = Lang::from_code("de").expect("de registered");
- assert_eq!(de.name(), "Deutsch");
- assert_eq!(normalize_pref("DE"), Some("de"));
- assert_eq!(lang_from_tag("de_DE.UTF-8"), Some(de));
- assert_eq!(lang_from_tag("de-AT"), Some(de));
- assert_eq!(lang_from_tag("de_CH"), Some(de));
- assert_eq!(first_supported("de-DE\r\nen-US"), Some(de));
- assert_eq!(tr(de, "Bericht des Nutzers.pdf"), "Bericht des Nutzers.pdf");
- assert_eq!((0..=3).map(|n| (de.0.plural)(n)).collect::<Vec<_>>(), [1, 0, 1, 1]);
- let mut app = crate::PdfCraftApp::default();
- app.set_option("language", "de").unwrap();
- assert_eq!(app.language, "de");
- let mut restored = crate::PdfCraftApp::default();
- restored.restore(&app.persist());
- assert_eq!(restored.language, "de");
- }
-
- #[test]
- fn tool_names_inside_sentences_are_lowercased_except_in_german() {
- set_current(Lang::EN);
- assert_eq!(in_sentence("Text Box"), "text box");
- set_current(Lang::from_code("de").expect("de registered"));
- assert_eq!(in_sentence("Textfeld"), "Textfeld");
- set_current(Lang::EN);
- }
-
- #[test]
- fn turkish_keeps_its_dotted_and_dotless_i_when_changing_case() {
- set_current(Lang::from_code("tr").expect("tr registered"));
- assert_eq!(upper_label("Advanced"), "GELİŞMİŞ");
- assert_eq!(upper_label("Signatures"), "İMZALAR");
- // A label with no Turkish row is still English and keeps the English rule.
- assert_eq!(upper_label("Untranslated title"), "UNTRANSLATED TITLE");
- assert_eq!(in_sentence("İmza Alanı"), "imza alanı");
- assert_eq!(in_sentence("Işık"), "ışık");
- set_current(Lang::EN);
- assert_eq!(upper_label("Advanced"), "ADVANCED");
- assert_eq!(in_sentence("Image"), "image");
- }
-
- #[test]
- fn russian_is_registered() {
- let ru = Lang::from_code("ru").expect("ru registered");
- assert_eq!(ru.name(), "Русский");
- assert_eq!(normalize_pref("RU"), Some("ru"));
- assert_eq!(lang_from_tag("ru_RU.UTF-8"), Some(ru));
- assert_eq!(lang_from_tag("ru-BY"), Some(ru));
- assert_eq!(first_supported("ru-RU\r\nen-US"), Some(ru));
- assert_eq!(tr(ru, "Rapport de l'utilisateur.pdf"), "Rapport de l'utilisateur.pdf");
- // one (1), few (2-4), many (0, 5+), with 11-14 exception
- assert_eq!((0..=3).map(|n| (ru.0.plural)(n)).collect::<Vec<_>>(), [2, 0, 1, 1]);
- let mut app = crate::PdfCraftApp::default();
- app.set_option("language", "ru").unwrap();
- assert_eq!(app.language, "ru");
- let mut restored = crate::PdfCraftApp::default();
- restored.restore(&app.persist());
- assert_eq!(restored.language, "ru");
- }
-
- #[test]
- fn finnish_is_registered_and_persists() {
- let fi = Lang::from_code("fi").expect("fi registered");
- assert_eq!(fi.name(), "Suomi");
- assert_eq!(normalize_pref("FI"), Some("fi"));
- for tag in ["fi", "fi-FI", "fi_FI.UTF-8", "FI-fi"] {
- assert_eq!(lang_from_tag(tag), Some(fi), "{tag}");
- }
- // Filipino (`fil`) and Swedish in Finland (`sv-FI`) don't pick Finnish.
- assert_ne!(lang_from_tag("fil"), Some(fi));
- assert_ne!(lang_from_tag("sv-FI"), Some(fi));
- let mut app = crate::PdfCraftApp::default();
- app.set_option("language", "FI").unwrap();
- assert_eq!(app.language, "fi");
- let mut restored = crate::PdfCraftApp::default();
- restored.restore(&app.persist());
- assert_eq!(restored.language, "fi");
- }
-
- #[test]
- fn lithuanian_is_registered_and_persists() {
- let lt = Lang::from_code("lt").expect("lt registered");
- assert_eq!(lt.name(), "Lietuvių");
- assert_eq!(normalize_pref("LT"), Some("lt"));
- for tag in ["lt", "lt-LT", "lt_LT.UTF-8", "LT-lt"] {
- assert_eq!(lang_from_tag(tag), Some(lt), "{tag}");
- }
- let mut app = crate::PdfCraftApp::default();
- app.set_option("language", "LT").unwrap();
- assert_eq!(app.language, "lt");
- let mut restored = crate::PdfCraftApp::default();
- restored.restore(&app.persist());
- assert_eq!(restored.language, "lt");
- assert!(restored.set_option("language", "xx").is_err());
- }
-
- #[test]
- fn norwegian_bokmal_is_registered_and_persists() {
- let nb = Lang::from_code("nb").expect("nb registered");
- assert_eq!(nb.name(), "Norsk bokmål");
- assert_eq!(normalize_pref("NB"), Some("nb"));
- assert_eq!(normalize_pref("no"), None, "only exact codes are preferences");
- // Current systems say `nb`; older ones and some Linux setups say `no`. Nynorsk is `nn`.
- for tag in ["nb", "nb-NO", "nb_NO.UTF-8", "no", "no_NO.UTF-8", "NO-no", "nn", "nn_NO.UTF-8"] {
- assert_eq!(lang_from_tag(tag), Some(nb), "{tag}");
- }
- assert_eq!(first_supported("(\n \"nb-NO\",\n \"en-US\"\n)\n"), Some(nb));
- assert_eq!(first_supported("nn-NO\r\nen-US\r\n"), Some(nb));
- assert_eq!((0..=3).map(|n| (nb.0.plural)(n)).collect::<Vec<_>>(), [1, 0, 1, 1]);
- let mut app = crate::PdfCraftApp::default();
- app.set_option("language", "NB").unwrap();
- assert_eq!(app.language, "nb");
- let mut restored = crate::PdfCraftApp::default();
- restored.restore(&app.persist());
- assert_eq!(restored.language, "nb");
- }
-
- #[test]
- fn vietnamese_is_registered_and_persists() {
- let vi = Lang::from_code("vi").expect("vi registered");
- assert_eq!(vi.name(), "Tiếng Việt");
- assert_eq!(normalize_pref("Vi"), Some("vi"));
- for tag in ["vi", "vi-VN", "vi_VN.UTF-8", "VI-vn"] {
- assert_eq!(lang_from_tag(tag), Some(vi), "{tag}");
- }
- assert_eq!(first_supported("vi-VN\r\nen-US"), Some(vi));
- assert_eq!((0..=3).map(|n| (vi.0.plural)(n)).collect::<Vec<_>>(), [0, 0, 0, 0]);
- let mut app = crate::PdfCraftApp::default();
- app.set_option("language", "vi").unwrap();
- assert_eq!(app.language, "vi");
- let mut restored = crate::PdfCraftApp::default();
- restored.restore(&app.persist());
- assert_eq!(restored.language, "vi");
- assert!(restored.set_option("language", "xx").is_err());
- assert_eq!(restored.language, "vi");
- }
-
- #[test]
- fn romanian_is_registered_with_three_plural_forms() {
- let ro = Lang::from_code("ro").expect("ro registered");
- for tag in ["ro", "ro-RO", "ro_RO.UTF-8", "RO-ro", "ro-MD"] {
- assert_eq!(lang_from_tag(tag), Some(ro), "{tag}");
- }
- assert_eq!(normalize_pref("Ro"), Some("ro"));
- let info = LANGUAGES.iter().find(|language| language.code == "ro").expect("ro row");
- assert_eq!(info.plural_forms(), 3);
- // one: 1; few: 0 and n % 100 in 1..=19 ("2 pagini", "101 pagini"); other: the "de" form ("20 de pagini").
- for (n, form) in [(1, 0), (0, 1), (2, 1), (19, 1), (101, 1), (119, 1), (20, 2), (100, 2), (120, 2), (1000, 2)] {
- assert_eq!(plural_ro(n), form, "{n}");
- }
- }
-
- #[test]
- fn catalan_is_registered_and_persists() {
- let ca = Lang::from_code("ca").expect("ca registered");
- assert_eq!(ca.name(), "Català");
- assert_eq!(normalize_pref("CA"), Some("ca"));
- for tag in ["ca", "ca-ES", "ca_ES.UTF-8", "CA-es", "ca_ES@valencia"] {
- assert_eq!(lang_from_tag(tag), Some(ca), "{tag}");
- }
- assert_eq!(first_supported("ca-ES\r\nen-US"), Some(ca));
- // one (1), other (0, 2+), as in English
- assert_eq!((0..=3).map(|n| (ca.0.plural)(n)).collect::<Vec<_>>(), [1, 0, 1, 1]);
- let mut app = crate::PdfCraftApp::default();
- app.set_option("language", "CA").unwrap();
- assert_eq!(app.language, "ca");
- let mut restored = crate::PdfCraftApp::default();
- restored.restore(&app.persist());
- assert_eq!(restored.language, "ca");
- assert!(restored.set_option("language", "xx").is_err());
- assert_eq!(restored.language, "ca");
- }
-
- #[test]
- fn slovene_is_registered_and_persists() {
- let sl = Lang::from_code("sl").expect("sl registered");
- assert_eq!(sl.name(), "Slovenščina");
- assert_eq!(normalize_pref("SL"), Some("sl"));
- for tag in ["sl", "sl-SI", "sl_SI.UTF-8", "SL-si", "sl_SI@variant"] {
- assert_eq!(lang_from_tag(tag), Some(sl), "{tag}");
- }
- assert_eq!(first_supported("sl-SI\r\nen-US"), Some(sl));
- assert_eq!(tr(sl, "Poročilo {n}.pdf"), "Poročilo {n}.pdf");
- // one (1), two (2), few (3, 4), other (0, 5+)
- assert_eq!((0..=5).map(|n| (sl.0.plural)(n)).collect::<Vec<_>>(), [3, 0, 1, 2, 2, 3]);
- let mut app = crate::PdfCraftApp::default();
- app.set_option("language", "SL").unwrap();
- assert_eq!(app.language, "sl");
- let mut restored = crate::PdfCraftApp::default();
- restored.restore(&app.persist());
- assert_eq!(restored.language, "sl");
- assert!(restored.set_option("language", "xx").is_err());
- assert_eq!(restored.language, "sl");
- }
-
- #[test]
- fn albanian_is_registered_and_persists() {
- let sq = Lang::from_code("sq").expect("sq registered");
- assert_eq!(sq.name(), "Shqip");
- assert_eq!(normalize_pref("SQ"), Some("sq"));
- for tag in ["sq", "sq-AL", "sq_AL.UTF-8", "SQ-xk", "sq_XK@variant"] {
- assert_eq!(lang_from_tag(tag), Some(sq), "{tag}");
- }
- assert_eq!(first_supported("sq-AL\r\nen-US"), Some(sq));
- // one (1), other (0, 2+)
- assert_eq!((0..=3).map(|n| (sq.0.plural)(n)).collect::<Vec<_>>(), [1, 0, 1, 1]);
- let mut app = crate::PdfCraftApp::default();
- app.set_option("language", "SQ").unwrap();
- assert_eq!(app.language, "sq");
- let mut restored = crate::PdfCraftApp::default();
- restored.restore(&app.persist());
- assert_eq!(restored.language, "sq");
- assert!(restored.set_option("language", "xx").is_err());
- assert_eq!(restored.language, "sq");
- }
-
- #[test]
- fn slovene_plurals_cover_dual_few_teens_and_large_counts() {
- let sl = Lang::from_code("sl").expect("sl registered");
- assert_eq!(sl.0.plural_forms(), 4);
- for (counts, form) in [
- (vec![1, 101, 201, 1001, 1101], 0),
- (vec![2, 102, 202, 1002], 1),
- (vec![3, 4, 103, 104, 1003], 2),
- (vec![0, 5, 10, 11, 12, 13, 14, 15, 20, 21, 22, 23, 24, 25, 31, 100, 111, 112, 121, 122, 1000, u64::MAX], 3),
- ] {
- for n in counts {
- assert_eq!((sl.0.plural)(n), form, "{n}");
- }
- }
- }
-
- #[test]
- fn indonesian_and_vietnamese_are_registered_and_persist() {
- let id = Lang::from_code("id").expect("id registered");
- let vi = Lang::from_code("vi").expect("vi registered");
- assert_eq!(id.name(), "Bahasa Indonesia");
- assert_eq!(vi.name(), "Tiếng Việt");
- assert_eq!(normalize_pref("ID"), Some("id"));
- assert_eq!(normalize_pref("Vi"), Some("vi"));
- for tag in ["id", "id-ID", "id_ID.UTF-8", "ID-id"] {
- assert_eq!(lang_from_tag(tag), Some(id), "{tag}");
- }
- for tag in ["vi", "vi-VN", "vi_VN.UTF-8", "VI-vn"] {
- assert_eq!(lang_from_tag(tag), Some(vi), "{tag}");
- }
- assert_eq!(first_supported("id-ID\r\nen-US"), Some(id));
- assert_eq!(first_supported("vi-VN\r\nen-US"), Some(vi));
- // One CLDR plural form (CLDR `id`, `vi`): the message reads the same for every count.
- assert_eq!((0..=3).map(|n| (id.0.plural)(n)).collect::<Vec<_>>(), [0, 0, 0, 0]);
- assert_eq!((0..=3).map(|n| (vi.0.plural)(n)).collect::<Vec<_>>(), [0, 0, 0, 0]);
- let mut app = crate::PdfCraftApp::default();
- app.set_option("language", "ID").unwrap();
- assert_eq!(app.language, "id");
- let mut restored = crate::PdfCraftApp::default();
- restored.restore(&app.persist());
- assert_eq!(restored.language, "id");
- let mut app = crate::PdfCraftApp::default();
- app.set_option("language", "vi").unwrap();
- assert_eq!(app.language, "vi");
- let mut restored = crate::PdfCraftApp::default();
- restored.restore(&app.persist());
- assert_eq!(restored.language, "vi");
- assert!(restored.set_option("language", "xx").is_err());
- assert_eq!(restored.language, "vi");
- }
-
- #[test]
- fn hindi_and_korean_are_registered_and_persist() {
- let hi = Lang::from_code("hi").expect("hi registered");
- let ko = Lang::from_code("ko").expect("ko registered");
- assert_eq!(hi.name(), "हिन्दी");
- assert_eq!(ko.name(), "한국어");
- assert_eq!(normalize_pref("HI"), Some("hi"));
- assert_eq!(normalize_pref("Ko"), Some("ko"));
- for tag in ["hi", "hi-IN", "hi_IN.UTF-8", "HI-in"] {
- assert_eq!(lang_from_tag(tag), Some(hi), "{tag}");
- }
- for tag in ["ko", "ko-KR", "ko_KR.UTF-8", "KO-kr"] {
- assert_eq!(lang_from_tag(tag), Some(ko), "{tag}");
- }
- assert_eq!(first_supported("hi-IN\r\nen-US"), Some(hi));
- assert_eq!(first_supported("ko-KR\r\nen-US"), Some(ko));
- // One plural form per catalog: the message reads the same for every count.
- assert_eq!((0..=3).map(|n| (hi.0.plural)(n)).collect::<Vec<_>>(), [0, 0, 0, 0]);
- assert_eq!((0..=3).map(|n| (ko.0.plural)(n)).collect::<Vec<_>>(), [0, 0, 0, 0]);
- for code in ["hi", "ko"] {
- let mut app = crate::PdfCraftApp::default();
- app.set_option("language", &code.to_uppercase()).unwrap();
- assert_eq!(app.language, code);
- let mut restored = crate::PdfCraftApp::default();
- restored.restore(&app.persist());
- assert_eq!(restored.language, code);
- assert!(restored.set_option("language", "xx").is_err());
- assert_eq!(restored.language, code);
- }
- }
-
- #[test]
- fn bulgarian_is_registered() {
- let bg = Lang::from_code("bg").expect("bg registered");
- assert_eq!(bg.name(), "Български");
- assert_eq!(normalize_pref("BG"), Some("bg"));
- assert_eq!(lang_from_tag("bg_BG.UTF-8"), Some(bg));
- assert_eq!(lang_from_tag("bg-BG"), Some(bg));
- assert_eq!(first_supported("bg-BG\r\nen-US"), Some(bg));
- assert_eq!(tr(bg, "Rapport de l'utilisateur.pdf"), "Rapport de l'utilisateur.pdf");
- // one (1), other (0, 2+)
- assert_eq!((0..=3).map(|n| (bg.0.plural)(n)).collect::<Vec<_>>(), [1, 0, 1, 1]);
- let mut app = crate::PdfCraftApp::default();
- app.set_option("language", "bg").unwrap();
- assert_eq!(app.language, "bg");
- let mut restored = crate::PdfCraftApp::default();
- restored.restore(&app.persist());
- assert_eq!(restored.language, "bg");
- }
-
- #[test]
- fn hungarian_is_registered() {
- let hu = Lang::from_code("hu").expect("hu registered");
- assert_eq!(hu.name(), "Magyar");
- assert_eq!(normalize_pref("HU"), Some("hu"));
- assert_eq!(lang_from_tag("hu_HU.UTF-8"), Some(hu));
- assert_eq!(lang_from_tag("hu-HU"), Some(hu));
- assert_eq!(first_supported("hu-HU\r\nen-US"), Some(hu));
- assert_eq!(tr(hu, "Rapport de l'utilisateur.pdf"), "Rapport de l'utilisateur.pdf");
- // one (1), other (0, 2+)
- assert_eq!((0..=3).map(|n| (hu.0.plural)(n)).collect::<Vec<_>>(), [1, 0, 1, 1]);
- let mut app = crate::PdfCraftApp::default();
- app.set_option("language", "hu").unwrap();
- assert_eq!(app.language, "hu");
- let mut restored = crate::PdfCraftApp::default();
- restored.restore(&app.persist());
- assert_eq!(restored.language, "hu");
- }
-
- #[test]
- fn ukrainian_is_registered_and_persists() {
- let uk = Lang::from_code("uk").expect("uk registered");
- assert_eq!(uk.name(), "Українська");
- assert_eq!(normalize_pref("UK"), Some("uk"));
- for tag in ["uk", "uk-UA", "uk_UA.UTF-8", "UK-ua", "uk_UA@variant"] {
- assert_eq!(lang_from_tag(tag), Some(uk), "{tag}");
- }
- assert_eq!(first_supported("uk-UA\r\nen-US"), Some(uk));
- assert_eq!(first_supported("(\n \"uk-UA\",\n \"en-US\"\n)\n"), Some(uk));
- assert_eq!(tr(uk, "Звіт {n}.pdf"), "Звіт {n}.pdf");
- let mut app = crate::PdfCraftApp::default();
- app.set_option("language", "UK").unwrap();
- assert_eq!(app.language, "uk");
- let mut restored = crate::PdfCraftApp::default();
- restored.restore(&app.persist());
- assert_eq!(restored.language, "uk");
- assert!(restored.set_option("language", "xx").is_err());
- assert_eq!(restored.language, "uk");
- }
-
- #[test]
- fn ukrainian_integer_plurals_cover_teens_and_large_counts() {
- let uk = Lang::from_code("uk").expect("uk registered");
- assert_eq!(uk.0.plural_forms(), 3);
- for (counts, form) in [
- (vec![1, 21, 31, 101, 121, 1001], 0),
- (vec![2, 3, 4, 22, 23, 24, 102, 104, 122, 1002], 1),
- (vec![0, 5, 10, 11, 12, 13, 14, 19, 20, 25, 100, 110, 111, 112, 114, 1000, u64::MAX], 2),
- ] {
- for n in counts {
- assert_eq!((uk.0.plural)(n), form, "{n}");
- }
- }
- }
-
- fn arabic() -> Lang {
- Lang::from_code("ar").expect("ar registered")
- }
-
- #[test]
- fn arabic_is_registered_and_persists() {
- let ar = arabic();
- assert_eq!(ar.name(), "العربية");
- assert!(ar.rtl());
- let rtl: Vec<&str> = Lang::all().filter(|l| l.rtl()).map(|l| l.code()).collect();
- assert_eq!(rtl, ["ar", "ckb", "fa"], "Arabic, Kurdish and Persian are the right-to-left languages");
- assert_eq!(normalize_pref("AR"), Some("ar"));
- for tag in ["ar", "ar-MA", "ar_EG.UTF-8", "AR-sa", "ar_DZ@variant"] {
- assert_eq!(lang_from_tag(tag), Some(ar), "{tag}");
- }
- assert_eq!(first_supported("ar-MA\r\nen-US"), Some(ar));
- // Unknown strings and user text are never reordered by a lookup.
- assert_eq!(tr(ar, "تقرير نهائي {n}.pdf"), "تقرير نهائي {n}.pdf");
- let mut app = crate::PdfCraftApp::default();
- app.set_option("language", "AR").unwrap();
- assert_eq!(app.language, "ar");
- let mut restored = crate::PdfCraftApp::default();
- restored.restore(&app.persist());
- assert_eq!(restored.language, "ar");
- assert!(restored.set_option("language", "xx").is_err());
- assert_eq!(restored.language, "ar");
- }
-
- /// Catalog lookups stay in logical order; the egui 0.37 fork owns bidi shaping and display
- /// reordering (E5/E12), so preordering here would reverse Arabic twice. Accessibility names,
- /// copied labels and search therefore see the source string.
- #[test]
- fn arabic_catalog_stays_logical() {
- let ar = arabic();
- assert_eq!(tr(ar, "Save as…"), "حفظ باسم…");
- assert_eq!(tr(ar, "About PdfCraft"), "حول PdfCraft");
- assert_eq!(tr(ar, "Name:"), "الاسم:");
- assert_eq!(tr(ar, "Issued by: "), "صادرة عن: ");
- // Placeholders survive in their logical positions.
- assert_eq!(tr(ar, "Couldn't open {name}: {e}"), "تعذّر فتح {name}: {e}");
- assert_eq!(fmt(tr(ar, "Couldn't open {name}: {e}"), &[("name", "a {e}.pdf"), ("e", "x")]), "تعذّر فتح a {e}.pdf: x");
- assert_eq!(fmt(tr(ar, "Page {p} of {n}"), &[("p", "3"), ("n", "12")]), "الصفحة 3 من 12");
- set_current(ar);
- let command = command_label("Undo Insert pages from a.pdf");
- assert!(command.contains("a.pdf") && command.contains("إدراج صفحات"), "logical command label: {command:?}");
- assert_eq!(menu_label("file.saveAs", "Save as…"), "حفظ باسم…");
- set_current(Lang::EN);
- }
-
- #[test]
- fn arabic_plurals_follow_the_six_cldr_forms() {
- let ar = arabic();
- assert_eq!(ar.0.plural_forms(), 6);
- let form = |n| (ar.0.plural)(n);
- assert_eq!([0, 1, 2].map(form), [0, 1, 2]);
- assert_eq!([3, 10, 103, 110, 1003].map(form), [3; 5]);
- assert_eq!([11, 99, 111, 199, 1011].map(form), [4; 5]);
- assert_eq!([100, 101, 102, 200, 1000, u64::MAX - 13].map(form), [5; 6]);
- }
-
- fn persian() -> Lang {
- Lang::from_code("fa").expect("fa registered")
- }
-
- #[test]
- fn persian_is_registered_and_persists() {
- let fa = persian();
- assert_eq!(fa.name(), "فارسی");
- assert!(fa.rtl());
- // CLDR `fa` (one: i = 0 or n = 1): 0 and 1 are singular, every other count the plural.
- assert_eq!(fa.0.plural_forms(), 2);
- assert_eq!([0, 1, 2, 11].map(|n| (fa.0.plural)(n)), [0, 0, 1, 1]);
- assert_eq!(normalize_pref("FA"), Some("fa"));
- for tag in ["fa", "fa-IR", "fa_IR.UTF-8", "FA-af", "fa_IR@calendar=persian"] {
- assert_eq!(lang_from_tag(tag), Some(fa), "{tag}");
- }
- assert_eq!(first_supported("fa-IR\r\nen-US"), Some(fa));
- // Lookups return Persian in logical order; epaint handles visual ordering.
- assert_eq!(tr(fa, "Save"), "ذخیره");
- assert_eq!(tr(fa, "Cancel"), "لغو");
- assert_eq!(tr(fa, "File"), "فایل");
- // Unknown strings and user text are never reordered by a lookup.
- assert_eq!(tr(fa, "گزارش نهایی {n}.pdf"), "گزارش نهایی {n}.pdf");
- let mut app = crate::PdfCraftApp::default();
- app.set_option("language", "FA").unwrap();
- assert_eq!(app.language, "fa");
- let mut restored = crate::PdfCraftApp::default();
- restored.restore(&app.persist());
- assert_eq!(restored.language, "fa");
- assert!(restored.set_option("language", "xx").is_err());
- assert_eq!(restored.language, "fa");
- }
-
- /// With a craft-fonts Arabic face, every Arabic translation has glyphs: with all interface
- /// faces (desktop) and with the Arabic face as the only craft-fonts face (the web build keeps
- /// it; Arabic labels must not need a Japanese face).
- #[test]
- fn arabic_labels_have_glyphs() {
- let faces: Vec<String> = pdfcraft_fonts::ui_arabic_fonts().iter().map(|f| f.name()).collect();
- if faces.is_empty() {
- eprintln!("skipping Arabic glyph checks: build with CRAFT_FONTS_DIR and an Arabic face to run them");
- return;
- }
- let ar = arabic();
- let (entries, _) = parse_entries(ar.0.source, ar.0.plural_forms());
- let labels: String = entries.iter().flat_map(|e| e.translation.chars()).chain(ar.name().chars()).filter(|c| !c.is_control()).collect();
- let mut arabic_only = crate::theme::font_definitions();
- for family in arabic_only.families.values_mut() {
- family.retain(|name| !pdfcraft_fonts::CRAFT_FONTS.iter().any(|face| face.name() == *name) || faces.contains(name));
- }
- use egui::epaint::text::{Fonts, TextOptions};
- for (build, defs) in [("all faces", crate::theme::font_definitions()), ("Arabic face only", arabic_only)] {
- let mut fonts = Fonts::new(TextOptions::default(), defs);
- for id in [egui::FontId::proportional(13.0), egui::FontId::monospace(13.0), crate::theme::medium(13.0), crate::theme::semibold(17.0)] {
- let missing: std::collections::BTreeSet<char> = labels.chars().filter(|c| !fonts.has_glyphs(&id, &c.to_string())).collect();
- assert!(missing.is_empty(), "{build}: {id:?} lacks Arabic label glyphs {missing:?}");
- }
- }
- }
-
- /// Every bundled catalog is well-formed and consistent with its sources.
- #[test]
- fn bundled_catalogs_are_consistent() {
- let mut codes = std::collections::HashSet::new();
- for l in &LANGUAGES {
- assert!(codes.insert(l.code), "duplicate code {}", l.code);
- assert!(l.code == l.code.to_ascii_lowercase() && !l.name.is_empty(), "{}", l.code);
- let (entries, errors) = parse_entries(l.source, l.plural_forms());
- assert!(errors.is_empty(), "{}: {errors:?}", l.code);
- for e in entries.iter().filter(|e| e.context == "@id") {
- let command = pdfcraft_engine::commands::command(&e.source);
- let Some(command) = command else { panic!("{}: unknown command id {:?}", l.code, e.source) };
- assert_eq!(placeholders(&e.translation), placeholders(command.label), "{}: {}", l.code, e.source);
- assert_eq!(e.translation.ends_with('…'), command.label.ends_with('…'), "{}: ellipsis mismatch: {}", l.code, e.source);
- }
- }
- }
-
- /// The translation gaps report (`cargo xtask i18n-report`, a step of `cargo xtask ci`): for
- /// each language, how many English strings it has no translation for, and the first few.
- /// It never fails: a missing string shows in English.
- ///
- /// The English strings are the UI source's literals, the commands, All tools, the engine's
- /// own wordings, and every key of every bundled catalog (which covers contextual, plural and
- /// dynamically looked-up strings the scan can't see).
- #[test]
- fn translation_gaps_report() {
- use std::collections::BTreeSet;
- const SHOWN: usize = 3;
- let mut plain: BTreeSet<String> = ui_literals();
- let mut add = |s: &str| {
- plain.insert(s.to_string());
- };
- for command in pdfcraft_engine::commands::COMMANDS {
- add(command.label);
- command.menu.into_iter().for_each(&mut add);
- }
- for group in pdfcraft_engine::catalog::TOOL_GROUPS {
- add(group.label);
- for section in group.sections {
- add(section.title);
- section.items.iter().for_each(|item| add(item.label));
- }
- }
- pdfcraft_engine::catalog::TOOL_CATEGORIES.iter().for_each(|category| add(category.label));
- let engine: [&[&str]; 9] = [
- pdfcraft_engine::a11y::WORDINGS,
- pdfcraft_engine::a11y::REPORT_WORDS,
- pdfcraft_engine::pdfa::WORDINGS,
- pdfcraft_engine::sign::pdf::WORDINGS,
- pdfcraft_engine::sign::pdf::kind::ALL,
- pdfcraft_engine::print::WORDINGS,
- pdfcraft_engine::EDIT_LABELS,
- pdfcraft_engine::BATCH_LABELS,
- pdfcraft_engine::field_table::WORDINGS,
- ];
- engine.into_iter().flatten().for_each(|s| add(s));
- pdfcraft_engine::sign::AppearanceLabels::default().fields().into_iter().for_each(|(_, label)| add(label));
- crate::credits::NameMode::ALL.iter().for_each(|mode| add(mode.label()));
- for key in crate::credits::SortKey::ALL {
- let (label, header) = key.label();
- add(label);
- add(header);
- }
- crate::credits::MODEL_COLUMNS.iter().for_each(|s| add(s));
- // (context, source) keys; `@id` rows only reword a command label, which is in `plain`.
- let mut keys: BTreeSet<(String, String)> = plain.into_iter().map(|s| (String::new(), s)).collect();
- for language in &LANGUAGES {
- let (entries, _) = parse_entries(language.source, language.plural_forms());
- keys.extend(entries.into_iter().filter(|e| e.context != "@id").map(|e| (e.context, e.source)));
- }
- let mut report = format!("Translation gaps: {} English strings\n", keys.len());
- for lang in Lang::all().filter(|l| *l != Lang::EN) {
- let catalog = lang.catalog();
- let missing: Vec<&(String, String)> = keys
- .iter()
- .filter(|(context, source)| match context.as_str() {
- "" => catalog.plain(source).is_none(),
- "@plural" => source.split_once('|').is_none_or(|(one, other)| catalog.plural(one, other, 0).is_none()),
- // A contextual lookup falls back to the plain translation.
- context => catalog.contextual(context, source).is_none() && catalog.plain(source).is_none(),
- })
- .collect();
- let mut line = format!(" {:<8} {:>5} missing", lang.code(), missing.len());
- for (i, (context, source)) in missing.iter().take(SHOWN).enumerate() {
- let mut shown: String = source.chars().take(48).collect();
- if shown.len() < source.len() {
- shown.push('…');
- }
- let key = if context.is_empty() { format!("{shown:?}") } else { format!("{context} / {shown:?}") };
- line.push_str(if i == 0 { ": " } else { ", " });
- line.push_str(&key);
- }
- if missing.len() > SHOWN {
- line.push_str(", …");
- }
- report.push_str(&line);
- report.push('\n');
- }
- println!("{REPORT_START}\n{report}{REPORT_END}");
- }
-
- /// The lines `cargo xtask i18n-report` prints from the test output lie between these.
- const REPORT_START: &str = "=== translation gaps ===";
- const REPORT_END: &str = "=== end of translation gaps ===";
-
- /// Preferences ▸ Date format ▸ Language offers exactly the interface languages, in order.
- #[test]
- fn date_languages_are_the_interface_languages() {
- let interface: Vec<(&str, &str)> = Lang::all().map(|l| (l.code(), l.name())).collect();
- let dates: Vec<(&str, &str)> = pdfcraft_engine::dates::DATE_LANGUAGES.iter().map(|l| (l.code, l.name)).collect();
- assert_eq!(dates, interface);
- }
-}
+mod tests;
#[cfg(test)]
mod picker_order_tests {
diff --git a/crates/ui-egui/src/i18n/tests.rs b/crates/ui-egui/src/i18n/tests.rs
new file mode 100644
index 000000000..b66c31d9c
--- /dev/null
+++ b/crates/ui-egui/src/i18n/tests.rs
@@ -0,0 +1,1227 @@
+use super::catalog::{Entry, parse_entries, placeholders};
+use super::*;
+
+const JA: fn() -> Lang = || Lang::from_code("ja").expect("ja registered");
+
+#[test]
+fn keyboard_key_names_have_a_separate_context_and_english_fallback() {
+ static KEYS: LangInfo = LangInfo {
+ code: "keys",
+ name: "Key name test catalog",
+ source: "key\tDelete\tEntf\n\tDelete\tLöschen\n\tOpen\tÖffnen\n",
+ plural: plural_one_other,
+ rtl: false,
+ catalog: OnceLock::new(),
+ };
+ let previous = current();
+ set_current(Lang(&KEYS));
+ assert_eq!(key_name("Delete"), "Entf");
+ assert_eq!(t("Delete"), "Löschen");
+ assert_eq!(key_name("Open"), "Open", "a missing key name must not borrow a command translation");
+ set_current(Lang::EN);
+ assert_eq!(key_name("Delete"), "Delete");
+ set_current(previous);
+}
+
+/// Regression test: a language picker uses its native name only when a face can draw it, otherwise its
+/// English name.
+#[test]
+fn picker_names_fall_back_to_english_when_their_script_has_no_face() {
+ let hi = Lang::from_code("hi").expect("hi registered");
+ assert_eq!(hi.picker_name(|_| true), "हिन्दी", "the native name is kept when it can be drawn");
+ assert_eq!(hi.picker_name(|_| false), "Hindi", "no Devanagari face: an English name, not an unrenderable label");
+ assert_eq!(Lang::EN.picker_name(|_| false), "English");
+ for language in Lang::all() {
+ assert!(!language.english_name().is_empty(), "{}", language.code());
+ assert_ne!(language.english_name(), language.code(), "{} needs an English picker fallback", language.code());
+ }
+}
+
+#[test]
+fn tags_map_to_languages() {
+ assert_eq!(lang_from_tag("ja_JP.UTF-8"), Some(JA()));
+ assert_eq!(lang_from_tag("ja-JP"), Some(JA()));
+ assert_eq!(lang_from_tag("en_US.UTF-8"), Some(Lang::EN));
+ assert_eq!(lang_from_tag("C"), Some(Lang::EN));
+ assert_eq!(lang_from_tag("POSIX"), Some(Lang::EN));
+ assert_eq!(lang_from_tag("fr_FR"), Lang::from_code("fr"));
+ assert_eq!(lang_from_tag("fr_CA.UTF-8"), Lang::from_code("fr"));
+ assert_eq!(lang_from_tag("fr-BE"), Lang::from_code("fr"));
+ assert_eq!(lang_from_tag("zh-TW"), Lang::from_code("zh-hant"));
+ assert_eq!(lang_from_tag("zh_CN.UTF-8"), Lang::from_code("zh-hans"));
+ assert_eq!(lang_from_tag("zh"), Lang::from_code("zh-hans"));
+ assert_eq!(lang_from_tag("zh_HK.UTF-8"), Lang::from_code("zh-hant"));
+ assert_eq!(lang_from_tag("zh-Hant-MO"), Lang::from_code("zh-hant"));
+ assert_eq!(lang_from_tag("lo_LA.UTF-8"), Lang::from_code("lo"));
+ assert_eq!(lang_from_tag("lo-LA"), Lang::from_code("lo"));
+ assert_eq!(lang_from_tag("lo"), Lang::from_code("lo"));
+ assert_eq!(lang_from_tag(""), None);
+ assert_eq!(lang_from_tag("_"), None);
+}
+
+#[test]
+fn candidates_walk_from_specific_to_general() {
+ assert_eq!(candidates("pt_BR.UTF-8"), ["pt-br", "pt"]);
+ assert_eq!(candidates("pt_PT.UTF-8"), ["pt-pt", "pt-br", "pt"]);
+ assert_eq!(candidates("pt"), ["pt-br", "pt"]);
+ assert_eq!(candidates("zh_TW"), ["zh-tw", "zh-hant", "zh"]);
+ assert_eq!(candidates("zh-CN"), ["zh-cn", "zh-hans", "zh"]);
+ assert_eq!(candidates("zh-Hant-HK"), ["zh-hant-hk", "zh-hant", "zh"]);
+ assert_eq!(candidates("lo_LA.UTF-8"), ["lo-la", "lo"]);
+ assert_eq!(candidates("nb_NO.UTF-8"), ["nb-no", "nb"]);
+ assert_eq!(candidates("no_NO.UTF-8"), ["no-no", "no", "nb"]);
+ assert_eq!(candidates("nn-NO"), ["nn-no", "nn", "nb"]);
+}
+
+#[test]
+fn macos_language_list_is_parsed() {
+ assert_eq!(first_supported("(\n \"ja-JP\",\n \"en-US\"\n)\n"), Some(JA()));
+ assert_eq!(first_supported("(\n \"fr-FR\",\n \"en-US\"\n)\n"), Lang::from_code("fr"));
+ assert_eq!(first_supported("("), None);
+}
+
+/// #2954: the web build's Auto language follows the browser's preferred languages in order,
+/// skipping ones without a catalog, and is English only when none is supported.
+#[test]
+fn browser_language_list_is_followed_in_order() {
+ assert_eq!(first_supported_tag(["it-IT", "en-US"]), Lang::from_code("it"));
+ assert_eq!(first_supported_tag(["xx-YY", "ja", "fr-FR"]), Some(JA()));
+ assert_eq!(first_supported_tag(["zh-TW"]), Lang::from_code("zh-hant"));
+ assert_eq!(first_supported_tag(["en-GB", "fr-FR"]), Some(Lang::EN));
+ assert_eq!(first_supported_tag([" pt-PT "]), Lang::from_code("pt-br"));
+ assert_eq!(first_supported_tag(["", "xx"]), None);
+ assert_eq!(first_supported_tag(Vec::<String>::new()), None);
+ let long = std::iter::repeat_n("xx", 10_000).chain(["fr"]);
+ assert_eq!(first_supported_tag(long), None, "only the first tags are read");
+}
+
+#[test]
+fn windows_display_language_resolves_chinese_scripts() {
+ for tag in ["zh-CN", "zh-SG", "zh-Hans", "zh-Hans-CN"] {
+ assert_eq!(first_supported(&format!("{tag}\r\n")), Lang::from_code("zh-hans"));
+ }
+ for tag in ["zh-TW", "zh-HK", "zh-MO", "zh-Hant", "zh-Hant-HK"] {
+ assert_eq!(first_supported(&format!("{tag}\r\n")), Lang::from_code("zh-hant"));
+ }
+ assert_eq!(first_supported("en-US\r\n"), Some(Lang::EN));
+ assert_eq!(first_supported("fr-FR\r\n"), Lang::from_code("fr"));
+ assert_eq!(first_supported("lo-LA\r\n"), Lang::from_code("lo"));
+ assert_eq!(first_supported("\r\n"), None);
+}
+
+#[cfg(target_os = "windows")]
+#[test]
+fn neutral_locale_does_not_override_display_language() {
+ let fr = Lang::from_code("fr").unwrap();
+ for tag in ["C", "C.UTF-8", "POSIX", "posix.UTF-8", "", " C.UTF-8 ", "unsupported"] {
+ assert_eq!(language_override(tag), None, "{tag}");
+ assert_eq!(language_override(tag).or_else(|| first_supported("unsupported-XY\nfr-FR\nen-US")), Some(fr));
+ }
+ assert_eq!(["C.UTF-8", "POSIX", "fr_FR.UTF-8"].into_iter().find_map(language_override), Some(fr));
+ assert_eq!(language_override("fr_FR.UTF-8"), Some(fr));
+ assert_eq!(language_override("en_US.UTF-8"), Some(Lang::EN));
+ assert_eq!(language_override("ja_JP.UTF-8"), Some(JA()));
+}
+
+#[cfg(target_os = "windows")]
+#[test]
+fn windows_display_language_query_returns_a_locale_tag() {
+ // One tag per line, as `first_supported` reads them: a machine with several display
+ // languages reports them all, so each line is checked rather than the list as a whole.
+ let list = windows_ui_language().expect("Windows should report a display language");
+ let tags: Vec<&str> = list.lines().map(str::trim).filter(|t| !t.is_empty()).collect();
+ assert!(!tags.is_empty(), "no display language in {list:?}");
+ for tag in tags {
+ assert!(tag.split('-').all(|part| !part.is_empty() && part.bytes().all(|b| b.is_ascii_alphanumeric())), "not a locale tag: {tag:?}");
+ }
+}
+
+#[test]
+fn preferences_resolve_with_fallback() {
+ assert_eq!(Lang::from_pref("ja"), JA());
+ assert_eq!(Lang::from_pref("JA"), JA());
+ assert_eq!(Lang::from_pref("en"), Lang::EN);
+ // `auto` and unknown codes follow the system (English under test).
+ assert_eq!(Lang::from_pref(AUTO), Lang::EN);
+ assert_eq!(Lang::from_pref("xx-unknown"), Lang::EN);
+ assert_eq!(normalize_pref("JA"), Some("ja"));
+ assert_eq!(normalize_pref("Auto"), Some(AUTO));
+ assert_eq!(normalize_pref("xx"), None);
+}
+
+#[test]
+fn lookups_fall_back_to_english() {
+ assert_eq!(tr(JA(), "no such label"), "no such label");
+ assert_eq!(tr(Lang::EN, "File"), "File");
+ assert_eq!(tr(JA(), "File"), "ファイル");
+ assert_eq!(tr(JA(), "日本語の文書.pdf"), "日本語の文書.pdf");
+ assert_eq!(tr_id(JA(), "no.such.id", "File"), "ファイル");
+ assert_eq!(tr_ctx(JA(), "no such context", "File"), "ファイル");
+ assert!(has(JA(), "Save") && !has(Lang::EN, "Save"));
+}
+
+#[test]
+fn catalog_kinds_are_parsed_and_looked_up() {
+ let (c, errors) = Catalog::parse(
+ "# c\n\tHello\tこんにちは\n@id\tfile.save\t保存する\nmenu\tWindows\tウィンドウ群\n@plural\t{n} file|{n} files\t{n} 個\n\n",
+ 1,
+ );
+ assert!(errors.is_empty(), "{errors:?}");
+ assert_eq!(c.plain("Hello"), Some("こんにちは"));
+ assert_eq!(c.id("file.save"), Some("保存する"));
+ assert_eq!(c.contextual("menu", "Windows"), Some("ウィンドウ群"));
+ assert_eq!(c.contextual("other", "Windows"), None);
+ assert_eq!(c.plural("{n} file", "{n} files", 0), Some("{n} 個"));
+ assert_eq!(c.plural("{n} file", "{n} files", 5), Some("{n} 個"), "an index past the forms clamps");
+}
+
+#[test]
+fn malformed_lines_are_reported_not_fatal() {
+ let (entries, errors) = parse_entries("\tok\tはい\nno tabs here\n\tonly\n\ta\tb\tc\textra\n\t\tempty source\n", 1);
+ assert_eq!(entries.len(), 1);
+ assert_eq!(errors.len(), 4, "{errors:?}");
+ let (entries, errors) = parse_entries("\ta\\tb\tx\\ny\\\\z\n", 1);
+ assert!(errors.is_empty(), "{errors:?}");
+ assert_eq!(entries, [Entry { context: String::new(), source: "a\tb".into(), translation: "x\ny\\z".into() }]);
+}
+
+#[test]
+fn strict_validation_skips_only_the_bad_line() {
+ for (text, forms, error) in [
+ ("\tFile", 1, "context<TAB>"),
+ ("\tFile\t", 1, "nonempty"),
+ ("\tFile\\q\tFiles", 1, "unknown escape"),
+ ("\tFile\tFiles\\", 1, "trailing backslash"),
+ ("\tOpen…\tOpen", 1, "ellipsis"),
+ ("\tOpen {file}\tOpen {name}", 1, "placeholders"),
+ ("@plural\tpage\tPages", 1, "one|other"),
+ ("@plural\t{n} page|{n} pages\t{n} pages", 2, "2 nonempty"),
+ ("@plural\t{n} page|{n} pages\tPages", 1, "placeholders"),
+ ("@unknown\tFile\tFiles", 1, "reserved context"),
+ ] {
+ // The bad line comes first; the good line after it still loads.
+ let (catalog, errors) = Catalog::parse(&format!("{text}\n\tSave\t保存\n"), forms);
+ assert_eq!(errors.len(), 1, "{text:?}: {errors:?}");
+ assert!(errors[0].starts_with("line 1: ") && errors[0].contains(error), "{errors:?}");
+ assert_eq!(catalog.plain("Save"), Some("保存"), "{text:?}");
+ }
+ let (catalog, errors) = Catalog::parse("\tFile\tファイル\n\tFile\t別\n", 1);
+ assert!(errors.len() == 1 && errors[0].contains("line 2: duplicate"), "{errors:?}");
+ assert_eq!(catalog.plain("File"), Some("ファイル"), "the first entry wins");
+}
+
+#[test]
+fn catalogs_handle_escapes_crlf_and_distinct_contexts() {
+ let (catalog, errors) =
+ Catalog::parse("# comment\r\n\r\n\tLine\\nTab\\tPath\\\\\tOther\\nTab\\tPath\\\\\r\nweight\tLight\tThin\r\ntheme\tLight\tPale\r\n", 1);
+ assert!(errors.is_empty(), "{errors:?}");
+ assert_eq!(catalog.plain("Line\nTab\tPath\\"), Some("Other\nTab\tPath\\"));
+ assert_eq!(catalog.contextual("weight", "Light"), Some("Thin"));
+ assert_eq!(catalog.contextual("theme", "Light"), Some("Pale"));
+}
+
+#[test]
+fn broken_catalog_falls_back_to_english() {
+ static BROKEN: LangInfo = LangInfo {
+ code: "broken",
+ name: "Broken test catalog",
+ source: "malformed\n\\",
+ plural: plural_none,
+ rtl: false,
+ catalog: OnceLock::new(),
+ };
+ assert_eq!(tr(Lang(&BROKEN), "File"), "File");
+ assert_eq!(trn(Lang(&BROKEN), 2, "{n} page", "{n} pages"), "2 pages");
+}
+
+#[test]
+fn contextual_id_and_plural_lookups_have_english_fallbacks() {
+ static TEST: LangInfo = LangInfo {
+ code: "test",
+ name: "Test catalog",
+ source: "\tLight\tPlain light\nweight\tLight\tThin\n@id\tfile.open\tOpen dialog…\n@plural\t{n} page|{n} pages\tOne page: {n}|Many pages: {n}\n",
+ plural: plural_one_other,
+ rtl: false,
+ catalog: OnceLock::new(),
+ };
+ let l = Lang(&TEST);
+ assert_eq!(tr_ctx(l, "weight", "Light"), "Thin");
+ assert_eq!(tr_ctx(l, "theme", "Light"), "Plain light");
+ assert_eq!(tr_ctx(l, "theme", "Unknown"), "Unknown");
+ assert_eq!(tr_id(l, "file.open", "Reworded English…"), "Open dialog…");
+ assert_eq!(tr_id(l, "unknown", "Light"), "Plain light");
+ assert_eq!(tr_id(l, "unknown", "Unknown"), "Unknown");
+ assert_eq!(trn(l, 1, "{n} page", "{n} pages"), "One page: 1");
+ assert_eq!(trn(l, 0, "{n} page", "{n} pages"), "Many pages: 0");
+ assert_eq!(trn(l, u64::MAX, "{n} page", "{n} pages"), format!("Many pages: {}", u64::MAX));
+}
+
+#[test]
+fn formatting_reorders_parameters_without_reinterpreting_user_text() {
+ let args = [("file", "日本語-{n}.pdf"), ("n", "2")];
+ assert_eq!(fmt("{n}: {file}; {unknown}", &args), "2: 日本語-{n}.pdf; {unknown}");
+ assert_eq!(fmt("{file} / {file}", &args), "日本語-{n}.pdf / 日本語-{n}.pdf");
+ assert_eq!(fmt("text {unfinished", &args), "text {unfinished");
+ assert_eq!(fmt("}{n}{", &args), "}2{");
+ assert_eq!(fmt("unchanged", &[]), "unchanged");
+}
+
+/// Every literal passed to `tl!(…)` or `crate::i18n::t(…)` in the UI source (test modules
+/// aside), unescaped, including literals on a line of their own.
+fn ui_literals() -> std::collections::BTreeSet<String> {
+ let mut stack = vec![std::path::Path::new(env!("CARGO_MANIFEST_DIR")).join("src")];
+ let mut literals = std::collections::BTreeSet::new();
+ while let Some(dir) = stack.pop() {
+ for entry in std::fs::read_dir(dir).expect("UI source directory") {
+ let path = entry.expect("UI source entry").path();
+ if path.is_dir() {
+ if path.file_name().is_some_and(|name| name != "i18n") {
+ stack.push(path);
+ }
+ } else if path.extension().is_some_and(|ext| ext == "rs") {
+ let source = std::fs::read_to_string(path).expect("UI source file").replace("\r\n", "\n");
+ let source = source.replace("crate::i18n::t(", "tl!(");
+ let mut rest = source.split("#[cfg(test)]\nmod ").next().unwrap_or_default();
+ while let Some((_, after)) = rest.split_once("tl!(") {
+ let after = after.trim_start();
+ let Some(after) = after.strip_prefix('"') else {
+ rest = after;
+ continue;
+ };
+ let mut escaped = false;
+ let end = after
+ .char_indices()
+ .find_map(|(i, c)| {
+ if c == '"' && !escaped {
+ return Some(i);
+ }
+ escaped = c == '\\' && !escaped;
+ None
+ })
+ .expect("closed tl! literal");
+ let (raw, tail) = after.split_at(end);
+ let argument_end = tail.strip_prefix('"').expect("closing quote").trim_start();
+ let literal_call =
+ argument_end.starts_with(')') || argument_end.strip_prefix(',').is_some_and(|rest| rest.trim_start().starts_with(')'));
+ if literal_call {
+ let label: String = serde_json::from_str(&format!("\"{raw}\"")).expect("UI literal escapes");
+ literals.insert(label);
+ }
+ rest = tail.strip_prefix('"').expect("closing quote");
+ }
+ }
+ }
+ }
+ literals
+}
+
+/// Each translated label of a visible signature that runs into its value keeps a separator
+/// at its end.
+#[test]
+fn signature_appearance_labels_keep_their_separator() {
+ let english = pdfcraft_engine::sign::AppearanceLabels::default();
+ for language in LANGUAGES.iter().filter(|language| !language.source.is_empty()) {
+ let lang = Lang::from_code(language.code).expect("registered language");
+ for (field, label) in english.fields() {
+ let said = tr(lang, label);
+ if field != "signed_by" && !lang.rtl() {
+ assert!(said.ends_with(' ') || said.ends_with(':'), "{}: the {field} label runs into its value: {said:?}", language.code);
+ }
+ }
+ }
+}
+
+/// With craft-fonts, every Japanese translation has glyphs: with all interface faces (desktop)
+/// and with BIZ UDPGothic Regular alone (the web build's only Japanese face).
+#[test]
+fn japanese_labels_have_glyphs() {
+ let craft = pdfcraft_fonts::ui_japanese_fonts();
+ let Some(web) = craft.iter().find(|f| f.family == "BIZ UDPGothic" && f.style == "Regular") else {
+ eprintln!("skipping Japanese glyph checks: build with CRAFT_FONTS_DIR to run them");
+ return;
+ };
+ let (entries, _) = parse_entries(JA().0.source, 1);
+ let labels: String = entries.iter().flat_map(|e| e.translation.chars()).chain(JA().name().chars()).filter(|c| !c.is_control()).collect();
+ let web_name = web.name();
+ let mut web_only = crate::theme::font_definitions();
+ for family in web_only.families.values_mut() {
+ family.retain(|name| !pdfcraft_fonts::CRAFT_FONTS.iter().any(|face| face.name() == *name) || *name == web_name);
+ }
+ use egui::epaint::text::{Fonts, TextOptions};
+ for (build, defs) in [("desktop", crate::theme::font_definitions()), ("web", web_only)] {
+ let mut fonts = Fonts::new(TextOptions::default(), defs);
+ for id in [egui::FontId::proportional(13.0), egui::FontId::monospace(13.0), crate::theme::medium(13.0), crate::theme::semibold(17.0)] {
+ assert!(fonts.has_glyphs(&id, &labels), "{build}: {id:?} lacks a Japanese label glyph");
+ }
+ }
+}
+
+#[test]
+fn history_labels_keep_captured_names() {
+ set_current(JA());
+ assert_eq!(action_label("Insert pages from Save {e}.pdf"), "Save {e}.pdf からページを挿入");
+ assert_eq!(command_label("Undo Insert pages from Save {e}.pdf"), "取り消し Save {e}.pdf からページを挿入");
+ assert_eq!(action_label("Untranslated custom action"), "Untranslated custom action");
+ assert_eq!(menu_label("file.open", "Open…"), "開く…");
+ set_current(Lang::EN);
+ assert_eq!(command_label("Undo Fill in Save {e}"), "Undo Fill in Save {e}");
+}
+
+#[test]
+fn current_language_is_per_thread() {
+ set_current(JA());
+ assert_eq!(t("File"), "ファイル");
+ std::thread::spawn(|| assert_eq!(current(), Lang::EN)).join().unwrap();
+ set_current(Lang::EN);
+ assert_eq!(t("File"), "File");
+}
+
+#[test]
+fn plurals_and_placeholders() {
+ assert_eq!(trn(Lang::EN, 1, "{n} item", "{n} items"), "1 item");
+ assert_eq!(trn(Lang::EN, 0, "{n} item", "{n} items"), "0 items");
+ assert_eq!(trn(Lang::EN, 7, "{n} item", "{n} items"), "7 items");
+ // No catalog has this `@plural` entry: Japanese falls back to the English forms.
+ assert_eq!(trn(JA(), 7, "{n} test item", "{n} test items"), "7 test items");
+ assert_eq!(fmt("{b} before {a}", &[("a", "x"), ("b", "y"), ("c", "z")]), "y before x");
+ assert_eq!(fmt("{missing}", &[]), "{missing}");
+ assert_eq!(placeholders("a {x} b {y} {"), ["x", "y"]);
+}
+
+#[test]
+fn language_persists_and_invalid_input_keeps_current_language() {
+ let mut app = crate::PdfCraftApp::default();
+ assert_eq!(app.language, AUTO);
+ app.set_option("language", "JA").unwrap();
+ assert_eq!(app.language, "ja");
+ assert!(app.set_option("language", "xx").is_err());
+ assert_eq!(app.language, "ja");
+ let mut restored = crate::PdfCraftApp::default();
+ restored.restore(&app.persist());
+ assert_eq!(restored.language, "ja");
+ restored.restore(r#"{"language":"xx"}"#);
+ assert_eq!(restored.language, "ja");
+ app.set_option("language", AUTO).unwrap();
+ assert_eq!(app.language, AUTO);
+ // Settings written before the system-locale default (no key) follow the system.
+ let mut legacy = crate::PdfCraftApp::default();
+ legacy.restore("{}");
+ assert_eq!(legacy.language, AUTO);
+}
+
+#[test]
+fn brazilian_portuguese_is_registered() {
+ let pt = Lang::from_code("pt-br").expect("pt-br registered");
+ assert_eq!(pt.name(), "Português (Brasil)");
+ assert_eq!(Lang::from_code("PT-BR"), Some(pt));
+ assert_eq!(normalize_pref("pt-BR"), Some("pt-br"));
+ assert_eq!(normalize_pref("pt"), None, "only exact codes are preferences");
+ assert_eq!(lang_from_tag("pt_BR.UTF-8"), Some(pt));
+ assert_eq!(lang_from_tag("pt_PT"), Some(pt));
+ assert_eq!(tr(pt, "Arquivo do usuário.pdf"), "Arquivo do usuário.pdf");
+ assert_eq!((0..=3).map(|n| (pt.0.plural)(n)).collect::<Vec<_>>(), [0, 0, 1, 1]);
+ let mut app = crate::PdfCraftApp::default();
+ app.set_option("language", "pt-br").unwrap();
+ assert_eq!(app.language, "pt-br");
+ let mut restored = crate::PdfCraftApp::default();
+ restored.restore(&app.persist());
+ assert_eq!(restored.language, "pt-br");
+}
+
+#[test]
+fn spanish_is_registered() {
+ let es = Lang::from_code("es").expect("es registered");
+ assert_eq!(es.name(), "Español");
+ assert_eq!(normalize_pref("ES"), Some("es"));
+ assert_eq!(lang_from_tag("es_ES.UTF-8"), Some(es));
+ assert_eq!(lang_from_tag("es-MX"), Some(es));
+ assert_eq!(first_supported("es-ES\r\nen-US"), Some(es));
+ assert_eq!(tr(es, "Informe del usuario.pdf"), "Informe del usuario.pdf");
+ let mut app = crate::PdfCraftApp::default();
+ app.set_option("language", "es").unwrap();
+ assert_eq!(app.language, "es");
+ let mut restored = crate::PdfCraftApp::default();
+ restored.restore(&app.persist());
+ assert_eq!(restored.language, "es");
+}
+
+/// Each sentence the engine words for itself keeps its holes when it is said in Spanish, so
+/// the document's own words still have somewhere to go: a translation that drops `{p}` or
+/// `{}` would read as a sentence about nothing in particular.
+#[test]
+fn spanish_keeps_the_holes_in_what_the_engine_says() {
+ let es = Lang::from_code("es").expect("es registered");
+ let lists: [&[&str]; 5] = [
+ pdfcraft_engine::a11y::WORDINGS,
+ pdfcraft_engine::pdfa::WORDINGS,
+ pdfcraft_engine::sign::pdf::WORDINGS,
+ pdfcraft_engine::print::WORDINGS,
+ pdfcraft_engine::field_table::WORDINGS,
+ ];
+ for wording in lists.into_iter().flatten() {
+ let said = tr(es, wording);
+ // `{}` is one hole; `{name}` holes are named, and each name must survive by itself.
+ assert_eq!(wording.matches("{}").count(), said.matches("{}").count(), "the Spanish of {wording:?} loses a hole: {said:?}");
+ for hole in wording.split('{').skip(1).filter_map(|rest| rest.split_once('}')).map(|(name, _)| name).filter(|n| !n.is_empty()) {
+ assert!(said.contains(&format!("{{{hole}}}")), "the Spanish of {wording:?} loses {{{hole}}}: {said:?}");
+ }
+ }
+}
+
+#[test]
+fn telugu_is_registered() {
+ let te = Lang::from_code("te").expect("te registered");
+ assert_eq!(te.name(), "తెలుగు");
+ assert_eq!(normalize_pref("TE"), Some("te"));
+ assert_eq!(lang_from_tag("te_IN.UTF-8"), Some(te));
+ assert_eq!(first_supported("te-IN\r\nen-US"), Some(te));
+ assert_eq!(tr(te, "నివేదిక.pdf"), "నివేదిక.pdf");
+ let mut app = crate::PdfCraftApp::default();
+ app.set_option("language", "te").unwrap();
+ assert_eq!(app.language, "te");
+ let mut restored = crate::PdfCraftApp::default();
+ restored.restore(&app.persist());
+ assert_eq!(restored.language, "te");
+}
+
+/// Telugu puts the verb last, so it translates "Undo {action}" as a whole phrase; a catalog
+/// without that entry (Spanish) keeps the verb in front of the action.
+#[test]
+fn undo_and_redo_labels_use_the_catalog_phrase_when_there_is_one() {
+ let te = Lang::from_code("te").expect("te registered");
+ set_current(te);
+ assert_eq!(command_label("Undo"), "రద్దు చేయి");
+ assert_eq!(command_label("Undo Untranslated custom action"), "రద్దు చేయి: Untranslated custom action");
+ assert_eq!(command_label("Redo Untranslated custom action"), "మళ్లీ చేయి: Untranslated custom action");
+ let es = Lang::from_code("es").expect("es registered");
+ set_current(es);
+ assert_eq!(command_label("Undo Untranslated custom action"), format!("{} Untranslated custom action", tr(es, "Undo")));
+ set_current(Lang::EN);
+ assert_eq!(command_label("Undo Untranslated custom action"), "Undo Untranslated custom action");
+}
+
+/// A label that reads differently by use has its own contextual entry where a language needs
+/// one; a language without it falls back to the plain translation.
+#[test]
+fn contextual_labels_fall_back_to_the_plain_translation() {
+ let te = Lang::from_code("te").expect("te registered");
+ assert_eq!(tr_ctx(te, "signature pad", "Type"), "టైప్ చేయి");
+ assert_eq!(tr(te, "Type"), "రకం");
+ // A context no catalog defines, so the fallback stays tested as catalogs fill their gaps.
+ let es = Lang::from_code("es").expect("es registered");
+ assert_eq!(tr_ctx(es, "no such context", "Type"), tr(es, "Type"));
+}
+
+/// With a craft-fonts Telugu face, every Telugu translation has glyphs: with all interface
+/// faces (desktop) and with the Telugu face as the only craft-fonts face (the web build keeps
+/// it; Telugu labels must not need a Japanese or Arabic face).
+#[test]
+fn telugu_labels_have_glyphs() {
+ let telugu: Vec<String> = pdfcraft_fonts::ui_telugu_fonts().iter().map(|f| f.name()).collect();
+ if telugu.is_empty() {
+ eprintln!("skipping Telugu glyph checks: build with CRAFT_FONTS_DIR and a Telugu face to run them");
+ return;
+ }
+ let te = Lang::from_code("te").expect("te registered");
+ let (entries, _) = parse_entries(te.0.source, te.0.plural_forms());
+ let labels: String = entries.iter().flat_map(|e| e.translation.chars()).chain(te.name().chars()).filter(|c| !c.is_control()).collect();
+ let mut telugu_only = crate::theme::font_definitions();
+ for family in telugu_only.families.values_mut() {
+ family.retain(|name| !pdfcraft_fonts::CRAFT_FONTS.iter().any(|face| face.name() == *name) || telugu.contains(name));
+ }
+ use egui::epaint::text::{Fonts, TextOptions};
+ for (build, defs) in [("all faces", crate::theme::font_definitions()), ("Telugu face only", telugu_only)] {
+ let mut fonts = Fonts::new(TextOptions::default(), defs);
+ for id in [egui::FontId::proportional(13.0), egui::FontId::monospace(13.0), crate::theme::medium(13.0), crate::theme::semibold(17.0)] {
+ assert!(fonts.has_glyphs(&id, &labels), "{build}: {id:?} lacks a Telugu label glyph");
+ }
+ }
+}
+
+#[test]
+fn czech_is_registered_and_persists() {
+ let cs = Lang::from_code("cs").expect("cs registered");
+ assert_eq!(cs.name(), "Čeština");
+ assert_eq!(tr(cs, "Žluťoučký kůň.pdf"), "Žluťoučký kůň.pdf");
+ assert_eq!((0..=6).map(|n| (cs.0.plural)(n)).collect::<Vec<_>>(), [2, 0, 1, 1, 1, 2, 2]);
+ let mut app = crate::PdfCraftApp::default();
+ app.set_option("language", "cs").unwrap();
+ assert!(app.set_option("language", "cz").is_err());
+ assert_eq!(app.language, "cs");
+ let mut restored = crate::PdfCraftApp::default();
+ restored.restore(&app.persist());
+ assert_eq!(restored.language, "cs");
+}
+
+#[test]
+fn turkish_is_registered_and_persists() {
+ let tr_lang = Lang::from_code("tr").expect("tr registered");
+ assert_eq!(tr_lang.name(), "Türkçe");
+ assert_eq!(tr(tr_lang, "Türkçe Belge.pdf"), "Türkçe Belge.pdf");
+ assert_eq!((0..=6).map(|n| (tr_lang.0.plural)(n)).collect::<Vec<_>>(), [0; 7]);
+ let mut app = crate::PdfCraftApp::default();
+ app.set_option("language", "tr").unwrap();
+ assert!(app.set_option("language", "tu").is_err());
+ assert_eq!(app.language, "tr");
+ let mut restored = crate::PdfCraftApp::default();
+ restored.restore(&app.persist());
+ assert_eq!(restored.language, "tr");
+}
+
+/// The code joins some labels with a space at either end, so these catalogs keep exactly the
+/// source's, and write … rather than three dots.
+#[test]
+fn catalog_rows_keep_the_source_spacing_and_ellipsis() {
+ let edges = |s: &str| (s.len() - s.trim_start().len(), s.len() - s.trim_end().len());
+ for code in ["cs", "tr", "vi"] {
+ let lang = Lang::from_code(code).expect("registered");
+ let (entries, errors) = parse_entries(lang.0.source, lang.0.plural_forms());
+ assert!(errors.is_empty(), "{code}: {errors:?}");
+ for e in &entries {
+ assert!(!e.translation.contains("..."), "{code}: use … rather than three dots: {:?}", e.translation);
+ assert_eq!(edges(&e.translation), edges(&e.source), "{code}: stray whitespace: {:?}", e.translation);
+ }
+ }
+}
+
+#[test]
+fn simplified_chinese_is_registered() {
+ let zh = Lang::from_code("zh-hans").expect("zh-hans registered");
+ assert_eq!(zh.name(), "简体中文");
+ assert_eq!(normalize_pref("zh-Hans"), Some("zh-hans"));
+ assert_eq!(normalize_pref("zh"), None, "only exact codes are preferences");
+ assert_eq!(tr(zh, "报告.pdf"), "报告.pdf");
+}
+
+#[test]
+fn traditional_chinese_is_registered() {
+ let zh = Lang::from_code("zh-hant").expect("zh-hant registered");
+ assert_eq!(zh.name(), "繁體中文");
+ assert_eq!(normalize_pref("zh-Hant"), Some("zh-hant"));
+ assert_eq!(tr(zh, "報告.pdf"), "報告.pdf");
+}
+
+#[test]
+fn french_is_registered() {
+ let fr = Lang::from_code("fr").expect("fr registered");
+ assert_eq!(fr.name(), "Français");
+ assert_eq!(normalize_pref("FR"), Some("fr"));
+ assert_eq!(lang_from_tag("fr_FR.UTF-8"), Some(fr));
+ assert_eq!(lang_from_tag("fr-CA"), Some(fr));
+ assert_eq!(first_supported("fr-FR\r\nen-US"), Some(fr));
+ assert_eq!(tr(fr, "Rapport de l'utilisateur.pdf"), "Rapport de l'utilisateur.pdf");
+ assert_eq!((0..=3).map(|n| (fr.0.plural)(n)).collect::<Vec<_>>(), [0, 0, 1, 1]);
+ let mut app = crate::PdfCraftApp::default();
+ app.set_option("language", "fr").unwrap();
+ assert_eq!(app.language, "fr");
+ let mut restored = crate::PdfCraftApp::default();
+ restored.restore(&app.persist());
+ assert_eq!(restored.language, "fr");
+}
+
+#[test]
+fn german_is_registered() {
+ let de = Lang::from_code("de").expect("de registered");
+ assert_eq!(de.name(), "Deutsch");
+ assert_eq!(normalize_pref("DE"), Some("de"));
+ assert_eq!(lang_from_tag("de_DE.UTF-8"), Some(de));
+ assert_eq!(lang_from_tag("de-AT"), Some(de));
+ assert_eq!(lang_from_tag("de_CH"), Some(de));
+ assert_eq!(first_supported("de-DE\r\nen-US"), Some(de));
+ assert_eq!(tr(de, "Bericht des Nutzers.pdf"), "Bericht des Nutzers.pdf");
+ assert_eq!((0..=3).map(|n| (de.0.plural)(n)).collect::<Vec<_>>(), [1, 0, 1, 1]);
+ let mut app = crate::PdfCraftApp::default();
+ app.set_option("language", "de").unwrap();
+ assert_eq!(app.language, "de");
+ let mut restored = crate::PdfCraftApp::default();
+ restored.restore(&app.persist());
+ assert_eq!(restored.language, "de");
+}
+
+#[test]
+fn tool_names_inside_sentences_are_lowercased_except_in_german() {
+ set_current(Lang::EN);
+ assert_eq!(in_sentence("Text Box"), "text box");
+ set_current(Lang::from_code("de").expect("de registered"));
+ assert_eq!(in_sentence("Textfeld"), "Textfeld");
+ set_current(Lang::EN);
+}
+
+#[test]
+fn turkish_keeps_its_dotted_and_dotless_i_when_changing_case() {
+ set_current(Lang::from_code("tr").expect("tr registered"));
+ assert_eq!(upper_label("Advanced"), "GELİŞMİŞ");
+ assert_eq!(upper_label("Signatures"), "İMZALAR");
+ // A label with no Turkish row is still English and keeps the English rule.
+ assert_eq!(upper_label("Untranslated title"), "UNTRANSLATED TITLE");
+ assert_eq!(in_sentence("İmza Alanı"), "imza alanı");
+ assert_eq!(in_sentence("Işık"), "ışık");
+ set_current(Lang::EN);
+ assert_eq!(upper_label("Advanced"), "ADVANCED");
+ assert_eq!(in_sentence("Image"), "image");
+}
+
+#[test]
+fn russian_is_registered() {
+ let ru = Lang::from_code("ru").expect("ru registered");
+ assert_eq!(ru.name(), "Русский");
+ assert_eq!(normalize_pref("RU"), Some("ru"));
+ assert_eq!(lang_from_tag("ru_RU.UTF-8"), Some(ru));
+ assert_eq!(lang_from_tag("ru-BY"), Some(ru));
+ assert_eq!(first_supported("ru-RU\r\nen-US"), Some(ru));
+ assert_eq!(tr(ru, "Rapport de l'utilisateur.pdf"), "Rapport de l'utilisateur.pdf");
+ // one (1), few (2-4), many (0, 5+), with 11-14 exception
+ assert_eq!((0..=3).map(|n| (ru.0.plural)(n)).collect::<Vec<_>>(), [2, 0, 1, 1]);
+ let mut app = crate::PdfCraftApp::default();
+ app.set_option("language", "ru").unwrap();
+ assert_eq!(app.language, "ru");
+ let mut restored = crate::PdfCraftApp::default();
+ restored.restore(&app.persist());
+ assert_eq!(restored.language, "ru");
+}
+
+#[test]
+fn finnish_is_registered_and_persists() {
+ let fi = Lang::from_code("fi").expect("fi registered");
+ assert_eq!(fi.name(), "Suomi");
+ assert_eq!(normalize_pref("FI"), Some("fi"));
+ for tag in ["fi", "fi-FI", "fi_FI.UTF-8", "FI-fi"] {
+ assert_eq!(lang_from_tag(tag), Some(fi), "{tag}");
+ }
+ // Filipino (`fil`) and Swedish in Finland (`sv-FI`) don't pick Finnish.
+ assert_ne!(lang_from_tag("fil"), Some(fi));
+ assert_ne!(lang_from_tag("sv-FI"), Some(fi));
+ let mut app = crate::PdfCraftApp::default();
+ app.set_option("language", "FI").unwrap();
+ assert_eq!(app.language, "fi");
+ let mut restored = crate::PdfCraftApp::default();
+ restored.restore(&app.persist());
+ assert_eq!(restored.language, "fi");
+}
+
+#[test]
+fn lithuanian_is_registered_and_persists() {
+ let lt = Lang::from_code("lt").expect("lt registered");
+ assert_eq!(lt.name(), "Lietuvių");
+ assert_eq!(normalize_pref("LT"), Some("lt"));
+ for tag in ["lt", "lt-LT", "lt_LT.UTF-8", "LT-lt"] {
+ assert_eq!(lang_from_tag(tag), Some(lt), "{tag}");
+ }
+ let mut app = crate::PdfCraftApp::default();
+ app.set_option("language", "LT").unwrap();
+ assert_eq!(app.language, "lt");
+ let mut restored = crate::PdfCraftApp::default();
+ restored.restore(&app.persist());
+ assert_eq!(restored.language, "lt");
+ assert!(restored.set_option("language", "xx").is_err());
+}
+
+#[test]
+fn norwegian_bokmal_is_registered_and_persists() {
+ let nb = Lang::from_code("nb").expect("nb registered");
+ assert_eq!(nb.name(), "Norsk bokmål");
+ assert_eq!(normalize_pref("NB"), Some("nb"));
+ assert_eq!(normalize_pref("no"), None, "only exact codes are preferences");
+ // Current systems say `nb`; older ones and some Linux setups say `no`. Nynorsk is `nn`.
+ for tag in ["nb", "nb-NO", "nb_NO.UTF-8", "no", "no_NO.UTF-8", "NO-no", "nn", "nn_NO.UTF-8"] {
+ assert_eq!(lang_from_tag(tag), Some(nb), "{tag}");
+ }
+ assert_eq!(first_supported("(\n \"nb-NO\",\n \"en-US\"\n)\n"), Some(nb));
+ assert_eq!(first_supported("nn-NO\r\nen-US\r\n"), Some(nb));
+ assert_eq!((0..=3).map(|n| (nb.0.plural)(n)).collect::<Vec<_>>(), [1, 0, 1, 1]);
+ let mut app = crate::PdfCraftApp::default();
+ app.set_option("language", "NB").unwrap();
+ assert_eq!(app.language, "nb");
+ let mut restored = crate::PdfCraftApp::default();
+ restored.restore(&app.persist());
+ assert_eq!(restored.language, "nb");
+}
+
+#[test]
+fn vietnamese_is_registered_and_persists() {
+ let vi = Lang::from_code("vi").expect("vi registered");
+ assert_eq!(vi.name(), "Tiếng Việt");
+ assert_eq!(normalize_pref("Vi"), Some("vi"));
+ for tag in ["vi", "vi-VN", "vi_VN.UTF-8", "VI-vn"] {
+ assert_eq!(lang_from_tag(tag), Some(vi), "{tag}");
+ }
+ assert_eq!(first_supported("vi-VN\r\nen-US"), Some(vi));
+ assert_eq!((0..=3).map(|n| (vi.0.plural)(n)).collect::<Vec<_>>(), [0, 0, 0, 0]);
+ let mut app = crate::PdfCraftApp::default();
+ app.set_option("language", "vi").unwrap();
+ assert_eq!(app.language, "vi");
+ let mut restored = crate::PdfCraftApp::default();
+ restored.restore(&app.persist());
+ assert_eq!(restored.language, "vi");
+ assert!(restored.set_option("language", "xx").is_err());
+ assert_eq!(restored.language, "vi");
+}
+
+#[test]
+fn romanian_is_registered_with_three_plural_forms() {
+ let ro = Lang::from_code("ro").expect("ro registered");
+ for tag in ["ro", "ro-RO", "ro_RO.UTF-8", "RO-ro", "ro-MD"] {
+ assert_eq!(lang_from_tag(tag), Some(ro), "{tag}");
+ }
+ assert_eq!(normalize_pref("Ro"), Some("ro"));
+ let info = LANGUAGES.iter().find(|language| language.code == "ro").expect("ro row");
+ assert_eq!(info.plural_forms(), 3);
+ // one: 1; few: 0 and n % 100 in 1..=19 ("2 pagini", "101 pagini"); other: the "de" form ("20 de pagini").
+ for (n, form) in [(1, 0), (0, 1), (2, 1), (19, 1), (101, 1), (119, 1), (20, 2), (100, 2), (120, 2), (1000, 2)] {
+ assert_eq!(plural_ro(n), form, "{n}");
+ }
+}
+
+#[test]
+fn catalan_is_registered_and_persists() {
+ let ca = Lang::from_code("ca").expect("ca registered");
+ assert_eq!(ca.name(), "Català");
+ assert_eq!(normalize_pref("CA"), Some("ca"));
+ for tag in ["ca", "ca-ES", "ca_ES.UTF-8", "CA-es", "ca_ES@valencia"] {
+ assert_eq!(lang_from_tag(tag), Some(ca), "{tag}");
+ }
+ assert_eq!(first_supported("ca-ES\r\nen-US"), Some(ca));
+ // one (1), other (0, 2+), as in English
+ assert_eq!((0..=3).map(|n| (ca.0.plural)(n)).collect::<Vec<_>>(), [1, 0, 1, 1]);
+ let mut app = crate::PdfCraftApp::default();
+ app.set_option("language", "CA").unwrap();
+ assert_eq!(app.language, "ca");
+ let mut restored = crate::PdfCraftApp::default();
+ restored.restore(&app.persist());
+ assert_eq!(restored.language, "ca");
+ assert!(restored.set_option("language", "xx").is_err());
+ assert_eq!(restored.language, "ca");
+}
+
+#[test]
+fn slovene_is_registered_and_persists() {
+ let sl = Lang::from_code("sl").expect("sl registered");
+ assert_eq!(sl.name(), "Slovenščina");
+ assert_eq!(normalize_pref("SL"), Some("sl"));
+ for tag in ["sl", "sl-SI", "sl_SI.UTF-8", "SL-si", "sl_SI@variant"] {
+ assert_eq!(lang_from_tag(tag), Some(sl), "{tag}");
+ }
+ assert_eq!(first_supported("sl-SI\r\nen-US"), Some(sl));
+ assert_eq!(tr(sl, "Poročilo {n}.pdf"), "Poročilo {n}.pdf");
+ // one (1), two (2), few (3, 4), other (0, 5+)
+ assert_eq!((0..=5).map(|n| (sl.0.plural)(n)).collect::<Vec<_>>(), [3, 0, 1, 2, 2, 3]);
+ let mut app = crate::PdfCraftApp::default();
+ app.set_option("language", "SL").unwrap();
+ assert_eq!(app.language, "sl");
+ let mut restored = crate::PdfCraftApp::default();
+ restored.restore(&app.persist());
+ assert_eq!(restored.language, "sl");
+ assert!(restored.set_option("language", "xx").is_err());
+ assert_eq!(restored.language, "sl");
+}
+
+#[test]
+fn albanian_is_registered_and_persists() {
+ let sq = Lang::from_code("sq").expect("sq registered");
+ assert_eq!(sq.name(), "Shqip");
+ assert_eq!(normalize_pref("SQ"), Some("sq"));
+ for tag in ["sq", "sq-AL", "sq_AL.UTF-8", "SQ-xk", "sq_XK@variant"] {
+ assert_eq!(lang_from_tag(tag), Some(sq), "{tag}");
+ }
+ assert_eq!(first_supported("sq-AL\r\nen-US"), Some(sq));
+ // one (1), other (0, 2+)
+ assert_eq!((0..=3).map(|n| (sq.0.plural)(n)).collect::<Vec<_>>(), [1, 0, 1, 1]);
+ let mut app = crate::PdfCraftApp::default();
+ app.set_option("language", "SQ").unwrap();
+ assert_eq!(app.language, "sq");
+ let mut restored = crate::PdfCraftApp::default();
+ restored.restore(&app.persist());
+ assert_eq!(restored.language, "sq");
+ assert!(restored.set_option("language", "xx").is_err());
+ assert_eq!(restored.language, "sq");
+}
+
+#[test]
+fn slovene_plurals_cover_dual_few_teens_and_large_counts() {
+ let sl = Lang::from_code("sl").expect("sl registered");
+ assert_eq!(sl.0.plural_forms(), 4);
+ for (counts, form) in [
+ (vec![1, 101, 201, 1001, 1101], 0),
+ (vec![2, 102, 202, 1002], 1),
+ (vec![3, 4, 103, 104, 1003], 2),
+ (vec![0, 5, 10, 11, 12, 13, 14, 15, 20, 21, 22, 23, 24, 25, 31, 100, 111, 112, 121, 122, 1000, u64::MAX], 3),
+ ] {
+ for n in counts {
+ assert_eq!((sl.0.plural)(n), form, "{n}");
+ }
+ }
+}
+
+#[test]
+fn indonesian_and_vietnamese_are_registered_and_persist() {
+ let id = Lang::from_code("id").expect("id registered");
+ let vi = Lang::from_code("vi").expect("vi registered");
+ assert_eq!(id.name(), "Bahasa Indonesia");
+ assert_eq!(vi.name(), "Tiếng Việt");
+ assert_eq!(normalize_pref("ID"), Some("id"));
+ assert_eq!(normalize_pref("Vi"), Some("vi"));
+ for tag in ["id", "id-ID", "id_ID.UTF-8", "ID-id"] {
+ assert_eq!(lang_from_tag(tag), Some(id), "{tag}");
+ }
+ for tag in ["vi", "vi-VN", "vi_VN.UTF-8", "VI-vn"] {
+ assert_eq!(lang_from_tag(tag), Some(vi), "{tag}");
+ }
+ assert_eq!(first_supported("id-ID\r\nen-US"), Some(id));
+ assert_eq!(first_supported("vi-VN\r\nen-US"), Some(vi));
+ // One CLDR plural form (CLDR `id`, `vi`): the message reads the same for every count.
+ assert_eq!((0..=3).map(|n| (id.0.plural)(n)).collect::<Vec<_>>(), [0, 0, 0, 0]);
+ assert_eq!((0..=3).map(|n| (vi.0.plural)(n)).collect::<Vec<_>>(), [0, 0, 0, 0]);
+ let mut app = crate::PdfCraftApp::default();
+ app.set_option("language", "ID").unwrap();
+ assert_eq!(app.language, "id");
+ let mut restored = crate::PdfCraftApp::default();
+ restored.restore(&app.persist());
+ assert_eq!(restored.language, "id");
+ let mut app = crate::PdfCraftApp::default();
+ app.set_option("language", "vi").unwrap();
+ assert_eq!(app.language, "vi");
+ let mut restored = crate::PdfCraftApp::default();
+ restored.restore(&app.persist());
+ assert_eq!(restored.language, "vi");
+ assert!(restored.set_option("language", "xx").is_err());
+ assert_eq!(restored.language, "vi");
+}
+
+#[test]
+fn hindi_and_korean_are_registered_and_persist() {
+ let hi = Lang::from_code("hi").expect("hi registered");
+ let ko = Lang::from_code("ko").expect("ko registered");
+ assert_eq!(hi.name(), "हिन्दी");
+ assert_eq!(ko.name(), "한국어");
+ assert_eq!(normalize_pref("HI"), Some("hi"));
+ assert_eq!(normalize_pref("Ko"), Some("ko"));
+ for tag in ["hi", "hi-IN", "hi_IN.UTF-8", "HI-in"] {
+ assert_eq!(lang_from_tag(tag), Some(hi), "{tag}");
+ }
+ for tag in ["ko", "ko-KR", "ko_KR.UTF-8", "KO-kr"] {
+ assert_eq!(lang_from_tag(tag), Some(ko), "{tag}");
+ }
+ assert_eq!(first_supported("hi-IN\r\nen-US"), Some(hi));
+ assert_eq!(first_supported("ko-KR\r\nen-US"), Some(ko));
+ // One plural form per catalog: the message reads the same for every count.
+ assert_eq!((0..=3).map(|n| (hi.0.plural)(n)).collect::<Vec<_>>(), [0, 0, 0, 0]);
+ assert_eq!((0..=3).map(|n| (ko.0.plural)(n)).collect::<Vec<_>>(), [0, 0, 0, 0]);
+ for code in ["hi", "ko"] {
+ let mut app = crate::PdfCraftApp::default();
+ app.set_option("language", &code.to_uppercase()).unwrap();
+ assert_eq!(app.language, code);
+ let mut restored = crate::PdfCraftApp::default();
+ restored.restore(&app.persist());
+ assert_eq!(restored.language, code);
+ assert!(restored.set_option("language", "xx").is_err());
+ assert_eq!(restored.language, code);
+ }
+}
+
+#[test]
+fn bulgarian_is_registered() {
+ let bg = Lang::from_code("bg").expect("bg registered");
+ assert_eq!(bg.name(), "Български");
+ assert_eq!(normalize_pref("BG"), Some("bg"));
+ assert_eq!(lang_from_tag("bg_BG.UTF-8"), Some(bg));
+ assert_eq!(lang_from_tag("bg-BG"), Some(bg));
+ assert_eq!(first_supported("bg-BG\r\nen-US"), Some(bg));
+ assert_eq!(tr(bg, "Rapport de l'utilisateur.pdf"), "Rapport de l'utilisateur.pdf");
+ // one (1), other (0, 2+)
+ assert_eq!((0..=3).map(|n| (bg.0.plural)(n)).collect::<Vec<_>>(), [1, 0, 1, 1]);
+ let mut app = crate::PdfCraftApp::default();
+ app.set_option("language", "bg").unwrap();
+ assert_eq!(app.language, "bg");
+ let mut restored = crate::PdfCraftApp::default();
+ restored.restore(&app.persist());
+ assert_eq!(restored.language, "bg");
+}
+
+#[test]
+fn hungarian_is_registered() {
+ let hu = Lang::from_code("hu").expect("hu registered");
+ assert_eq!(hu.name(), "Magyar");
+ assert_eq!(normalize_pref("HU"), Some("hu"));
+ assert_eq!(lang_from_tag("hu_HU.UTF-8"), Some(hu));
+ assert_eq!(lang_from_tag("hu-HU"), Some(hu));
+ assert_eq!(first_supported("hu-HU\r\nen-US"), Some(hu));
+ assert_eq!(tr(hu, "Rapport de l'utilisateur.pdf"), "Rapport de l'utilisateur.pdf");
+ // one (1), other (0, 2+)
+ assert_eq!((0..=3).map(|n| (hu.0.plural)(n)).collect::<Vec<_>>(), [1, 0, 1, 1]);
+ let mut app = crate::PdfCraftApp::default();
+ app.set_option("language", "hu").unwrap();
+ assert_eq!(app.language, "hu");
+ let mut restored = crate::PdfCraftApp::default();
+ restored.restore(&app.persist());
+ assert_eq!(restored.language, "hu");
+}
+
+#[test]
+fn ukrainian_is_registered_and_persists() {
+ let uk = Lang::from_code("uk").expect("uk registered");
+ assert_eq!(uk.name(), "Українська");
+ assert_eq!(normalize_pref("UK"), Some("uk"));
+ for tag in ["uk", "uk-UA", "uk_UA.UTF-8", "UK-ua", "uk_UA@variant"] {
+ assert_eq!(lang_from_tag(tag), Some(uk), "{tag}");
+ }
+ assert_eq!(first_supported("uk-UA\r\nen-US"), Some(uk));
+ assert_eq!(first_supported("(\n \"uk-UA\",\n \"en-US\"\n)\n"), Some(uk));
+ assert_eq!(tr(uk, "Звіт {n}.pdf"), "Звіт {n}.pdf");
+ let mut app = crate::PdfCraftApp::default();
+ app.set_option("language", "UK").unwrap();
+ assert_eq!(app.language, "uk");
+ let mut restored = crate::PdfCraftApp::default();
+ restored.restore(&app.persist());
+ assert_eq!(restored.language, "uk");
+ assert!(restored.set_option("language", "xx").is_err());
+ assert_eq!(restored.language, "uk");
+}
+
+#[test]
+fn ukrainian_integer_plurals_cover_teens_and_large_counts() {
+ let uk = Lang::from_code("uk").expect("uk registered");
+ assert_eq!(uk.0.plural_forms(), 3);
+ for (counts, form) in [
+ (vec![1, 21, 31, 101, 121, 1001], 0),
+ (vec![2, 3, 4, 22, 23, 24, 102, 104, 122, 1002], 1),
+ (vec![0, 5, 10, 11, 12, 13, 14, 19, 20, 25, 100, 110, 111, 112, 114, 1000, u64::MAX], 2),
+ ] {
+ for n in counts {
+ assert_eq!((uk.0.plural)(n), form, "{n}");
+ }
+ }
+}
+
+fn arabic() -> Lang {
+ Lang::from_code("ar").expect("ar registered")
+}
+
+#[test]
+fn arabic_is_registered_and_persists() {
+ let ar = arabic();
+ assert_eq!(ar.name(), "العربية");
+ assert!(ar.rtl());
+ let rtl: Vec<&str> = Lang::all().filter(|l| l.rtl()).map(|l| l.code()).collect();
+ assert_eq!(rtl, ["ar", "ckb", "fa"], "Arabic, Kurdish and Persian are the right-to-left languages");
+ assert_eq!(normalize_pref("AR"), Some("ar"));
+ for tag in ["ar", "ar-MA", "ar_EG.UTF-8", "AR-sa", "ar_DZ@variant"] {
+ assert_eq!(lang_from_tag(tag), Some(ar), "{tag}");
+ }
+ assert_eq!(first_supported("ar-MA\r\nen-US"), Some(ar));
+ // Unknown strings and user text are never reordered by a lookup.
+ assert_eq!(tr(ar, "تقرير نهائي {n}.pdf"), "تقرير نهائي {n}.pdf");
+ let mut app = crate::PdfCraftApp::default();
+ app.set_option("language", "AR").unwrap();
+ assert_eq!(app.language, "ar");
+ let mut restored = crate::PdfCraftApp::default();
+ restored.restore(&app.persist());
+ assert_eq!(restored.language, "ar");
+ assert!(restored.set_option("language", "xx").is_err());
+ assert_eq!(restored.language, "ar");
+}
+
+/// Catalog lookups stay in logical order; the egui 0.37 fork owns bidi shaping and display
+/// reordering (E5/E12), so preordering here would reverse Arabic twice. Accessibility names,
+/// copied labels and search therefore see the source string.
+#[test]
+fn arabic_catalog_stays_logical() {
+ let ar = arabic();
+ assert_eq!(tr(ar, "Save as…"), "حفظ باسم…");
+ assert_eq!(tr(ar, "About PdfCraft"), "حول PdfCraft");
+ assert_eq!(tr(ar, "Name:"), "الاسم:");
+ assert_eq!(tr(ar, "Issued by: "), "صادرة عن: ");
+ // Placeholders survive in their logical positions.
+ assert_eq!(tr(ar, "Couldn't open {name}: {e}"), "تعذّر فتح {name}: {e}");
+ assert_eq!(fmt(tr(ar, "Couldn't open {name}: {e}"), &[("name", "a {e}.pdf"), ("e", "x")]), "تعذّر فتح a {e}.pdf: x");
+ assert_eq!(fmt(tr(ar, "Page {p} of {n}"), &[("p", "3"), ("n", "12")]), "الصفحة 3 من 12");
+ set_current(ar);
+ let command = command_label("Undo Insert pages from a.pdf");
+ assert!(command.contains("a.pdf") && command.contains("إدراج صفحات"), "logical command label: {command:?}");
+ assert_eq!(menu_label("file.saveAs", "Save as…"), "حفظ باسم…");
+ set_current(Lang::EN);
+}
+
+#[test]
+fn arabic_plurals_follow_the_six_cldr_forms() {
+ let ar = arabic();
+ assert_eq!(ar.0.plural_forms(), 6);
+ let form = |n| (ar.0.plural)(n);
+ assert_eq!([0, 1, 2].map(form), [0, 1, 2]);
+ assert_eq!([3, 10, 103, 110, 1003].map(form), [3; 5]);
+ assert_eq!([11, 99, 111, 199, 1011].map(form), [4; 5]);
+ assert_eq!([100, 101, 102, 200, 1000, u64::MAX - 13].map(form), [5; 6]);
+}
+
+fn persian() -> Lang {
+ Lang::from_code("fa").expect("fa registered")
+}
+
+#[test]
+fn persian_is_registered_and_persists() {
+ let fa = persian();
+ assert_eq!(fa.name(), "فارسی");
+ assert!(fa.rtl());
+ // CLDR `fa` (one: i = 0 or n = 1): 0 and 1 are singular, every other count the plural.
+ assert_eq!(fa.0.plural_forms(), 2);
+ assert_eq!([0, 1, 2, 11].map(|n| (fa.0.plural)(n)), [0, 0, 1, 1]);
+ assert_eq!(normalize_pref("FA"), Some("fa"));
+ for tag in ["fa", "fa-IR", "fa_IR.UTF-8", "FA-af", "fa_IR@calendar=persian"] {
+ assert_eq!(lang_from_tag(tag), Some(fa), "{tag}");
+ }
+ assert_eq!(first_supported("fa-IR\r\nen-US"), Some(fa));
+ // Lookups return Persian in logical order; epaint handles visual ordering.
+ assert_eq!(tr(fa, "Save"), "ذخیره");
+ assert_eq!(tr(fa, "Cancel"), "لغو");
+ assert_eq!(tr(fa, "File"), "فایل");
+ // Unknown strings and user text are never reordered by a lookup.
+ assert_eq!(tr(fa, "گزارش نهایی {n}.pdf"), "گزارش نهایی {n}.pdf");
+ let mut app = crate::PdfCraftApp::default();
+ app.set_option("language", "FA").unwrap();
+ assert_eq!(app.language, "fa");
+ let mut restored = crate::PdfCraftApp::default();
+ restored.restore(&app.persist());
+ assert_eq!(restored.language, "fa");
+ assert!(restored.set_option("language", "xx").is_err());
+ assert_eq!(restored.language, "fa");
+}
+
+/// With a craft-fonts Arabic face, every Arabic translation has glyphs: with all interface
+/// faces (desktop) and with the Arabic face as the only craft-fonts face (the web build keeps
+/// it; Arabic labels must not need a Japanese face).
+#[test]
+fn arabic_labels_have_glyphs() {
+ let faces: Vec<String> = pdfcraft_fonts::ui_arabic_fonts().iter().map(|f| f.name()).collect();
+ if faces.is_empty() {
+ eprintln!("skipping Arabic glyph checks: build with CRAFT_FONTS_DIR and an Arabic face to run them");
+ return;
+ }
+ let ar = arabic();
+ let (entries, _) = parse_entries(ar.0.source, ar.0.plural_forms());
+ let labels: String = entries.iter().flat_map(|e| e.translation.chars()).chain(ar.name().chars()).filter(|c| !c.is_control()).collect();
+ let mut arabic_only = crate::theme::font_definitions();
+ for family in arabic_only.families.values_mut() {
+ family.retain(|name| !pdfcraft_fonts::CRAFT_FONTS.iter().any(|face| face.name() == *name) || faces.contains(name));
+ }
+ use egui::epaint::text::{Fonts, TextOptions};
+ for (build, defs) in [("all faces", crate::theme::font_definitions()), ("Arabic face only", arabic_only)] {
+ let mut fonts = Fonts::new(TextOptions::default(), defs);
+ for id in [egui::FontId::proportional(13.0), egui::FontId::monospace(13.0), crate::theme::medium(13.0), crate::theme::semibold(17.0)] {
+ let missing: std::collections::BTreeSet<char> = labels.chars().filter(|c| !fonts.has_glyphs(&id, &c.to_string())).collect();
+ assert!(missing.is_empty(), "{build}: {id:?} lacks Arabic label glyphs {missing:?}");
+ }
+ }
+}
+
+/// Every bundled catalog is well-formed and consistent with its sources.
+#[test]
+fn bundled_catalogs_are_consistent() {
+ let mut codes = std::collections::HashSet::new();
+ for l in &LANGUAGES {
+ assert!(codes.insert(l.code), "duplicate code {}", l.code);
+ assert!(l.code == l.code.to_ascii_lowercase() && !l.name.is_empty(), "{}", l.code);
+ let (entries, errors) = parse_entries(l.source, l.plural_forms());
+ assert!(errors.is_empty(), "{}: {errors:?}", l.code);
+ for e in entries.iter().filter(|e| e.context == "@id") {
+ let command = pdfcraft_engine::commands::command(&e.source);
+ let Some(command) = command else { panic!("{}: unknown command id {:?}", l.code, e.source) };
+ assert_eq!(placeholders(&e.translation), placeholders(command.label), "{}: {}", l.code, e.source);
+ assert_eq!(e.translation.ends_with('…'), command.label.ends_with('…'), "{}: ellipsis mismatch: {}", l.code, e.source);
+ }
+ }
+}
+
+/// The translation gaps report (`cargo xtask i18n-report`, a step of `cargo xtask ci`): for
+/// each language, how many English strings it has no translation for, and the first few.
+/// It never fails: a missing string shows in English.
+///
+/// The English strings are the UI source's literals, the commands, All tools, the engine's
+/// own wordings, and every key of every bundled catalog (which covers contextual, plural and
+/// dynamically looked-up strings the scan can't see).
+#[test]
+fn translation_gaps_report() {
+ use std::collections::BTreeSet;
+ const SHOWN: usize = 3;
+ let mut plain: BTreeSet<String> = ui_literals();
+ let mut add = |s: &str| {
+ plain.insert(s.to_string());
+ };
+ for command in pdfcraft_engine::commands::COMMANDS {
+ add(command.label);
+ command.menu.into_iter().for_each(&mut add);
+ }
+ for group in pdfcraft_engine::catalog::TOOL_GROUPS {
+ add(group.label);
+ for section in group.sections {
+ add(section.title);
+ section.items.iter().for_each(|item| add(item.label));
+ }
+ }
+ pdfcraft_engine::catalog::TOOL_CATEGORIES.iter().for_each(|category| add(category.label));
+ let engine: [&[&str]; 9] = [
+ pdfcraft_engine::a11y::WORDINGS,
+ pdfcraft_engine::a11y::REPORT_WORDS,
+ pdfcraft_engine::pdfa::WORDINGS,
+ pdfcraft_engine::sign::pdf::WORDINGS,
+ pdfcraft_engine::sign::pdf::kind::ALL,
+ pdfcraft_engine::print::WORDINGS,
+ pdfcraft_engine::EDIT_LABELS,
+ pdfcraft_engine::BATCH_LABELS,
+ pdfcraft_engine::field_table::WORDINGS,
+ ];
+ engine.into_iter().flatten().for_each(|s| add(s));
+ pdfcraft_engine::sign::AppearanceLabels::default().fields().into_iter().for_each(|(_, label)| add(label));
+ crate::credits::NameMode::ALL.iter().for_each(|mode| add(mode.label()));
+ for key in crate::credits::SortKey::ALL {
+ let (label, header) = key.label();
+ add(label);
+ add(header);
+ }
+ crate::credits::MODEL_COLUMNS.iter().for_each(|s| add(s));
+ // (context, source) keys; `@id` rows only reword a command label, which is in `plain`.
+ let mut keys: BTreeSet<(String, String)> = plain.into_iter().map(|s| (String::new(), s)).collect();
+ for language in &LANGUAGES {
+ let (entries, _) = parse_entries(language.source, language.plural_forms());
+ keys.extend(entries.into_iter().filter(|e| e.context != "@id").map(|e| (e.context, e.source)));
+ }
+ let mut report = format!("Translation gaps: {} English strings\n", keys.len());
+ for lang in Lang::all().filter(|l| *l != Lang::EN) {
+ let catalog = lang.catalog();
+ let missing: Vec<&(String, String)> = keys
+ .iter()
+ .filter(|(context, source)| match context.as_str() {
+ "" => catalog.plain(source).is_none(),
+ "@plural" => source.split_once('|').is_none_or(|(one, other)| catalog.plural(one, other, 0).is_none()),
+ // A contextual lookup falls back to the plain translation.
+ context => catalog.contextual(context, source).is_none() && catalog.plain(source).is_none(),
+ })
+ .collect();
+ let mut line = format!(" {:<8} {:>5} missing", lang.code(), missing.len());
+ for (i, (context, source)) in missing.iter().take(SHOWN).enumerate() {
+ let mut shown: String = source.chars().take(48).collect();
+ if shown.len() < source.len() {
+ shown.push('…');
+ }
+ let key = if context.is_empty() { format!("{shown:?}") } else { format!("{context} / {shown:?}") };
+ line.push_str(if i == 0 { ": " } else { ", " });
+ line.push_str(&key);
+ }
+ if missing.len() > SHOWN {
+ line.push_str(", …");
+ }
+ report.push_str(&line);
+ report.push('\n');
+ }
+ println!("{REPORT_START}\n{report}{REPORT_END}");
+}
+
+/// The lines `cargo xtask i18n-report` prints from the test output lie between these.
+const REPORT_START: &str = "=== translation gaps ===";
+const REPORT_END: &str = "=== end of translation gaps ===";
+
+/// Preferences ▸ Date format ▸ Language offers exactly the interface languages, in order.
+#[test]
+fn date_languages_are_the_interface_languages() {
+ let interface: Vec<(&str, &str)> = Lang::all().map(|l| (l.code(), l.name())).collect();
+ let dates: Vec<(&str, &str)> = pdfcraft_engine::dates::DATE_LANGUAGES.iter().map(|l| (l.code, l.name)).collect();
+ assert_eq!(dates, interface);
+}