https://github.com/brettdong/polib
A Rust library for loading translation data in GNU gettext PO format.
https://github.com/brettdong/polib
gettext i18n rust
Last synced: 3 months ago
JSON representation
A Rust library for loading translation data in GNU gettext PO format.
- Host: GitHub
- URL: https://github.com/brettdong/polib
- Owner: BrettDong
- License: mit
- Created: 2022-01-08T11:19:23.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2025-05-02T12:04:43.000Z (about 1 year ago)
- Last Synced: 2025-05-02T13:23:02.323Z (about 1 year ago)
- Topics: gettext, i18n, rust
- Language: Rust
- Homepage: https://crates.io/crates/polib
- Size: 104 KB
- Stars: 11
- Watchers: 2
- Forks: 8
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# `polib`
[](https://crates.io/crates/polib)
[](https://opensource.org/licenses/MIT)
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
```rust
use polib::po_file;
use std::error::Error;
use std::path::Path;
fn main() -> Result<(), Box> {
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
```rust
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_to_file(&catalog, Path::new(&output_file))?;
println!("{} untranslated or fuzzy translations removed.", filtered);
```
### Fill in missing translations from some other translation service
```rust
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_to_file(&catalog, Path::new(&output_file))?;
```
### Compile a `.po` file to `.mo` format
```rust
mo_file::compile_from_po(Path::new(&input), Path::new(&output))?;
```
## Documentation
Refer to [docs.rs](https://docs.rs/polib).