better_translate 0.5.0 → 1.0.0

metadata

@@ -1,249 +1,135 @@
 --- !ruby/object:Gem::Specification
 name: better_translate
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 1.0.0
 platform: ruby
 authors:
-- Alessio Bussolari
+- alessiobussolari
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-03-11 00:00:00.000000000 Z
+date: 2025-10-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: ruby-progressbar
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.13'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.13'
-- !ruby/object:Gem::Dependency
-  name: httparty
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.21.0
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.21.0
-- !ruby/object:Gem::Dependency
-  name: zeitwerk
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.6'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.6'
-- !ruby/object:Gem::Dependency
-  name: bundler
+  name: faraday
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.0'
-  type: :development
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.0'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13.0'
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.12'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.12'
-- !ruby/object:Gem::Dependency
-  name: rubocop
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.50'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.50'
-- !ruby/object:Gem::Dependency
-  name: rubocop-rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.6'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.6'
-- !ruby/object:Gem::Dependency
-  name: rubocop-rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.22'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.22'
-- !ruby/object:Gem::Dependency
-  name: yard
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.9'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.9'
-- !ruby/object:Gem::Dependency
-  name: simplecov
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.22'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.22'
-- !ruby/object:Gem::Dependency
-  name: webmock
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.19'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.19'
-- !ruby/object:Gem::Dependency
-  name: dotenv
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.8'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.8'
-description: |
-  BetterTranslate is a powerful Ruby gem for translating YAML files using AI providers.
-
-  Key features:
-  * Multiple AI providers support (ChatGPT and Google Gemini)
-  * Smart translation modes (override/incremental)
-  * LRU caching for performance
-  * Precise key exclusion control
-  * Rails integration with generators
-  * Progress tracking with progress bar
-  * Comprehensive test coverage
-
-  Perfect for internationalizing Ruby/Rails applications with minimal effort.
+description: Automatically translate YAML locale files using AI providers (ChatGPT,
+  Gemini, Claude). Features intelligent caching, batch processing, and Rails integration.
 email:
 - alessio.bussolari@pandev.it
-executables: []
+executables:
+- better_translate
 extensions: []
 extra_rdoc_files: []
 files:
+- ".env.example"
+- ".rspec"
+- ".rubocop.yml"
+- ".yardopts"
 - CHANGELOG.md
+- CLAUDE.md
 - CODE_OF_CONDUCT.md
 - LICENSE.txt
 - README.md
 - Rakefile
+- Steepfile
+- docs/implementation/00-overview.md
+- docs/implementation/01-setup_dependencies.md
+- docs/implementation/02-error_handling.md
+- docs/implementation/03-core_components.md
+- docs/implementation/03.5-variable_preservation.md
+- docs/implementation/04-provider_architecture.md
+- docs/implementation/05-translation_logic.md
+- docs/implementation/06-main_module_api.md
+- docs/implementation/07-direct_translation_helpers.md
+- docs/implementation/08-rails_integration.md
+- docs/implementation/09-testing_suite.md
+- docs/implementation/10-documentation_examples.md
+- docs/implementation/11-quality_security.md
+- docs/implementation/12-cli_standalone.md
+- exe/better_translate
 - lib/better_translate.rb
-- lib/better_translate/helper.rb
-- lib/better_translate/providers/base_provider.rb
+- lib/better_translate/cache.rb
+- lib/better_translate/cli.rb
+- lib/better_translate/configuration.rb
+- lib/better_translate/direct_translator.rb
+- lib/better_translate/errors.rb
+- lib/better_translate/progress_tracker.rb
+- lib/better_translate/provider_factory.rb
+- lib/better_translate/providers/anthropic_provider.rb
+- lib/better_translate/providers/base_http_provider.rb
 - lib/better_translate/providers/chatgpt_provider.rb
 - lib/better_translate/providers/gemini_provider.rb
-- lib/better_translate/service.rb
-- lib/better_translate/similarity_analyzer.rb
+- lib/better_translate/railtie.rb
+- lib/better_translate/rate_limiter.rb
+- lib/better_translate/strategies/base_strategy.rb
+- lib/better_translate/strategies/batch_strategy.rb
+- lib/better_translate/strategies/deep_strategy.rb
+- lib/better_translate/strategies/strategy_selector.rb
 - lib/better_translate/translator.rb
