Fluent Migration Tools
======================
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.
`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
------------
Install from PyPI:
pip install fluent.migrate[hg]
If you only want to use the `MigrationContext` API, you can drop the
requirement on `python-hglib`:
pip install fluent.migrate
Usage
-----
Migrations consist of _recipes_, which are applied to a _localization repository_, based on _template files_.
You can find recipes for Firefox in `mozilla-central/python/l10n/fluent_migrations/`,
the reference repository is [gecko-strings](https://hg.mozilla.org/l10n/gecko-strings/) or _quarantine_.
You apply those migrations to l10n repositories in [l10n-central](https://hg.mozilla.org/l10n-central/), or to `gecko-strings` for testing.
The migrations are run as python modules, so you need to have their file location in `PYTHONPATH`.
An example would look like
$ migrate-l10n --lang it --reference-dir gecko-strings --localization-dir l10n-central/it bug_1451992_preferences_sitedata bug_1451992_preferences_translation
Raw data
{
"_id": null,
"home_page": "https://github.com/mozilla/fluent-migrate",
"name": "fluent.migrate",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "fluent, localization, l10n",
"author": "Mozilla",
"author_email": "l10n-drivers@mozilla.org",
"download_url": "https://files.pythonhosted.org/packages/7a/f6/7a29278222a9ae897aff40bff79ae05cf3b966766664da1b48d89533ba7b/fluent_migrate-0.13.2.tar.gz",
"platform": null,
"description": "Fluent Migration Tools\n======================\n\nProgrammatically create Fluent files from existing content in both legacy\nand Fluent formats. Use recipes written in Python to migrate content for each\nof your localizations.\n\n`migrate-l10n` is a CLI script which uses the `fluent.migrate` module under\nthe hood to run migrations on existing translations.\n\n`validate-l10n-recipe` is a CLI script to test a migration recipe for common\nerrors, without trying to apply it.\n\nInstallation\n------------\n\nInstall from PyPI:\n\n pip install fluent.migrate[hg]\n\nIf you only want to use the `MigrationContext` API, you can drop the\nrequirement on `python-hglib`:\n\n pip install fluent.migrate\n\nUsage\n-----\n\nMigrations consist of _recipes_, which are applied to a _localization repository_, based on _template files_.\nYou can find recipes for Firefox in `mozilla-central/python/l10n/fluent_migrations/`,\nthe reference repository is [gecko-strings](https://hg.mozilla.org/l10n/gecko-strings/) or _quarantine_.\nYou apply those migrations to l10n repositories in [l10n-central](https://hg.mozilla.org/l10n-central/), or to `gecko-strings` for testing.\n\nThe migrations are run as python modules, so you need to have their file location in `PYTHONPATH`.\n\nAn example would look like\n\n $ migrate-l10n --lang it --reference-dir gecko-strings --localization-dir l10n-central/it bug_1451992_preferences_sitedata bug_1451992_preferences_translation\n",
"bugtrack_url": null,
"license": "APL 2",
"summary": "Toolchain to migrate legacy translation to Fluent.",
"version": "0.13.2",
"project_urls": {
"Homepage": "https://github.com/mozilla/fluent-migrate"
},
"split_keywords": [
"fluent",
" localization",
" l10n"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1b7eb3be10829760e6050eb3aa10a4e51734541086efb7bf6f16851451640dfd",
"md5": "98a79557a300bef1730b12f7b19c2e5b",
"sha256": "77a361b4ff874af5c8134f2f73631c946e40527d9108ebadaeb823b97debf650"
},
"downloads": -1,
"filename": "fluent.migrate-0.13.2-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "98a79557a300bef1730b12f7b19c2e5b",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 29347,
"upload_time": "2024-11-19T11:21:10",
"upload_time_iso_8601": "2024-11-19T11:21:10.863143Z",
"url": "https://files.pythonhosted.org/packages/1b/7e/b3be10829760e6050eb3aa10a4e51734541086efb7bf6f16851451640dfd/fluent.migrate-0.13.2-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "7af67a29278222a9ae897aff40bff79ae05cf3b966766664da1b48d89533ba7b",
"md5": "d769b72c6101866efbeb72acb259590b",
"sha256": "e69bb4fde0a071e9edfecf371680ed719b451cff3ba2ecf6c32ccf9b29fffbaa"
},
"downloads": -1,
"filename": "fluent_migrate-0.13.2.tar.gz",
"has_sig": false,
"md5_digest": "d769b72c6101866efbeb72acb259590b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 24978,
"upload_time": "2024-11-19T11:21:12",
"upload_time_iso_8601": "2024-11-19T11:21:12.767822Z",
"url": "https://files.pythonhosted.org/packages/7a/f6/7a29278222a9ae897aff40bff79ae05cf3b966766664da1b48d89533ba7b/fluent_migrate-0.13.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-19 11:21:12",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mozilla",
"github_project": "fluent-migrate",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "fluent.migrate"
}
JSON
