releases-comm-central/third_party/python/fluent.migratetb
Rob Lemley 51ba018f34 Bug 1885663 - Update vendored copy of fluent.migratetb to v0.13.0.1. r=dandarnell
Differential Revision: https://phabricator.services.mozilla.com/D204822

--HG--
extra : moz-landing-system : lando
2024-03-21 22:02:52 +00:00
..
fluent Bug 1885663 - Update vendored copy of fluent.migratetb to v0.13.0.1. r=dandarnell 2024-03-21 22:02:52 +00:00
fluent.migratetb.egg-info Bug 1885663 - Update vendored copy of fluent.migratetb to v0.13.0.1. r=dandarnell 2024-03-21 22:02:52 +00:00
LICENSE Bug 1816956 - Vendor tb-fluent-migrate into comm/third_party/python. r=dandarnell 2023-03-25 20:17:12 +11:00
PKG-INFO Bug 1885663 - Update vendored copy of fluent.migratetb to v0.13.0.1. r=dandarnell 2024-03-21 22:02:52 +00:00
README.md Bug 1816956 - Vendor tb-fluent-migrate into comm/third_party/python. r=dandarnell 2023-03-25 20:17:12 +11:00
moz.yaml Bug 1885663 - Update vendored copy of fluent.migratetb to v0.13.0.1. r=dandarnell 2024-03-21 22:02:52 +00:00
setup.cfg Bug 1816956 - Vendor tb-fluent-migrate into comm/third_party/python. r=dandarnell 2023-03-25 20:17:12 +11:00
setup.py Bug 1885663 - Update vendored copy of fluent.migratetb to v0.13.0.1. r=dandarnell 2024-03-21 22:02:52 +00:00

README.md

Fluent Migration Tools - Thunderbird Fork

Programmatically create Fluent files from existing content in both legacy and Fluent formats. Use recipes written in Python to migrate content for each of your localizations.

This is a fork for performing Thunderbird string migrations. Usage is slightly different than upsteam due to the use of a monorepo.

migrate-l10n is a CLI script which uses the fluent.migrate module under the hood to run migrations on existing translations.

validate-l10n-recipe is a CLI script to test a migration recipe for common errors, without trying to apply it.

Installation

  • Clone this repo somewhere

  • pip install "/tb-fluent-migrate[hg]"

Alternatively, install right from the repo:

Usage

Migrations consist of recipes, which are applied to a localization repository, based on template files. You can find recipes for Thunderbird in comm-central/python/l10n/tb_fluent_migrations/, the reference repository is comm-strings-quarantine or quarantine. You apply those migrations to l10n repositories in comm-l10n.

The migrations are run as python modules, so you need to have their file location in PYTHONPATH.

An example would look like

$ migrate-l10n --locale it --reference-dir comm-strings-quarantine --localization-dir comm-l10n bug_1802387_langpack_defines

Upstream

https://hg.mozilla.org/l10n/fluent-migration/