-- lib/better_translate/utils.rb
+- lib/better_translate/utils/hash_flattener.rb
+- lib/better_translate/validator.rb
+- lib/better_translate/variable_extractor.rb
 - lib/better_translate/version.rb
-- lib/better_translate/writer.rb
-- lib/generators/better_translate/analyze_generator.rb
-- lib/generators/better_translate/install_generator.rb
-- lib/generators/better_translate/templates/better_translate.rb
-- lib/generators/better_translate/translate_generator.rb
+- lib/better_translate/yaml_handler.rb
+- lib/generators/better_translate/analyze/USAGE
+- lib/generators/better_translate/analyze/analyze_generator.rb
+- lib/generators/better_translate/install/USAGE
+- lib/generators/better_translate/install/install_generator.rb
+- lib/generators/better_translate/install/templates/README
+- lib/generators/better_translate/install/templates/initializer.rb.tt
+- lib/generators/better_translate/translate/USAGE
+- lib/generators/better_translate/translate/translate_generator.rb
+- lib/tasks/better_translate.rake
 - sig/better_translate.rbs
+- sig/better_translate/cache.rbs
+- sig/better_translate/cli.rbs
+- sig/better_translate/configuration.rbs
+- sig/better_translate/direct_translator.rbs
+- sig/better_translate/errors.rbs
+- sig/better_translate/progress_tracker.rbs
+- sig/better_translate/provider_factory.rbs
+- sig/better_translate/providers/anthropic_provider.rbs
+- sig/better_translate/providers/base_http_provider.rbs
+- sig/better_translate/providers/chatgpt_provider.rbs
+- sig/better_translate/providers/gemini_provider.rbs
+- sig/better_translate/railtie.rbs
+- sig/better_translate/rate_limiter.rbs
+- sig/better_translate/strategies/base_strategy.rbs
+- sig/better_translate/strategies/batch_strategy.rbs
+- sig/better_translate/strategies/deep_strategy.rbs
+- sig/better_translate/strategies/strategy_selector.rbs
+- sig/better_translate/translator.rbs
+- sig/better_translate/utils/hash_flattener.rbs
+- sig/better_translate/validator.rbs
+- sig/better_translate/variable_extractor.rbs
+- sig/better_translate/version.rbs
+- sig/better_translate/yaml_handler.rbs
+- sig/faraday.rbs
+- sig/generators/better_translate/analyze/analyze_generator.rbs
+- sig/generators/better_translate/install/install_generator.rbs
+- sig/generators/better_translate/translate/translate_generator.rbs
+- sig/optparse.rbs
+- sig/psych.rbs
+- sig/rails.rbs
 homepage: https://github.com/alessiobussolari/better_translate
 licenses:
 - MIT
 metadata:
-  allowed_push_host: https://rubygems.org
-  rubygems_mfa_required: 'true'
   homepage_uri: https://github.com/alessiobussolari/better_translate
   source_code_uri: https://github.com/alessiobussolari/better_translate
   changelog_uri: https://github.com/alessiobussolari/better_translate/blob/main/CHANGELOG.md
-  bug_tracker_uri: https://github.com/alessiobussolari/better_translate/issues
-  documentation_uri: https://github.com/alessiobussolari/better_translate
-  wiki_uri: https://github.com/alessiobussolari/better_translate/wiki
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -262,5 +148,5 @@ requirements: []
 rubygems_version: 3.5.11
 signing_key:
 specification_version: 4
-summary: AI-powered YAML translation with ChatGPT and Google Gemini
+summary: AI-powered YAML locale file translator for Rails and Ruby projects
 test_files: []

data/lib/better_translate/helper.rb

