use std::collections::HashMap;
/// Parsed Factorio locale text: `[section]` headers, `key=value` lines, `;` / `#` comment lines,
/// `\n` escapes in values. A later duplicate key wins.
#[derive(Clone, Debug, Default, PartialEq, Eq)]
pub struct Locale {
sections: HashMap<String, HashMap<String, String>>,
}
impl Locale {
pub fn parse(text: &str) -> Self {
let mut locale = Self::default();
locale.extend(text);
locale
}
/// Merge more `.cfg` text; later files override earlier ones, as the game merges a mod's files.
pub fn extend(&mut self, text: &str) {
let mut section = String::new();
for line in text.trim_start_matches('\u{feff}').lines() {
let line = line.trim_end_matches('\r');
let trimmed = line.trim_start();
if trimmed.is_empty() || trimmed.starts_with([';', '#']) {
continue;
}
if let Some(name) = trimmed
.strip_prefix('[')
.and_then(|rest| rest.trim_end().strip_suffix(']'))
{
section = name.trim().to_string();
} else if let Some((key, value)) = trimmed.split_once('=') {
self.sections
.entry(section.clone())
.or_default()
.insert(key.trim().to_string(), value.replace("\\n", "\n"));
}
}
}
pub fn get(&self, section: &str, key: &str) -> Option<&str> {
self.sections.get(section)?.get(key).map(String::as_str)
}
}
#[cfg(test)]
mod tests {
use super::Locale;
#[test]
fn parses_sections_comments_escapes_and_equals_in_values() {
let l = Locale::parse(
"\u{feff}; header\r\n# note\r\n[mod-name]\r\nbase=Base mod\r\n\r\n[mod-description]\r\nbase=Line one\\nLine two = x\r\n [other]\r\n; hidden=no\r\nk = v \r\n",
);
assert_eq!(l.get("mod-name", "base"), Some("Base mod"));
assert_eq!(
l.get("mod-description", "base"),
Some("Line one\nLine two = x")
);
assert_eq!(l.get("other", "k"), Some(" v "));
assert_eq!(l.get("other", "hidden"), None);
assert_eq!(l.get("mod-name", "other"), None);
}
#[test]
fn later_text_overrides_earlier_and_keys_before_a_section_are_unsectioned() {
let mut l = Locale::parse("loose=1\n[a]\nx=old\n");
l.extend("[a]\nx=new\n");
assert_eq!(l.get("a", "x"), Some("new"));
assert_eq!(l.get("", "loose"), Some("1"));
}
}