Struct Catalog 

pub struct Catalog { /* private fields */ }

Implementations

impl Catalog

pub fn load(path: &str) -> Result<Self, EngineError>

Strict loader: fails if the file is missing or invalid. Use this at startup when you want the application to refuse to run without a valid catalog (propagate with ? via anyhow in main).

pub fn load_or_fallback(path: &str) -> Self

Infallible loader. If the catalog can’t be read or parsed, returns a Catalog with no entries, remembering the error so render() can surface it as UNK-000 instead of panicking. This is the loader most applications should use.

pub fn render(&self, code: &str, ctx: &[(&str, String)]) -> String

Never fails. Falls back to UNK-000 in two cases:

• the catalog itself failed to load (load_error is set)
• the code has no entry in an otherwise valid catalog

pub fn hint(&self, code: &str) -> Option<&str>

None in both UNK-000 cases (catalog load failure or missing code).

Trait Implementations

impl Debug for Catalog

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.