better_translate 1.0.0.1 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b02561def13795980279169998c3a28170f0c2b1c4c7e4ffc58ae61b20b98ff5
-  data.tar.gz: d44be305f231f038918bb8dbf722db94328d9d9e71f1bcdd8bbe32aefceeb2f1
+  metadata.gz: 602a159b9ba2217e813a2d2b2f5b121e2fcc33006b18f12de64a99eb83ba3b16
+  data.tar.gz: 9c4db4fb12302620492af42d6db5e369f2d00fac3c62d288d6d11e872bb5acf1
 SHA512:
-  metadata.gz: 98e5a8fb7c3103220b6b2102a2242a8bb4d103a8e3b2df24298e3fa4a3f8e75dae3b48ebbb578a59de84e7c547f3bc12cab71a77c789aa9ab347b7d424aea113
-  data.tar.gz: 6aeaafff6b3ff756c620e229d93582ab64a48dca322d21b32d5d38a408e5f6d085ef5ba280da141d0c65b02ca54c3b5559bda29e204aff81b0a6562fac0b860f
+  metadata.gz: a67b31f8cc1aa48775baddae6982f2bcc0e18a9a3966981b40a6b122e976ebd93922f17cbfc7ae8eeddd8741668006eafcedec13dcdf63cfdd209ed2695f4de3
+  data.tar.gz: a5f455c8a676a0899bab3e03bf71ed51c6d4a5b16e81cb1bfb6ef90e560352758319a6616e1f269039a47decf14e72070bdfe39be5ebec6457c83cbd9b79a47e

data/.rubocop.yml

@@ -1,8 +1,36 @@
+inherit_from: .rubocop_todo.yml
+
+inherit_mode:
+  merge:
+    - Exclude
+
+plugins:
+  - rubocop-rake
+  - rubocop-rspec
+
 AllCops:
   TargetRubyVersion: 3.0
+  NewCops: enable
 
 Style/StringLiterals:
   EnforcedStyle: double_quotes
 
 Style/StringLiteralsInInterpolation:
   EnforcedStyle: double_quotes
+
+Metrics/BlockLength:
+  Exclude:
+    - 'spec/**/*_spec.rb'
+    - 'Rakefile'
+    - '*.gemspec'
+
+# RSpec-specific configurations
+RSpec/MultipleExpectations:
+  Max: 5
+
+RSpec/ExampleLength:
+  Max: 15
+
+RSpec/DescribeClass:
+  Exclude:
+    - 'spec/integration/**/*'

data/.rubocop_todo.yml

