i18nize 0.5 → 0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 592b298cbac45e06745596fe3b02025797d39f572214e2dd345ef6f9d39abe33
-  data.tar.gz: a661e6474225964f79d6d80a38c23f91d531e6c6c58b5c52e3b7b11de211d652
+  metadata.gz: ed1bfd2cff604aa20337cfd2e87dd47985ab66d470ee13fa1241378e8c7613d2
+  data.tar.gz: 8e2a54ea7acb3ff57233944f81648f8243f732768278cd77478f7bf5fed08d35
 SHA512:
-  metadata.gz: 210f54125ca483b27318abcdcb0647d947a83639d11e62ce4ca34506974d3cb0f65d2357954b81106eafd28874c64b1e774338548f48f3898d9e2fac84a1b85c
-  data.tar.gz: 21ed727606ee36a27b10ab94d7625f4b5deda616b3e4afd2fb745db7b69945b3a5688f0d6ba75d407d7fc4a82ee89eda49475c659f413c75bf03321594550ef0
+  metadata.gz: f7322c2b6b1bc505090789774f340404186be3dcaed272629b19ab914bd36af3f8c1d50cde289ce29e203c60fc3273d5a8981c11060fdbfd571d261bc96803a3
+  data.tar.gz: ff89ec4d79479de9c40855916fc0a5dfa3f87a6e300459625edcfb7928aafb54ac15faec21e3a9e68d6a8c47543d716ac53a41620496363e86c7abb5314d00e4

data/CHANGELOG.md

@@ -1,5 +1,100 @@
-## [Unreleased]
+# Changelog
 
-## [0.1.0] - 2025-07-30
+## [0.6] - 2025-09-11
+### Added
+- CLI flag `--only_blank`: fills only missing or blank keys with a placeholder  
+  (`<locale>.<full.key> missing`) instead of translating with DeepL.
+- Environment variable `I18NIZE_ALLOW_EMPTY=1`: skips keys where the source value is empty  
+  or whitespace-only, preventing them from being copied/translated.
 
-- Initial release
+### Changed
+- CLI parsing improved: `--from` can now be used **before or after** the target locale.  
+  Examples:  
+  ```bash
+  i18nize cs --from de
+  i18nize --from de cs
+````
+
+---
+
+## [0.5.0] - 2025-09-08
+### Added
+- **Conflict policy**: source locale is now treated as the source of truth.  
+  If the target locale has a scalar where a nested hash is required, the scalar is **overwritten** with the correct structure from the source.
+- **Pluralization support**: automatic handling of `one`, `other`, and related plural keys. Scalars can be coerced into plural hashes.
+- **Placeholder preservation**: `%{count}` and other I18n-style placeholders are protected from being altered by DeepL.
+- Improved file name detection for `.yml` and `.yaml` formats, including names like `app.en.yml`.
+
+### Changed
+- Default behaviour: conflicts are no longer skipped or raise errors, but are resolved by overwriting with source locale values.
+
+### Removed
+- **Rake task `i18nize:translate`** has been removed.  
+  Use the CLI instead:
+  ```bash
+  i18nize cs
+  i18nize cs --from en
+  i18nize cs --missing
+  ```
+
+### Fixed
+
+* Eliminated `IndexError: string not matched` errors when attempting to insert into scalar values.
+
+---
+
+## \[0.4.4] - 2025-09-08
+
+### Added
+
+* CLI option `--missing [FROM]` to list missing keys without translating.
+
+    * `i18nize cs --missing` → shows missing Czech keys (from English).
+    * `i18nize cs --missing de` → shows missing Czech keys (from German).
+
+---
+
+## \[0.4.2.1] - 2025-09-08
+
+### Fixed
+
+* Correct requires for `Translator` and `Inserter` inside CLI (prevented `NameError`).
+
+---
+
+## \[0.4.2] - 2025-09-08
+
+### Added
+
+* `.env` file support (via `dotenv` if present).
+* Improved CLI error messages.
+
+---
+
+## \[0.4.1] - 2025-09-08
+
+### Fixed
+
+* File path normalization for top-level locales (`en.yml` → `cs.yml`).
+* Safer regex for file name replacement.
+
+---
+
+## \[0.4.0] - 2025-08-25
+
+### Added
+
+* Standalone CLI (`i18nize <locale>`) — no need to call only via Rake.
+* Basic `--from` option for source language.
+
+---
+
+## \[0.1.0] - 2025-07-30
+
+### Added
+
+* Initial release.
+* DeepL translation of missing keys.
+* Character count estimation and confirmation prompt.
+* Automatic creation of target locale files.
+* Rake task `i18nize:translate[locale]`.

data/README.md

@@ -1,19 +1,23 @@
+
 # i18nize
 
-🧠 Automatically fills in missing I18n YAML keys using DeepL translation API.  
-Designed to streamline multi-language support in Ruby and Rails projects.
+[![CI](https://github.com/nikolas2145/i18nize/actions/workflows/main.yml/badge.svg)](https://github.com/nikolas2145/i18nize/actions/workflows/main.yml)
+[![Gem Version](https://badge.fury.io/rb/i18nize.svg)](https://badge.fury.io/rb/i18nize)
 
+🧠 Automatically fills in missing I18n YAML keys using DeepL translation API.
+Designed to streamline multi-language support in Ruby and Rails projects.
 
 ## ✨ Features
 
-- Detects missing or empty translation keys in locale files
-- Supports multiple YAML files and nested directories (e.g. `config/locales/api/en.yml`)
-- Automatically translates from a source locale (default: `en`) to a target (e.g. `cs`)
-- Integrates with DeepL API (Free or Pro)
-- Safely merges translations into corresponding `*.yml` files
-- Includes character count check with confirmation
-- CLI via Rake task
-
+* Detects missing or empty translation keys in locale files
+* Supports multiple YAML files and nested directories (e.g. `config/locales/api/en.yml`)
+* Automatically translates from a source locale (**default: `en`**) to a target (e.g. `cs`)
+* **Placeholder mode** to fill only blank/missing keys without DeepL (`--only_blank`)
+* Integrates with DeepL API (Free or Pro)
+* Safely merges translations into corresponding `*.yml` files
+* Handles structural conflicts by overwriting target with source truth
+* Character count check with confirmation prompt
+* CLI (`i18nize`)
 
 ## 🔧 Installation
 
@@ -35,61 +39,95 @@ Or install manually:
 gem install i18nize
 ```
 
