globalize 3.0.5 → 3.1.0

data/CHANGELOG.md

@@ -46,10 +46,7 @@
 
 ## 3.1.0 (2014-1-25)
 
-* Backport scope support on uniqueness validation from 4.0, drop support for ActiveRecord < 3.1, fixes [#324](https://github.com/globalize/globalize/issues/324).
-
-## 3.0.5 (2015-04-24)
-* Now working properly with the squeel library. (thanks [Toru Mori](https://github.com/torumori)). See [#437](https://github.com/globalize/globalize/pull/437)
+* Backport scope support on uniqueness validation from 4.0, drop support for ActiveRecord < 3.1, fixes ([https://github.com/globalize/globalize/issues/324](#324)).
 
 ## 3.0.4 (2014-1-8)
 * Extract all versioning-related code to separate [globalize-versioning](https://github.com/globalize/globalize-versioning) gem.

data/Gemfile.lock

@@ -8,15 +8,15 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    activemodel (3.2.21)
-      activesupport (= 3.2.21)
+    activemodel (3.2.16)
+      activesupport (= 3.2.16)
       builder (~> 3.0.0)
-    activerecord (3.2.21)
-      activemodel (= 3.2.21)
-      activesupport (= 3.2.21)
+    activerecord (3.2.16)
+      activemodel (= 3.2.16)
+      activesupport (= 3.2.16)
       arel (~> 3.0.2)
       tzinfo (~> 0.3.29)
-    activesupport (3.2.21)
+    activesupport (3.2.16)
       i18n (~> 0.6, >= 0.6.4)
       multi_json (~> 1.0)
     arel (3.0.3)
@@ -25,17 +25,18 @@ GEM
     ffi2-generators (0.1.1)
     friendly_id (4.0.10.1)
       activerecord (>= 3.0, < 4.0)
-    i18n (0.7.0)
-    metaclass (0.0.4)
-    minitest (5.5.1)
-    mocha (1.1.0)
+    i18n (0.6.9)
+    json (1.8.1)
+    metaclass (0.0.1)
+    minitest (4.7.5)
+    mocha (0.14.0)
       metaclass (~> 0.0.1)
-    multi_json (1.11.0)
+    multi_json (1.8.2)
     pathname_local (0.0.2)
-    power_assert (0.2.3)
-    rake (10.4.2)
-    rdoc (4.2.0)
-    rubysl (2.1.0)
+    rake (10.1.1)
+    rdoc (4.1.0)
+      json (~> 1.4)
+    rubysl (2.0.15)
       rubysl-abbrev (~> 2.0)
       rubysl-base64 (~> 2.0)
       rubysl-benchmark (~> 2.0)
@@ -69,7 +70,7 @@ GEM
       rubysl-io-nonblock (~> 2.0)
       rubysl-io-wait (~> 2.0)
       rubysl-ipaddr (~> 2.0)
-      rubysl-irb (~> 2.1)
+      rubysl-irb (~> 2.0)
       rubysl-logger (~> 2.0)
       rubysl-mathn (~> 2.0)
       rubysl-matrix (~> 2.0)
@@ -98,6 +99,7 @@ GEM
       rubysl-pstore (~> 2.0)
       rubysl-pty (~> 2.0)
       rubysl-rational (~> 2.0)
+      rubysl-readline (~> 2.0)
       rubysl-resolv (~> 2.0)
       rubysl-rexml (~> 2.0)
       rubysl-rinda (~> 2.0)
@@ -139,14 +141,14 @@ GEM
     rubysl-csv (2.0.2)
       rubysl-english (~> 2.0)
     rubysl-curses (2.0.1)
-    rubysl-date (2.0.9)
+    rubysl-date (2.0.6)
     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-erb (2.0.1)
     rubysl-etc (2.0.3)
       ffi2-generators (~> 0.1)
     rubysl-expect (2.0.0)
@@ -164,11 +166,12 @@ GEM
     rubysl-io-nonblock (2.0.0)
     rubysl-io-wait (2.0.0)
     rubysl-ipaddr (2.0.0)
-    rubysl-irb (2.1.1)
+    rubysl-irb (2.0.4)
       rubysl-e2mmap (~> 2.0)
       rubysl-mathn (~> 2.0)
+      rubysl-readline (~> 2.0)
       rubysl-thread (~> 2.0)
-    rubysl-logger (2.1.0)
+    rubysl-logger (2.0.0)
     rubysl-mathn (2.0.0)
     rubysl-matrix (2.1.0)
       rubysl-e2mmap (~> 2.0)
@@ -191,21 +194,22 @@ GEM
     rubysl-observer (2.0.0)
     rubysl-open-uri (2.0.0)
     rubysl-open3 (2.0.0)
-    rubysl-openssl (2.2.1)
+    rubysl-openssl (2.0.5)
     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-pathname (2.0.0)
+    rubysl-prettyprint (2.0.2)
     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-pty (2.0.2)
     rubysl-rational (2.0.1)
-    rubysl-resolv (2.1.0)
-    rubysl-rexml (2.0.4)
-    rubysl-rinda (2.0.1)
+    rubysl-readline (2.0.2)
+    rubysl-resolv (2.0.0)
+    rubysl-rexml (2.0.2)
+    rubysl-rinda (2.0.0)
     rubysl-rss (2.0.0)
     rubysl-scanf (2.0.0)
     rubysl-securerandom (2.0.0)
@@ -216,14 +220,14 @@ GEM
     rubysl-stringio (2.0.0)
     rubysl-strscan (2.0.0)
     rubysl-sync (2.0.0)
-    rubysl-syslog (2.1.0)
+    rubysl-syslog (2.0.1)
       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-tmpdir (2.0.0)
     rubysl-tsort (2.0.1)
     rubysl-un (2.0.0)
       rubysl-fileutils (~> 2.0)
@@ -232,13 +236,12 @@ GEM
     rubysl-weakref (2.0.0)
     rubysl-webrick (2.0.0)
     rubysl-xmlrpc (2.0.0)
-    rubysl-yaml (2.1.0)
+    rubysl-yaml (2.0.4)
     rubysl-zlib (2.0.1)
-    sqlite3 (1.3.10)
-    test-unit (3.0.9)
-      power_assert
+    sqlite3 (1.3.8)
+    test-unit (2.0.0.0)
     test_declarative (0.0.5)
-    tzinfo (0.3.43)
+    tzinfo (0.3.38)
 
 PLATFORMS
   ruby

data/lib/globalize/version.rb

@@ -1,3 +1,3 @@
 module Globalize
-  Version = '3.0.5'
+  Version = '3.1.0'
 end

data/lib/patches/active_record/uniqueness_validator.rb

@@ -4,48 +4,32 @@ ActiveRecord::Validations::UniquenessValidator.class_eval do
   def validate_each_with_translations(record, attribute, value)
     klass = record.class
     if klass.translates? && klass.translated?(attribute)
-      if methods.include?(:build_relation) || respond_to?(:build_relation)
-        finder_class = klass.translation_class
-        table = finder_class.arel_table
+      finder_class = klass.translation_class
+      table = finder_class.arel_table
 
-        relation = build_relation(finder_class, table, attribute, value).and(table[:locale].eq(Globalize.locale))
-        relation = relation.and(table[klass.reflect_on_association(:translations).foreign_key].not_eq(record.send(:id))) if record.persisted?
+      relation = build_relation(finder_class, table, attribute, value).and(table[:locale].eq(Globalize.locale))
+      relation = relation.and(table[klass.reflect_on_association(:translations).foreign_key].not_eq(record.send(:id))) if record.persisted?
 
-  #      TODO: add scope with translated attributes
-        if options[:scope]
-          ActiveRecord::Base.logger.warn("WARNING: Globalize does not currently support `scope` option on uniqueness validation for translated attributes.")
-        end
-
-        if finder_class.unscoped.where(relation).exists?
-          record.errors.add(attribute, :taken, options.except(:case_sensitive, :scope).merge(:value => value))
-        end
-      else
-        finder_class = klass.translation_class
-        table = finder_class.unscoped
-
-        table_name   = finder_class.quoted_table_name
-
-        if value && klass.serialized_attributes.key?(attribute.to_s)
-          value = YAML.dump value
-        end
+      translated_scopes = Array(options[:scope]) & klass.translated_attribute_names
+      untranslated_scopes = Array(options[:scope]) - translated_scopes
 
-        sql, params  = mount_sql_and_params(finder_class, table_name, attribute, value)
-
-        relation = table.where(sql, *params).where(:locale => Globalize.locale.to_s)
-
-        Array.wrap(options[:scope]).each do |scope_item|
-          scope_value = record.send(scope_item)
-          relation = relation.where(scope_item => scope_value)
+      untranslated_scopes.each do |scope_item|
+        scope_value = record.send(scope_item)
+        reflection = klass.reflect_on_association(scope_item)
+        if reflection
+          scope_value = record.send(reflection.foreign_key)
+          scope_item = reflection.foreign_key
         end
+        relation = relation.and(find_finder_class_for(record).arel_table[scope_item].eq(scope_value))
+      end
 
-        if record.persisted?
-          fk = klass.reflect_on_association(:translations).options[:foreign_key]
-          relation = relation.where(finder_class.arel_table[fk].not_eq(record.send(:id)))
-        end
+      translated_scopes.each do |scope_item|
+        scope_value = record.send(scope_item)
+        relation = relation.and(table[scope_item].eq(scope_value))
+      end
 
-        if relation.exists?
-          record.errors.add(attribute, :taken, options.except(:case_sensitive, :scope).merge(:value => value))
-        end
+      if klass.unscoped.with_translations.where(relation).exists?
+        record.errors.add(attribute, :taken, options.except(:case_sensitive, :scope).merge(:value => value))
       end
     else
       validate_each_without_translations(record, attribute, value)

metadata

@@ -1,7 +1,8 @@
 --- !ruby/object:Gem::Specification
 name: globalize
 version: !ruby/object:Gem::Version
-  version: 3.0.5
+  version: 3.1.0
+  prerelease: 
 platform: ruby
 authors:
 - Sven Fuchs
@@ -14,158 +15,178 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-04-23 00:00:00.000000000 Z
+date: 2014-01-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - ">="
+    - - ! '>='
       - !ruby/object:Gem::Version
-        version: 3.0.0
-    - - "<"
+        version: 3.1.0
+    - - <
       - !ruby/object:Gem::Version
         version: 4.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - ">="
+    - - ! '>='
       - !ruby/object:Gem::Version
-        version: 3.0.0
-    - - "<"
+        version: 3.1.0
+    - - <
       - !ruby/object:Gem::Version
         version: 4.0.0
 - !ruby/object:Gem::Dependency
   name: activemodel
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - ">="
+    - - ! '>='
       - !ruby/object:Gem::Version
-        version: 3.0.0
-    - - "<"
+        version: 3.1.0
+    - - <
       - !ruby/object:Gem::Version
         version: 4.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - ">="
+    - - ! '>='
       - !ruby/object:Gem::Version
-        version: 3.0.0
-    - - "<"
+        version: 3.1.0
+    - - <
       - !ruby/object:Gem::Version
         version: 4.0.0
 - !ruby/object:Gem::Dependency
   name: database_cleaner
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: 0.6.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: 0.6.0
 - !ruby/object:Gem::Dependency
   name: mocha
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - ">="
+    - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - ">="
+    - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: pathname_local
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - ">="
+    - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - ">="
+    - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: test_declarative
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - ">="
+    - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - ">="
+    - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: friendly_id
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - ">="
+    - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - ">="
+    - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: sqlite3
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - ">="
+    - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - ">="
+    - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - ">="
+    - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - ">="
+    - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: rdoc
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - ">="
+    - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - ">="
+    - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
 description: Rails I18n de-facto standard library for ActiveRecord model/data translation.
@@ -174,69 +195,76 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- CHANGELOG.md
-- CONTRIBUTING.md
-- Gemfile
-- Gemfile.lock
-- LICENSE
-- Rakefile
-- globalize.gemspec
-- init.rb
 - lib/globalize.rb
+- lib/patches/active_record/xml_attribute_serializer.rb
+- lib/patches/active_record/uniqueness_validator.rb
+- lib/patches/active_record/query_method.rb
+- lib/patches/i18n/interpolate.rb
 - lib/globalize/active_record.rb
-- lib/globalize/active_record/act_macro.rb
 - lib/globalize/active_record/adapter.rb
-- lib/globalize/active_record/attributes.rb
-- lib/globalize/active_record/class_methods.rb
-- lib/globalize/active_record/exceptions.rb
-- lib/globalize/active_record/instance_methods.rb
-- lib/globalize/active_record/migration.rb
 - lib/globalize/active_record/query_methods.rb
+- lib/globalize/active_record/migration.rb
+- lib/globalize/active_record/act_macro.rb
 - lib/globalize/active_record/translation.rb
-- lib/globalize/interpolation.rb
+- lib/globalize/active_record/instance_methods.rb
+- lib/globalize/active_record/class_methods.rb
+- lib/globalize/active_record/exceptions.rb
+- lib/globalize/active_record/attributes.rb
 - lib/globalize/version.rb
-- lib/i18n/missing_translations_log_handler.rb
+- lib/globalize/interpolation.rb
 - lib/i18n/missing_translations_raise_handler.rb
-- lib/patches/active_record/query_method.rb
-- lib/patches/active_record/uniqueness_validator.rb
-- lib/patches/active_record/xml_attribute_serializer.rb
-- lib/patches/i18n/interpolate.rb
-- readme.md
+- lib/i18n/missing_translations_log_handler.rb
+- CONTRIBUTING.md
+- Rakefile
+- LICENSE
+- CHANGELOG.md
+- Gemfile
+- Gemfile.lock
 homepage: https://github.com/globalize/globalize
 licenses:
 - MIT
-metadata: {}
-post_install_message: |2+
+post_install_message: ! '
 
   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
+
+  "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.
 
+
+'
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
   requirements:
-  - - ">="
+  - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
   requirements:
-  - - ">="
+  - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.6
+rubygems_version: 1.8.23
 signing_key: 
-specification_version: 4
+specification_version: 3
 summary: Rails I18n de-facto standard library for ActiveRecord model/data translation
 test_files: []
-has_rdoc: 

checksums.yaml

@@ -1,7 +0,0 @@
----
-SHA1:
-  metadata.gz: ece7db7c7ff689c0abebb00006d1fb5602e2ab7f
-  data.tar.gz: 68e728cdb2c0d847fc3b57e9e910288af2045f25
-SHA512:
-  metadata.gz: a86baab1b896f424cd6406928676f191d6ae5996c47c596a5c24892240d9a0f496d0275c0d965a52918ea93bb4064aa08a2e08bfc9f21bb038fcf4e5c6fa5282
-  data.tar.gz: 12d69809f2783da9f9079001b748e449bc2718b57fe814b4661a633c9a7c27ad13503b64035644dc076e88828d77bf841aad1fa003b7a297859eb0df6f90a8de

data/globalize.gemspec

@@ -1,54 +0,0 @@
-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     = 'https://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'
-
-  if ENV['RAILS_3_0']
-    s.add_dependency 'activerecord', '~> 3.0.0'
-    s.add_dependency 'activemodel', '~> 3.0.0'
-  elsif ENV['RAILS_3_1']
-    s.add_dependency 'activerecord', '~> 3.1.0'
-    s.add_dependency 'activemodel', '~> 3.1.0'
-  elsif ENV['RAILS_3_2']
-    s.add_dependency 'activerecord', '~> 3.2.0'
-    s.add_dependency 'activemodel', '~> 3.2.0'
-  else
-    # normal case
-    s.add_dependency 'activerecord', '>= 3.0.0', '< 4.0.0'
-    s.add_dependency 'activemodel', '>= 3.0.0', '< 4.0.0'
-  end
-
-  s.add_development_dependency 'database_cleaner', '~> 0.6.0'
-  s.add_development_dependency 'mocha'
-  s.add_development_dependency 'pathname_local'
-  s.add_development_dependency 'test_declarative'
-  s.add_development_dependency 'friendly_id'
-  s.add_development_dependency 'sqlite3'
-  s.add_development_dependency 'rake'
-  s.add_development_dependency 'rdoc'
-  s.post_install_message = <<-END
-
-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.
-
-  END
-end

data/init.rb

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

data/readme.md

@@ -1,312 +0,0 @@
-# Globalize [![Build Status](https://travis-ci.org/globalize/globalize.png?branch=3-0-stable)](https://travis-ci.org/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.0.0 (see below for installation with ActiveRecord 3.x)
-* I18n
-
-## Installation
-
-To install the ActiveRecord 4.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', '~> 4.0.0'
-```
-
-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 in Rails >= 3.1.0._
-
-### Rails 3.0
-
-```ruby
-class CreatePosts < ActiveRecord::Migration
-  def self.up
-    create_table :posts do |t|
-      t.timestamps
-    end
-    Post.create_translation_table! :title => :string, :text => :text
-  end
-  def self.down
-    drop_table :posts
-    Post.drop_translation_table!
-  end
-end
-```
-
-### Rails >= 3.1.0
-
-***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.
-
-## 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!"
-```
-
-## 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)
-* [globalize2 Demo App](http://github.com/svenfuchs/globalize2-demo) - demo application for globalize2 (Sven Fuchs)
-* [migrate_from_globalize1](http://gist.github.com/120867) - migrate model translations from Globalize1 to globalize2 (Tomasz Stachewicz)
-* [easy_globalize2_accessors](http://github.com/astropanic/easy_globalize2_accessors) - easily access (read and write) globalize2-translated fields (astropanic, Tomasz Stachewicz)
-* [globalize2-easy-translate](http://github.com/bsamman/globalize2-easy-translate) - adds methods to easily access or set translated attributes to your model (bsamman)
-* [batch_translations](http://github.com/rilla/batch_translations) - allow saving multiple globalize2 translations in the same request (Jose Alvarez Rilla)