globalize 4.0.3 → 5.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 1d86330a6d33c2690020a923b34f33212f334d33
-  data.tar.gz: c4295ec69aed48ffa104e98384b57fedd8e627f8
+  metadata.gz: 2eeaeaa894fcfa1bda7a09f0082888c1daeb2867
+  data.tar.gz: e66a9181bbf984d8ecd2d3e37c70de70d944733a
 SHA512:
-  metadata.gz: 969f5f26a04dc4ee0a79d569cb771bac063198f2fe9624ca627e4fe602298b4a204237eba4a08e470d70856eeb955fed65d2b4d5b62281dd8a4ade974cc71b66
-  data.tar.gz: e4de5115385b47cc9c699421dd53b3348377133e3b47ea2606b59945d9c3983bad1911efb5e5b8a6885ad2149517ff54ca45a780316126fcfdee3031ba56a67c
+  metadata.gz: 3c0d7d63119d1b46a47b3a33466a23ad153656678b8c98fda5345e3e36f7d7b1794fc00368140d9826307e8fe3ae4e6cef5d04404f3ae04d3b277141e6dffaeb
+  data.tar.gz: 36ab294d22cb53542122c8e2111020445ec1f9495def8d4ea9daecf2d9d6a81a4bb2fd50798d585f0d2cba1fc77024c7f5f9c97c632707b2b24d99396995c8cf

data/CHANGELOG.md

@@ -1,5 +1,8 @@
 # Globalize Changelog
 
