Skip to content

Fluent migrations for comm-central

License

Notifications You must be signed in to change notification settings

jfx2006/tb-fluent-migrate

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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/