Crate poreader

Expand description

Translation catalogues are key part of any localization infrastructure. They contain the lists of messages from the application, possibly disambiguated with identifiers or contexts, and corresponding translations.

Catalogs are usually stored in one of two formats: Portable Objects (.po), used primarily by GNU gettext, and XML Localisation Interchange File Format (XLIFF), a more generic OASIS open standard.

These formats can be converted to each other, and to and from many others, using translate-toolkit.

XLIFF is quite flexible and can be used in different ways, but this library focuses primarily on using it in a way gettext and translate-toolkit work, namely with separate catalogue for each language.

Example:

use poreader::PoParser;

use std::{env::args, fs::File, io::Result};

fn main() -> Result<()> {
    // Filename
    let filename = match args().skip(1).next() {
        Some(v) => v,
        None => {
            eprintln!("No file specified");

            return Ok(());
        }
    };

    // Open a file
    let file = File::open(filename)?;

    // Create PO parser
    let parser = PoParser::new();

    // Create PO reader
    let reader = parser.parse(file)?;

    // Read PO file by iterating on units
    for unit in reader {
        let unit = unit?;

        // Show `msgid`
        println!(" - {}", unit.message().get_id())
    }

    Ok(())
}