Crate patois_build

Expand description

Gettext tooling for apps that use patois. Call it from a build script or an xtask.

gen_pot and gen_pot_from_dirs extract strings from Rust source into a .pot template.
extend_pot_from_source_dirs and prune_pot_from_source_dirs keep the strings of Swift and Kotlin source in the same template.
compile_translations compiles .po catalogs to the .mo files that an app embeds.
gen_ios_strings and gen_android_strings generate translation assets for mobile apps.
check and lint find translation mistakes in catalogs and source code.
credits reads the names of translators from the catalogs.
po edits a .po file and leaves the lines it doesn’t change as they were.

Modules§

check: Checks that a translation kept the parts of its source that aren’t prose: the placeholders, the accelerator, the shortcut suffix, and all the plural forms.
credits: Translator credits from the Last-Translator headers of the .po files, so an app credits a new translator in the same commit that adds their language.
lint: Checks that catch translation mistakes nothing else reports.
po: Edits .po files in place.

compile_translations: Compiles each .po file in po_dir to <locale_dir>/<lang>/LC_MESSAGES/<domain>.mo, where <domain> is the name of the crate.
extend_pot_from_source_dirs: Adds the strings of t("...") and nt("...", "...", n) calls in other languages to an existing .pot file.
gen_android_strings: Writes the translated strings of each <lang>.po in po_dir to <assets_dir>/translations/<lang>.json, as an object that maps each msgid to its translation.
gen_ios_strings: Writes the translated strings of each <lang>.po in po_dir to <ios_dir>/<lang>.lproj/Localizable.strings.
gen_pot: Regenerates <po_dir>/<package_name>.pot from every package with [package.metadata.patois] translatable = true, including dependencies.
gen_pot_from_dirs: Regenerates <po_dir>/<package_name>.pot from the Rust files in source_dirs.
prune_pot_from_source_dirs: Removes the entries that extend_pot_from_source_dirs added whose strings are no longer in the sources, and returns those strings.