@@ -0,0 +1,291 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2025-10-22 20:47:42 UTC using RuboCop version 1.81.6.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: Severity.
+Gemspec/RequireMFA:
+  Exclude:
+    - 'better_translate.gemspec'
+
+# Offense count: 4
+# This cop supports safe autocorrection (--autocorrect).
+Lint/AmbiguousOperatorPrecedence:
+  Exclude:
+    - 'lib/better_translate/analyzer/reporter.rb'
+
+# Offense count: 1
+Lint/FloatComparison:
+  Exclude:
+    - 'spec/better_translate/providers/chatgpt_provider_spec.rb'
+
+# Offense count: 8
+# This cop supports unsafe autocorrection (--autocorrect-all).
+Lint/NonAtomicFileOperation:
+  Exclude:
+    - 'lib/better_translate/json_handler.rb'
+    - 'lib/better_translate/yaml_handler.rb'
+    - 'spec/better_translate/analyzer/key_scanner_spec.rb'
+    - 'spec/better_translate/analyzer/reporter_spec.rb'
+
+# Offense count: 22
+# Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes.
+Metrics/AbcSize:
+  Max: 116
+
+# Offense count: 7
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns, inherit_mode.
+# AllowedMethods: refine
+Metrics/BlockLength:
+  Max: 99
+
+# Offense count: 3
+# Configuration parameters: CountComments, CountAsOne.
+Metrics/ClassLength:
+  Max: 246
+
+# Offense count: 12
+# Configuration parameters: AllowedMethods, AllowedPatterns.
+Metrics/CyclomaticComplexity:
+  Max: 24
+
+# Offense count: 41
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
+Metrics/MethodLength:
+  Max: 61
+
+# Offense count: 1
+# Configuration parameters: CountKeywordArgs, MaxOptionalParameters.
+Metrics/ParameterLists:
+  Max: 6
+
+# Offense count: 9
+# Configuration parameters: AllowedMethods, AllowedPatterns.
+Metrics/PerceivedComplexity:
+  Max: 25
+
+# Offense count: 2
+Naming/AccessorMethodName:
+  Exclude:
+    - 'lib/better_translate/json_handler.rb'
+    - 'lib/better_translate/yaml_handler.rb'
+
+# Offense count: 6
+# Configuration parameters: Mode, AllowedMethods, AllowedPatterns, AllowBangMethods, WaywardPredicates.
+# AllowedMethods: call
+# WaywardPredicates: nonzero?
+Naming/PredicateMethod:
+  Exclude:
+    - 'lib/better_translate/configuration.rb'
+    - 'lib/better_translate/validator.rb'
+    - 'lib/better_translate/variable_extractor.rb'
+
+# Offense count: 30
+RSpec/AnyInstance:
+  Exclude:
+    - 'spec/better_translate/cli_spec.rb'
+    - 'spec/better_translate/direct_translator_spec.rb'
+    - 'spec/better_translate/multiple_files_spec.rb'
+    - 'spec/better_translate/rake_tasks_spec.rb'
+    - 'spec/better_translate/translator_spec.rb'
+    - 'spec/better_translate_spec.rb'
+    - 'spec/generators/translate_generator_spec.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: be, be_nil
+RSpec/BeNil:
+  Exclude:
+    - 'spec/better_translate_spec.rb'
+
+# Offense count: 6
+RSpec/BeforeAfterAll:
+  Exclude:
+    - '**/spec/spec_helper.rb'
+    - '**/spec/rails_helper.rb'
+    - '**/spec/support/**/*.rb'
+    - 'spec/generators/analyze_generator_spec.rb'
+    - 'spec/generators/install_generator_spec.rb'
+    - 'spec/generators/translate_generator_spec.rb'
+
+# Offense count: 13
+# Configuration parameters: Prefixes, AllowedPatterns.
+# Prefixes: when, with, without
+RSpec/ContextWording:
+  Exclude:
+    - 'spec/better_translate/analyzer/reporter_spec.rb'
+    - 'spec/better_translate/configuration_spec.rb'
+    - 'spec/better_translate/strategies/batch_strategy_spec.rb'
+    - 'spec/better_translate/strategies/deep_strategy_spec.rb'
+    - 'spec/better_translate/strategies/strategy_selector_spec.rb'
+
+# Offense count: 2
+# Configuration parameters: IgnoredMetadata.
+RSpec/DescribeClass:
+  Exclude:
+    - 'spec/integration/**/*'
+    - 'spec/better_translate/multiple_files_spec.rb'
+    - 'spec/better_translate/rake_tasks_spec.rb'
+
+# Offense count: 1
+# This cop supports unsafe autocorrection (--autocorrect-all).
+# Configuration parameters: SkipBlocks, EnforcedStyle, OnlyStaticConstants.
+# SupportedStyles: described_class, explicit
+RSpec/DescribedClass:
+  Exclude:
+    - 'spec/better_translate/cli_spec.rb'
+
+# Offense count: 18
+# Configuration parameters: Max, CountAsOne.
+RSpec/ExampleLength:
+  Exclude:
+    - 'spec/better_translate/configuration_spec.rb'
+    - 'spec/better_translate/direct_translator_spec.rb'
+    - 'spec/better_translate/providers/base_http_provider_spec.rb'
+    - 'spec/better_translate/strategies/batch_strategy_spec.rb'
+    - 'spec/better_translate/strategies/deep_strategy_spec.rb'
+    - 'spec/better_translate/translator_spec.rb'
+    - 'spec/integration/analyzer_integration_spec.rb'
+
+# Offense count: 11
+# This cop supports safe autocorrection (--autocorrect).
+RSpec/LeadingSubject:
+  Exclude:
+    - 'spec/better_translate/direct_translator_spec.rb'
+    - 'spec/better_translate/json_handler_spec.rb'
+    - 'spec/better_translate/providers/anthropic_provider_spec.rb'
+    - 'spec/better_translate/providers/base_http_provider_spec.rb'
+    - 'spec/better_translate/providers/chatgpt_provider_spec.rb'
+    - 'spec/better_translate/providers/gemini_provider_spec.rb'
+    - 'spec/better_translate/strategies/base_strategy_spec.rb'
+    - 'spec/better_translate/yaml_handler_spec.rb'
+    - 'spec/integration/anthropic_integration_spec.rb'
+    - 'spec/integration/chatgpt_integration_spec.rb'
+    - 'spec/integration/gemini_integration_spec.rb'
+
+# Offense count: 32
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: have_received, receive
+RSpec/MessageSpies:
+  Exclude:
+    - 'spec/better_translate/strategies/batch_strategy_spec.rb'
+    - 'spec/better_translate/strategies/deep_strategy_spec.rb'
+
+# Offense count: 1
+RSpec/MultipleDescribes:
+  Exclude:
+    - 'spec/better_translate/errors_spec.rb'
+
+# Offense count: 9
+# Configuration parameters: Max.
+RSpec/MultipleExpectations:
+  Exclude:
+    - 'spec/better_translate/configuration_spec.rb'
+    - 'spec/better_translate/providers/anthropic_provider_spec.rb'
+    - 'spec/better_translate/providers/chatgpt_provider_spec.rb'
+    - 'spec/better_translate/strategies/batch_strategy_spec.rb'
+    - 'spec/better_translate/strategies/deep_strategy_spec.rb'
+    - 'spec/better_translate_spec.rb'
+    - 'spec/integration/analyzer_integration_spec.rb'
+
+# Offense count: 22
+# Configuration parameters: AllowSubject.
+RSpec/MultipleMemoizedHelpers:
+  Max: 6
+
+# Offense count: 16
+# This cop supports unsafe autocorrection (--autocorrect-all).
+RSpec/ReceiveMessages:
+  Exclude:
+    - 'spec/better_translate/providers/base_http_provider_spec.rb'
+
+# Offense count: 2
+RSpec/RepeatedExample:
+  Exclude:
+    - 'spec/generators/analyze_generator_spec.rb'
+
+# Offense count: 4
+# Configuration parameters: CustomTransform, IgnoreMethods, IgnoreMetadata.
+RSpec/SpecFilePathFormat:
+  Exclude:
+    - '**/spec/routing/**/*'
+    - 'spec/better_translate/providers/chatgpt_provider_spec.rb'
+    - 'spec/generators/analyze_generator_spec.rb'
+    - 'spec/generators/install_generator_spec.rb'
+    - 'spec/generators/translate_generator_spec.rb'
+
+# Offense count: 17
+RSpec/StubbedMock:
+  Exclude:
+    - 'spec/better_translate/strategies/batch_strategy_spec.rb'
+    - 'spec/better_translate/strategies/deep_strategy_spec.rb'
+
+# Offense count: 4
+RSpec/SubjectStub:
+  Exclude:
+    - 'spec/better_translate/providers/base_http_provider_spec.rb'
+
+# Offense count: 33
+# Configuration parameters: IgnoreNameless, IgnoreSymbolicNames.
+RSpec/VerifiedDoubles:
+  Exclude:
+    - 'spec/better_translate/providers/anthropic_provider_spec.rb'
+    - 'spec/better_translate/providers/base_http_provider_spec.rb'
+    - 'spec/better_translate/providers/chatgpt_provider_spec.rb'
+    - 'spec/better_translate/providers/gemini_provider_spec.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: trailing_conditional, ternary
+Style/EmptyStringInsideInterpolation:
+  Exclude:
+    - 'lib/generators/better_translate/analyze/analyze_generator.rb'
+
+# Offense count: 14
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowedVars, DefaultToNil.
+Style/FetchEnvVar:
+  Exclude:
+    - 'lib/better_translate/cli.rb'
+    - 'lib/generators/better_translate/translate/translate_generator.rb'
+    - 'lib/tasks/better_translate.rake'
+    - 'regenerate_vcr.rb'
+
+# Offense count: 5
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, MaxUnannotatedPlaceholdersAllowed, Mode, AllowedMethods, AllowedPatterns.
+# SupportedStyles: annotated, template, unannotated
+Style/FormatStringToken:
+  Exclude:
+    - 'lib/better_translate/progress_tracker.rb'
+
+# Offense count: 2
+# This cop supports unsafe autocorrection (--autocorrect-all).
+Style/HashExcept:
+  Exclude:
+    - 'lib/better_translate/json_handler.rb'
+    - 'lib/better_translate/yaml_handler.rb'
+
+# Offense count: 9
+# This cop supports safe autocorrection (--autocorrect).
+Style/IfUnlessModifier:
+  Exclude:
+    - 'lib/better_translate/configuration.rb'
+    - 'lib/better_translate/providers/anthropic_provider.rb'
+    - 'lib/better_translate/providers/chatgpt_provider.rb'
+    - 'lib/better_translate/providers/gemini_provider.rb'
+    - 'lib/better_translate/translator.rb'
+
+# Offense count: 4
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, IgnoreCopDirectives, AllowedPatterns, SplitStrings.
+# URISchemes: http, https
+Layout/LineLength:
+  Max: 181

