translated 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 29074d491110db08e39419d73a816b72827cbcf43376d6767ca8b51db29ac282
-  data.tar.gz: 87902d648e5d79b93792174219dcc2b1aa4d5f8e2d8c165964bf9942f70ce87f
+  metadata.gz: cf06c93932fadce4e676acef5b3521c15bb62522a28bcec98fc92f9e94f5819e
+  data.tar.gz: 8ebdbdf3b47b23b45c023cc23afc25036e52fd2595d156d58799d1d4099965a7
 SHA512:
-  metadata.gz: 6864357eddf64bb99813934c9984d35fa77a819c779eb109192ef18c414a70ec53cb9893f555277c102f82427be55464a41cd3ee2a07d0d4004ba3c98eaa06ef
-  data.tar.gz: a8cf2bc3c1193fa62067ccaf58fc18e469c8d939efa906933ee40502b050b1ddda87320b32625796026e2c3eabd66c41b0c8697682634da179c1b1af7da36af3
+  metadata.gz: add8b99d4d294c79d754388c8a5f6ccc07baec15b7fcb9708c69830e63b0dd73a1359d979a7a641bbe578ac726303b8ad5fe5764f642c73e104379569475625d
+  data.tar.gz: 1cc585e85c0914c07d8c032830898467a94dffd40013763ac4aeba98dbad0c7432031c8331945bc888cac040fc19906474bbf2d068b0b4364c4c255cf64228c9

data/README.md

@@ -1,16 +1,18 @@
 # Translated
-Simple, automatic translations for your Rails app.
+Simple, automatic translations for your Rails app with https://translatedrb.com.
 
 ## Usage
-Translated can handle both plain text and rich text (using actiontext).
+Translated can handle both plain text and rich text (using Action Text).
 
-These helpers will let you work with the content attribute like you normally would. The return of this attribute will always be in the language specified by I18n.current_locale. So if it's set to :es, then you'll get Spanish. When you set the value it will save that for the current_locale and then create translations for every locale listed in the I18n.available_locales list.
+These helpers will let you work with the content attribute like you normally would. The return value of this attribute will always be in the language specified by `I18n.locale`. So if it's set to `:es`, then you'll get Spanish.
+
+When you set the value, it will save that for the current locale and then create translations for every locale listed in the `I18n.available_locales` list.
 
 For plain text, simply add this to your model:
 
 ```ruby
 class Message < ApplicationRecord
-  has_translated_text :content
+  has_translated_text_field :content
 end
 ```
 
@@ -22,7 +24,7 @@ class Message < ApplicationRecord
 end
 ```
 
-You can use this attribute just like any other actiontext attribute.
+You can use this attribute just like any other Action Text attribute.
 
 ## Installation
 Add this line to your application's Gemfile:
@@ -33,12 +35,23 @@ gem "translated"
 
 And then execute:
 ```bash
-$ bundle
+bundle
 ```
 
 Install the migrations:
 ```bash