-
 ## 🚀 Usage
 
 ### 1. Set your DeepL API key
 
-Create a `.env` or export it in your shell:
+Create a `.env` file (loaded automatically if you use `dotenv`) or export it in your shell:
 
 ```bash
 export DEEPL_API_KEY=your-api-key
 export DEEPL_ENDPOINT=https://api.deepl.com/v2/translate # Only if you are using a DeepL Pro account
 ```
 
-> You can use the [Free DeepL API](https://www.deepl.com/pro#developer)
+👉 You can use the [Free DeepL API](https://www.deepl.com/pro#developer).
 
-
-
-### 2. Run the translation task
+### 2. Run translations via CLI
 
 ```bash
-bundle exec rake "i18nize:translate[language]"
+# Translate from en → cs
+i18nize cs
+
+# Translate from de → fr
+i18nize fr --from de
 ```
 
 💬 This will:
 
-* Scan config/locales/**/*en.yml (English is the default source language)
-* Detect which `language.yml` files are missing keys
+* Scan `config/locales/**/*en.yml` (or your chosen source language)
+* Detect which `cs.yml` files are missing keys
 * Use DeepL to translate missing values
-* Write them to the appropriate files (e.g. `config/locales/errors/language.yml`)
+* Write them to the appropriate files (creating them if needed)
+
+### 3. Show missing keys only
+
+```bash
+# Missing cs keys (source en)
+i18nize cs --missing
+
+# Missing cs keys (source de)
+i18nize cs --missing de
+```
+
+This mode only lists missing keys, no translations are written.
+
+### 4. Fill placeholders for blank/missing keys (no DeepL)
+
+```bash
+# Insert placeholders instead of translating
+i18nize cs --only_blank
+```
 
+This scans all keys in the **source** locale (default `en`) and, for any **missing or blank** value in the target locale, inserts a placeholder:
 
+```
+<locale>.<full.dot.key> missing
+```
+
+Example:
+
+```yaml
+en:
+  test:
+    title: "Testing"
+cs:
+  test:
+    title: "cs.test.title missing"
+```
+
+Existing non-blank values in the target are left untouched.
 
 ## 🛡️ Character limit check
 
-Before translating, the task will:
+Before translating, the CLI:
 
-* Count the total number of characters to be translated
-* Warn if the count exceeds **500,000** (DeepL Free monthly limit)
-* Ask for confirmation:
+* Counts the total number of characters
+* Warns if the count exceeds **500,000** (DeepL Free monthly limit)
+* Asks for confirmation:
 
 ```text
 [i18nize] Estimated character count: 43125
 Proceed with translation? [y/N]:
 ```
 
-
-
 ## 🗂️ Locale file support
 
-* Files are grouped per folder and matched:
+* Files are matched by name:
 
-    * `config/locales/api/en.yml` → `config/locales/api/cs.yml`
-    * `config/locales/en.devise.yml` → `config/locales/cs.devise.yml`
+  * `config/locales/api/en.yml` → `config/locales/api/cs.yml`
+  * `config/locales/en.devise.yml` → `config/locales/cs.devise.yml`
 * Missing files are created automatically
-
-
+* If a scalar exists where a nested structure is required, **it is overwritten by source locale structure**
 
 ## 🧩 Example structure
 
@@ -102,7 +140,13 @@ config/locales/
 │   └── cs.yml
 ```
 
-After running `rake i18nize:translate[cs]`, the gem will create:
+After running:
+
+```bash
+i18nize cs
+```
+
+the gem will create:
 
 ```
 config/locales/api/cs.yml
@@ -114,16 +158,22 @@ With keys translated from `api/en.yml`.
 
 ## 📦 Configuration
 
-For now, configuration is via method arguments and `ENV["DEEPL_API_KEY"]`.
-Optional future support: `.i18nize.yml`.
+For now, configuration is via CLI flags and environment variables:
 
+* `--from LANG` (default `en`)
+* `--missing [FROM]` (list missing keys only)
+* `--only_blank` (fill only blank/missing keys with placeholders, no DeepL)
+* `DEEPL_API_KEY` (required for translation mode)
+* `DEEPL_ENDPOINT` (optional, only for Pro)
+* `I18NIZE_ALLOW_EMPTY == "1"` → **skip empty/whitespace-only values** in the source when inserting or translating
+  (i.e., if a source value is `""` or `" "` it will be ignored and not propagated to the target)
 
+---
 
 ## 🔍 TODO
 
-* Test suite (RSpec)
-* YAML key sorting and format preservation
-* Smart overwrite protection
-* Changeable source language
-
+* RSpec test suite
+* YAML key sorting / format preservation
+* Richer conflict resolution strategies (configurable overwrite / skip)
+* Use custom char limit
 

data/lib/i18nize/cli.rb

@@ -1,12 +1,12 @@
 # frozen_string_literal: true
 
 require "optparse"
-
 require "i18nize/translator"
 require "i18nize/inserter"
 require "i18nize/comparer"
 
 module I18nize
+  # CLI for i18nize
   class CLI
     def self.run(argv)
       new(argv).run
@@ -16,107 +16,102 @@ module I18nize
       @argv = argv.dup
       @options = {
         from: "en",
-        mode: :translate,
+        mode: :translate, # :translate | :missing | :only_blank
         missing_from: nil
       }
     end
 
     def run
-      print_help_and_exit if @argv.empty? || help_requested?
-
-      first = @argv.first
-      parse_flags!(@argv[1..] || [])
-
-      to_locale = parse_positional_locale!(first)
+      remaining = parse_flags!(@argv)
+      abort usage unless remaining.any?
+      to_locale = remaining.shift.strip
 
-      if @options[:mode] == :missing
+      case @options[:mode]
+      when :missing
         from = @options[:missing_from] || @options[:from]
         show_missing_translations(from:, to: to_locale)
-        return 0
+      when :only_blank
+        run_only_blank(to_locale)
+      else
+        run_translation(to_locale)
       end
-
-      run_translation(to_locale)
       0
     rescue OptionParser::InvalidOption => e
       warn red(e.message)
-      print_help_and_exit(2)
+      puts usage
+      2
     rescue SystemExit => e
       raise e
     rescue => e
       warn red("Error: #{e.class}: #{e.message}")
       e.backtrace.each { |l| warn l } if ENV["I18NIZE_DEBUG"] == "1"
-      exit 1
+      1
     end
 
     private
 
-    def help_requested?
-      (@argv & %w[-h --help help]).any?
-    end
-
-    def parse_positional_locale!(arg)
-      abort yellow("Usage: i18nize <to_locale> [--from en] [--missing [FROM]]") unless arg
-      arg.strip
-    end
-
-    def parse_flags!(rest)
-      OptionParser.new do |o|
+    def parse_flags!(args)
+      parser = OptionParser.new do |o|
         o.banner = "Usage: i18nize <to_locale> [options]"
-        o.on("--from LANG", "Source language for comparison/translation (default: en)") { |v| @options[:from] = v }
-
+        o.on("--from LANG", "Source language (default: en)") { |v| @options[:from] = v }
         o.on("--missing", "--missing [FROM]", "List missing keys only; optionally specify source locale") do |from|
           @options[:mode] = :missing
           @options[:missing_from] = from if from && !from.strip.empty?
         end
+        o.on("--only_blank", "Fill only missing/blank keys with '<locale>.<full.key> missing'") do
+          @options[:mode] = :only_blank
+        end
+        o.on("-h", "--help", "Show help") { puts usage; exit 0 }
+      end
 
-        o.on("-h", "--help", "Show help") { print_help_and_exit }
-      end.parse!(rest)
+      parser.parse!(args)
+      args
     end
 
     def show_missing_translations(from:, to:)
       load_rails_if_available
       puts cyan("🔍 Missing keys for #{to} (from #{from})")
-
       missing = I18nize::Comparer.missing_translations(from_locale: from, to_locale: to)
-
       if missing.empty?
         puts green("✅ No missing translations.")
         return
       end
-
-      total_keys = missing.total_keys
-      puts yellow("⚠️  #{total_keys} missing #{total_keys == 1 ? 'key' : 'keys'}:")
-
+      total = missing.total_keys
+      puts yellow("⚠️  #{total} missing #{total == 1 ? 'key' : 'keys'}:")
       missing.values_by_file.each do |file, keys_hash|
         puts "  #{file}:"
-        keys_hash.keys.sort.each do |k|
-          puts "    - #{k.sub(/^#{from}\./, '')}"
-        end
+        keys_hash.keys.sort.each { |k| puts "    - #{k.sub(/^#{Regexp.escape(from)}\./, "")}" }
       end
     end
 
-    def run_translation(to_locale)
+    def run_only_blank(to_locale)
       load_env_files
+      load_rails_if_available
+      puts cyan("Filling only blank/missing keys: from #{@options[:from]} → #{to_locale}")
+      I18nize::Inserter.insert_only_blank(
+        from_locale: @options[:from],
+        to_locale: to_locale
+      )
+      puts green("✅ Placeholders inserted for blank/missing keys.")
+    end
 
+    def run_translation(to_locale)
+      load_env_files
       api_key = ENV["DEEPL_API_KEY"]
       abort red("Missing DEEPL_API_KEY env variable") if api_key.to_s.strip.empty?
-
       load_rails_if_available
 
       puts cyan("Starting translation: from #{@options[:from]} → #{to_locale}")
-
       translator = I18nize::Translator.new(
         auth_key: api_key,
         from_lang: @options[:from].upcase,
         to_lang: to_locale.upcase
       )
-
       I18nize::Inserter.insert_missing(
         from_locale: @options[:from],
         to_locale: to_locale,
         translator: translator
       )
-
       puts green("✅ Translation completed.")
     end
 
@@ -124,18 +119,37 @@ module I18nize
       begin
         require "dotenv/load"
       rescue LoadError
-        # Ignore
       end
     end
 
     def load_rails_if_available
       return if defined?(Rails)
 
-      if File.exist?("config/environment.rb")
-        require_relative "../../config/environment"
-      end
+      require_relative "../../config/environment" if File.exist?("config/environment.rb")
+
     rescue LoadError
-      # Ignore
+      # Ignored
+    end
+
+    def usage
+      <<~HELP
+        Usage:
+          i18nize <to_locale> [options]
+
+        Examples:
+          i18nize cs                    # translate missing from en -> cs
+          i18nize cs --from de          # translate missing from de -> cs
+          i18nize --from de cs          # flags can be before or after the locale
+          i18nize cs --missing          # list missing keys for cs (from en)
+          i18nize cs --missing de       # list missing keys for cs (from de)
+          i18nize cs --only_blank       # fill only blank/missing keys with placeholders
+
+        Options:
+          --from LANG                   Source language (default: en)
+          --missing [FROM]              Only list missing keys (optional override of source)
+          --only_blank                  Insert '<locale>.<full.key> missing' for blank/missing keys
+          -h, --help                    Show this help
+      HELP
     end
 
     def color(text, code) = "\e[#{code}m#{text}\e[0m"
@@ -147,24 +161,5 @@ module I18nize
     def yellow(text) = color(text, 33)
 
     def cyan(text) = color(text, 36)
-
-    def print_help_and_exit(code = 0)
-      puts <<~HELP
-        Usage:
-          i18nize <to_locale> [options]
-
-        Examples:
-          i18nize cs                  # translate missing from en -> cs
-          i18nize cs --from de        # translate missing from de -> cs
-          i18nize cs --missing        # list missing keys for cs (from en)
-          i18nize cs --missing de     # list missing keys for cs (from de)
-
-        Options:
-          --from LANG                 Source language (default: en)
-          --missing [FROM]            Only list missing keys (optional override of source)
-          -h, --help                  Show this help
-      HELP
-      exit code
-    end
   end
 end

data/lib/i18nize/comparer.rb

@@ -4,8 +4,9 @@ require_relative "loader"
 require_relative "missing_set"
 
 module I18nize
+  # Small utility to compare translations from one locale to another
   class Comparer
-    def self.missing_translations(from_locale: "en", to_locale:)
+    def self.missing_translations(to_locale:, from_locale: "en") # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
       from_data = Loader.load_per_file(locale: from_locale)
       to_data   = Loader.load_per_file(locale: to_locale)
 
@@ -37,7 +38,7 @@ module I18nize
       MissingSet.new(from_locale: from_locale, to_locale: to_locale, data: result)
     end
 
-    def self.missing_keys(from_locale: "en", to_locale:)
+    def self.missing_keys(to_locale:, from_locale: "en")
       missing_translations(from_locale: from_locale, to_locale: to_locale).keys_by_file
     end
   end

data/lib/i18nize/inserter.rb

@@ -2,13 +2,15 @@
 
 require "yaml"
 require "fileutils"
+require "byebug"
 require_relative "comparer"
+require_relative "loader"
 
 module I18nize
   class Inserter
     CONFLICT_POLICY = :overwrite # :overwrite | :skip
 
-    def self.insert_missing(from_locale: "en", to_locale:, base_path: "config/locales", translator: nil)
+    def self.insert_missing(to_locale:, from_locale: "en", base_path: "config/locales", translator: nil)
       missing_data = Comparer.missing_translations(from_locale: from_locale, to_locale: to_locale)
 
       if translator
@@ -26,7 +28,7 @@ module I18nize
       overwrites = []
 
       missing_data.data.each do |from_rel_path, translations|
-        dirname  = File.dirname(from_rel_path)
+        dirname = File.dirname(from_rel_path)
         filename = File.basename(from_rel_path)
 
         locale_re = /(^|[._])#{Regexp.escape(from_locale)}\.(ya?ml)$/
@@ -40,7 +42,7 @@ module I18nize
         translation_map =
           if translator
             src_values = translations.values
-            translated_values = translator.translate_texts(src_values) # => pole!
+            translated_values = translator.translate_texts(src_values) # returns array
             translations.keys.zip(translated_values).to_h
           else
             translations
@@ -57,15 +59,70 @@ module I18nize
         puts "\e[32m[i18nize] Inserted #{translation_map.size} keys into #{to_full_path}\e[0m"
       end
 
-      if overwrites.any?
+      return unless overwrites.any?
         puts "\n\e[33m[i18nize] Overwrote #{overwrites.size} scalar node(s) to create nested structure:\e[0m"
         overwrites.each do |c|
           puts "  \e[33m- #{c[:file]}: #{c[:locale]}.#{c[:path].join('.')}\e[0m (was: #{c[:existing_class]})"
         end
+
+    end
+
+    # NEW: fill only missing/blank values with "<locale>.<full.key> missing"
+    def self.insert_only_blank(to_locale:, from_locale: "en", base_path: "config/locales")
+      from_data = Loader.load_per_file(locale: from_locale, base_path: base_path)
+      # to_data = Loader.load_per_file(locale: to_locale, base_path: base_path)
+
+      updated_files = 0
+      overwrites = []
+
+      from_data.each do |from_rel_path, from_keys|
+        dirname = File.dirname(from_rel_path)
+        filename = File.basename(from_rel_path)
+        locale_re = /(^|[._])#{Regexp.escape(from_locale)}\.(ya?ml)$/
+        new_filename = filename.sub(locale_re) { "#{Regexp.last_match(1)}#{to_locale}.#{Regexp.last_match(2)}" }
+        to_rel_path = dirname == "." || dirname.empty? ? new_filename : File.join(dirname, new_filename)
+        to_full_path = File.join(base_path, to_rel_path)
+
+        existing = File.exist?(to_full_path) ? YAML.load_file(to_full_path) : {}
+        existing[to_locale] ||= {}
+
+        changes = 0
+
+        from_keys.each_key do |from_full_key|
+          to_full_key = from_full_key.sub(/^#{Regexp.escape(from_locale)}\./, "#{to_locale}.")
+          path = to_full_key.sub(/^#{Regexp.escape(to_locale)}\./, "").split(".")
+          current = dig_nested(existing[to_locale], path)
+          next if current.to_s.strip.empty? && ENV["I18NIZE_ALLOW_EMPTY"] == "1"
+          next unless current.nil? || current.to_s.strip.empty?
+
+          placeholder = "#{to_full_key} missing"
+          insert_nested(existing[to_locale], path, placeholder, overwrites, to_rel_path, to_locale, :overwrite)
+          changes += 1
+        end
+
+        next unless changes.positive?
+
+        FileUtils.mkdir_p(File.dirname(to_full_path))
+        File.write(to_full_path, existing.to_yaml(line_width: -1))
+        updated_files += 1
+        puts "\e[32m[i18nize] Inserted #{changes} placeholder#{changes == 1 ? '' : 's'} into #{to_full_path}\e[0m"
+      end
+
+      puts "\e[90m[i18nize] No blank or missing keys found.\e[0m" if updated_files.zero?
+
+      return unless overwrites.any?
+
+      puts "\n\e[33m[i18nize] Overwrote #{overwrites.size} scalar node(s) while creating nested structure:\e[0m"
+      overwrites.each do |c|
+        puts "  \e[33m- #{c[:file]}: #{c[:locale]}.#{c[:path].join('.')}\e[0m (was: #{c[:existing_class]})"
       end
     end
 
-    # conflict_policy: :overwrite (replace scalar with {}), :skip (leave as is)
+    def self.dig_nested(hash, path)
+      path.reduce(hash) { |h, k| h.is_a?(Hash) ? h[k] : nil }
+    end
+
+    # conflict_policy: :overwrite (replace scalar with {}), :skip
     def self.insert_nested(base, keys, value, overwrites, file, locale, conflict_policy)
       key = keys.shift
 
@@ -79,18 +136,15 @@ module I18nize
       case cur
       when nil
         base[key] = {}
-        insert_nested(base[key], keys, value, overwrites, file, locale, conflict_policy)
+        return insert_nested(base[key], keys, value, overwrites, file, locale, conflict_policy)
       when Hash
-        insert_nested(cur, keys, value, overwrites, file, locale, conflict_policy)
+        return insert_nested(cur, keys, value, overwrites, file, locale, conflict_policy)
       else
-        if conflict_policy == :overwrite
+        return false unless conflict_policy == :overwrite
           overwrites << { file: file, locale: locale, path: [key, *keys], existing_class: cur.class.to_s }
           base[key] = {}
-          insert_nested(base[key], keys, value, overwrites, file, locale, conflict_policy)
-        else
-          # :skip
-          false
-        end
+        return insert_nested(base[key], keys, value, overwrites, file, locale, conflict_policy)
+
       end
     end
   end

data/lib/i18nize/loader.rb

@@ -3,6 +3,7 @@
 require "yaml"
 
 module I18nize
+  # Loader for i18nize
   class Loader
     def self.load_per_file(locale: "en", base_path: "config/locales")
       files = Dir.glob(File.join(base_path, "**", "*.yml")).select do |f|

data/lib/i18nize/missing_set.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module I18nize
-  require "byebug"
+  # Set of missing translations
   class MissingSet
     attr_reader :from_locale, :to_locale, :data
 

data/lib/i18nize/translator.rb

@@ -4,14 +4,15 @@ require "uri"
 require "json"
 
 module I18nize
+  # Translator for i18nize
   class Translator
     ENDPOINT = ENV.fetch("DEEPL_ENDPOINT", "https://api-free.deepl.com/v2/translate")
     PLACEHOLDER_RE = /%{\s*[^}]+\s*}/
 
     def initialize(auth_key:, from_lang: "EN", to_lang:)
-      @auth_key  = auth_key
+      @auth_key = auth_key
       @from_lang = from_lang
-      @to_lang   = to_lang
+      @to_lang = to_lang
     end
 
     def translate_texts(texts)
@@ -30,7 +31,7 @@ module I18nize
       body_params = [
         ["auth_key", @auth_key],
         ["source_lang", @from_lang],
-        ["target_lang", @to_lang],
+        ["target_lang", @to_lang]
       ] + protected.map { |text| ["text", text] }
 
       req = Net::HTTP::Post.new(uri)
@@ -43,7 +44,7 @@ module I18nize
       json = JSON.parse(res.body)
       out = json["translations"].map { |t| t["text"] }
 
-      out.map { |s| s.gsub(/__I18NIZE_PLH_(\d+)__/) { placeholders[$1.to_i] } }
+      out.map { |s| s.gsub(/__I18NIZE_PLH_(\d+)__/) { placeholders[::Regexp.last_match(1).to_i] } }
     end
   end
 end

data/lib/i18nize/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module I18nize
-  VERSION = "0.5"
+  VERSION = "0.6"
 end

metadata

@@ -1,16 +1,27 @@
 --- !ruby/object:Gem::Specification
 name: i18nize
 version: !ruby/object:Gem::Version
-  version: '0.5'
+  version: '0.6'
 platform: ruby
 authors:
 - nikolas2145
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-09-08 00:00:00.000000000 Z
+date: 2025-09-11 00:00:00.000000000 Z
 dependencies: []
-description: ''
+description: "i18nize helps Ruby and Rails projects stay multilingual by automatically
+  filling in \nmissing translations in I18n YAML locale files. It scans for missing
+  or empty keys \nacross nested locale structures, and uses the DeepL API (Free or
+  Pro) to translate \nthem from a chosen source locale (default: en).\n\nFeatures:\n-
+  Detects and lists missing translation keys\n- Automatically translates and inserts
+  values into the correct YAML files\n- Supports nested directories and multiple locale
+  files (e.g. config/locales/api/en.yml)\n- Preserves I18n placeholders such as %{count}\n-
+  Handles pluralization branches (one, other, etc.)\n- Source locale is treated as
+  the single source of truth (conflicts are resolved by overwrite)\n- Simple CLI:
+  `i18nize <locale>` or `i18nize <locale> --missing`\n\nThis gem streamlines the translation
+  workflow, making it easier to maintain \nconsistent, up-to-date locale files across
+  large Ruby on Rails applications.\n"
 email:
 - nikolas2145@gmail.com
 executables:
@@ -18,11 +29,6 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
-- ".idea/.gitignore"
-- ".idea/git_toolbox_prj.xml"
-- ".idea/i18nize.iml"
-- ".idea/material_theme_project_new.xml"
-- ".idea/vcs.xml"
 - ".rspec"
 - ".rubocop.yml"
 - CHANGELOG.md
@@ -66,5 +72,5 @@ requirements: []
 rubygems_version: 3.4.19
 signing_key:
 specification_version: 4
-summary: Auto-translates missing I18n keys in YAML files using DeepL.
+summary: Automatic DeepL-powered translations for I18n YAML files
 test_files: []

data/.idea/.gitignore

@@ -1,8 +0,0 @@
-# Default ignored files
-/shelf/
-/workspace.xml
-# Editor-based HTTP Client requests
-/httpRequests/
-# Datasource local storage ignored files
-/dataSources/
-/dataSources.local.xml

data/.idea/git_toolbox_prj.xml

@@ -1,15 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="GitToolBoxProjectSettings">
-    <option name="commitMessageIssueKeyValidationOverride">
-      <BoolValueOverride>
-        <option name="enabled" value="true" />
-      </BoolValueOverride>
-    </option>
-    <option name="commitMessageValidationEnabledOverride">
-      <BoolValueOverride>
-        <option name="enabled" value="true" />
-      </BoolValueOverride>
-    </option>
-  </component>
-</project>

data/.idea/i18nize.iml

@@ -1,53 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<module version="4">
-  <component name="ModuleRunConfigurationManager">
-    <shared />
-  </component>
-  <component name="RakeTasksCache-v2">
-    <option name="myRootTask">
-      <RakeTaskImpl id="rake">
-        <subtasks>
-          <RakeTaskImpl description="Build i18nize-0.4.0.gem into the pkg directory" fullCommand="build" id="build" />
-          <RakeTaskImpl id="build">
-            <subtasks>
-              <RakeTaskImpl description="Generate SHA512 checksum of i18nize-0.4.0.gem into the checksums directory" fullCommand="build:checksum" id="checksum" />
-            </subtasks>
-          </RakeTaskImpl>
-          <RakeTaskImpl description="Remove any temporary products" fullCommand="clean" id="clean" />
-          <RakeTaskImpl description="Remove any generated files" fullCommand="clobber" id="clobber" />
-          <RakeTaskImpl id="i18nize">
-            <subtasks>
-              <RakeTaskImpl description="Auto-translate missing I18n keys using DeepL (usage: rake 'i18nize:translate[cs]')" fullCommand="i18nize:translate[to_locale]" id="translate[to_locale]" />
-              <RakeTaskImpl description="" fullCommand="i18nize:translate" id="translate" />
-            </subtasks>
-          </RakeTaskImpl>
-          <RakeTaskImpl description="Build and install i18nize-0.4.0.gem into system gems" fullCommand="install" id="install" />
-          <RakeTaskImpl id="install">
-            <subtasks>
-              <RakeTaskImpl description="Build and install i18nize-0.4.0.gem into system gems without network access" fullCommand="install:local" id="local" />
-            </subtasks>
-          </RakeTaskImpl>
-          <RakeTaskImpl description="Create tag v0.4.0 and build and push i18nize-0.4.0.gem to https://rubygems.org" fullCommand="release[remote]" id="release[remote]" />
-          <RakeTaskImpl description="Run RuboCop" fullCommand="rubocop" id="rubocop" />
-          <RakeTaskImpl id="rubocop">
-            <subtasks>
-              <RakeTaskImpl description="Autocorrect RuboCop offenses (only when it's safe)" fullCommand="rubocop:autocorrect" id="autocorrect" />
-              <RakeTaskImpl description="Autocorrect RuboCop offenses (safe and unsafe)" fullCommand="rubocop:autocorrect_all" id="autocorrect_all" />
-              <RakeTaskImpl description="" fullCommand="rubocop:auto_correct" id="auto_correct" />
-            </subtasks>
-          </RakeTaskImpl>
-          <RakeTaskImpl description="Run RSpec code examples" fullCommand="spec" id="spec" />
-          <RakeTaskImpl description="" fullCommand="default" id="default" />
-          <RakeTaskImpl description="" fullCommand="release" id="release" />
-          <RakeTaskImpl id="release">
-            <subtasks>
-              <RakeTaskImpl description="" fullCommand="release:guard_clean" id="guard_clean" />
-              <RakeTaskImpl description="" fullCommand="release:rubygem_push" id="rubygem_push" />
-              <RakeTaskImpl description="" fullCommand="release:source_control_push" id="source_control_push" />
-            </subtasks>
-          </RakeTaskImpl>
-        </subtasks>
-      </RakeTaskImpl>
-    </option>
-  </component>
-</module>

data/.idea/material_theme_project_new.xml

@@ -1,12 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="MaterialThemeProjectNewConfig">
-    <option name="metadata">
-      <MTProjectMetadataState>
-        <option name="migrated" value="true" />
-        <option name="pristineConfig" value="false" />
-        <option name="userId" value="-151e60b4:18eb353ec10:-7ffc" />
-      </MTProjectMetadataState>
-    </option>
-  </component>
-</project>

data/.idea/vcs.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="VcsDirectoryMappings">
-    <mapping directory="$PROJECT_DIR$" vcs="Git" />
-  </component>
-</project>