Revision control
Copy as Markdown
Other Tools
Metadata-Version: 2.1
Name: fluent.migratetb
Version: 0.13.1.2
Summary: Toolchain to migrate legacy translation to Fluent. (Thunderbird fork)
Author: Mozilla
Author-email: tb-builds@thunderbird.net
License: APL 2
Keywords: fluent,localization,l10n
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: compare-locales<10.0,>=9.0.1
Requires-Dist: fluent.syntax<0.20,>=0.19.0
Provides-Extra: hg
Requires-Dist: python-hglib; extra == "hg"
# 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 "<path-to->/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](https://hg.mozilla.org/projects/comm-strings-quarantine/) or _quarantine_.
You apply those migrations to l10n repositories in [comm-l10n](https://hg.mozilla.org/projects/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
--------