active_translation 0.7.9 → 0.7.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 20c120b29981a823b9e6d0e6615de1d8449a62c05fed30457c838c467e809ea2
-  data.tar.gz: 196f8ad25bca2b0d26519fb93e99a399e96847b50bd86bf8af4b153407951a1a
+  metadata.gz: 753b6bfc3922bc72e78ad59a1632dd63082aec905d9e9ac9743be33ffd6baf5f
+  data.tar.gz: 49cde87e86c0992a6189b7b574ab542db9de59891f89bc1073469603f4f23e9e
 SHA512:
-  metadata.gz: 94a210afa88f3807a79925b16068c378505284ce287c509726bdd8ad3dad15a1ed6fd2fb0365d4d15873d13756b55c6163ab24d7e2f25e3abdb2231fcc38a09d
-  data.tar.gz: 6e2e94578b455ba0a2d6db6a47bb5bd36f809c30bca8cbcbcf20eab1c9c35bbf522a6c63a5521c6752b073347fc23e8a97ed4ee217625dff62d48fce415abb42
+  metadata.gz: 3f6d9d0fd884299a0f579cc4063a9c212b98170cd4dbc89f3735660baa1ea74e8b9b2c2e7d4f114971d86ec4bd7505c09a07c6898c20410f9041a967ca5f63ed
+  data.tar.gz: c3a177a2a5f06f69b2eed28208bf1190e283bc318d1e6da61a62648ae5ed083f7f25a5a628a77ca85784efdb5dcb75875cd83949d1f092277a895f351647ba53

data/README.md

@@ -354,6 +354,19 @@ You can call `translation_config` on a model or instance to see what you've set
 => {attributes: [:profile_html], manual_attributes: ["name"], locales: :method_that_returns_locales, unless: nil, if: nil}
 ```
 
+
+### Translation Without Objectification
+
+You might want to use ActiveTranslation to translate a random string that has no connection to an ActiveRecord model. You can do that with `ActiveTranslation.translate` method.
+
+```ruby
+ActiveTranslation.translate("some string to translate", locale: :fr)
+```
+
+This will return the translated string, and it will cache the result so future calls to translate won't hit the API. You can pass `cache: false` to not cache the result, and also to not return an already cached result.
+
+```ruby
+
 #### Disclaimer
 
 ActiveTranslation doesn't check the accuracy of translations in any way. It assumes that the response from Google is always perfect. If you are translating sensitive content where accuracy is critical in a legal or existential sense, you must handle translation auditing separately.

data/app/models/active_translation/cache.rb

@@ -4,5 +4,24 @@ module ActiveTranslation
 
     validates :locale, presence: true
     validates :checksum, presence: true
+
+    class << self
+      def add!(locale:, original_text:, translated_text:)
+        find_or_create_by(
+          checksum: Digest::MD5.hexdigest(original_text),
+          locale:,
+        ).update(translated_text:,)
+      end
+
+      def lookup(locale:, text:)
+        text = text.to_s
+        locale = locale.to_s
+
+        find_by(
+          checksum: Digest::MD5.hexdigest(text),
+          locale:,
+        )&.translated_text
+      end
+    end
   end
 end

data/lib/active_translation/translatable.rb

@@ -161,12 +161,12 @@ module ActiveTranslation
     def translate_attribute(attribute, locale)
       return nil if send(attribute).nil?
 
-      cached_translation = ActiveTranslation::Cache.find_by(
-        checksum: text_checksum(send(attribute)),
-        locale: locale,
+      cached_translation = Cache.lookup(
+        locale:,
+        text: send(attribute),
       )
 
-      translated_text = cached_translation&.translated_text || ActiveTranslation::GoogleTranslate.translate(target_language_code: locale, text: send(attribute))
+      translated_text = cached_translation || ActiveTranslation::GoogleTranslate.translate(target_language_code: locale, text: send(attribute))
 
       should_cache = case translation_config[:cache]
       when TrueClass then true
@@ -176,10 +176,11 @@ module ActiveTranslation
       end
 
       if should_cache
-        ActiveTranslation::Cache.find_or_create_by(
-          checksum: text_checksum(send(attribute)),
+        Cache.add!(
           locale:,
-        ).update(translated_text:,)
+          original_text: send(attribute),
+          translated_text:,
+        )
       end
 
       translated_text

data/lib/active_translation/version.rb

@@ -1,3 +1,3 @@
 module ActiveTranslation
-  VERSION = "0.7.9"
+  VERSION = "0.7.10"
 end

data/lib/active_translation.rb

@@ -17,5 +17,21 @@ module ActiveTranslation
     def configure
       yield(configuration)
     end
+
+    def translate(text:, locale:, cache: true)
+      text = text.to_s
+      locale = locale.to_s
+
+      if cache
+        cached_translation = Cache.find_by(locale:, checksum: Digest::MD5.hexdigest(text))
+        return cached_translation.translated_text if cached_translation
+      end
+
+      translated_text = GoogleTranslate.translate(target_language_code: locale, text:)
+
+      Cache.add!(locale:, original_text: text, translated_text:) if cache
+
+      translated_text
+    end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: active_translation
 version: !ruby/object:Gem::Version
-  version: 0.7.9
+  version: 0.7.10
 platform: ruby
 authors:
 - Talentronic