summaryrefslogtreecommitdiffstats
path: root/comm/third_party/python/fluent.migratetb/PKG-INFO
diff options
context:
space:
mode:
Diffstat (limited to 'comm/third_party/python/fluent.migratetb/PKG-INFO')
-rw-r--r--comm/third_party/python/fluent.migratetb/PKG-INFO61
1 files changed, 61 insertions, 0 deletions
diff --git a/comm/third_party/python/fluent.migratetb/PKG-INFO b/comm/third_party/python/fluent.migratetb/PKG-INFO
new file mode 100644
index 0000000000..a717c518eb
--- /dev/null
+++ b/comm/third_party/python/fluent.migratetb/PKG-INFO
@@ -0,0 +1,61 @@
+Metadata-Version: 2.1
+Name: fluent.migratetb
+Version: 0.11.2
+Summary: Toolchain to migrate legacy translation to Fluent. (Thunderbird fork)
+Home-page: https://github.com/jfx2006/tb-fluent-migrate/
+Author: Mozilla
+Author-email: l10n-drivers@mozilla.org
+License: APL 2
+Keywords: fluent,localization,l10n
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3.7
+Description-Content-Type: text/markdown
+Provides-Extra: hg
+License-File: LICENSE
+
+# 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:
+
+- pip install "fluent.migrate[hg] @ git+https://github.com/jfx2006/tb-fluent-migrate"
+
+
+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
+--------
+https://hg.mozilla.org/l10n/fluent-migration/