@@ -1,83 +0,0 @@
-module BetterTranslate
-  # Helper class that provides utility methods for translating text and arrays of text
-  # to multiple target languages using different translation providers.
-  # This class simplifies the process of translating content by abstracting away
-  # the provider-specific implementation details.
-  #
-  # @example Translating a single text to multiple languages
-  #   BetterTranslate::Helper.translate_text_to_languages(
-  #     "Hello world!",
-  #     [{ short_name: "it", name: "Italian" }, { short_name: "fr", name: "French" }],
-  #     "en",
-  #     :chatgpt
-  #   )
-  class Helper
-    class << self
-      # Translates a given text into multiple target languages.
-      #
-      # @param text [String] The text to be translated.
-      # @param target_languages [Array<Hash>] Array of target language hashes,
-      #   e.g. [{ short_name: "it", name: "Italian" }, { short_name: "fr", name: "French" }]
-      # @param source_language [String] The source language code (e.g., "en").
-      # @param provider_name [Symbol] The provider to use (e.g., :chatgpt or :gemini).
-      # @return [Hash] A hash where each key is a target language code and the value is the translated text.
-      #
-      # Example:
-      #   translated = BetterTranslate::Helpers.translate_text_to_languages(
-      #     "Hello world!",
-      #     [{ short_name: "it", name: "Italian" }, { short_name: "fr", name: "French" }],
-      #     "en",
-      #     :chatgpt
-      #   )
-      #   # => { "it" => "Ciao mondo!", "fr" => "Bonjour le monde!" }
-      def translate_text_to_languages(text, target_languages, source_language, provider_name)
-        provider_instance = case provider_name
-                            when :chatgpt
-                              Providers::ChatgptProvider.new(BetterTranslate.configuration.openai_key)
-                            when :gemini
-                              Providers::GeminiProvider.new(BetterTranslate.configuration.google_gemini_key)
-                            else
-                              raise "Provider not supported: #{provider_name}"
-                            end
-
-        result = {}
-        target_languages.each do |lang|
-          # Optionally, you could also pass the source_language if needed by your provider.
-          translated_text = provider_instance.translate(text, lang[:short_name], lang[:name])
-          result[lang[:short_name]] = translated_text
-        end
-        result
-      end
-
-      # Translates an array of texts into multiple target languages using the translate_text_to_languages helper.
-      #
-      # @param texts [Array<String>] An array of texts to translate.
-      # @param target_languages [Array<Hash>] Array of target language hashes,
-      #   e.g. [{ short_name: "it", name: "Italian" }, { short_name: "fr", name: "French" }].
-      # @param source_language [String] The source language code (e.g., "en").
-      # @param provider_name [Symbol] The provider to use (e.g., :chatgpt or :gemini).
-      # @return [Hash] A hash where each key is a target language code and the value is an array of translated texts.
-      #
-      # Example:
-      #   texts = ["Hello world!", "How are you?"]
-      #   result = BetterTranslate::TranslationHelper.translate_texts_to_languages(
-      #     texts,
-      #     [{ short_name: "it", name: "Italian" }, { short_name: "fr", name: "French" }],
-      #     "en",
-      #     :chatgpt
-      #   )
-      #   # => { "it" => ["Ciao mondo!", "Come stai?"], "fr" => ["Bonjour le monde!", "Comment ça va?"] }
-      def translate_texts_to_languages(texts, target_languages, source_language, provider_name)
-        result = {}
-        target_languages.each do |lang|
-          # For each target language, translate each text and collect translations into an array.
-          result[lang[:short_name]] = texts.map do |text|
-            translation_hash = translate_text_to_languages(text, [lang], source_language, provider_name)
-            translation_hash[lang[:short_name]]
-          end
-        end
-        result
-      end
-    end
-  end
-end

data/lib/better_translate/providers/base_provider.rb