+## 5.0.0 (2014-03-03)
+* Added support for Rails 4.2, but removed support for every previous version of Rails.  This is a backward incompatible change, thus the version is now 5.0.0. (thanks [Nico Ritsche](https://github.com/ncri) and others). [#396](https://github.com/globalize/globalize/pull/396).
+
 ## 4.0.3 (2014-11-24)
 * Fixes a problem where after dup the dup'd model and the original model shared a translation instance, which means that if you mutate a translated field on the dup and save it, the original becomes a clone of the dup. [#352](https://github.com/globalize/globalize/pull/352).
 * Deprecated `with_required_attributes`, `required_attributes`, and `required_translated_attributes`. `with_translations` no longer invokes `with_required_attributes`. [#355](https://github.com/globalize/globalize/pull/355).

data/Gemfile.lock

@@ -2,35 +2,36 @@ PATH
   remote: .
   specs:
     globalize (4.0.3)
-      activemodel (>= 4.0.0, < 5)
-      activerecord (>= 4.0.0, < 5)
+      activemodel (>= 4.2.0, < 4.3)
+      activerecord (>= 4.2.0, < 4.3)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activemodel (4.1.8)
-      activesupport (= 4.1.8)
+    activemodel (4.2.0)
+      activesupport (= 4.2.0)
       builder (~> 3.1)
-    activerecord (4.1.8)
-      activemodel (= 4.1.8)
-      activesupport (= 4.1.8)
-      arel (~> 5.0.0)
-    activesupport (4.1.8)
-      i18n (~> 0.6, >= 0.6.9)
+    activerecord (4.2.0)
+      activemodel (= 4.2.0)
+      activesupport (= 4.2.0)
+      arel (~> 6.0)
+    activesupport (4.2.0)
+      i18n (~> 0.7)
       json (~> 1.7, >= 1.7.7)
       minitest (~> 5.1)
-      thread_safe (~> 0.1)
+      thread_safe (~> 0.3, >= 0.3.4)
       tzinfo (~> 1.1)
     ansi (1.4.3)
-    arel (5.0.1.20140414130214)
+    arel (6.0.0)
     builder (3.2.2)
     coderay (1.1.0)
-    database_cleaner (1.3.0)
-    i18n (0.6.11)
-    json (1.8.1)
+    database_cleaner (1.4.0)
+    ffi2-generators (0.1.1)
+    i18n (0.7.0)
+    json (1.8.2)
     method_source (0.8.2)
-    minitest (5.4.3)
-    minitest-reporters (1.0.7)
+    minitest (5.5.1)
+    minitest-reporters (1.0.8)
       ansi
       builder
       minitest (>= 5.0)
@@ -41,10 +42,210 @@ GEM
       slop (~> 3.4)
     pry-nav (0.2.4)
       pry (>= 0.9.10, < 0.11.0)
-    rake (10.3.2)
-    rdoc (4.1.2)
-      json (~> 1.4)
-    ruby-progressbar (1.7.0)
+    rake (10.4.2)
+    rb-readline (0.5.2)
+    rdoc (4.2.0)
+    ruby-progressbar (1.7.1)
+    rubysl (2.1.0)
+      rubysl-abbrev (~> 2.0)
+      rubysl-base64 (~> 2.0)
+      rubysl-benchmark (~> 2.0)
+      rubysl-bigdecimal (~> 2.0)
+      rubysl-cgi (~> 2.0)
+      rubysl-cgi-session (~> 2.0)
+      rubysl-cmath (~> 2.0)
+      rubysl-complex (~> 2.0)
+      rubysl-continuation (~> 2.0)
+      rubysl-coverage (~> 2.0)
+      rubysl-csv (~> 2.0)
+      rubysl-curses (~> 2.0)
+      rubysl-date (~> 2.0)
+      rubysl-delegate (~> 2.0)
+      rubysl-digest (~> 2.0)
+      rubysl-drb (~> 2.0)
+      rubysl-e2mmap (~> 2.0)
+      rubysl-english (~> 2.0)
+      rubysl-enumerator (~> 2.0)
+      rubysl-erb (~> 2.0)
+      rubysl-etc (~> 2.0)
+      rubysl-expect (~> 2.0)
+      rubysl-fcntl (~> 2.0)
+      rubysl-fiber (~> 2.0)
+      rubysl-fileutils (~> 2.0)
+      rubysl-find (~> 2.0)
+      rubysl-forwardable (~> 2.0)
+      rubysl-getoptlong (~> 2.0)
+      rubysl-gserver (~> 2.0)
+      rubysl-io-console (~> 2.0)
+      rubysl-io-nonblock (~> 2.0)
+      rubysl-io-wait (~> 2.0)
+      rubysl-ipaddr (~> 2.0)
+      rubysl-irb (~> 2.1)
+      rubysl-logger (~> 2.0)
+      rubysl-mathn (~> 2.0)
+      rubysl-matrix (~> 2.0)
+      rubysl-mkmf (~> 2.0)
+      rubysl-monitor (~> 2.0)
+      rubysl-mutex_m (~> 2.0)
+      rubysl-net-ftp (~> 2.0)
+      rubysl-net-http (~> 2.0)
+      rubysl-net-imap (~> 2.0)
+      rubysl-net-pop (~> 2.0)
+      rubysl-net-protocol (~> 2.0)
+      rubysl-net-smtp (~> 2.0)
+      rubysl-net-telnet (~> 2.0)
+      rubysl-nkf (~> 2.0)
+      rubysl-observer (~> 2.0)
+      rubysl-open-uri (~> 2.0)
+      rubysl-open3 (~> 2.0)
+      rubysl-openssl (~> 2.0)
+      rubysl-optparse (~> 2.0)
+      rubysl-ostruct (~> 2.0)
+      rubysl-pathname (~> 2.0)
+      rubysl-prettyprint (~> 2.0)
+      rubysl-prime (~> 2.0)
+      rubysl-profile (~> 2.0)
+      rubysl-profiler (~> 2.0)
+      rubysl-pstore (~> 2.0)
+      rubysl-pty (~> 2.0)
+      rubysl-rational (~> 2.0)
+      rubysl-resolv (~> 2.0)
+      rubysl-rexml (~> 2.0)
+      rubysl-rinda (~> 2.0)
+      rubysl-rss (~> 2.0)
+      rubysl-scanf (~> 2.0)
+      rubysl-securerandom (~> 2.0)
+      rubysl-set (~> 2.0)
+      rubysl-shellwords (~> 2.0)
+      rubysl-singleton (~> 2.0)
+      rubysl-socket (~> 2.0)
+      rubysl-stringio (~> 2.0)
+      rubysl-strscan (~> 2.0)
+      rubysl-sync (~> 2.0)
+      rubysl-syslog (~> 2.0)
+      rubysl-tempfile (~> 2.0)
+      rubysl-thread (~> 2.0)
+      rubysl-thwait (~> 2.0)
+      rubysl-time (~> 2.0)
+      rubysl-timeout (~> 2.0)
+      rubysl-tmpdir (~> 2.0)
+      rubysl-tsort (~> 2.0)
+      rubysl-un (~> 2.0)
+      rubysl-uri (~> 2.0)
+      rubysl-weakref (~> 2.0)
+      rubysl-webrick (~> 2.0)
+      rubysl-xmlrpc (~> 2.0)
+      rubysl-yaml (~> 2.0)
+      rubysl-zlib (~> 2.0)
+    rubysl-abbrev (2.0.4)
+    rubysl-base64 (2.0.0)
+    rubysl-benchmark (2.0.1)
+    rubysl-bigdecimal (2.0.2)
+    rubysl-cgi (2.0.1)
+    rubysl-cgi-session (2.0.1)
+    rubysl-cmath (2.0.0)
+    rubysl-complex (2.0.0)
+    rubysl-continuation (2.0.0)
+    rubysl-coverage (2.0.3)
+    rubysl-csv (2.0.2)
+      rubysl-english (~> 2.0)
+    rubysl-curses (2.0.1)
+    rubysl-date (2.0.8)
+    rubysl-delegate (2.0.1)
+    rubysl-digest (2.0.3)
+    rubysl-drb (2.0.1)
+    rubysl-e2mmap (2.0.0)
+    rubysl-english (2.0.0)
+    rubysl-enumerator (2.0.0)
+    rubysl-erb (2.0.2)
+    rubysl-etc (2.0.3)
+      ffi2-generators (~> 0.1)
+    rubysl-expect (2.0.0)
+    rubysl-fcntl (2.0.4)
+      ffi2-generators (~> 0.1)
+    rubysl-fiber (2.0.0)
+    rubysl-fileutils (2.0.3)
+    rubysl-find (2.0.1)
+    rubysl-forwardable (2.0.1)
+    rubysl-getoptlong (2.0.0)
+    rubysl-gserver (2.0.0)
+      rubysl-socket (~> 2.0)
+      rubysl-thread (~> 2.0)
+    rubysl-io-console (2.0.0)
+    rubysl-io-nonblock (2.0.0)
+    rubysl-io-wait (2.0.0)
+    rubysl-ipaddr (2.0.0)
+    rubysl-irb (2.1.0)
+      rb-readline (~> 0.5)
+      rubysl-e2mmap (~> 2.0)
+      rubysl-mathn (~> 2.0)
+      rubysl-thread (~> 2.0)
+    rubysl-logger (2.1.0)
+    rubysl-mathn (2.0.0)
+    rubysl-matrix (2.1.0)
+      rubysl-e2mmap (~> 2.0)
+    rubysl-mkmf (2.0.1)
+      rubysl-fileutils (~> 2.0)
+      rubysl-shellwords (~> 2.0)
+    rubysl-monitor (2.0.0)
+    rubysl-mutex_m (2.0.0)
+    rubysl-net-ftp (2.0.1)
+    rubysl-net-http (2.0.4)
+      rubysl-cgi (~> 2.0)
+      rubysl-erb (~> 2.0)
+      rubysl-singleton (~> 2.0)
+    rubysl-net-imap (2.0.1)
+    rubysl-net-pop (2.0.1)
+    rubysl-net-protocol (2.0.1)
+    rubysl-net-smtp (2.0.1)
+    rubysl-net-telnet (2.0.0)
+    rubysl-nkf (2.0.1)
+    rubysl-observer (2.0.0)
+    rubysl-open-uri (2.0.0)
+    rubysl-open3 (2.0.0)
+    rubysl-openssl (2.2.1)
+    rubysl-optparse (2.0.1)
+      rubysl-shellwords (~> 2.0)
+    rubysl-ostruct (2.0.4)
+    rubysl-pathname (2.1.0)
+    rubysl-prettyprint (2.0.3)
+    rubysl-prime (2.0.1)
+    rubysl-profile (2.0.0)
+    rubysl-profiler (2.0.1)
+    rubysl-pstore (2.0.0)
+    rubysl-pty (2.0.3)
+    rubysl-rational (2.0.1)
+    rubysl-resolv (2.1.0)
+    rubysl-rexml (2.0.4)
+    rubysl-rinda (2.0.1)
+    rubysl-rss (2.0.0)
+    rubysl-scanf (2.0.0)
+    rubysl-securerandom (2.0.0)
+    rubysl-set (2.0.1)
+    rubysl-shellwords (2.0.0)
+    rubysl-singleton (2.0.0)
+    rubysl-socket (2.0.1)
+    rubysl-stringio (2.0.0)
+    rubysl-strscan (2.0.0)
+    rubysl-sync (2.0.0)
+    rubysl-syslog (2.1.0)
+      ffi2-generators (~> 0.1)
+    rubysl-tempfile (2.0.1)
+    rubysl-thread (2.0.2)
+    rubysl-thwait (2.0.0)
+    rubysl-time (2.0.3)
+    rubysl-timeout (2.0.0)
+    rubysl-tmpdir (2.0.1)
+    rubysl-tsort (2.0.1)
+    rubysl-un (2.0.0)
+      rubysl-fileutils (~> 2.0)
+      rubysl-optparse (~> 2.0)
+    rubysl-uri (2.0.0)
+    rubysl-weakref (2.0.0)
+    rubysl-webrick (2.0.0)
+    rubysl-xmlrpc (2.0.0)
+    rubysl-yaml (2.1.0)
+    rubysl-zlib (2.0.1)
     slop (3.6.0)
     sqlite3 (1.3.10)
     thread_safe (0.3.4)
@@ -52,11 +253,10 @@ GEM
       thread_safe (~> 0.1)
 
 PLATFORMS
-  java
   ruby
 
 DEPENDENCIES
-  database_cleaner (~> 1.3.0)
+  database_cleaner (~> 1.4.0)
   globalize!
   minitest
   minitest-reporters

data/globalize.gemspec

@@ -0,0 +1,29 @@
+require File.expand_path('../lib/globalize/version', __FILE__)
+
+Gem::Specification.new do |s|
+  s.name         = 'globalize'
+  s.version      = Globalize::Version
+  s.authors      = ['Sven Fuchs', 'Joshua Harvey', 'Clemens Kofler', 'John-Paul Bader', 'Tomasz Stachewicz', 'Philip Arndt', 'Chris Salzberg']
+  s.email        = 'nobody@globalize-rails.org'
+  s.homepage     = 'http://github.com/globalize/globalize'
+  s.summary      = 'Rails I18n de-facto standard library for ActiveRecord model/data translation'
+  s.description  = "#{s.summary}."
+  s.license      = "MIT"
+
+  s.files        = Dir['{lib/**/*,[A-Z]*}']
+  s.platform     = Gem::Platform::RUBY
+  s.require_path = 'lib'
+  s.rubyforge_project = '[none]'
+
+  s.add_dependency 'activerecord', '>= 4.2.0', '< 4.3'
+  s.add_dependency 'activemodel', '>= 4.2.0', '< 4.3'
+
+  s.add_development_dependency 'database_cleaner', '~> 1.4.0'
+  s.add_development_dependency 'minitest'
+  s.add_development_dependency 'minitest-reporters'
+
+  s.add_development_dependency 'sqlite3'
+  s.add_development_dependency 'rdoc'
+
+  s.add_development_dependency 'rake'
+end

data/init.rb

@@ -0,0 +1 @@
+require 'globalize'

data/lib/globalize.rb

@@ -2,6 +2,8 @@ require 'active_record'
 require 'patches/active_record/xml_attribute_serializer'
 require 'patches/active_record/query_method'
 require 'patches/active_record/uniqueness_validator'
+require 'patches/active_record/persistence'
+
 
 module Globalize
   autoload :ActiveRecord, 'globalize/active_record'

data/lib/globalize/active_record/act_macro.rb

@@ -51,11 +51,10 @@ module Globalize
       end
 
       def enable_serializable_attribute(attr_name)
-        serializer = self.serialized_attributes[attr_name.to_s]
+        serializer = serializer_for_attribute(attr_name)
         if serializer.present?
           if defined?(::ActiveRecord::Coders::YAMLColumn) &&
-             serializer.is_a?(::ActiveRecord::Coders::YAMLColumn)
-
+            serializer.is_a?(::ActiveRecord::Coders::YAMLColumn)
             serializer = serializer.object_class
           end
 
@@ -63,6 +62,13 @@ module Globalize
         end
       end
 
+      def serializer_for_attribute(attr_name)
+        column = self.columns_hash[attr_name.to_s]
+        if column && column.cast_type.is_a?(::ActiveRecord::Type::Serialized)
+          column.cast_type.coder
+        end
+      end
+
       def setup_translates!(options)
         apply_globalize_options(options)
 

data/lib/globalize/active_record/adapter.rb

@@ -37,7 +37,11 @@ module Globalize
         stash.reject {|locale, attrs| attrs.empty?}.each do |locale, attrs|
           translation = record.translations_by_locale[locale] ||
                         record.translations.build(locale: locale.to_s)
-          attrs.each { |name, value| translation[name] = value }
+
+          attrs.each do |name, value|
+            value = value.val if value.is_a?(Arel::Nodes::Casted)
+            translation[name] = value
+          end
           ensure_foreign_key_for(translation)
           translation.save!
         end
@@ -53,8 +57,7 @@ module Globalize
 
       # Sometimes the translation is initialised before a foreign key can be set.
       def ensure_foreign_key_for(translation)
-        # AR >= 4.1 reflections renamed to _reflections
-        translation[translation.class.reflections[:globalized_model].foreign_key] = record.id
+        translation[translation.class.reflections["globalized_model"].foreign_key] = record.id
       end
 
       def type_cast(name, value)

data/lib/globalize/active_record/exceptions.rb

@@ -2,13 +2,13 @@ module Globalize
   module ActiveRecord
     module Exceptions
       class MigrationError < StandardError; end
-  
+
       class BadFieldName < MigrationError
         def initialize(field)
           super("Missing translated field #{field.inspect}")
         end
       end
-  
+
       class BadFieldType < MigrationError
         def initialize(name, type)
           super("Bad field type for field #{name.inspect} (#{type.inspect}), should be :string or :text")

data/lib/globalize/active_record/instance_methods.rb

@@ -30,12 +30,12 @@ module Globalize
         if attribute_changed?(name_str)
           # If there's already a change, delete it if this undoes the change.
           old = changed_attributes[name_str]
-          changed_attributes.delete(name_str) if value == old
+          @changed_attributes.delete(name_str) if value == old
         else
           # If there's not a change yet, record it.
           old = globalize.fetch(options[:locale], name)
           old = old.dup if old.duplicable?
-          changed_attributes[name_str] = old if value != old
+          @changed_attributes[name_str] = old if value != old
         end
 
         globalize.write(options[:locale], name, value)
@@ -93,7 +93,7 @@ module Globalize
 
       def reload(options = nil)
         translation_caches.clear
-        translated_attribute_names.each { |name| @attributes.delete(name.to_s) }
+        translated_attribute_names.each { |name| @attributes.reset(name.to_s) }
         globalize.reset
         super(options)
       end

data/lib/globalize/active_record/migration.rb

@@ -70,7 +70,7 @@ module Globalize
           connection.create_table(translations_table_name) do |t|
             t.references table_name.sub(/^#{table_name_prefix}/, '').singularize, :null => false
             t.string :locale, :null => false
-            t.timestamps
+            t.timestamps :null => false
           end
         end
 

data/lib/globalize/active_record/query_methods.rb

@@ -22,6 +22,14 @@ module Globalize
         end
       end
 
+      def order(opts, *rest)
+        if respond_to?(:translated_attribute_names) && parsed = parse_translated_order(opts)
+          super(parsed)
+        else
+          super
+        end
+      end
+
       def exists?(conditions = :none)
         if parsed = parse_translated_conditions(conditions)
           with_translations_in_fallbacks.exists?(parsed)
@@ -43,6 +51,7 @@ module Globalize
       end
 
       def where_values_hash(*args)
+        return super unless respond_to?(:translations_table_name)
         equalities = respond_to?(:with_default_scope) ? with_default_scope.where_values : where_values
         equalities = equalities.grep(Arel::Nodes::Equality).find_all { |node|
           node.left.relation.name == translations_table_name
@@ -52,7 +61,7 @@ module Globalize
 
         super.merge(Hash[equalities.map { |where|
           name = where.left.name
-          [name, binds.fetch(name.to_s) { where.right }]
+          [name, binds.fetch(name.to_s) { right = where.right; right.is_a?(Arel::Nodes::Casted) ? right.val : right }]
         }])
       end
 
@@ -63,6 +72,27 @@ module Globalize
           relation.with_translations_in_fallbacks
         end
       end
+
+      private
+
+      def parse_translated_order(opts)
+        case opts
+        when Hash
+          ordering = opts.map do |column, direction|
+            klass = translated_column?(column) ? translation_class : self
+            klass.arel_table[column].send(direction)
+          end
+          order(ordering).order_values
+        when Symbol
+          translated_column_name(opts) if translated_attribute_names.include?(opts)
+        else # failsafe returns nothing
+          nil
+        end
+      end
+
+      def translated_column?(column)
+        translated_attribute_names.include?(column)
+      end
     end
   end
 end

data/lib/globalize/version.rb

@@ -1,3 +1,3 @@
 module Globalize
-  Version = '4.0.3'
+  Version = '5.0.0'
 end

data/lib/patches/active_record/persistence.rb

@@ -0,0 +1,26 @@
+module ActiveRecord
+  module Persistence
+    # Updates the associated record with values matching those of the instance attributes.
+    # Returns the number of affected rows.
+    def _update_record(attribute_names = self.attribute_names)
+      attribute_names_without_translated = attribute_names.select{ |k| not respond_to?('translated?') or not translated?(k) }
+      attributes_values = arel_attributes_with_values_for_update(attribute_names_without_translated)
+      if attributes_values.empty?
+        0
+      else
+        self.class.unscoped._update_record attributes_values, id, id_was
+      end
+    end
+
+    def _create_record(attribute_names = self.attribute_names)
+      attribute_names_without_translated = attribute_names.select{ |k| not respond_to?('translated?') or not translated?(k) }
+      attributes_values = arel_attributes_with_values_for_create(attribute_names_without_translated)
+
+      new_id = self.class.unscoped.insert attributes_values
+      self.id ||= new_id if self.class.primary_key
+
+      @new_record = false
+      id
+    end
+  end
+end

data/readme.md

@@ -0,0 +1,338 @@
+![Globalize](http://globalize.github.io/globalize/images/globalize.png)
+
+[![Build Status](https://travis-ci.org/globalize/globalize.svg?branch=master)](https://travis-ci.org/globalize/globalize) [![Code Climate](https://codeclimate.com/github/globalize/globalize.svg)](https://codeclimate.com/github/globalize/globalize)
+
+You can chat with us using Gitter:
+
+[![Gitter chat](https://badges.gitter.im/globalize/globalize.svg)](https://gitter.im/globalize/globalize)
+
+Globalize builds on the [I18n API in Ruby on Rails](http://guides.rubyonrails.org/i18n.html)
+to add model translations to ActiveRecord models.
+
+## Requirements
+
+* ActiveRecord >= 4.2.0 (see below for installation with ActiveRecord 3.x)
+* I18n
+
+## Installation
+
+To install the ActiveRecord 4.2.x compatible version of Globalize with its default setup, just use:
+
+```ruby
+gem install globalize
+```
+
+When using bundler put this in your Gemfile:
+
+```ruby
+gem 'globalize', '~> 5.0.0'
+```
+
+To use the version of globalize for ActiveRecord 4.0 or 4.1, specify:
+
+```ruby
+gem 'globalize', '~> 4.0.3'
+```
+
+To use the version of globalize for ActiveRecord 3.1 or 3.2, specify:
+
+````ruby
+gem 'globalize', '~> 3.1.0'
+````
+
+(If you are using ActiveRecord 3.0, use version 3.0: `gem 'globalize', '3.0.4'`.)
+
+The [`3-1-stable` branch](https://github.com/globalize/globalize/tree/3-1-stable) of this repository corresponds to the latest ActiveRecord 3 version of globalize. Note that `globalize3` has been deprecated and you are encouraged to update your Gemfile accordingly.
+
+## Model translations
+
+Model translations allow you to translate your models' attribute values. E.g.
+
+```ruby
+class Post < ActiveRecord::Base
+  translates :title, :text
+end
+```
+
+Allows you to translate the attributes :title and :text per locale:
+
+```ruby
+I18n.locale = :en
+post.title # => Globalize rocks!
+
+I18n.locale = :he
+post.title # => גלובאלייז2 שולט!
+```
+
+In order to make this work, you'll need to add the appropriate translation tables.
+Globalize comes with a handy helper method to help you do this.
+It's called `create_translation_table!`. Here's an example:
+
+Note that your migrations can use `create_translation_table!` and `drop_translation_table!`
+only inside the `up` and `down` instance methods, respectively. You cannot use `create_translation_table!`
+and `drop_translation_table!` inside the `change` instance method.
+
+### Creating translation tables
+
+***Do not use the `change` method, use `up` and `down`!***
+
+```ruby
+class CreatePosts < ActiveRecord::Migration
+  def up
+    create_table :posts do |t|
+      t.timestamps
+    end
+    Post.create_translation_table! :title => :string, :text => :text
+  end
+  def down
+    drop_table :posts
+    Post.drop_translation_table!
+  end
+end
+```
+
+Also, you can pass options for specific columns. Here’s an example:
+
+```ruby
+class CreatePosts < ActiveRecord::Migration
+  def up
+    create_table :posts do |t|
+      t.timestamps
+    end
+    Post.create_translation_table! :title => :string,
+      :text => {:type => :text, :null => false, :default => 'abc'}
+  end
+  def down
+    drop_table :posts
+    Post.drop_translation_table!
+  end
+end
+```
+
+Note that the ActiveRecord model `Post` must already exist and have a `translates`
+directive listing the translated fields.
+
+## Migrating existing data to and from the translated version
+
+As well as creating a translation table, you can also use `create_translation_table!`
+to migrate across any existing data to the default locale. This can also operate
+in reverse to restore any translations from the default locale back to the model
+when you don't want to use a translation table anymore using `drop_translation_table!`
+
+This feature makes use of `untranslated_attributes` which allows access to the
+model's attributes as they were before the translation was applied. Here's an
+example (which assumes you already have a model called `Post` and its table
+exists):
+
+```ruby
+class TranslatePosts < ActiveRecord::Migration
+  def self.up
+    Post.create_translation_table!({
+      :title => :string,
+      :text => :text
+    }, {
+      :migrate_data => true
+    })
+  end
+
+  def self.down
+    Post.drop_translation_table! :migrate_data => true
+  end
+end
+```
+
+NOTE: Make sure you drop the translated columns from the parent table after all your data is safely migrated.
+
+## Adding additional fields to the translation table
+
+In order to add a new field to an existing translation table, you can use `add_translation_fields!`:
+
+```ruby
+class AddAuthorToPost < ActiveRecord::Migration
+  def up
+    Post.add_translation_fields! author: :text
+  end
+
+  def down
+    remove_column :post_translations, :author
+  end
+end
+```
+
+NOTE: Remember to add the new field to the model:
+
+```ruby
+translates :title, :author
+```
+
+## Versioning with Globalize
+
+See the [globalize-versioning](https://github.com/globalize/globalize-versioning) gem.
+
+## I18n fallbacks for empty translations
+
+It is possible to enable fallbacks for empty translations. It will depend on the
+configuration setting you have set for I18n translations in your Rails config.
+
+You can enable them by adding the next line to `config/application.rb` (or only
+`config/environments/production.rb` if you only want them in production)
+
+```ruby
+config.i18n.fallbacks = true
+```
+
+By default, globalize will only use fallbacks when your translation model does
+not exist or the translation value for the item you've requested is `nil`.
+However it is possible to also use fallbacks for `blank` translations by adding
+`:fallbacks_for_empty_translations => true` to the `translates` method.
+
+```ruby
+class Post < ActiveRecord::Base
+  translates :title, :name
+end
+
+puts post.translations.inspect
+# => [#<Post::Translation id: 1, post_id: 1, locale: "en", title: "Globalize rocks!", name: "Globalize">,
+      #<Post::Translation id: 2, post_id: 1, locale: "nl", title: '', name: nil>]
+
+I18n.locale = :en
+post.title # => 'Globalize rocks!'
+post.name  # => 'Globalize'
+
+I18n.locale = :nl
+post.title # => ''
+post.name  # => 'Globalize'
+```
+
+```ruby
+class Post < ActiveRecord::Base
+  translates :title, :name, :fallbacks_for_empty_translations => true
+end
+
+puts post.translations.inspect
+# => [#<Post::Translation id: 1, post_id: 1, locale: "en", title: "Globalize rocks!", name: "Globalize">,
+      #<Post::Translation id: 2, post_id: 1, locale: "nl", title: '', name: nil>]
+
+I18n.locale = :en
+post.title # => 'Globalize rocks!'
+post.name  # => 'Globalize'
+
+I18n.locale = :nl
+post.title # => 'Globalize rocks!'
+post.name  # => 'Globalize'
+```
+
+## Fallback locales to each other
+
+It is possible to setup locales to fallback to each other.
+
+```ruby
+class Post < ActiveRecord::Base
+  translates :title, :name
+end
+
+Globalize.fallbacks = {:en => [:en, :pl], :pl => [:pl, :en]}
+
+I18n.locale = :en
+en_post = Post.create(:title => 'en_title')
+
+I18n.locale = :pl
+pl_post = Post.create(:title => 'pl_title')
+en_post.title # => 'en_title'
+
+I18n.locale = :en
+en_post.title # => 'en_title'
+pl_post.title # => 'pl_title'
+```
+
+
+## Scoping objects by those with translations
+
+To only return objects that have a translation for the given locale we can use
+the `with_translations` scope. This will only return records that have a
+translations for the passed in locale.
+
+```ruby
+Post.with_translations('en')
+# => [
+  #<Post::Translation id: 1, post_id: 1, locale: "en", title: "Globalize rocks!", name: "Globalize">,
+  #<Post::Translation id: 2, post_id: 1, locale: "nl", title: '', name: nil>
+]
+
+Post.with_translations(I18n.locale)
+# => [
+  #<Post::Translation id: 1, post_id: 1, locale: "en", title: "Globalize rocks!", name: "Globalize">,
+  #<Post::Translation id: 2, post_id: 1, locale: "nl", title: '', name: nil>
+]
+
+Post.with_translations('de')
+# => []
+```
+
+## Show different languages
+
+In views, if there is content from different locales that you wish to display,
+you should use the `with_locale` option with a block, as below:
+
+```erb
+<% Globalize.with_locale(:en) do %>
+  <%= render "my_translated_partial" %>
+<% end %>
+```
+
+Your partial will now be rendered with the `:en` locale set as the current locale.
+
+## Interpolation
+
+Globalize supports interpolation in a similar manner to I18n.
+
+```ruby
+class Post < ActiveRecord::Base
+  translates :title
+end
+
+I18n.locale = :en
+post.title = "Globalize %{superlative}!"
+
+post.title
+# #=> "Globalize %{superlative}!"
+
+post.title(:foo => "bar")
+# SomeError: missing interpolation argument :superlative
+
+post.title(:superlative => "rocks")
+# #=> "Globalize rocks!"
+```
+
+## Fragment caching
+
+Don't forget to add globalize locale into the `cache_key` to separate different localizations of the record.
+One of the possible ways to implement it:
+
+```ruby
+# inside translated model
+def cache_key
+  super + '-' + Globalize.locale.to_s
+end
+```
+
+## Official Globalize extensions
+
+* [globalize-accessors](https://github.com/globalize/globalize-accessors) - Replacement for [easy_globalize_3_accessors](https://github.com/paneq/easy_globalize3_accessors) compatible with Globalize 3.x and 4.x.
+* [globalize-versioning](https://github.com/globalize/globalize-versioning) - Versioning support for using Globalize with [`paper_trail`](https://github.com/airblade/paper_trail).
+
+## Alternative Solutions
+
+* [Veger's fork](http://github.com/veger/globalize2) - uses default AR schema for the default locale, delegates to the translations table for other locales only
+* [TranslatableColumns](http://github.com/iain/translatable_columns) - have multiple languages of the same attribute in a model (Iain Hecker)
+* [Traco](https://github.com/barsoom/traco) - A newer take on using multiple columns in the same model (Barsoom)
+* [localized_record](http://github.com/glennpow/localized_record) - allows records to have localized attributes without any modifications to the database (Glenn Powell)
+* [model_translations](http://github.com/janne/model_translations) - Minimal implementation of Globalize2 style model translations (Jan Andersson)
+* [hstore_translate](http://github.com/robworley/hstore_translate) - Rails I18n library for ActiveRecord model/data translation using PostgreSQL's hstore datatype (Rob Worley)
+
+## Related solutions
+
+* [globalize2_versioning](http://github.com/joshmh/globalize2_versioning) - acts_as_versioned style versioning for globalize2 (Joshua Harvey)
+* [i18n_multi_locales_validations](http://github.com/ZenCocoon/i18n_multi_locales_validations) - multi-locales attributes validations to validates attributes from globalize2 translations models (Sébastien Grosjean)
+* [migrate_from_globalize1](http://gist.github.com/120867) - migrate model translations from Globalize1 to globalize2 (Tomasz Stachewicz)
+* [batch_translations](http://github.com/rilla/batch_translations) - allow saving multiple globalize2 translations in the same request (Jose Alvarez Rilla)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: globalize
 version: !ruby/object:Gem::Version
-  version: 4.0.3
+  version: 5.0.0
 platform: ruby
 authors:
 - Sven Fuchs
@@ -14,7 +14,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-11-25 00:00:00.000000000 Z
+date: 2015-02-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -22,54 +22,54 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 4.0.0
+        version: 4.2.0
     - - "<"
       - !ruby/object:Gem::Version
-        version: '5'
+        version: '4.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 4.0.0
+        version: 4.2.0
     - - "<"
       - !ruby/object:Gem::Version
-        version: '5'
+        version: '4.3'
 - !ruby/object:Gem::Dependency
   name: activemodel
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 4.0.0
+        version: 4.2.0
     - - "<"
       - !ruby/object:Gem::Version
-        version: '5'
+        version: '4.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 4.0.0
+        version: 4.2.0
     - - "<"
       - !ruby/object:Gem::Version
-        version: '5'
+        version: '4.3'
 - !ruby/object:Gem::Dependency
   name: database_cleaner
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.3.0
+        version: 1.4.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.3.0
+        version: 1.4.0
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -152,6 +152,8 @@ files:
 - Gemfile.lock
 - LICENSE
 - Rakefile
+- globalize.gemspec
+- init.rb
 - lib/globalize.rb
 - lib/globalize/active_record.rb
 - lib/globalize/active_record/act_macro.rb
@@ -167,26 +169,16 @@ files:
 - lib/globalize/version.rb
 - lib/i18n/missing_translations_log_handler.rb
 - lib/i18n/missing_translations_raise_handler.rb
+- lib/patches/active_record/persistence.rb
 - lib/patches/active_record/query_method.rb
 - lib/patches/active_record/uniqueness_validator.rb
 - lib/patches/active_record/xml_attribute_serializer.rb
+- readme.md
 homepage: http://github.com/globalize/globalize
 licenses:
 - MIT
 metadata: {}
-post_install_message: |2+
-
-  Globalize has extracted versioning support to a separate gem named
-  globalize-versioning. If you are using versioning (with paper_trail
-  or any other versioning gem), please add the line
-  "gem 'globalize-versioning'" to your Gemfile and go to the github
-  page at globalize/globalize-versioning if you encounter any problems.
-
-  Note that the globalize-versioning gem does not delegate versions to
-  the translation table, so you will have to update your syntax to
-  the form: `post.translation.versions`. See the globalize-versioning
-  readme for details.
-
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -202,7 +194,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: "[none]"
-rubygems_version: 2.2.2
+rubygems_version: 2.4.5
 signing_key: 
 specification_version: 4
 summary: Rails I18n de-facto standard library for ActiveRecord model/data translation