i18n-active_record 1.2.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 696d09fb79116c47ec3924b359f31ba4c632d68a075d6da1af591dcb0412548f
-  data.tar.gz: eff1a17efd57a2f09546e80aa0d1269b07751f8615b65377c891d89186407d45
+  metadata.gz: a0bb9a3f4087d304d5ee5fdc38b8df8e31147a412c618fed9c82f1363db579be
+  data.tar.gz: b77a32f97c5d1785084a5c8332ff7e8909ce81ec6d3724ec664650540c72451d
 SHA512:
-  metadata.gz: 8dc72a6d40f4ce0da1d98f5ade7bc26f660766aa72814771f359b9c6c8e943a4c51acfce8f612794cd3ede72c3ad9808e9442524c951fded1c2ec2457be0201f
-  data.tar.gz: cc0fcb1c5121cefa325f52c4edbae8308a095d896cd6a8e3917d5c0144c1460f4f7795a4de6be9f25f399e678b4ce9fa2e95472e0cd651ee08aeead47e30ab03
+  metadata.gz: 46eb68288d4b64db1760235e72fd73a3a03e7e06d19b9f699ed4b160a423dfde3333fe92f9556fd65ed2d3f1e5d8e1e14d5ffebcfa7d7251fd37632bc3b36f44
+  data.tar.gz: 7f1ace5489592b78a2e0dab66564837025a21cb0a2b10dbaf3999a4ea128c0c983ba8f952b867236d71554226553b2c119ad32a232cf3a96c29f62200b29b9c9

data/README.md

@@ -89,11 +89,26 @@ end
 
 You can now use `I18n.t('Your String')` to lookup translations in the database.
 
-## Missing Translations
+## Custom translation model
+
+By default, the gem relies on [the built-in translation model](https://github.com/svenfuchs/i18n-active_record/blob/master/lib/i18n/backend/active_record/translation.rb).  
+However, to extend the default functionality, the translation model can be customized:
+
+```ruby
+class MyTranslation < I18n::Backend::ActiveRecord::Translation
+  def value=(val)
+    super("custom #{val}")
+  end
+end
 
-### Usage
+I18n::Backend::ActiveRecord.configure do |config|
+  config.translation_model = MyTranslation
+end
+```
+
+## Missing Translations
 
-In order to make the `I18n::Backend::ActiveRecord::Missing` module working correctly pluralization rules should be configured properly.
+To make the `I18n::Backend::ActiveRecord::Missing` module working correctly pluralization rules should be configured properly.
 The `i18n.plural.keys` translation key should be present in any of the backends.
 See https://github.com/svenfuchs/i18n-active_record/blob/master/lib/i18n/backend/active_record/missing.rb for more information.
 

data/lib/i18n/active_record/version.rb

@@ -2,6 +2,6 @@
 
 module I18n
   module ActiveRecord
-    VERSION = '1.2.0'
+    VERSION = '1.3.0'
   end
 end

data/lib/i18n/backend/active_record/configuration.rb

@@ -4,11 +4,12 @@ module I18n
   module Backend
     class ActiveRecord
       class Configuration
-        attr_accessor :cleanup_with_destroy, :cache_translations
+        attr_accessor :cleanup_with_destroy, :cache_translations, :translation_model
 
         def initialize
           @cleanup_with_destroy = false
           @cache_translations = false
+          @translation_model = I18n::Backend::ActiveRecord::Translation
         end
       end
     end

data/lib/i18n/backend/active_record/missing.rb

@@ -36,13 +36,14 @@ module I18n
     class ActiveRecord
       module Missing
         include Flatten
+        include TranslationModel
 
         def store_default_translations(locale, key, options = {})
           count, scope, _, separator = options.values_at(:count, :scope, :default, :separator)
           separator ||= I18n.default_separator
           key = normalize_flat_keys(locale, key, scope, separator)
 
-          return if ActiveRecord::Translation.locale(locale).lookup(key).exists?
+          return if translation_model.locale(locale).lookup(key).exists?
 
           interpolations = options.keys - I18n::RESERVED_KEYS
           keys = count ? I18n.t('i18n.plural.keys', locale: locale).map { |k| [key, k].join(FLATTEN_SEPARATOR) } : [key]
@@ -50,7 +51,7 @@ module I18n
         end
 
         def store_default_translation(locale, key, interpolations)
-          translation = ActiveRecord::Translation.new locale: locale.to_s, key: key
+          translation = translation_model.new locale: locale.to_s, key: key
           translation.interpolations = interpolations
           translation.save
         end

data/lib/i18n/backend/active_record/store_procs.rb

@@ -23,6 +23,8 @@ module I18n
   module Backend
     class ActiveRecord
       module StoreProcs
+        extend TranslationModel
+
         def value=(val)
           case val
           when Proc
@@ -33,7 +35,7 @@ module I18n
           end
         end
 
-        Translation.send(:include, self) if method(:to_s).respond_to?(:to_ruby)
+        translation_model.send(:include, self) if method(:to_s).respond_to?(:to_ruby)
       end
     end
   end

data/lib/i18n/backend/active_record.rb

@@ -25,12 +25,21 @@ module I18n
         reload!
       end
 
+      module TranslationModel
+        private
+
+        def translation_model
+          I18n::Backend::ActiveRecord.config.translation_model
+        end
+      end
+
       module Implementation
         include Base
         include Flatten
+        include TranslationModel
 
         def available_locales
-          Translation.available_locales
+          translation_model.available_locales
         rescue ::ActiveRecord::StatementInvalid
           []
         end
@@ -39,7 +48,7 @@ module I18n
           escape = options.fetch(:escape, true)
 
           flatten_translations(locale, data, escape, false).each do |key, value|
-            translation = Translation.locale(locale).lookup(expand_keys(key))
+            translation = translation_model.locale(locale).lookup(expand_keys(key))
 
             if self.class.config.cleanup_with_destroy
               translation.destroy_all
@@ -47,7 +56,7 @@ module I18n
               translation.delete_all
             end
 
-            Translation.create(locale: locale.to_s, key: key.to_s, value: value)
+            translation_model.create(locale: locale.to_s, key: key.to_s, value: value)
           end
 
           reload! if self.class.config.cache_translations
@@ -64,7 +73,7 @@ module I18n
         end
 
         def init_translations
-          @translations = Translation.to_h
+          @translations = translation_model.to_h
         end
 
         def translations(do_init: false)
@@ -86,9 +95,9 @@ module I18n
           end
 
           result = if key == ''
-            Translation.locale(locale).all
+            translation_model.locale(locale).all
           else
-            Translation.locale(locale).lookup(key)
+            translation_model.locale(locale).lookup(key)
           end
 
           if result.empty?

data/test/active_record_test.rb

@@ -172,4 +172,23 @@ class I18nBackendActiveRecordTest < I18n::TestCase
       I18n.t('foo')
     end
   end
+
+  class WithCustomTranslationModel < I18nBackendActiveRecordTest
+    class CustomTranslation < I18n::Backend::ActiveRecord::Translation
+      def value=(val)
+        super("custom #{val}")
+      end
+    end
+
+    def setup
+      super
+
+      I18n::Backend::ActiveRecord.config.translation_model = CustomTranslation
+    end
+
+    test 'use a custom model' do
+      store_translations(:en, foo: 'foo')
+      assert_equal I18n.t(:foo), 'custom foo'
+    end
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: i18n-active_record
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.3.0
 platform: ruby
 authors:
 - Sven Fuchs
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-08-17 00:00:00.000000000 Z
+date: 2023-09-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: i18n