ferrocat-po 3.4.2

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
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105

mod audit;
mod catalog;
mod catalog_index;
mod collation;
mod collation_table;
mod combine;
mod compile;
mod compile_types;
mod conversion;
mod coverage;
mod export;
mod fcl;
mod file_io;
mod helpers;
mod icu_syntax;
mod message_status;
mod mt;
mod plural;
mod pseudolocalization;
mod review;
mod types;

pub use ferrocat_icu::IcuPseudolocalizationOptions;

pub use self::audit::{
    CatalogAuditChecks, CatalogAuditDiagnostic, CatalogAuditIcuOptions, CatalogAuditMessageRef,
    CatalogAuditOptions, CatalogAuditReport, CatalogAuditSummary, audit_catalogs,
};
pub use self::catalog::{
    parse_catalog, parse_catalog_for_review, update_catalog, update_catalog_file,
};
pub use self::combine::{combine_catalog_files, combine_catalogs, merge_catalogs_three_way};
pub use self::compile::{
    compile_catalog_artifact, compile_catalog_artifact_report, compile_catalog_artifact_selected,
    compiled_key, compiled_key_with_policy,
};
pub use self::compile_types::{
    COMPILED_CATALOG_ARTIFACT_SCHEMA_VERSION, CompileCatalogArtifactIcuOptions,
    CompileCatalogArtifactOptions, CompileCatalogArtifactReportOptions,
    CompileCatalogArtifactReportSelection, CompileCatalogOptions,
    CompileSelectedCatalogArtifactOptions, CompiledCatalog, CompiledCatalogArtifact,
    CompiledCatalogArtifactReport, CompiledCatalogDiagnostic, CompiledCatalogIdDescription,
    CompiledCatalogIdIndex, CompiledCatalogMissingMessage, CompiledCatalogProvenanceReport,
    CompiledCatalogResolution, CompiledCatalogResolutionKind, CompiledCatalogTranslationKind,
    CompiledCatalogUnavailableId, CompiledKeyStrategy, CompiledMessage, CompiledTranslation,
    DescribeCompiledIdsReport, IcuFormatterSupportPolicy,
};
pub use self::conversion::{convert_catalog, convert_catalog_file};
pub use self::coverage::{
    CatalogCoverageMessage, CatalogCoverageOptions, CatalogCoverageReport, CatalogLocaleCoverage,
    measure_catalog_coverage,
};
pub use self::icu_syntax::canonicalize_icu_with_policy;
pub use self::message_status::CatalogMessageStatus;
pub use self::mt::{AiProvenance, MachineMetadata, machine_translation_hash};
pub use self::pseudolocalization::{
    CompiledCatalogPseudolocalizationOptions, pseudolocalize_compiled_catalog_artifact,
};
pub use self::review::{
    CatalogLocaleReview, CatalogMachineTranslationMessage, CatalogMachineTranslationReview,
    CatalogMachineTranslationStatus, CatalogReviewOptions, CatalogReviewReport,
    CatalogReviewSummary, CatalogReviewTranslation, CatalogSourceChange, CatalogSourceChangeKind,
    CatalogSourceChangeReport, CatalogTranslationChange, CatalogTranslationChangeReport,
    review_catalogs,
};
pub use self::types::{
    ApiError, CatalogCombineInput, CatalogCombineResult, CatalogCombineSelection,
    CatalogCombineStats, CatalogConflictStrategy, CatalogConvertResult, CatalogFileCombineResult,
    CatalogFileConvertResult, CatalogFileFormat, CatalogMergeSide, CatalogMessage,
    CatalogMessageKey, CatalogMode, CatalogOrigin, CatalogSemantics, CatalogStats,
    CatalogStorageFormat, CatalogUpdateInput, CatalogUpdateResult, CombineCatalogFilesOptions,
    CombineCatalogOptions, ConvertCatalogFileOptions, ConvertCatalogOptions, Diagnostic,
    DiagnosticSeverity, EffectiveTranslation, EffectiveTranslationRef, ExtractedMessage,
    ExtractedPluralMessage, ExtractedSingularMessage, IcuSyntaxPolicy,
    MergeCatalogsThreeWayOptions, NormalizedParsedCatalog, ObsoleteInfo, ObsoleteStrategy, OrderBy,
    ParseCatalogOptions, ParsedCatalog, PlaceholderCommentMode, PluralEncoding, PluralSource,
    RenderOptions, SourceExtractedMessage, TranslationShape, UpdateCatalogFileOptions,
    UpdateCatalogOptions, WriteDurability,
};
fn validate_source_locale(source_locale: &str) -> Result<(), ApiError> {
    if source_locale.trim().is_empty() {
        return Err(ApiError::InvalidArguments(
            "source_locale must not be empty".to_owned(),
        ));
    }
    Ok(())
}

#[cfg(test)]
mod unit_tests {
    use super::{ApiError, validate_source_locale};

    #[test]
    fn validate_source_locale_rejects_empty_values() {
        assert!(validate_source_locale("en").is_ok());
        assert!(validate_source_locale(" en ").is_ok());
        assert!(matches!(
            validate_source_locale(" \n\t "),
            Err(ApiError::InvalidArguments(message)) if message.contains("must not be empty")
        ));
    }
}

#[cfg(test)]
mod tests;