Skip to main content

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 or quarantine. You apply those migrations to l10n repositories in 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

Metadata

Release files for fluent.migrate 0.13.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for fluent.migrate 0.13.3
File Size Uploaded
fluent_migrate-0.13.3.tar.gz 24.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for fluent.migrate 0.13.3
File Interpreter ABI Platform
fluent.migrate-0.13.3-py2.py3-none-any.whl Python 2, Python 3 none any Details

Total release size: 53.8 kB

Release files / fluent_migrate-0.13.3.tar.gz

Download URL fluent_migrate-0.13.3.tar.gz
Size 24.9 kB
Tags Source
SHA-256 checksum
How to use checksums
dafb8c7a4024e46aa2de359db7265f49fb4fb593fdb1d61b6b014a1a9f16ad5c
BLAKE2b-256 checksum
How to use checksums
4a70b3538bbabff88436510fc9c5825a1ee95ca154f26bf6b3ac19fc324e61d6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.5.21

Release files / fluent.migrate-0.13.3-py2.py3-none-any.whl

Download URL fluent.migrate-0.13.3-py2.py3-none-any.whl
Size 28.9 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
a190d5e76ea4a47061821d3688fb7eb9075916ab1439d838e2a54fe62305b80f
BLAKE2b-256 checksum
How to use checksums
ce98d12595cca26573b658e4b150ed0ab70cdacb120361576f7d1d15cae516a4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.5.21

Release history Release notifications | RSS feed

This release

0.13.3 This release

2 release files

0.13.2

2 release files

0.12.0

2 release files

0.11

1 release file

0.10

2 release files

0.9

2 release files

0.8.1

2 release files

0.8.0

2 release files

0.7.1

2 release files

0.7.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page