better_translate 1.0.0 → 1.0.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6a19ffdafe02b71cad6e1d93eba868299d8551adc3e7952450c709c3f71d1292
-  data.tar.gz: 7c5d7dde1f0b120124d13f75c31637b2a304845955a2974fc7f0c2f58eec8e76
+  metadata.gz: b02561def13795980279169998c3a28170f0c2b1c4c7e4ffc58ae61b20b98ff5
+  data.tar.gz: d44be305f231f038918bb8dbf722db94328d9d9e71f1bcdd8bbe32aefceeb2f1
 SHA512:
-  metadata.gz: a0c9c62cc2a35a0663d79af39c8e4a87cd86106b906b185c805f4ff9cba2bdfa82c1eaf8c366b5e91e70fe0c5ea87d5da852e03c32ae2a3959ae32ef2318d62a
-  data.tar.gz: 6fb2cac27269257f878d3055027213dc2bef5d75332132f559493064a4c83f1360903080571a3fd1e71c7c6feec73cf41ff619d8ecc8da180246779b5e893e59
+  metadata.gz: 98e5a8fb7c3103220b6b2102a2242a8bb4d103a8e3b2df24298e3fa4a3f8e75dae3b48ebbb578a59de84e7c547f3bc12cab71a77c789aa9ab347b7d424aea113
+  data.tar.gz: 6aeaafff6b3ff756c620e229d93582ab64a48dca322d21b32d5d38a408e5f6d085ef5ba280da141d0c65b02ca54c3b5559bda29e204aff81b0a6562fac0b860f

data/README.md

@@ -685,7 +685,7 @@ Bug reports and pull requests are welcome on GitHub at https://github.com/alessi
 5. **HTTP Client**: Use Faraday for all HTTP requests (never Net::HTTP or HTTParty)
 6. **VCR Cassettes**: Record integration tests with real API responses for CI/CD
 
-### Workflow
+### Development Workflow
 
 ```bash
 # 1. Clone and setup
@@ -714,6 +714,33 @@ git push origin my-feature
 # 7. Create a Pull Request
 ```
 
+### Release Workflow
+
+Releases are automated via GitHub Actions:
+
+```bash
+# 1. Update version
+vim lib/better_translate/version.rb  # VERSION = "1.0.1"
+
+# 2. Update CHANGELOG
+vim CHANGELOG.md
+
+# 3. Commit and tag
+git add -A
+git commit -m "chore: Release v1.0.1"
+git tag v1.0.1
+git push origin main
+git push origin v1.0.1
+
+# 4. GitHub Actions automatically:
+#    ✅ Runs tests
+#    ✅ Builds gem
+#    ✅ Publishes to RubyGems.org
+#    ✅ Creates GitHub Release
+```
+
+**Setup**: See [`.github/RUBYGEMS_SETUP.md`](.github/RUBYGEMS_SETUP.md) for configuring RubyGems trusted publishing (no API keys needed!).
+
 ## 📄 License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/RELEASE_NOTES_v1.0.0.md

