lost_in_translations 1.4.2 → 1.4.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 32e8b3114257ea7a04833848621b662ac170db3e
-  data.tar.gz: 70d1fd6bb408f437056bfaaf90c05453e0b2bf78
+SHA256:
+  metadata.gz: 94899fa31aad1c22083125064d145f3f955cd5c7d895cabf547c89e218baf907
+  data.tar.gz: 48cf57640178e2f5f22210eb95ce71d784885fed9cf06f4e2594f1cbac8bcf6b
 SHA512:
-  metadata.gz: 8cadaef4095afee2cafa73aebd6500b2d160e2dd318bea23c2025b60f0c396764b1b9026d826d4ca6fc2c202733acdd13019c1d08270b1f126bbeb06e5c36858
-  data.tar.gz: 2b252e278302c01e130e3eb753bdeb9bc3d836e7e396922d940640a073ab7c6b00b12a5cfa1e6f41bf3c0e85de2e64b3205b2acb94e6d5d14d9ae690a7bccce3
+  metadata.gz: 476dec88ac5c73978729a095955d124e84e38b542c4bd31f0448f65bd182f695faeb86ae509689b65f5495d6d718f828e7d6b1e9721d2463a58e677b4c06cdae
+  data.tar.gz: ea672a70d24764931eb85f42d80c0909c06446707987ca9f0166d1c0a22ce060434c47b58a7783e20cf8270ef18315cf1bfd12222c9dae4457c7741c59790c2e

data/README.md

@@ -102,7 +102,7 @@ class CreateUsers < ActiveRecord::Migration
     User.create \
       title: 'Cavaleiro',
       first_name: 'Joao',
-      last_name: 'Neve'
+      last_name: 'Neve',
       translation_data: {
         en: { first_name: 'Jon', last_name: 'Snow' },
         fr: { first_name: 'Jean', last_name: 'Neige' }
@@ -128,7 +128,69 @@ I18n.locale = :fr
 @user.title # returns nil
 ```
 
-## 3) Instalation
+## 3) Forcing locales
+
+There are many cases when you'll need to translate only a part of your data,
+specially if this part is returned in a list of translated data.
+
+For those cases you only have to define the field (virtual or persisted)
+`force_locale` with one valid locale:
+
+```ruby
+class User < ActiveRecord::Base
+  include LostInTranslations
+
+  translate :title, :first_name
+end
+
+User.create(
+  title: 'Cavaleiro',
+  first_name: 'Joao',
+  last_name: 'Neve',
+  force_locale: nil,
+  translation_data: {
+    en: { first_name: 'Jon', last_name: 'Snow' },
+    fr: { first_name: 'Jean', last_name: 'Neige' }
+  }
+)
+
+User.create(
+  title: 'Cavaleiro',
+  first_name: 'Joao',
+  last_name: 'Neve',
+  force_locale: 'fr'
+  translation_data: {
+    en: { first_name: 'Jon', last_name: 'Snow' },
+    fr: { first_name: 'Jean', last_name: 'Neige' }
+  }
+)
+
+User.create(
+  title: 'Cavaleiro',
+  first_name: 'Joao',
+  last_name: 'Neve',
+  force_locale: 'en'
+  translation_data: {
+    en: { first_name: 'Jon', last_name: 'Snow' },
+    fr: { first_name: 'Jean', last_name: 'Neige' }
+  }
+)
+
+I18n.locale = :pt
+
+User.all.each do |user|
+  puts user.name
+end
+
+# It'll automatically output:
+# Joao
+# Jean
+# Jon
+
+```
+
+
+## 4) Instalation
 
 Add this to your Gemfile:
 ```
@@ -147,7 +209,7 @@ LostInTranslations.reload
 ```
 Because Rails starts with a set of **I18n.available_locales** different from when it finished loading and **LostInTranslations** needs to redefine new methods for those new locales in your classes.
 
-## 4) F.A.Q.
+## 5) F.A.Q.
 
 - [I18n.available_locales as changed, how do I recreate the new translation methods?](https://github.com/Streetbees/lost-in-translations/wiki/Redefining-translation-methods)
 - [Your "translation_data" method (in all of your objects) is not called "translation_data"](https://github.com/Streetbees/lost-in-translations/wiki/translation_data-configuration-version-1)

data/lib/lost_in_translations/base.rb

@@ -22,17 +22,23 @@ module LostInTranslations
 
     def fallback_to_default_locale(locale)
       LostInTranslations.config.fallback_to_default_locale ||
-      locale.to_sym == I18n.default_locale.to_sym
+        locale.to_sym == I18n.default_locale.to_sym
     end
 
     module ClassMethods
       attr_writer :translation_data_field
+      attr_writer :force_locale_field
 
       def translation_data_field
         @translation_data_field ||
           LostInTranslations.config.translation_data_field
       end
 
+      def force_locale_field
+        @force_locale_field ||
+          LostInTranslations.config.force_locale_field
+      end
+
       def translation_fields
         @translation_fields ||= []
       end

data/lib/lost_in_translations/config.rb

@@ -1,4 +1,5 @@
 module LostInTranslations
   Config = Struct.new \
-    :translation_data_field, :translator, :fallback_to_default_locale
+    :translation_data_field, :translator, :fallback_to_default_locale,
+    :force_locale_field
 end

data/lib/lost_in_translations/translator/base.rb

@@ -1,7 +1,9 @@
 module LostInTranslations
   module Translator
     class Base
-      def self.translate(object, field, locale)
+      def self.translate(object, field, original_locale)
+        locale = check_forcing_locale(object, original_locale)
+
         data = translation_data(object)
 
         translations = data[locale.to_sym] || data[locale.to_s] || {}
@@ -42,6 +44,18 @@ module LostInTranslations
 
         translation_data_field
       end
+
+      def self.check_forcing_locale(object, locale)
+        force_locale_field = object.class.force_locale_field
+
+        if object.respond_to?(force_locale_field)
+          force_locale = object.send(force_locale_field)
+
+          return force_locale unless force_locale.to_s.length < 2
+        end
+
+        locale
+      end
     end
   end
 end

data/lib/lost_in_translations/version.rb

@@ -1,3 +1,3 @@
 module LostInTranslations
-  VERSION = '1.4.2'.freeze
+  VERSION = '1.4.3'.freeze
 end

data/lib/lost_in_translations.rb

@@ -16,7 +16,12 @@ module LostInTranslations
   end
 
   def self.config
-    @config ||= Config.new('translation_data', Translator::Base)
+    @config ||= Config.new(
+      'translation_data',
+      Translator::Base,
+      nil,
+      'force_locale'
+    )
   end
 
   def self.translate(*args)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lost_in_translations
 version: !ruby/object:Gem::Version
-  version: 1.4.2
+  version: 1.4.3
 platform: ruby
 authors:
 - StreetBees Dev Team
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-10-04 00:00:00.000000000 Z
+date: 2018-07-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pry
@@ -171,7 +171,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.5.1
+rubygems_version: 2.7.6
 signing_key: 
 specification_version: 4
 summary: Ruby Translation Gem