f67d38b35cc5
catalog.rs
//! Parser and lookup tables for translation catalogs (`*.tsv`, format documented in `es.tsv`).
use std::collections::HashMap;
/// A parsed catalog. Built once per language and kept for the life of the process.
#[derive(Debug, Default)]
pub struct Catalog {
/// context-free strings: English source → translation (looked up every frame)
plain: HashMap<String, String>,
/// strings with a disambiguating context, keyed `context \u{1} source`
contextual: HashMap<String, String>,
}
/// A catalog entry as read from the file: (context, source, translation).
pub type Entry = (String, String, String);
fn unescape(s: &str) -> String {
let mut out = String::with_capacity(s.len());
let mut it = s.chars();
while let Some(c) = it.next() {
if c != '\\' {
out.push(c);
continue;
}
match it.next() {
Some('n') => out.push('\n'),
Some('t') => out.push('\t'),
Some('\\') => out.push('\\'),
Some(o) => {
out.push('\\');
out.push(o);
}
None => out.push('\\'),
}
}
out
}
/// Read the entries of a catalog file. Malformed lines are returned as errors (and skipped), so a
/// bad translation never breaks the UI; the tests insist the bundled catalogs have none.
pub fn parse_entries(text: &str) -> (Vec<Entry>, Vec<String>) {
let mut entries = Vec::new();
let mut errors = Vec::new();
for (n, line) in text.lines().enumerate() {
if line.trim().is_empty() || line.starts_with('#') {
continue;
}
let mut cols = line.split('\t');
match (cols.next(), cols.next(), cols.next(), cols.next()) {
(Some(ctx), Some(src), Some(tr), None) if !src.is_empty() && !tr.is_empty() => {
entries.push((unescape(ctx), unescape(src), unescape(tr)));
}
_ => errors.push(format!("line {}: expected `context<TAB>source<TAB>translation`", n + 1)),
}
}
(entries, errors)
}
impl Catalog {
pub fn parse(text: &str) -> Catalog {
let mut c = Catalog::default();
for (ctx, src, tr) in parse_entries(text).0 {
if ctx.is_empty() {
c.plain.insert(src, tr);
} else {
c.contextual.insert(format!("{ctx}\u{1}{src}"), tr);
}
}
c
}
pub fn plain(&self, s: &str) -> Option<&str> {
self.plain.get(s).map(String::as_str)
}
pub fn contextual(&self, ctx: &str, s: &str) -> Option<&str> {
self.contextual.get(&format!("{ctx}\u{1}{s}")).map(String::as_str)
}
}
/// `{name}` placeholders of a template, in order of appearance.
#[cfg(test)]
pub fn placeholders(s: &str) -> Vec<&str> {
let mut out = Vec::new();
let mut rest = s;
while let Some(a) = rest.find('{') {
let after = &rest[a + 1..];
match after.find('}') {
Some(b) => {
out.push(&after[..b]);
rest = &after[b + 1..];
}
None => break,
}
}
out
}
No file is open. Choose one in the tree, or press Ctrl+O (⌘O on a Mac) to find one by name.
Syntax highlighting could not load. The unmodified read-only text remains available above.