i18n-tasks

# i18n-tasks [![Build Status][badge-ci]][ci] [![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/glebm/i18n-tasks?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

[![Stand With Ukraine](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/banner2-direct.svg)](https://stand-with-ukraine.pp.ua/)

i18n-tasks helps you find and manage missing and unused translations.

<img width="539" height="331" src="https://i.imgur.com/XZBd8l7.png">

This gem analyses code statically for key usages, such as `I18n.t('some.key')`, in order to:

- Report keys that are missing or unused.
- Pre-fill missing keys, optionally from Google Translate or DeepL (Pro or Free).
- Remove unused keys.

Thus addressing the two main problems of [i18n gem][i18n-gem] design:

- Missing keys only blow up at runtime.
- Keys no longer in use may accumulate and introduce overhead, without you knowing it.

## Table of Contents

- [Quick Start](#quick-start)
- [Commands](#commands)
  - [Check health](#check-health)
  - [Find usages](#find-usages)
  - [Add missing keys](#add-missing-keys)
  - [Translate missing keys](#translate-missing-keys)
  - [Remove unused keys](#remove-unused-keys)
  - [Prune](#prune)
  - [Normalize](#normalize)
  - [Move / rename / merge keys](#move--rename--merge-keys)
  - [Delete keys](#delete-keys)
  - [Compose tasks](#compose-tasks)
- [Configuration](#configuration)
  - [Locales](#locales)
  - [Storage & locale files](#storage--locale-files)
    - [Pattern router](#pattern-router)
    - [Conservative router](#conservative-router)
    - [Isolating router](#isolating-router)
    - [Key pattern syntax](#key-pattern-syntax)
    - [Custom adapters](#custom-adapters)
    - [Rails credentials](#rails-credentials)
  - [Usage search](#usage-search)
    - [Prism-based scanner](#prism-based-scanner)
  - [Fine-tuning](#fine-tuning)
  - [Environment variables & dotenv](#environment-variables--dotenv)
- [Translation backends](#translation-backends)
  - [Google Translate](#google-translate)
  - [DeepL](#deepl)
  - [Yandex](#yandex)
  - [OpenAI](#openai)
  - [watsonx](#watsonx)
- [Features & limitations](#features--limitations)
  - [Relative keys](#relative-keys)
  - [Plural keys](#plural-keys)
  - [Reference keys](#reference-keys)
  - [Dynamic keys](#dynamic-keys)
  - [I18n.localize](#i18nlocalize)
  - [`t()` keyword arguments](#t-keyword-arguments)
  - [Unexpected normalization](#unexpected-normalization)
- [Advanced](#advanced)
  - [Interactive console](#interactive-console)
  - [CSV import / export](#csv-import--export)
  - [Add custom tasks](#add-custom-tasks)
- [Development](#development)

## Quick Start

i18n-tasks can be used with any project using the ruby [i18n gem][i18n-gem] (default in Rails).

1. Add to your `Gemfile`:

   ```ruby
   gem 'i18n-tasks', '~> 1.2.0', group: :development
   ```

2. Copy the default [configuration file](#configuration):

   ```sh
   $ cp $(bundle exec i18n-tasks gem-path)/templa