ferrocat-po 1.2.1

Performance-first PO parsing, serialization, and catalog update primitives for ferrocat.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78

use std::collections::BTreeSet;

#[cfg(feature = "serde")]
use serde::{Deserialize, Serialize};

use super::{CatalogMessage, CatalogMessageKey, EffectiveTranslationRef, NormalizedParsedCatalog};

/// Canonical catalog message status used by coverage and review reports.
#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash)]
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
#[cfg_attr(feature = "serde", serde(rename_all = "snake_case"))]
#[non_exhaustive]
pub enum CatalogMessageStatus {
    /// Active target message exists and has a non-empty, non-fuzzy translation.
    Translated,
    /// Active target message exists and carries a visible `fuzzy` flag.
    Fuzzy,
    /// No active or obsolete target entry exists for the active source identity.
    Missing,
    /// Active target entry exists, but its effective translation is empty.
    Empty,
    /// Target entry exists for the active source identity, but is obsolete.
    Obsolete,
    /// Active target entry is not present in the active source identity set.
    Extra,
}

pub(super) fn active_message_keys(
    catalog: &NormalizedParsedCatalog,
) -> BTreeSet<CatalogMessageKey> {
    catalog
        .iter()
        .filter_map(|(key, message)| (!message.obsolete).then_some(key.clone()))
        .collect()
}

pub(super) fn classify_expected_message(
    target_catalog: &NormalizedParsedCatalog,
    key: &CatalogMessageKey,
) -> CatalogMessageStatus {
    let Some(message) = target_catalog.get(key) else {
        return CatalogMessageStatus::Missing;
    };
    if message.obsolete {
        return CatalogMessageStatus::Obsolete;
    }
    if translation_is_empty(message) {
        return CatalogMessageStatus::Empty;
    }
    if message_has_fuzzy_flag(message) {
        return CatalogMessageStatus::Fuzzy;
    }
    CatalogMessageStatus::Translated
}

pub(super) fn is_extra_target_message(
    source_keys: &BTreeSet<CatalogMessageKey>,
    key: &CatalogMessageKey,
    message: &CatalogMessage,
) -> bool {
    !message.obsolete && !source_keys.contains(key)
}

pub(super) fn translation_is_empty(message: &CatalogMessage) -> bool {
    match message.effective_translation() {
        EffectiveTranslationRef::Singular(value) => value.trim().is_empty(),
        EffectiveTranslationRef::Plural(translations) => {
            translations.is_empty() || translations.values().any(|value| value.trim().is_empty())
        }
    }
}

pub(super) fn message_has_fuzzy_flag(message: &CatalogMessage) -> bool {
    message
        .extra
        .as_ref()
        .is_some_and(|extra| extra.flags.iter().any(|flag| flag == "fuzzy"))
}