better_translate 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6a19ffdafe02b71cad6e1d93eba868299d8551adc3e7952450c709c3f71d1292
-  data.tar.gz: 7c5d7dde1f0b120124d13f75c31637b2a304845955a2974fc7f0c2f58eec8e76
+  metadata.gz: 80868b0f529d5c8310efabe07a402bd89d015e6bced86a3c0e2689e288d702f6
+  data.tar.gz: fdaede4b54e2c956d3f2cc936f221a83703a2001e1d647fec3abe2283d11e157
 SHA512:
-  metadata.gz: a0c9c62cc2a35a0663d79af39c8e4a87cd86106b906b185c805f4ff9cba2bdfa82c1eaf8c366b5e91e70fe0c5ea87d5da852e03c32ae2a3959ae32ef2318d62a
-  data.tar.gz: 6fb2cac27269257f878d3055027213dc2bef5d75332132f559493064a4c83f1360903080571a3fd1e71c7c6feec73cf41ff619d8ecc8da180246779b5e893e59
+  metadata.gz: 90a863900c1e132d7be3bf96a80a66cfad9580e38d7c634fd0e8dcea891be5768ff4cd548eadae6a74dde15a18c4f839a047e8e0653e6642272e518e6859ebac
+  data.tar.gz: 3ffb3062a2919d7296fe0ad95f28f29d5352ea3c126f12d09c89229378194a6386c4da65a7d419e7868d34d2297353a2561364600b1b5fe09d30ee9a24244408

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 🎉