@@ -1,102 +0,0 @@
-module BetterTranslate
-  module Providers
-    # Abstract base class for translation providers.
-    # Provides common functionality and defines the interface that all providers must implement.
-    # Handles rate limiting, input validation, and retry logic for failed translations.
-    #
-    # @abstract Subclass and override {#translate_text} to implement a provider
-    class BaseProvider
-      # Number of retry attempts for failed translations
-      MAX_RETRIES = 3
-      
-      # Delay in seconds between retry attempts
-      RETRY_DELAY = 2 # seconds
-      
-      # Initializes a new provider instance with the specified API key.
-      #
-      # @param api_key [String] The API key for the translation service
-      # @return [BaseProvider] A new instance of the provider
-      def initialize(api_key)
-        @api_key = api_key
-        @last_request_time = Time.now - 1
-      end
-
-      private
-
-      # Implements a simple rate limiting mechanism to prevent overloading the API.
-      # Ensures at least 0.5 seconds between consecutive requests.
-      #
-      # @return [void]
-      def rate_limit
-        time_since_last_request = Time.now - @last_request_time
-        sleep(0.5 - time_since_last_request) if time_since_last_request < 0.5
-        @last_request_time = Time.now
-      end
-
-      # Validates the input parameters for translation.
-      # Ensures that the text is not empty and the language code is in a valid format.
-      #
-      # @param text [String] The text to translate
-      # @param target_lang_code [String] The target language code (e.g., "en", "fr-FR")
-      # @raise [ArgumentError] If the text is empty or the language code is invalid
-      # @return [void]
-      def validate_input(text, target_lang_code)
-        raise ArgumentError, "Text cannot be empty" if text.nil? || text.strip.empty?
-        raise ArgumentError, "Invalid target language code" unless target_lang_code.match?(/^[a-z]{2}(-[A-Z]{2})?$/)
-      end
-
-      # Public method to translate text with built-in retry logic.
-      # Attempts to translate the text and retries on failure up to MAX_RETRIES times.
-      #
-      # @param text [String] The text to translate
-      # @param target_lang_code [String] The target language code (e.g., "en")
-      # @param target_lang_name [String] The target language name (e.g., "English")
-      # @return [String] The translated text
-      # @raise [StandardError] If translation fails after all retry attempts
-      def translate(text, target_lang_code, target_lang_name)
-        retries = 0
-        begin
-          perform_translation(text, target_lang_code, target_lang_name)
-        rescue StandardError => e
-          retries += 1
-          if retries <= MAX_RETRIES
-            message = "Translation attempt #{retries} failed. Retrying in #{RETRY_DELAY} seconds..."
-            BetterTranslate::Utils.logger(message: message)
-            sleep(RETRY_DELAY)
-            retry
-          else
-            message = "Translation failed after #{MAX_RETRIES} attempts: #{e.message}"
-            BetterTranslate::Utils.logger(message: message)
-            raise
-          end
-        end
-      end
-
-      # Performs the actual translation process.
-      # Validates input, applies rate limiting, and calls the provider-specific translation method.
-      #
-      # @param text [String] The text to translate
-      # @param target_lang_code [String] The target language code
-      # @param target_lang_name [String] The target language name
-      # @return [String] The translated text
-      def perform_translation(text, target_lang_code, target_lang_name)
-        validate_input(text, target_lang_code)
-        rate_limit
-        translate_text(text, target_lang_code, target_lang_name)
-      end
-
-      # Provider-specific implementation of the translation logic.
-      # Must be overridden by subclasses to implement the actual translation.
-      #
-      # @abstract
-      # @param text [String] The text to translate
-      # @param target_lang_code [String] The target language code
-      # @param target_lang_name [String] The target language name
-      # @return [String] The translated text
-      # @raise [NotImplementedError] If the method is not overridden by a subclass
-      def translate_text(text, target_lang_code, target_lang_name)
-        raise NotImplementedError, "The provider #{self.class} must implement the translate_text method"
-      end
-    end
-  end
-end

data/lib/better_translate/service.rb

