Struct NormalizedParsedCatalog 

pub struct NormalizedParsedCatalog { /* private fields */ }

Parsed catalog with fast key-based lookup helpers.

Implementations

impl NormalizedParsedCatalog

pub fn compile( &self, options: &CompileCatalogOptions<'_>, ) -> Result<CompiledCatalog, ApiError>

Compiles the normalized catalog into a runtime-oriented lookup map.

Compiled keys are derived from the canonical gettext identity (msgctxt + msgid) using the selected built-in key strategy. The default configuration keeps translations as-is without filling missing values from the source text.

Errors

Returns ApiError::InvalidArguments when source fallback is enabled without a source_locale, or ApiError::Conflict when two source messages compile to the same derived key.

use ferrocat_po::{CompileCatalogOptions, ParseCatalogOptions, parse_catalog};

let parsed = parse_catalog(ParseCatalogOptions {
    content: "msgid \"Hello\"\nmsgstr \"Hallo\"\n",
    source_locale: "en",
    locale: Some("de"),
    ..ParseCatalogOptions::default()
})?;
let normalized = parsed.into_normalized_view()?;
let compiled = normalized.compile(&CompileCatalogOptions::default())?;

assert_eq!(compiled.len(), 1);
let (_, message) = compiled.iter().next().expect("compiled message");
assert_eq!(message.source_key.msgid, "Hello");

impl NormalizedParsedCatalog

pub const fn parsed_catalog(&self) -> &ParsedCatalog

Returns the underlying parsed catalog.

pub fn into_parsed_catalog(self) -> ParsedCatalog

Consumes the normalized view and returns the underlying parsed catalog.

pub fn get(&self, key: &CatalogMessageKey) -> Option<&CatalogMessage>

Returns a message by key.

pub fn contains_key(&self, key: &CatalogMessageKey) -> bool

Returns true if a message for key exists.

pub fn message_count(&self) -> usize

Returns the number of indexed messages.

pub fn iter( &self, ) -> impl Iterator<Item = (&CatalogMessageKey, &CatalogMessage)>

Iterates over all indexed messages in key order.

pub fn effective_translation( &self, key: &CatalogMessageKey, ) -> Option<EffectiveTranslationRef<'_>>

Returns the effective translation for key, if present.

pub fn effective_translation_with_source_fallback( &self, key: &CatalogMessageKey, source_locale: &str, ) -> Option<EffectiveTranslation>

Returns the effective translation and fills empty source-locale values from the source text when appropriate.

Trait Implementations

impl Clone for NormalizedParsedCatalog

fn clone(&self) -> NormalizedParsedCatalog

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for NormalizedParsedCatalog

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

Formats the value using the given formatter.

impl PartialEq for NormalizedParsedCatalog

fn eq(&self, other: &NormalizedParsedCatalog) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for NormalizedParsedCatalog

impl StructuralPartialEq for NormalizedParsedCatalog