Verifique traduções a partir de Make ou scripts npm

Makefile

Instale o verificador uma vez com pip install kaeris. A linha da receita começa com um tab. Fazer test depender de i18n-check executa a verificação antes dos testes.

.PHONY: i18n-check test

i18n-check:
	kaeris check --source locales/en.json --langs de,fr --ci

test: i18n-check
	./run-tests.sh

scripts do npm

O script apenas chama kaeris do seu PATH, então o verificador é o pacote Python do pip install kaeris. pretest roda antes do test e o interrompe se a verificação falhar.

{
  "scripts": {
    "i18n:check": "kaeris check --source locales/en.json --langs de,fr --ci",
    "pretest": "npm run i18n:check",
    "test": "jest"
  }
}

npm test

Saída do npm test com os scripts acima (o script test foi echo nesta execução). À esquerda: arquivos corretos. À direita: de.json com {nam} em vez de {name} e a chave checkout ausente; npm para antes do test.

$ npm test

> [email protected] pretest
> npm run i18n:check


> [email protected] i18n:check
> kaeris check --source locales/en.json --langs de,fr --ci

✓ de: complete & placeholder-safe
✓ fr: complete & placeholder-safe
✓ all locales complete & placeholder-safe

> [email protected] test
> echo tests would run here

tests would run here
exit code: 0

$ npm test

> [email protected] pretest
> npm run i18n:check


> [email protected] i18n:check
> 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
exit code: 1

A linha da receita no Makefile

O mesmo comando que o alvo i18n-check executa, e seu código de saída.

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

$ 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
exit code: 1

1. Instale o verificador

   Execute pip install kaeris na máquina ou na imagem CI que roda seus testes.

2. Adicione o alvo ou script

   Adicione o alvo i18n-check ao Makefile ou os scripts i18n:check e pretest ao package.json, com seu próprio --source e --langs.

3. Execute seu comando usual

   make test ou npm test agora executam a verificação primeiro e param com código de saída diferente de zero quando uma tradução está quebrada.

• O que foi executado

  npm test com os scripts acima, exceto que test foi um echo (npm 11.17, Node 24), e kaeris 0.2.35 do PyPI no PATH. Arquivos limpos: código de saída 0, testes executados. de.json com erro: código de saída 1, testes não executados.

• O que não foi executado

  make não está instalado na máquina onde isso foi verificado. A linha da receita foi executada pelo shell, que é o que o make faz, então o código de saída acima é real, mas o Makefile em si não foi executado pelo make.

• npm

  Ainda não existe pacote kaeris no registro npm, então esta página não direciona para o npm. Projetos Node chamam o pacote Python, como acima.

• Falhar também em chaves obsoletas

  --strict também falha quando uma tradução tem chaves que a fonte não possui mais.

• Mantenha nomes de marcas como estão

  --glossary 'KAERIS,GitHub' falha se um termo for removido no destino. A mesma lista pode ficar em keep no kaeris.json.

• Layout de arquivo diferente

  --out é a pasta com as traduções e --pattern '{lang}/common.json' seus nomes de arquivo. Padrão: o layout que kaeris translate gera.

• Sem flags

  Com um kaeris.json no projeto (kaeris init cria um), kaeris check usa a fonte, idiomas e pasta definidos nele.

Outras receitas: GitHub Actions · GitLab CI · pre-commit

Referência CLI · Referência Check · Referência GitHub Action · Check gratuito no navegador · Traduzir no navegador