data/CHANGELOG.md

@@ -5,6 +5,94 @@ All notable changes to BetterTranslate will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.0] - 2025-10-22
+
+### Added
+
+#### Enhanced Configuration
+- **Provider-Specific Options**: Fine-tune AI provider behavior
+  - `model`: Specify which AI model to use (e.g., "gpt-5-nano", "gemini-2.0-flash-exp")
+  - `temperature`: Control creativity/randomness (0.0-2.0, default: 0.3)
+  - `max_tokens`: Limit response length (default: 2000)
+  - Configurable via CLI, configuration file, or programmatically
+
+#### Automatic Backups
+- **Backup System**: Automatic backup creation before overwriting translation files
+  - `create_backup`: Enable/disable automatic backups (default: true)
+  - `max_backups`: Keep up to N backup files with rotation (default: 3)
+  - Backup format: `.bak`, `.bak.1`, `.bak.2`, etc.
+  - Automatic cleanup of old backups beyond `max_backups`
+  - Works with both YAML and JSON files
+
+#### JSON File Support
+- **JSON Handler**: Complete support for JSON translation files
+  - Read and write JSON locale files
+  - Automatic format detection based on file extension (.json vs .yml)
+  - Same feature set as YAML (incremental mode, backups, exclusions)
+  - Pretty-printed output with proper indentation
+  - Compatible with modern JavaScript frameworks (React, Vue, etc.)
+
+#### Parallel Translation
+- **Concurrent Processing**: Translate multiple languages simultaneously
+  - `max_concurrent_requests`: Control concurrency level (default: 3)
+  - Thread-based parallel execution for improved performance
+  - Automatic fallback to sequential processing when `max_concurrent_requests = 1`
+  - Thread-safe error handling
+  - Significant time savings for projects with many target languages
+
+#### Multiple Files Support
+- **Batch Translation**: Translate multiple files in a single run
+  - `input_files`: Accept array of file paths or glob patterns
+  - Glob pattern support: `config/locales/**/*.en.yml`
+  - Preserves directory structure in output
+  - Smart filename handling: `common.en.yml` → `common.it.yml`
+  - Works with both YAML and JSON files
+  - Backward compatible with single `input_file` attribute
+
+### Examples
+
+#### Provider-Specific Options
+```ruby
+config.model = "gpt-5-nano"           # Use specific model
+config.temperature = 0.7              # More creative translations
+config.max_tokens = 1500              # Limit response length
+```
+
+#### Automatic Backups
+```ruby
+config.create_backup = true           # Enable backups (default)
+config.max_backups = 5                # Keep up to 5 backup versions
+```
+
+#### JSON Support
+```ruby
+config.input_file = "config/locales/en.json"
+config.output_folder = "config/locales"
+# Automatically detects JSON format and uses JsonHandler
+```
+
+#### Parallel Translation
+```ruby
+config.target_languages = [
+  { short_name: "it", name: "Italian" },
+  { short_name: "fr", name: "French" },
+  { short_name: "es", name: "Spanish" }
+]
+config.max_concurrent_requests = 3   # Translate 3 languages at once
+```
+
+#### Multiple Files
+```ruby
+# Array of specific files
+config.input_files = [
+  "config/locales/common.en.yml",
+  "config/locales/errors.en.yml"
+]
+
+# Or use glob patterns
+config.input_files = "config/locales/**/*.en.yml"
+```
+
 ## [1.0.0] - 2025-10-22
 
 ### Complete Rewrite 🎉

data/CLAUDE.md

@@ -75,10 +75,21 @@ bundle exec rake steep
 # or
 bundle exec steep check
 
-# Run default rake task (runs spec, rubocop, and steep)
+# Run default rake task (runs spec, rubocop, steep, and brakeman)
 bundle exec rake
 ```
 
+### Security
+```bash
+# Run Brakeman security scanner
+bundle exec rake brakeman
+# or
+bundle exec brakeman --force --no-pager
+
+# Check for security vulnerabilities in dependencies
+bundle exec bundler-audit check --update
+```
+
 ### Documentation
 ```bash
 # Generate YARD documentation
@@ -91,12 +102,6 @@ bundle exec yard server
 bundle exec yard stats
 ```
 
-### Security
-```bash
-# Check for security vulnerabilities in dependencies
-bundle exec bundler-audit check --update
-```
-
 ### Type Checking (RBS/Steep)
 ```bash
 # Run type checking