Перевіряйте переклади в GitLab CI

Завдання

Додайте його до .gitlab-ci.yml. Змініть --source на файл вашої базової мови та --langs на локалі, які ви постачаєте. Блок rules запускає завдання лише для merge request, які змінюють щось у locales/; видаліть рядки changes, щоб запускати його для кожного merge request.

i18n-check:
  stage: test
  image: python:3.12-slim
  rules:
    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
      changes:
        - locales/**/*
  script:
    - pip install kaeris
    - kaeris check --source locales/en.json --langs de,fr --ci

Що друкує завдання

Два рядки script, виконані послідовно. Зліва: файли, які в порядку. Справа: de.json з {nam} замість {name} та відсутнім ключем checkout; завдання зупиняється з кодом виходу 1.

$ pip install kaeris
Collecting kaeris
  Using cached kaeris-0.2.35-py3-none-any.whl.metadata (26 kB)
Using cached kaeris-0.2.35-py3-none-any.whl (131 kB)
Installing collected packages: kaeris
Successfully installed kaeris-0.2.35

$ kaeris check --source locales/en.json --langs de,fr --ci
✓ de: complete & placeholder-safe
✓ fr: complete & placeholder-safe
✓ all locales complete & placeholder-safe
Job succeeded
exit code: 0

$ pip install kaeris
Requirement already satisfied: kaeris in C:\Users\Inzagi\AppData\Local\Temp\claude\C--Users-Inzagi-projects-kaeris\bfeebe69-3cfd-4f28-bbe7-e5600be082b9\scratchpad\venv-gl2\Lib\site-packages (0.2.35)

$ kaeris check --source locales/en.json --langs de,fr --ci
✗ de: 1 missing key(s): checkout
✗ de: 1 placeholder mismatch(es):
    greeting: missing ['{name}'], added ['{nam}']
✗ de: 2 translation fault(s):
    greeting: lost placeholder {name}
    greeting: invented placeholder {nam} (not in source)
✓ fr: complete & placeholder-safe
✗ 1 missing key, 1 placeholder mismatch, 2 translation faults
ERROR: Job failed: exit code 1
exit code: 1

1. Додайте завдання

   Вставте завдання до .gitlab-ci.yml та встановіть власні --source і --langs.

2. Відкрийте запит на злиття

   Змініть файл локалі у гілці та відкрийте запит на злиття. Завдання виконається і покаже всі знайдені проблеми у своєму журналі.

3. Вимагайте конвеєр

   У налаштуваннях проєкту в розділі запитів на злиття увімкніть, що конвеєри мають бути успішними. Червоне завдання тоді блокуватиме злиття.

• Що виконалося

  Обидва рядки script, взяті з розібраного YAML та виконані один за одним у чистому віртуальному середовищі Python, зупиняючись на першому невдалому рядку, як це робить завдання GitLab. pip install kaeris завантажив kaeris 0.2.35 з PyPI. Чисті файли: код виходу 0. Пошкоджений de.json: код виходу 1.

• Що не виконалося

  Не використовувався жоден засіб запуску GitLab або образ Docker (наведений вище журнал походить з ПК з Windows та Python 3.14, а не з python:3.12-slim). Блок rules та changes був лише розібраний як YAML; GitLab його не оцінював. Пакет вимагає Python 3.8 або новішої версії.

• Помилка також на застарілих ключах

  --strict також призводить до помилки, коли переклад містить ключі, яких більше немає у вихідному файлі.

• Зберігайте назви брендів як написано

  --glossary 'KAERIS,GitHub' призведе до помилки цільового файлу, який пропустив один із термінів. Той самий список може бути в keep у kaeris.json.

• Інший макет файлів

  --out — це папка з перекладами, а --pattern '{lang}/common.json' — їхні імена файлів. За замовчуванням: макет, який створює kaeris translate.

• Жодних прапорців

  За наявності файлу kaeris.json у проєкті (його записує kaeris init), kaeris check бере вихідний файл, мови та папку з нього.

Інші рецепти: GitHub Actions · pre-commit · Make та npm скрипти

Довідник CLI · Довідник Check · Довідник GitHub Action · Безкоштовна перевірка в браузері · Переклад у браузері