#gettext

polib

Read, manipulate and store translation data in GNU gettext PO format

2 unstable releases

0.2.0 Mar 11, 2023
0.1.0 Jan 20, 2022
0.0.1 Jan 15, 2022

#132 in Internationalization (i18n)

Download history 1592/week @ 2023-10-20 1039/week @ 2023-10-27 1013/week @ 2023-11-03 1838/week @ 2023-11-10 1665/week @ 2023-11-17 1040/week @ 2023-11-24 1186/week @ 2023-12-01 1086/week @ 2023-12-08 1122/week @ 2023-12-15 675/week @ 2023-12-22 1161/week @ 2023-12-29 1957/week @ 2024-01-05 1328/week @ 2024-01-12 1389/week @ 2024-01-19 1364/week @ 2024-01-26 1350/week @ 2024-02-02

5,605 downloads per month
Used in 4 crates

MIT license

62KB
1.5K SLoC

polib

crates.io License: MIT GitHub Actions

A Rust library to read, manipulate and write GNU gettext translation data in .po format.

Basic Concepts

A Message represents a translation of a text entry from the source language to a target language.

A Catalog holds a collection of Messages, and is stored in a .po file.

Example

Iterate over messages in a .po file

use polib::po_file;
use std::error::Error;
use std::path::Path;

fn main() -> Result<(), Box<dyn Error>> {
    let catalog = po_file::parse(Path::new("foo.po"))?;
    for message in catalog.messages() {
        if message.is_translated() {
            if message.is_singular() {
                println!("{} => {}", message.msgid(), message.msgstr()?);
            } else { // message.is_plural()
                println!("{} => {}", message.msgid(), message.msgstr_plural()?.join(", "));
            }
        } else {
            println!("{} is untranslated", message.msgid());
        }
    }
    Ok(())
}

Remove untranslated or fuzzy entries and save to another .po file

let mut catalog = po_file::parse(Path::new(&input_file))?;
let mut filtered: usize = 0;
for mut message in catalog.messages_mut() {
    if !message.is_translated() || message.is_fuzzy() {
        message.delete();
        filtered += 1;
    }
}
po_file::write(&catalog, Path::new(&output_file))?;
println!("{} untranslated or fuzzy translations removed.", filtered);

Fill in missing translations from some other translation service

let mut catalog = po_file::parse(Path::new(&input_file))?;
for mut message in catalog.messages_mut() {
    if !message.is_translated() {
        if message.is_singular() {
            message.set_msgstr(/* some 3rdparty provided */translate(message.msgid()))?;
        }
    }
}
po_file::write(&catalog, Path::new(&output_file))?;

Compile a .po file to .mo format

mo_file::compile_from_po(Path::new(&input), Path::new(&output))?;

Documentation

Refer to docs.rs.

Dependencies

~190–335KB