Use Babel to compile catalogues via tox.ini

Author: hugovk

.github/CONTRIBUTING.md

@@ -17,14 +17,19 @@ tox -e py -- tests/test_number.py
 tox -e py -- tests/test_number.py -k intcomma
 ```
 
-Some localisation tests are skipped when compiled `.mo` translation files are missing.
-Generate them with `scripts/generate-translation-binaries.sh`, which requires Bash and
-GNU gettext's `msgfmt`. Translation-update tests also require `xgettext` and `msgmerge`.
-Use `tox -e py -- -rs` to see skip reasons.
-
-CI generates translation binaries and runs the
-[configured tox environments](../tox.ini). See the [test workflow](workflows/test.yml)
-for supported Python versions and platforms.
+The tox test environments compile the `.mo` translation binaries from the `.po` catalogs
+before running the tests. When running `pytest` directly, some localisation tests are
+skipped if the `.mo` files are missing. Generate them with:
+
+```sh
+tox -e compile-translations
+```
+
+Translation-update tests also require GNU gettext's `xgettext` and `msgmerge`. Use
+`tox -e py -- -rs` to see skip reasons.
+
+CI runs the [configured tox environments](../tox.ini). See the
+[test workflow](workflows/test.yml) for supported Python versions and platforms.
 
 ## Linting
 

.github/workflows/actions.lock

@@ -6,6 +6,7 @@ workflows:
     '.github/workflows/benchmark.yml':
         - 'actions/checkout@v7.0.1'
         - 'actions/setup-python@v7.1.0'
+        - 'astral-sh/setup-uv@v10.3.2'
         - 'codspeedhq/action@v5.6.0'
     '.github/workflows/docs.yml':
         - 'actions/checkout@v7.0.1'
@@ -28,6 +29,7 @@ workflows:
     '.github/workflows/release.yml':
         - 'actions/checkout@v7.0.1'
         - 'actions/download-artifact@v8.0.2'
+        - 'astral-sh/setup-uv@v10.3.2'
         - 'hynek/build-and-inspect-python-package@v3.0.2'
         - 'pypa/gh-action-pypi-publish@v1.14.3'
     '.github/workflows/require-pr-label.yml':

.github/workflows/benchmark.yml

@@ -22,13 +22,12 @@ jobs:
           python-version: "3.15"
           allow-prereleases: true
 
-      - name: Install gettext
-        run: |
-          sudo apt install gettext
+      - name: Install uv
+        uses: astral-sh/setup-uv@v10.3.2
 
-      - name: Generate translation binaries
+      - name: Compile translations
         run: |
-          scripts/generate-translation-binaries.sh
+          uvx --with tox-uv tox -e compile-translations
 
       - name: Install dependencies
         run: pip install -e ".[tests]"

.github/workflows/release.yml

@@ -28,13 +28,12 @@ jobs:
           fetch-depth: 0
           persist-credentials: false
 
-      - name: Install gettext
-        run: |
-          sudo apt install gettext
+      - name: Install uv
+        uses: astral-sh/setup-uv@v10.3.2
 
-      - name: Generate translation binaries
+      - name: Compile translations
         run: |
-          scripts/generate-translation-binaries.sh
+          uvx --with tox-uv tox -e compile-translations
 
       - uses: hynek/build-and-inspect-python-package@v3.0.2
 

.github/workflows/test.yml

@@ -42,23 +42,9 @@ jobs:
         run: |
           echo "PYTHON_GIL=0" >> "$GITHUB_ENV"
 
-      - name: Install Linux dependencies
-        if: startsWith(matrix.os, 'ubuntu')
-        run: |
-          sudo apt install gettext
-
-      - name: Install macOS dependencies
-        if: startsWith(matrix.os, 'macos')
-        run: |
-          brew install gettext
-
       - name: Install uv
         uses: astral-sh/setup-uv@v10.3.2
 
-      - name: Generate translation binaries
-        run: |
-          scripts/generate-translation-binaries.sh
-
       - name: Tox tests
         run: |
           uvx --python ${{ matrix.python-version }} --with tox-uv tox -e py

scripts/generate-translation-binaries.sh

@@ -12,7 +12,7 @@ msgstr ""
 "PO-Revision-Date: 2026-04-07 22:42+0300\n"
 "Last-Translator: AYMENJD <let.me.code.safe@gmail.com>\n"
 "Language-Team: Arabic <let.me.code.safe@gmail.com>\n"
-"Language: Arabic (عربي)\n"
+"Language: ar\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"

src/humanize/locale/ar/LC_MESSAGES/humanize.po

@@ -3,7 +3,6 @@
 # This file is distributed under the same license as the PACKAGE package.
 # Jose Riha <jose1711 gmail com>, 2016.
 #
-#, fuzzy
 msgid ""
 msgstr ""
 "Project-Id-Version: humanize\n"
@@ -12,7 +11,7 @@ msgstr ""
 "PO-Revision-Date: 2020-09-29 22:43+0300\n"
 "Last-Translator: Jose Riha <jose1711 gmail com>\n"
 "Language-Team: sk <LL@li.org>\n"
-"Language: Slovak\n"
+"Language: sk\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"

src/humanize/locale/sk_SK/LC_MESSAGES/humanize.po

@@ -3,7 +3,7 @@ msgstr ""
 "Project-Id-Version: PROJECT VERSION\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2026-11-12 12:11+0200\n"
-"PO-Revision-Date: \n"
+"PO-Revision-Date: 2020-03-22 15:17+0200\n"
 "Last-Translator: TL\n"
 "Language-Team: uk_UA\n"
 "Language: uk\n"

src/humanize/locale/uk_UA/LC_MESSAGES/humanize.po

@@ -102,7 +102,7 @@ def test_i18n() -> None:
         assert humanize.naturaltime(in_three_days, when=NOW) == "3 gün sonra"
 
     except FileNotFoundError:
-        pytest.skip("Generate .mo with scripts/generate-translation-binaries.sh")
+        pytest.skip("Generate .mo with tox -e compile-translations")
 
     finally:
         humanize.i18n.deactivate()
@@ -127,7 +127,7 @@ def test_naturaltime_persian(seconds: int, expected: str) -> None:
         value = NOW + dt.timedelta(seconds=seconds)
         assert humanize.naturaltime(value, when=NOW) == expected
     except FileNotFoundError:
-        pytest.skip("Generate .mo with scripts/generate-translation-binaries.sh")
+        pytest.skip("Generate .mo with tox -e compile-translations")
     finally:
         humanize.deactivate()
 
@@ -161,7 +161,7 @@ def test_intcomma() -> None:
         assert humanize.intcomma("1.234.567,89") == "1.234.567,89"
 
     except FileNotFoundError:
-        pytest.skip("Generate .mo with scripts/generate-translation-binaries.sh")
+        pytest.skip("Generate .mo with tox -e compile-translations")
 
     finally:
         humanize.i18n.deactivate()
@@ -180,7 +180,7 @@ def test_naturaldelta() -> None:
         assert humanize.naturaldelta(seconds) == "1,234 años"
 
     except FileNotFoundError:
-        pytest.skip("Generate .mo with scripts/generate-translation-binaries.sh")
+        pytest.skip("Generate .mo with tox -e compile-translations")
 
     finally:
         humanize.i18n.deactivate()
@@ -270,7 +270,7 @@ def test_intword_i18n(locale: str, number: int, expected_result: str) -> None:
     try:
         humanize.i18n.activate(locale)
     except FileNotFoundError:
-        pytest.skip("Generate .mo with scripts/generate-translation-binaries.sh")
+        pytest.skip("Generate .mo with tox -e compile-translations")
     else:
         assert humanize.intword(number) == expected_result
     finally:
@@ -301,7 +301,7 @@ def test_naturalsize_i18n(locale: str, value: float, expected_result: str) -> No
     try:
         humanize.i18n.activate(locale)
     except FileNotFoundError:
-        pytest.skip("Generate .mo with scripts/generate-translation-binaries.sh")
+        pytest.skip("Generate .mo with tox -e compile-translations")
     else:
         assert humanize.naturalsize(value) == expected_result
     finally:
@@ -312,7 +312,7 @@ def test_naturalsize_i18n_binary() -> None:
     try:
         humanize.i18n.activate("fr_FR")
     except FileNotFoundError:
-        pytest.skip("Generate .mo with scripts/generate-translation-binaries.sh")
+        pytest.skip("Generate .mo with tox -e compile-translations")
     else:
         assert humanize.naturalsize(3000, binary=True) == "2.9 Kio"
     finally:
@@ -334,7 +334,7 @@ def test_naturaldelta_one_year_i18n(
     try:
         humanize.i18n.activate(locale)
     except FileNotFoundError:
-        pytest.skip("Generate .mo with scripts/generate-translation-binaries.sh")
+        pytest.skip("Generate .mo with tox -e compile-translations")
     else:
         assert humanize.naturaldelta(dt.timedelta(days=days)) == expected_result
     finally:
@@ -357,7 +357,7 @@ def test_langauge_codes(locale: str, expected_result: str) -> None:
     try:
         humanize.i18n.activate(locale)
     except FileNotFoundError:
-        pytest.skip("Generate .mo with scripts/generate-translation-binaries.sh")
+        pytest.skip("Generate .mo with tox -e compile-translations")
     else:
         assert humanize.ordinal(5) == expected_result
     finally:
@@ -382,7 +382,7 @@ def test_ordinal_genders(
     try:
         humanize.i18n.activate(locale)
     except FileNotFoundError:
-        pytest.skip("Generate .mo with scripts/generate-translation-binaries.sh")
+        pytest.skip("Generate .mo with tox -e compile-translations")
     else:
         assert humanize.ordinal(number, gender=gender) == expected_result
     finally:
@@ -455,7 +455,7 @@ def test_none_locale(self) -> None:
             test_str = humanize.naturaltime(three_seconds)
             assert test_str == "3 seconds ago"
         except FileNotFoundError:
-            pytest.skip("Generate .mo with scripts/generate-translation-binaries.sh")
+            pytest.skip("Generate .mo with tox -e compile-translations")
 
         finally:
             humanize.i18n.deactivate()
@@ -472,6 +472,6 @@ def test_intword_unit_has_no_format_placeholder(locale: str) -> None:
         for value in (1_000, 1_000_000, 1_000_000_000, 10**12, 10**15, 10**100):
             assert "%" not in humanize.intword(value)
     except FileNotFoundError:
-        pytest.skip("Generate .mo with scripts/generate-translation-binaries.sh")
+        pytest.skip("Generate .mo with tox -e compile-translations")
     finally:
         humanize.i18n.deactivate()