@@ -1,144 +0,0 @@
-module BetterTranslate
-  # Service class that handles translation requests using the configured provider.
-  # Implements a Least Recently Used (LRU) cache to avoid redundant translation requests.
-  # Supports built-in providers (ChatGPT, Gemini) and custom providers registered via
-  # the register_provider class method.
-  #
-  # @example
-  #   service = BetterTranslate::Service.new
-  #   translated_text = service.translate("Hello world", "fr", "French")
-  class Service
-    # Maximum number of translations to keep in the LRU cache
-    MAX_CACHE_SIZE = 1000
-
-    # Registry for custom providers
-    @@provider_registry = {}
-
-    # Initializes a new Service instance.
-    # Sets up the translation provider based on configuration and initializes the LRU cache.
-    #
-    # @return [BetterTranslate::Service] A new Service instance
-    def initialize
-      @provider_name = BetterTranslate.configuration.provider
-      @translation_cache = {}
-      @cache_order = []
-    end
-
-    # Translates text using the configured provider with caching support.
-    # First checks if the translation is already in the cache. If not, it uses the
-    # provider to translate the text and then caches the result for future use.
-    # Also tracks metrics about the translation request duration.
-    #
-    # @param text [String] The text to translate
-    # @param target_lang_code [String] The target language code (e.g., 'fr', 'es')
-    # @param target_lang_name [String] The target language name (e.g., 'French', 'Spanish')
-    # @return [String] The translated text
-    def translate(text, target_lang_code, target_lang_name)
-      cache_key = "#{text}:#{target_lang_code}"
-
-      # Prova a recuperare dalla cache
-      cached = cache_get(cache_key)
-      return cached if cached
-
-      # Traduci e salva in cache
-      start_time = Time.now
-      result = provider_instance.translate_text(text, target_lang_code, target_lang_name)
-      duration = Time.now - start_time
-
-      BetterTranslate::Utils.track_metric("translation_request_duration", {
-        provider: @provider_name,
-        text_length: text.length,
-        duration: duration
-      })
-
-      cache_set(cache_key, result)
-    end
-
-    private
-
-    # Retrieves a translation from the LRU cache if it exists.
-    # Updates the cache order to mark this key as most recently used.
-    #
-    # @param key [String] The cache key in the format "text:target_lang_code"
-    # @return [String, nil] The cached translation or nil if not found
-    def cache_get(key)
-      if @translation_cache.key?(key)
-        # Aggiorna l'ordine LRU
-        @cache_order.delete(key)
-        @cache_order.push(key)
-        @translation_cache[key]
-      end
-    end
-
-    # Stores a translation in the LRU cache.
-    # If the cache is full, removes the least recently used item before adding the new one.
-    #
-    # @param key [String] The cache key in the format "text:target_lang_code"
-    # @param value [String] The translated text to cache
-    # @return [String] The value that was cached
-    def cache_set(key, value)
-      if @translation_cache.size >= MAX_CACHE_SIZE
-        # Rimuovi l'elemento meno recentemente usato
-        oldest_key = @cache_order.shift
-        @translation_cache.delete(oldest_key)
-      end
-
-      @translation_cache[key] = value
-      @cache_order.push(key)
-      value
-    end
-
-
-
-    # Creates or returns a cached instance of the translation provider.
-    # The provider is determined by the configuration and instantiated with the appropriate API key.
-    # Supports built-in providers (ChatGPT, Gemini) and custom providers registered via
-    # the register_provider class method.
-    #
-    # @return [BetterTranslate::Providers::BaseProvider] An instance of the configured translation provider
-    # @raise [RuntimeError] If the configured provider is not supported
-    def provider_instance
-      @provider_instance ||= case @provider_name
-                             when :chatgpt
-                               Providers::ChatgptProvider.new(BetterTranslate.configuration.openai_key)
-                             when :gemini
-                               Providers::GeminiProvider.new(BetterTranslate.configuration.google_gemini_key)
-                             else
-                               if @@provider_registry.key?(@provider_name)
-                                 # Get the API key from configuration dynamically
-                                 api_key_method = "#{@provider_name}_key".to_sym
-                                 if BetterTranslate.configuration.respond_to?(api_key_method)
-                                   api_key = BetterTranslate.configuration.send(api_key_method)
-                                   @@provider_registry[@provider_name].call(api_key)
-                                 else
-                                   raise "API key configuration missing for provider: #{@provider_name}. Add config.#{@provider_name}_key to your BetterTranslate configuration."
-                                 end
-                               else
-                                 raise "Provider not supported: #{@provider_name}. Available providers: #{available_providers.join(', ')}"
-                               end
-                             end
-    end
-
-    # Returns a list of all available provider names
-    # @return [Array<Symbol>] List of available provider names
-    def available_providers
-      [:chatgpt, :gemini] + @@provider_registry.keys
-    end
-
-    # Registers a custom provider for use with BetterTranslate
-    # 
-    # @param name [Symbol] The name of the provider to register
-    # @param factory [Proc] A proc that takes an API key and returns a provider instance
-    # @return [Symbol] The name of the registered provider
-    # 
-    # @example Register a custom DeepL provider
-    #   BetterTranslate::Service.register_provider(
-    #     :deepl,
-    #     ->(api_key) { Providers::DeepLProvider.new(api_key) }
-    #   )
-    def self.register_provider(name, factory)
-      @@provider_registry[name] = factory
-      name
-    end
-  end
-end