rails_db_localize 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b871138a311b81b19fe496d8ee8e5a24728d0d2d
-  data.tar.gz: 9fef4a09569e4063bb8aa9cc102a948306f5eb01
+  metadata.gz: 6dddf4c074ccd2e53d6ae27b8f6894b3036760a8
+  data.tar.gz: 5093a12848cb94da0b88ffba1996f83de8bcfc82
 SHA512:
-  metadata.gz: 25dff5f05e0d1c9d5d4a594c6317f60a869e25273a05cf42c272c6676f80d013a5304b303e0af626d38a161eb3de3821a618a0d6c466ecaed6997a338c00144a
-  data.tar.gz: 46dd58fb5744d3d084ac2c403a61a626456d00917e1ad552574dcf894b7f05fb1c59ca480325876b8f7e752db1f1b486199e397facd47c30d055cd9ea3f6a880
+  metadata.gz: 1a1b65ecb96440a0135817ed14dcb1a2560da07422d084007af852ba617ee994559586b0a5b01c05ee7d566ba8dd9d21386d29590b295f121425bdfc441dabd8
+  data.tar.gz: fe7630b9035ac83ee4565bbcc71e12e00d14084e9cac2d121d707290a6b7b7fecbcaf56e30b6e62f6d72f9d5709fa175df315fda6c73a9aba6ca553bb3d9820a

data/README.md

@@ -9,21 +9,20 @@ The most annoying part is globalize3 create a table for each object you want to
 
 I've made this gem with theses rules in head:
 
-## 1/ Translation just in time.
+### 1/ Translation just in time.
 
 You don't need to think about translation in your project until you begin the translation process.
 `rails_db_localize` doesn't modify your database schematic but instead just add a layer on it.
 
-## 2/ One table to bring them all.
+### 2/ One table to bring them all.
 
 `rails_db_localize` add only one table to your project. All your translations are stored inside this table.
 This allow you to make without any pain a tool to manage a team of traductors for example. 
 
 Since everything is in the same table, one controller is enough to manage the translation process!
-About performance, `rails_db_localize` use some optimisations for fetching the rows (caching and hashing system).
+About performance, `rails_db_localize` use some optimizations for fetching the rows (caching and hashing system).
 
-
-## 3/ Only one query for all your translations
+### 3/ Only one query for all your translations
 
 Thanks to the caching system, `rails_db_localize` need only one query to retrieve all the translations of your current view (see below)
 
@@ -77,7 +76,7 @@ or:
   model.name_translated = "Name in french", :fr
 ```
 
-# SQL Optimisation
+# SQL Optimization
 
 To avoid N+1 requests, please use the preloader on every array of models you want to use:
 
@@ -86,11 +85,49 @@ To avoid N+1 requests, please use the preloader on every array of models you wan
     @categories = Category.all
     #Only one request per preload_translations_for call
     preload_translations_for(@translatables, @categories)
+
+    #If you have only one set of data, you can use the model method:
+    @categories.preload_translations
 ```
 
+# Other features
+
+Each model having at least a translated field can use `missing_translation` and `having_translation`
+
+Theses methods allow you to filters your models if they are translated or not.
+
+### Blog case:
+
+You have a blog with articles in two languages but you don't translate all articles.
+To show articles from the current langage selected on your blog, you can use:
+
+```ruby
+  def index
+    @articles = Articles.having_translation(I18n.locale).all
+  end
+```
+
+### Other case:
+
+You have a team of translators:
+- One can translate from english to french
+- Another one can translate from french to spanish
+
+You just have to filters the articles in your translation tool like this:
+```ruby
+  Articles.having_translation(translator.from_language).missing_translation(translator.to_language)
+```
+Create two users with role translator with from/to_language "en/fr" and "fr/es". Et voilà!
+
 # Changelog
 
-0.1 - First commit
+## 0.2
+
+Add methods `having_translation`, `missing_translation` and `preload_translation`
+
+## 0.1
+
+First commit
 
 # Licensing
 

