3 stable releases
1.1.1 | Mar 24, 2022 |
---|---|
1.1.0 |
|
1.0.6 | Jan 20, 2022 |
1.0.5 | Dec 1, 2021 |
#49 in Internationalization (i18n)
63 downloads per month
Used in 3 crates
175KB
4K
SLoC
poreader
Rust library for reading translation catalogs in Uniforum/Gettext PO. Similar to the translate.storage package in Python Translate Toolkit.
Only PO and Xliff are planned to be supported. For anything else, just convert it with Translate Toolkit. There is no point in replacing that excellent library; the main reason for Rust parser and writer is to them as part of build process of Rust programs, especially in procedural macros, which need to be written in Rust.
Documentation
On Docs.rs.
Installation
It uses Cargo, Rust's package manager. You can depend on this library by adding poreader
to your Cargo dependencies:
[dependencies]
poreader = "~1.1"
Or, to use the Git repo directly:
[dependencies.poreader]
git = "https://github.com/corebreaker/poreader.git"
How to use
Start by creating a PO reader from a new PO parser, then iterate on the reader:
use poreader::PoParser;
use std::{env::args, fs::File, io::{Result, Error, ErrorKind}};
struct NoArg;
impl std::error::Error for NoArg {}
impl std::fmt::Display for NoArg {
fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result { std::fmt::Debug::fmt(self, f) }
}
impl std::fmt::Debug for NoArg {
fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result { write!(f, "No file specified") }
}
fn main() -> Result<()> {
// Filename
let filename = match args().skip(1).next() {
Some(v) => v,
None => { return Err(Error::new(ErrorKind::Other, NoArg)); }
};
// 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(())
}
Dependencies
~1–2.3MB
~56K SLoC