@@ -0,0 +1,240 @@
+# BetterTranslate v1.0.0 - Complete Release 🎉
+
+**AI-powered YAML locale file translator for Rails and Ruby projects**
+
+This is the first complete release of BetterTranslate, featuring multi-provider AI translation support, comprehensive testing infrastructure, and production-ready features.
+
+## 🚀 Quick Start
+
+```bash
+# Install the gem
+gem install better_translate
+
+# Try the interactive demo
+git clone https://github.com/alessiobussolari/better_translate.git
+cd better_translate
+bundle install
+export OPENAI_API_KEY=your_key_here
+ruby spec/dummy/demo_translation.rb
+```
+
+## ✨ Key Features
+
+### Multi-Provider AI Support
+- **ChatGPT** (GPT-5-nano) - Fast, excellent quality
+- **Google Gemini** (gemini-2.0-flash-exp) - Very fast, cost-effective
+- **Anthropic Claude** (Claude 3.5) - Excellent quality (coming soon)
+
+### Translation Features
+- 🎯 **Smart Strategies**: Automatic selection between deep (<50 strings) and batch (≥50 strings) translation
+- ⚡ **Intelligent Caching**: LRU cache with optional TTL reduces API costs
+- 🔄 **Translation Modes**: Override (replace all) or Incremental (merge with existing)
+- 🚫 **Flexible Exclusions**: Global + language-specific exclusion rules
+- 🎨 **Domain Context**: Provide context for medical, legal, financial, or technical terminology
+- 📊 **Similarity Analysis**: Built-in Levenshtein distance analyzer
+
+### Production-Ready Quality
+- 🧪 **259 Tests** passing with 90%+ coverage
+- 🎬 **VCR Integration**: 18 cassettes (260KB) with real API responses
+- 🏗️ **Rails Dummy App**: Interactive demo with real translations
+- 📚 **Complete Documentation**: README, YARD docs, usage guides
+- 🛡️ **Type-Safe**: RBS signatures with Steep type checking
+- ✅ **RuboCop Compliant**: Clean, consistent code style
+
+### Rails Integration
+```bash
+# Generate initializer
+rails generate better_translate:install
+
+# Configure in config/initializers/better_translate.rb
+BetterTranslate.configure do |config|
+  config.provider = :chatgpt
+  config.openai_key = ENV["OPENAI_API_KEY"]
+  config.source_language = "en"
+  config.target_languages = [
+    { short_name: "it", name: "Italian" },
+    { short_name: "fr", name: "French" }
+  ]
+  config.input_file = "config/locales/en.yml"
+  config.output_folder = "config/locales"
+end
+
+# Translate all files
+BetterTranslate.translate_all
+```
+
+## 📖 Documentation
+
+- **[README.md](README.md)** - Complete feature documentation
+- **[USAGE_GUIDE.md](spec/dummy/USAGE_GUIDE.md)** - Interactive demo guide
+- **[VCR Testing Guide](spec/integration/README.md)** - Integration testing with VCR
+- **[CLAUDE.md](CLAUDE.md)** - Developer guide for contributors
+- **[CHANGELOG.md](CHANGELOG.md)** - Detailed changelog
+
+## 🎬 Demo Output
+
+```yaml
+# en.yml (input)
+en:
+  hello: "Hello"
+  users:
+    greeting: "Hello %{name}"
+  messages:
+    success: "Operation completed successfully"
+
+# it.yml (generated by BetterTranslate)
+it:
+  hello: "Ciao"
+  users:
+    greeting: "Ciao %{name}"  # ✅ Variables preserved!
+  messages:
+    success: "Operazione completata con successo"
+
+# fr.yml (generated by BetterTranslate)
+fr:
+  hello: "Bonjour"
+  users:
+    greeting: "Bonjour %{name}"  # ✅ Variables preserved!
+  messages:
+    success: "Opération réussie"
+```
+
+## 🏗️ Architecture Highlights
+
+### Provider Architecture
+```
+BaseHttpProvider (abstract)
+├── ChatGPTProvider (GPT-5-nano, temp=1.0)
+├── GeminiProvider (gemini-2.0-flash-exp)
+└── AnthropicProvider (coming soon)
+```
+
+**BaseHttpProvider features:**
+- Faraday-based HTTP communication
+- Retry logic with exponential backoff (3 attempts)
+- Rate limiting (0.5s between requests, thread-safe)
+- Configurable timeouts (default: 30s)
+
+### Core Components
+- **Configuration**: Type-safe config with validation
+- **Cache**: Thread-safe LRU cache with optional TTL
+- **RateLimiter**: Thread-safe request throttling
+- **Validator**: Comprehensive input validation
+- **HashFlattener**: Nested YAML ↔ flat structure conversion
+- **VariableExtractor**: Preserves `%{name}` and `%<name>s` placeholders
+- **ProgressTracker**: Real-time translation progress
+
+### Error Hierarchy
+```
+BetterTranslate::Error (base)
+├── ConfigurationError
+├── ValidationError
+├── TranslationError
+├── ProviderError
+├── ApiError
+├── RateLimitError
+├── FileError
+├── YamlError
+└── ProviderNotFoundError
+```
+
+## 🧪 Testing Infrastructure
+
+```
+spec/
+├── better_translate/           # 259 unit tests
+│   ├── cache_spec.rb
+│   ├── providers/
+│   └── ...
+├── integration/                # VCR integration tests
+│   ├── chatgpt_integration_spec.rb
+│   ├── gemini_integration_spec.rb
+│   └── rails_dummy_app_spec.rb
+├── dummy/                      # Rails dummy app
+│   ├── demo_translation.rb     # 🚀 Interactive demo
+│   └── config/locales/
+│       ├── en.yml              # Source (16 keys)
+│       ├── it.yml              # Generated (519 bytes)
+│       └── fr.yml              # Generated (511 bytes)
+└── vcr_cassettes/              # 18 cassettes (260KB)
+    ├── chatgpt/ (7)
+    ├── gemini/ (7)
+    └── rails/ (4)
+```
+
+## 📦 Package Details
+
+- **Gem Name**: `better_translate`
+- **Version**: `1.0.0`
+- **Size**: 83KB
+- **Files**: 152 files
+- **Lines of Code**: 23,654
+- **Ruby Version**: >= 3.0.0
+- **Dependencies**: Faraday ~> 2.0 (only runtime dependency)
+
+## 🔧 Configuration Examples
+
+### Medical Terminology
+```ruby
+config.translation_context = "Medical terminology for healthcare applications"
+config.target_languages = [{ short_name: "es", name: "Spanish" }]
+# "patient" → "paciente", "diagnosis" → "diagnóstico"
+```
+
+### E-commerce with Exclusions
+```ruby
+config.global_exclusions = ["brand_name", "sku"]  # Never translate
+config.exclusions_per_language = {
+  "de" => ["legal.terms"],  # German legal terms manually translated
+  "fr" => ["marketing.slogan"]  # French slogan crafted by marketing
+}
+```
+
+### Incremental Mode
+```ruby
+config.translation_mode = :incremental
+# Only translates missing keys, preserves manual corrections
+```
+
+## 🚦 Performance
+
+**Demo Results** (16 keys, 2 languages):
+- Italian: 16 strings in 1m 6s (~4s per string)
+- French: 16 strings in 1m 7s (~4s per string)
+- **Total**: 32 translations in 2m 13s
+
+**With Caching Enabled**:
+- Subsequent runs: < 1s (cache hits)
+- API costs reduced by ~90%
+
+## 🤝 Contributing
+
+Contributions are welcome! Please see [CLAUDE.md](CLAUDE.md) for development guidelines.
+
+**Development Requirements**:
+1. TDD (Test-Driven Development) - Write tests first
+2. YARD Documentation - Document all public methods
+3. RuboCop Compliance - Clean code style
+4. VCR Cassettes - Record integration tests
+
+## 📜 License
+
+MIT License - See [LICENSE.txt](LICENSE.txt)
+
+## 🙏 Acknowledgments
+
+Built with:
+- **Faraday** - HTTP client
+- **VCR** - HTTP interaction recording
+- **RSpec** - Testing framework
+- **RuboCop** - Code linting
+- **Steep** - Type checking
+- **YARD** - Documentation
+
+---
+
+**Made with ❤️ by [Alessio Bussolari](https://github.com/alessiobussolari)**
+
+**Powered by Claude Code** 🤖
+
+[Report Bug](https://github.com/alessiobussolari/better_translate/issues) · [Request Feature](https://github.com/alessiobussolari/better_translate/issues) · [Documentation](https://github.com/alessiobussolari/better_translate)

data/Steepfile

@@ -6,8 +6,8 @@
 D = Steep::Diagnostic
 
 target :lib do
-  # Specify Ruby version
-  check "lib"
+  # Only check library files
+  check "lib/**/*.rb"
 
   # Signature files location
   signature "sig"

data/docs/implementation/00-overview.md

@@ -14,7 +14,7 @@ BetterTranslate is a powerful Ruby gem designed to automatically translate YAML
 
 ### Key Features
 
-- **Multiple AI Providers**: ChatGPT (GPT-5-nano), Google Gemini (gemini-2.0-flash-exp), Anthropic Claude (claude-3-5-sonnet-20241022)
+- **Multiple AI Providers**: ChatGPT (GPT-5-nano), Google Gemini (gemini-2.5-flash-lite), Anthropic Claude (claude-haiku-4-5)
 - **Smart Translation Strategies**: Automatic selection between Deep (< 50 strings) and Batch (≥ 50 strings) processing
 - **Intelligent Caching**: LRU cache with configurable capacity and TTL
 - **Rails Integration**: 3 generators (install, translate, analyze)

data/docs/implementation/04-provider_architecture.md

@@ -331,10 +331,10 @@ module BetterTranslate
   module Providers
     # Google Gemini translation provider
     #
-    # Uses gemini-2.0-flash-exp model
+    # Uses gemini-2.5-flash-lite model
     class GeminiProvider < BaseHttpProvider
-      API_URL = "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash-exp:generateContent"
-      MODEL = "gemini-2.0-flash-exp"
+      API_URL = "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash-lite:generateContent"
+      MODEL = "gemini-2.5-flash-lite"
 
       # Translate a single text
       #
@@ -431,10 +431,10 @@ module BetterTranslate
   module Providers
     # Anthropic Claude translation provider
     #
-    # Uses claude-3-5-sonnet-20241022 model
+    # Uses claude-haiku-4-5 model
     class AnthropicProvider < BaseHttpProvider
       API_URL = "https://api.anthropic.com/v1/messages"
-      MODEL = "claude-3-5-sonnet-20241022"
+      MODEL = "claude-haiku-4-5"
       API_VERSION = "2023-06-01"
 
       # Translate a single text

data/lib/better_translate/cache.rb

@@ -52,7 +52,8 @@ module BetterTranslate
         entry = @cache[key]
 
         # Check TTL
-        if @ttl && entry && Time.now - entry[:timestamp] > @ttl
+        ttl_value = @ttl
+        if ttl_value && entry && Time.now - entry[:timestamp] > ttl_value
           @cache.delete(key)
           return nil
         end

data/lib/better_translate/cli.rb

@@ -221,8 +221,8 @@ module BetterTranslate
         "dry_run" => false,
         "translation_mode" => "override",
         "preserve_variables" => true,
-        "global_exclusions" => Array.new,
-        "exclusions_per_language" => Hash.new,
+        "global_exclusions" => [],
+        "exclusions_per_language" => {},
         "model" => nil,
         "temperature" => 0.3,
         "max_tokens" => 2000,

data/lib/better_translate/providers/anthropic_provider.rb

@@ -4,7 +4,7 @@ module BetterTranslate
   module Providers
     # Anthropic Claude translation provider
     #
-    # Uses claude-3-5-sonnet-20241022 model for high-quality translations.
+    # Uses claude-haiku-4-5 model for fast, efficient translations.
     #
     # @example Basic usage
     #   config = Configuration.new
@@ -18,7 +18,7 @@ module BetterTranslate
       API_URL = "https://api.anthropic.com/v1/messages"
 
       # Model to use for translations
-      MODEL = "claude-3-5-sonnet-20241022"
+      MODEL = "claude-haiku-4-5"
 
       # API version
       API_VERSION = "2023-06-01"
@@ -97,7 +97,8 @@ module BetterTranslate
       #
       def build_system_message(target_lang_name)
         base_message = "You are a professional translator. Translate the following text to #{target_lang_name}. " \
-                       "Return ONLY the translated text, without any explanations or additional text."
+                       "Return ONLY the translated text, without any explanations or additional text. " \
+                       "Words like VARIABLE_0, VARIABLE_1, etc. are placeholders and must be kept unchanged in the translation."
 
         if config.translation_context && !config.translation_context.empty?
           base_message += "\n\nContext: #{config.translation_context}"

data/lib/better_translate/providers/chatgpt_provider.rb

@@ -95,7 +95,8 @@ module BetterTranslate
       #
       def build_system_message(target_lang_name)
         base_message = "You are a professional translator. Translate the following text to #{target_lang_name}. " \
-                       "Return ONLY the translated text, without any explanations or additional text."
+                       "Return ONLY the translated text, without any explanations or additional text. " \
+                       "Words like VARIABLE_0, VARIABLE_1, etc. are placeholders and must be kept unchanged in the translation."
 
         if config.translation_context && !config.translation_context.empty?
           base_message += "\n\nContext: #{config.translation_context}"

data/lib/better_translate/providers/gemini_provider.rb

@@ -4,7 +4,7 @@ module BetterTranslate
   module Providers
     # Google Gemini translation provider
     #
-    # Uses gemini-2.0-flash-exp model for fast, high-quality translations.
+    # Uses gemini-2.5-flash-lite model for fast, high-quality translations.
     #
     # @example Basic usage
     #   config = Configuration.new
@@ -15,10 +15,10 @@ module BetterTranslate
     #
     class GeminiProvider < BaseHttpProvider
       # Google Gemini API endpoint
-      API_URL = "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash-exp:generateContent"
+      API_URL = "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash-lite:generateContent"
 
       # Model to use for translations
-      MODEL = "gemini-2.0-flash-exp"
+      MODEL = "gemini-2.5-flash-lite"
 
       # Translate a single text
       #
@@ -77,7 +77,8 @@ module BetterTranslate
       #
       def build_prompt(text, target_lang_name)
         base_prompt = "Translate the following text to #{target_lang_name}. " \
-                      "Return ONLY the translated text, without any explanations.\n\n" \
+                      "Return ONLY the translated text, without any explanations. " \
+                      "Words like VARIABLE_0, VARIABLE_1, etc. are placeholders and must be kept unchanged in the translation.\n\n" \
                       "Text: #{text}"
 
         if config.translation_context && !config.translation_context.empty?

data/lib/better_translate/railtie.rb

@@ -11,7 +11,8 @@ module BetterTranslate
   #
   class Railtie < Rails::Railtie
     rake_tasks do
-      rake_file = File.expand_path("../tasks/better_translate.rake", __dir__)
+      dir = __dir__
+      rake_file = File.expand_path("../tasks/better_translate.rake", dir) if dir
       load rake_file if rake_file
     end
   end

data/lib/better_translate/rate_limiter.rb

@@ -52,7 +52,10 @@ module BetterTranslate
       @mutex.synchronize do
         return if @last_request_time.nil?
 
-        elapsed = Time.now - @last_request_time
+        last_time = @last_request_time
+        return unless last_time
+
+        elapsed = Time.now - last_time
         sleep_time = @delay - elapsed.to_f
 
         sleep(sleep_time) if sleep_time.positive?

data/lib/better_translate/strategies/batch_strategy.rb

@@ -37,7 +37,7 @@ module BetterTranslate
           progress_tracker.update(
             language: target_lang_name,
             current_key: "Batch #{batch_index + 1}/#{total_batches}",
-            progress: ((batch_index + 1).to_f / total_batches * 100.0).round(1)
+            progress: ((batch_index + 1).to_f / total_batches * 100.0).round(1).to_f
           )
 
           translated_batch = provider.translate_batch(batch, target_lang_code, target_lang_name)

data/lib/better_translate/strategies/deep_strategy.rb

@@ -32,7 +32,7 @@ module BetterTranslate
           progress_tracker.update(
             language: target_lang_name,
             current_key: key,
-            progress: ((index + 1).to_f / total * 100.0).round(1)
+            progress: ((index + 1).to_f / total * 100.0).round(1).to_f
           )
 
           translated[key] = provider.translate_text(value, target_lang_code, target_lang_name)

data/lib/better_translate/translator.rb

@@ -62,7 +62,11 @@ module BetterTranslate
       rescue StandardError => e
         results[:failure_count] += 1
         # @type var error_context: Hash[Symbol, untyped]
-        error_context = e.respond_to?(:context) ? e.context : {}
+        error_context = if e.is_a?(BetterTranslate::Error)
+                          e.context
+                        else
+                          {}
+                        end
         results[:errors] << {
           language: lang[:name],
           error: e.message,

data/lib/better_translate/utils/hash_flattener.rb

@@ -47,7 +47,7 @@ module BetterTranslate
       #   #=> { "config/database/host" => "localhost" }
       #
       def self.flatten(hash, parent_key = "", separator = ".")
-        initial_hash = {} #: Hash[String, untyped]
+        initial_hash = {} # : Hash[String, untyped]
         hash.each_with_object(initial_hash) do |(key, value), result|
           new_key = parent_key.empty? ? key.to_s : "#{parent_key}#{separator}#{key}"
 
@@ -85,7 +85,7 @@ module BetterTranslate
       #   #=> { "config" => { "database" => { "host" => "localhost" } } }
       #
       def self.unflatten(hash, separator = ".")
-        initial_hash = {} #: Hash[String, untyped]
+        initial_hash = {} # : Hash[String, untyped]
         hash.each_with_object(initial_hash) do |(key, value), result|
           keys = key.split(separator)
           last_key = keys.pop

data/lib/better_translate/variable_extractor.rb

@@ -15,9 +15,9 @@ module BetterTranslate
   # @example Basic usage
   #   extractor = VariableExtractor.new("Hello %{name}, you have {{count}} messages")
   #   safe_text = extractor.extract
-  #   #=> "Hello __VAR_0__, you have __VAR_1__ messages"
+  #   #=> "Hello VARIABLE_0, you have VARIABLE_1 messages"
   #
-  #   translated = translate(safe_text)  # "Ciao __VAR_0__, hai __VAR_1__ messaggi"
+  #   translated = translate(safe_text)  # "Ciao VARIABLE_0, hai VARIABLE_1 messaggi"
   #   final = extractor.restore(translated)
   #   #=> "Ciao %{name}, hai {{count}} messaggi"
   #
@@ -41,10 +41,10 @@ module BetterTranslate
     COMBINED_PATTERN = Regexp.union(*VARIABLE_PATTERNS.values).freeze
 
     # Placeholder prefix
-    PLACEHOLDER_PREFIX = "__VAR_"
+    PLACEHOLDER_PREFIX = "VARIABLE_"
 
     # Placeholder suffix
-    PLACEHOLDER_SUFFIX = "__"
+    PLACEHOLDER_SUFFIX = ""
 
     # @return [String] Original text with variables
     attr_reader :original_text
@@ -72,13 +72,13 @@ module BetterTranslate
     # Extract variables and replace with placeholders
     #
     # Scans the text for all supported variable formats and replaces them
-    # with numbered placeholders (__VAR_0__, __VAR_1__, etc.).
+    # with numbered placeholders (VARIABLE_0, VARIABLE_1, etc.).
     #
     # @return [String] Text with variables replaced by placeholders
     #
     # @example
     #   extractor = VariableExtractor.new("Hello %{name}")
-    #   extractor.extract  #=> "Hello __VAR_0__"
+    #   extractor.extract  #=> "Hello VARIABLE_0"
     #
     def extract
       return "" if original_text.nil? || original_text.empty?
@@ -112,7 +112,7 @@ module BetterTranslate
     # @example Successful restore
     #   extractor = VariableExtractor.new("Hello %{name}")
     #   extractor.extract
-    #   extractor.restore("Ciao __VAR_0__")  #=> "Ciao %{name}"
+    #   extractor.restore("Ciao VARIABLE_0")  #=> "Ciao %{name}"
     #
     # @example Strict mode with missing variable
     #   extractor = VariableExtractor.new("Hello %{name}")

data/lib/better_translate/version.rb

@@ -2,5 +2,5 @@
 
 module BetterTranslate
   # Current version of BetterTranslate gem
-  VERSION = "1.0.0"
+  VERSION = "1.0.0.1"
 end

data/lib/generators/better_translate/analyze/analyze_generator.rb

@@ -12,7 +12,8 @@ module BetterTranslate
     #   rails generate better_translate:analyze config/locales/en.yml
     #
     class AnalyzeGenerator < Rails::Generators::Base
-      source_root File.expand_path("templates", __dir__)
+      dir = __dir__
+      source_root File.expand_path("templates", dir) if dir
 
       desc "Analyze YAML locale file structure and statistics"
 

data/lib/generators/better_translate/install/install_generator.rb

@@ -12,7 +12,8 @@ module BetterTranslate
     #   rails generate better_translate:install
     #
     class InstallGenerator < Rails::Generators::Base
-      source_root File.expand_path("templates", __dir__)
+      dir = __dir__
+      source_root File.expand_path("templates", dir) if dir
 
       desc "Creates BetterTranslate initializer and config files"
 
@@ -46,8 +47,8 @@ module BetterTranslate
           "dry_run" => false,
           "translation_mode" => "override",
           "preserve_variables" => true,
-          "global_exclusions" => Array.new,
-          "exclusions_per_language" => Hash.new,
+          "global_exclusions" => [],
+          "exclusions_per_language" => {},
           "model" => nil,
           "temperature" => 0.3,
           "max_tokens" => 2000,

data/lib/generators/better_translate/install/templates/initializer.rb.tt

@@ -14,15 +14,47 @@ BetterTranslate.configure do |config|
   config.anthropic_key = ENV["ANTHROPIC_API_KEY"]
 
   # Source and target languages
-  config.source_language = "en"
-  config.target_languages = [
-    { short_name: "it", name: "Italian" },
-    { short_name: "es", name: "Spanish" },
-    { short_name: "fr", name: "French" }
-  ]
+  # Automatically uses Rails I18n configuration
+  # To configure I18n in your Rails app, set in config/application.rb:
+  #   config.i18n.default_locale = :it
+  #   config.i18n.available_locales = [:it, :en, :es, :fr]
+  config.source_language = I18n.default_locale.to_s
+
+  # Target languages: automatically derived from I18n.available_locales
+  # Excludes the source language from targets
+  available_targets = (I18n.available_locales - [I18n.default_locale]).map(&:to_s)
+
+  # Language name mapping for common languages
+  language_names = {
+    "en" => "English", "it" => "Italian", "es" => "Spanish", "fr" => "French",
+    "de" => "German", "pt" => "Portuguese", "ru" => "Russian", "zh" => "Chinese",
+    "ja" => "Japanese", "ko" => "Korean", "ar" => "Arabic", "nl" => "Dutch",
+    "pl" => "Polish", "tr" => "Turkish", "sv" => "Swedish", "da" => "Danish",
+    "fi" => "Finnish", "no" => "Norwegian", "cs" => "Czech", "el" => "Greek",
+    "he" => "Hebrew", "hi" => "Hindi", "th" => "Thai", "vi" => "Vietnamese"
+  }
+
+  if available_targets.any?
+    # Use I18n available locales
+    config.target_languages = available_targets.map do |locale|
+      {
+        short_name: locale,
+        name: language_names[locale] || locale.capitalize
+      }
+    end
+  else
+    # Fallback: suggest common languages
+    # Uncomment and modify the languages you want to translate to
+    config.target_languages = [
+      { short_name: "it", name: "Italian" },
+      { short_name: "es", name: "Spanish" },
+      { short_name: "fr", name: "French" }
+    ]
+  end
 
   # File paths
-  config.input_file = Rails.root.join("config", "locales", "en.yml").to_s
+  # Uses source_language for input file
+  config.input_file = Rails.root.join("config", "locales", "#{config.source_language}.yml").to_s
   config.output_folder = Rails.root.join("config", "locales").to_s
 
   # Options

data/lib/generators/better_translate/translate/translate_generator.rb

@@ -15,7 +15,8 @@ module BetterTranslate
     #   rails generate better_translate:translate --dry-run
     #
     class TranslateGenerator < Rails::Generators::Base
-      source_root File.expand_path("templates", __dir__)
+      dir = __dir__
+      source_root File.expand_path("templates", dir) if dir
 
       desc "Run BetterTranslate translation task"
 

data/regenerate_vcr.rb

@@ -0,0 +1,47 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "dotenv/load"
+require "vcr"
+require "webmock/rspec"
+require_relative "lib/better_translate"
+require "tmpdir"
+
+# Setup VCR
+VCR.configure do |config|
+  config.cassette_library_dir = "spec/vcr_cassettes"
+  config.hook_into :webmock
+  config.filter_sensitive_data("<GEMINI_API_KEY>") { ENV["GEMINI_API_KEY"] }
+  config.default_cassette_options = { record: :all }
+end
+
+test_dir = Dir.mktmpdir("gemini_test")
+puts "Test output dir: #{test_dir}"
+
+VCR.use_cassette("rails/dummy_app_gemini_translation", record: :all) do
+  config = BetterTranslate::Configuration.new
+  config.provider = :gemini
+  config.gemini_key = ENV["GEMINI_API_KEY"]
+  config.source_language = "en"
+  config.target_languages = [{ short_name: "fr", name: "French" }]
+  config.input_file = "spec/dummy/config/locales/en.yml"
+  config.output_folder = test_dir
+  config.cache_enabled = false
+  config.verbose = true
+  config.validate!
+
+  puts "Starting translation..."
+  translator = BetterTranslate::Translator.new(config)
+  results = translator.translate_all
+
+  puts "\nResults: #{results.inspect}"
+  puts "\nFiles created:"
+  Dir.entries(test_dir).each { |f| puts "  - #{f}" unless f.start_with?(".") }
+
+  if results[:success_count].positive?
+    puts "\n✓ Successfully regenerated VCR cassette!"
+  else
+    puts "\n✗ Translation failed"
+  end
+end

data/sig/better_translate/configuration.rbs

@@ -31,8 +31,13 @@ module BetterTranslate
     attr_accessor provider: (Symbol | nil)
     attr_accessor openai_key: String?
     attr_accessor google_gemini_key: String?
-    attr_accessor gemini_key: String?
-    attr_accessor anthropic_key: String?
+    attr_accessor claude_key: String?
+
+    # Aliases (these are methods created by alias in configuration.rb)
+    alias gemini_key google_gemini_key
+    alias gemini_key= google_gemini_key=
+    alias anthropic_key claude_key
+    alias anthropic_key= claude_key=
     attr_accessor source_language: String?
     attr_accessor target_languages: Array[target_language]
     attr_accessor input_file: String?

data/sig/better_translate/providers/base_http_provider.rbs

@@ -36,7 +36,7 @@ module BetterTranslate
 
       def http_client: () -> Faraday::Connection
 
-      def with_cache: [T] (String cache_key) { () -> T } -> T
+      def with_cache: (String cache_key) { () -> String } -> String
 
       def build_cache_key: (String text, String target_lang_code) -> String
     end

data/sig/better_translate/variable_extractor.rbs

@@ -33,7 +33,7 @@ module BetterTranslate
 
     def validate_variables!: (String text) -> true
 
-    def self.find_variables: (String? text) -> Array[String]
+    def self.find_variables: (String? text) -> Array[String | Array[String?]]
 
     def self.contains_variables?: (String? text) -> bool
   end

data/sig/better_translate.rbs

@@ -5,7 +5,8 @@
 module BetterTranslate
   type translation_results = { success_count: Integer, failure_count: Integer, errors: Array[Hash[Symbol, untyped]] }
 
-  @configuration: Configuration?
+  # Module-level instance variable (for singleton methods)
+  self.@configuration: Configuration?
 
   # Configure BetterTranslate
   #

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: better_translate
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.0.1
 platform: ruby
 authors:
 - alessiobussolari
@@ -42,6 +42,7 @@ files:
 - CODE_OF_CONDUCT.md
 - LICENSE.txt
 - README.md
+- RELEASE_NOTES_v1.0.0.md
 - Rakefile
 - Steepfile
 - docs/implementation/00-overview.md
@@ -92,6 +93,7 @@ files:
 - lib/generators/better_translate/translate/USAGE
 - lib/generators/better_translate/translate/translate_generator.rb
 - lib/tasks/better_translate.rake
+- regenerate_vcr.rb
 - sig/better_translate.rbs
 - sig/better_translate/cache.rbs
 - sig/better_translate/cli.rbs