-$ bin/rails translated:install:migrations
+bin/rails translated:install:migrations
+```
+
+Get your API key from https://translatedrb.com
+
+Create an initializer `config/initializers/translated.rb`
+```ruby
+Translated.api_key = 'API KEY from translatedrb.com'
+
+# Optionally, you can configure which environments you would like translated.
+# By default, it will translate development and production
+# Translated.environments = %w(development production)
 ```
 
 ## License

data/app/jobs/translated/update_rich_translations_job.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Translated
+  class UpdateRichTranslationsJob < ApplicationJob
+    queue_as :default
+
+    def perform(record, attribute_name, from_locale, to_locale)
+      record.public_send(:"generate_translation_for_#{attribute_name}", from_locale, to_locale)
+    end
+  end
+end

data/app/models/concerns/translated/translatable.rb

@@ -7,27 +7,27 @@ module Translated
     class_methods do
       def has_translated_text_field(name, validates: {}) # rubocop:disable Naming/PredicateName
         class_eval <<-CODE, __FILE__, __LINE__ + 1 # rubocop:disable Style/DocumentDynamicEvalDefinition
-        def #{name}
-          translation = #{name}_translation || build_#{name}_translation
-          translation&.for_locale(I18n.locale)
-        end
+          def #{name}
+            translation = #{name}_translation || build_#{name}_translation
+            translation&.for_locale(I18n.locale)
+          end
 
-        def #{name}?
-          #{name}.present?
-        end
+          def #{name}?
+            #{name}.present?
+          end
 
-        def #{name}=(content)
-          translation = self.#{name}_translation || build_#{name}_translation
-          translation.set_locale(I18n.locale, content)
-          @_#{name}_translation_changed = true
-          content
-        end
+          def #{name}=(content)
+            translation = self.#{name}_translation || build_#{name}_translation
+            translation.set_locale(I18n.locale, content)
+            @_#{name}_translation_changed = true
+            content
+          end
 
-        private
+          private
 
-        def #{name}_translation_changed?
-          defined?(:@_#{name}_translation_changed) && @_#{name}_translation_changed
-        end
+          def #{name}_translation_changed?
+            defined?(:@_#{name}_translation_changed) && @_#{name}_translation_changed
+          end
         CODE
 
         has_one :"#{name}_translation",
@@ -55,20 +55,32 @@ module Translated
 
           def #{name}=(body)
             self.public_send(:"#{name}_\#{I18n.locale}=", body)
+            @_needs_rich_translation ||= []
 
             I18n.available_locales.each do |locale|
               next if locale == I18n.locale
 
-              generate_translation_for_#{name}(I18n.locale, locale)
+              @_needs_rich_translation << [:#{name}, I18n.locale, locale]
             end
 
             body
           end
 
-          private
-
           def generate_translation_for_#{name}(from, to)
             self.public_send(:"#{name}_\#{to}=", Translator.new.translate(public_send(:"#{name}_\#{from}").body.to_html, from:, to:))
+            save!
+          end
+
+          private
+
+          def needs_rich_translations?
+            defined?(:@_needs_rich_translation) && @_needs_rich_translation.present?
+          end
+
+          def update_rich_translations_later
+            @_needs_rich_translation.each do |args|
+              UpdateRichTranslationsJob.perform_later(self, *args)
+            end
           end
         CODE
 
@@ -76,6 +88,8 @@ module Translated
           has_rich_text :"#{name}_#{locale}"
         end
 
+        after_commit :update_rich_translations_later, if: :needs_rich_translations?
+
         scope :"with_rich_text_#{name}", lambda {
                                            includes(I18n.available_locales.map do |locale|
                                                       :"rich_text_#{name}_#{locale}"

data/app/models/translated/translated_text_field.rb

@@ -25,7 +25,7 @@ module Translated
       self.content ||= {}
       self.content[locale] = value
 
-      @_needs_translations = true
+      @_needs_translations = content_changed?
       value
     end
 
@@ -44,7 +44,7 @@ module Translated
     private
 
     def needs_translations?
-      defined?(:@_needs_translations) && @_needs_translations
+      defined?(:@_needs_translations) && @_needs_translations && Translated.environments.include?(Rails.env)
     end
 
     def update_translations_later

data/app/models/translated/translator.rb

@@ -4,16 +4,25 @@ require 'rest-client'
 
 module Translated
   class Translator
-    API_HOST = ENV.fetch('TRANSLATOR_API_HOST', 'http://localhost:3000')
+    API_HOST = ENV.fetch('TRANSLATED_API_HOST', 'https://translatedrb.com')
 
     def translate(text, from:, to:)
       response = RestClient.post(
         "#{API_HOST}/translate",
         { text: text, from: from, to: to }.to_json,
-        content_type: :json,
-        accept: :json
+        accept: :json,
+        authorization: "Token token=\"#{api_key}\"",
+        content_type: :json
       )
       JSON.parse(response.body)['translated_text']
     end
+
+    private
+
+    def api_key
+      fail 'Translated API key is required' if Translated.api_key.blank?
+
+      Translated.api_key
+    end
   end
 end

data/lib/translated/configuration.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Translated
+  class Configuration
+    attr_accessor :api_key, :environments
+
+    def initialize
+      @environments = %w(development production)
+    end
+  end
+end

data/lib/translated/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Translated
-  VERSION = '0.1.0'
+  VERSION = '0.2.0'
 end

data/lib/translated.rb

@@ -2,6 +2,17 @@
 
 require 'translated/version'
 require 'translated/engine'
+require 'translated/configuration'
 
 module Translated
+  @config = Configuration.new
+
+  class << self
+    extend Forwardable
+
+    attr_reader :config
+
+    def_delegators :@config, :api_key, :api_key=
+    def_delegators :@config, :environments, :environments=
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: translated
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Trae Robrock
@@ -92,6 +92,7 @@ files:
 - MIT-LICENSE
 - README.md
 - Rakefile
+- app/jobs/translated/update_rich_translations_job.rb
 - app/jobs/translated/update_translations_job.rb
 - app/models/concerns/translated/translatable.rb
 - app/models/translated/translated_text_field.rb
@@ -99,6 +100,7 @@ files:
 - db/migrate/202405031152_create_translated_translated_text_fields.rb
 - lib/tasks/translated_tasks.rake
 - lib/translated.rb
+- lib/translated/configuration.rb
 - lib/translated/engine.rb
 - lib/translated/version.rb
 homepage: https://github.com/getcomfortly/translated