data/app/models/rails_db_localize/translation.rb

@@ -15,11 +15,18 @@ class RailsDbLocalize::Translation < ActiveRecord::Base
 
   before_validation :set_compound_key
 
+
+
   def self.generate_ck resource_type, resource_id
-    #Keep it 32bits.
-    [resource_type.to_s.underscore, resource_id].join("|").hash & 0x7fffffff
+    hash_long = [resource_type.to_s.underscore, resource_id].join("|").chars.map(&:ord).inject(5381) do |h, v|
+      h = ((h<<5)+h)+v
+    end
+
+    #Keep it signed 32bits.
+    hash_long & 0x7fffffff
   end
 
+
    def self.get_untranslated model, field, lang
     model.where("id NOT IN (?)",
       [-1, *RailsDbLocalize::Translation.where(resource_type: k.to_s, lang: lang, field: field).pluck(:resource_id).uniq]

data/lib/ext/active_record_ext.rb

@@ -7,6 +7,38 @@ class ActiveRecord::Base
         @__rdbl_translations = true
         # Register it mostly to remove the translations once you delete an object
         self.has_many :translations, as: :resource, dependent: :destroy
+
+        scope :__rails_db_translations_sub_query, lambda{ |lang|
+          ttable = RailsDbLocalize::Translation.arel_table.name
+          number_of_fields_to_translates = RailsDbLocalize.schema[self.to_s].count
+
+          # We can unscope, but problems tend to appears
+          # with some gems like paranoid.
+          table = respond_to?(:klass) ? table.klass : self
+
+          table.select(:id).joins("INNER JOIN \"#{ttable}\"
+            ON (\"#{ttable}\".resource_id = \"#{arel_table.name}\".id
+            AND \"#{ttable}\".resource_type = '#{to_s}')")
+          .group(:resource_type, :resource_id)
+          .having("COUNT(*) == #{number_of_fields_to_translates}")
+          .where(:"rails_db_localize_translations.lang" => lang)
+        }
+
+        # Return all rows with missing translation for a selected language.
+        self.scope :missing_translation, lambda{ |lang|
+          where("\"#{arel_table.name}\".id NOT IN (#{__rails_db_translations_sub_query(lang).to_sql})")
+        }
+
+        # Return all rows with translation OK for a selected language.
+        self.scope :having_translation, lambda{ |lang|
+          where("\"#{arel_table.name}\".id IN (#{__rails_db_translations_sub_query(lang).to_sql})")
+        }
+
+        def self.preload_translations
+          RailsDbLocalize::TranslationCache.instance.prefetch_collections(self)
+          self
+        end
+
       end
 
       fields.each do |field|
@@ -20,6 +52,11 @@ class ActiveRecord::Base
         # I should really learn how to use the Reflection helpers in ActiveRecord, because
         # ruby eval is not the most readable stuff... :o)
         self.class_eval <<-CODE, __FILE__, __LINE__ + 1
+          def #{field}_translated_exists?(lang=nil)
+            lang ||= I18n.locale
+            !!RailsDbLocalize::TranslationCache.instance.get_translation_for(self.class, self.id, "#{field}", lang, nil )
+          end
+
           def #{field}_translated (lang=nil)
             lang ||= I18n.locale
             RailsDbLocalize::TranslationCache.instance.get_translation_for(self.class, self.id, "#{field}", lang, self.#{field} )

data/lib/rails_db_localize/translation_cache.rb

@@ -60,7 +60,7 @@ public
     encache RailsDbLocalize::Translation.where("compound_key IN (?)", in_clause).pluck(:resource_type, :resource_id, :field, :lang, :content)
   end
 
-  def get_translation_for model_class, model_id, field, lang, default
+  def get_translation_for model_class, model_id, field, lang, default=nil
     ck = RailsDbLocalize::Translation.generate_ck(model_class, model_id)
 
     if @cache[:cks][ck]

data/lib/rails_db_localize/version.rb

@@ -1,3 +1,3 @@
 module RailsDbLocalize
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end