translate_columns 1.1.0

data/.gitignore

@@ -0,0 +1 @@
+*.swp

data/Gemfile

@@ -0,0 +1,4 @@
+
+source :rubygems
+gemspec
+

data/Gemfile.lock

@@ -0,0 +1,36 @@
+PATH
+  remote: .
+  specs:
+    translate_columns (1.1.0)
+      activerecord (~> 3.0.0)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activemodel (3.0.3)
+      activesupport (= 3.0.3)
+      builder (~> 2.1.2)
+      i18n (~> 0.4)
+    activerecord (3.0.3)
+      activemodel (= 3.0.3)
+      activesupport (= 3.0.3)
+      arel (~> 2.0.2)
+      tzinfo (~> 0.3.23)
+    activesupport (3.0.3)
+    arel (2.0.7)
+    builder (2.1.2)
+    i18n (0.5.0)
+    mocha (0.9.10)
+      rake
+    rake (0.8.7)
+    sqlite3 (1.3.3)
+    tzinfo (0.3.24)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activerecord (~> 3.0.0)
+  mocha (~> 0.9.3)
+  sqlite3 (~> 1.3.3)
+  translate_columns!

data/LICENSE

@@ -0,0 +1,16 @@
+Copyright (c) 2007 Samuel Lown
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software 
+and associated documentation files (the “Software”), to deal in the Software without restriction, 
+including without limitation the rights to use, copy, modify, merge, publish, distribute, 
+sublicense, and/or sell copies of the Software, and to permit persons to whom the Software 
+is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or 
+substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING 
+BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND 
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES 
+OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN 
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,262 @@
+= Translate Columns Plugin
+
+Copyright (c) 2007-2011 Samuel Lown <me (AT) samlown.com>
+
+This Plugin is released under the MIT license, as Rails itself. Please see the 
+attached LICENSE file for further details.
+
+This document and plugin should be considered a work in progress until further
+notice!
+
+== Introduction
+
+The aim of the Translate Columns plugin is to aid the normally difficult task 
+of supporting multiple languages in the models. It provides a near transparent 
+interface to the data contained in the models and their translations such that
+your current controllers, views and models only need to be modified slightly 
+to support multiple languages in a scalable fashion.
+
+If you already have your rails app set up and functioning, using translate 
+columns will not require any major refactoring of your code (unless you're 
+really unlucky), and can be simply added. Indeed, the plugin was written to be 
+added to an existing application.
+
+== Updates
+
+=== v1.1 - 21st January 2011
+
+- Now only supports ActiveRecord 3
+- Converted to gem
+- +include TranslateColumns+ now required on a per model basis
+
+=== 24th September 2009
+
+- Added support for setting the locale variable on the parent, which disables translations. See below.
+
+=== 23rd September 2009
+
+- Testing finally added (hope to add more tests soon)
+- Validations now only performed by the parent model
+- Changed namespace to TranslateColumns (as opposed to Translate::Columns)
+- Parent model's +locale+ variable changed to +translation_locale+ so that it can be added as a column/attribute if needed.
+
+=== 20th May 2009
+
+- Finally got round to moving to github
+- Added support for the rails 2.2 I18n stuff (WIN!)
+
+*WARNING* Translate Columns will now only work with Rails 3 as a gem. For older
+2.3 projects, use as a plugin with the v_1.0 release tag.
+
+== Architecture
+
+Translate columns while simple, does require a specific architecture. The basic
+idea is that each of your models has an associated model that defines the 
+translations. An ASCII ERM that uses an example primary class called document 
+follows:
+
+  ____________                 _______________________
+ |            | 1           * |                       |
+ |  Document  |---------------|  DocumentTranslation  | 
+ |____________|               |_______________________|
+ 
+
+The data contained by these entities may be similar to the following:
+
+ Document:
+
+ |  Column    |   Type   |
+ -------------------------
+ | id         | integer  |
+ | name       | string   |
+ | title      | string   |
+ | sub_title  | string   |
+ | body       | text     |
+ | created_on | datetime |
+ | updated_on | datetime |
+ 
+ DocumentTranslation:
+ 
+ |  Column     |   Type   |
+ --------------------------
+ | id          | integer  |
+ | document_id | integer  |
+ | locale      | string   |  
+ | title       | string   |
+ | sub_title   | string   |
+ | body        | text     |
+
+In Rails, thsee models would be defined as follows:
+
+ class Document < ActiveRecord::Base
+   has_many :translations, :class_name => 'DocumentTranslation'
+ end
+
+ class DocumentTranslation < ActiveRecord::Base
+   belongs_to :document
+ end
+
+Each DocumentTranslation belongs to a Document and defines the locale of the
+translation and only those fields that require a translation. If you really 
+wanted to, a composite key could be used on the document_id and the locale,
+as these should always uniquely identify the translation.
+
+In previous versions of translate_columns a Locale model and associations was
+used to determine the language of a translation, this is no longer required
+with the new Rails 2.2 I18n code and simple string for the locale code 
+of your choice can be used instead.
+
+IMPORTANT: Default locale. In order for this setup to work, there must be a 
+single, pre-defined locale for the default data, this is the data contained
+in the 'Document' entity and will be used whenever we're operating in default
+mode, or if there is no translation available. It is essential that this 
+default locale *never* change during the lifetime of your application, 
+otherwise you'll end up with a mess.
+
+The Document's translations association uses the :class_name option to name the
+correct class. Aside from saving on typing, this is an essential requirement 
+of the translate_columns plugin. (At least until I get chance to add an option 
+to allow for different names.)
+
+== Installation
+
+Assuming you've read the above and understand the basic requirements, the
+plugin can now be installed and setup.
+
+The latest details and updates are available on the github repository:
+
+http://github.com/samlown/translate_columns
+
+To install plugin, use the standard rails plugin install method:
+
+ ./script/plugin install git://github.com/samlown/translate_columns.git
+
+There are no more installation steps, and the plugin does not install any extra
+files or customise the setup. To uninstall, simply remove the directory.
+
+== Setup
+
+Now for the hard part :-) Re-using the example above for documents, to use the
+plugin modify the model so that it looks like the following:
+
+ class Document < ActiveRecord::Base
+   include TranslateColumns
+   has_many :translations, :class_name => 'DocumentTranslation'
+   translate_columns :title, :sub_title, :body
+ end
+
+I'm working on getting it so that you don't need to specify the columns
+manually, but it is not yet ready.
+
+In earlier versions you'd need to mess around with a Locale class but thanks to
+the Rails I18n extension, this is no longer necessary.
+
+== Upgrading
+
+If you're using a realy old version of Translate Columns, then you'll need to perform an
+upgrade and migration to use the fabulous new I18n Rails code. Fortunately, this is
+very easy to do.
+
+To upgrade, remove and previous entries to your Locale class in you translation models
+and generate a migration to convert the local_id column into a string. Something like
+the following will surfice.
+
+ class UpgradeTranslationModels < ActiveRecord::Migration
+   def self.up
+     alter_column :product_translations, :locale_id, :string, :length => 10
+     rename_column :product_translations, :locale_id, :locale
+   end
+
+   def self.down
+     rename_column :product_translations, :locale, :locale_id
+     alter_column :product_translations, :locale_id, :integer
+   end
+ end
+
+After ensuring you're using the I18n.locale calls throughout your application, it
+should work fine.
+
+== Usage
+
+The idea here is that you forget about the fact your models can be translated
+and just use the app as normal. Indeed, if you don't set a locale, you
+won't even notice the plugin is there.
+
+Here's a really basic example of what we can do on the console.
+
+ >> I18n.locale = I18n.default_locale          # First try default language
+ => :en
+ >> doc = Document.find(:first)
+   -- output hidden --
+ >> doc.title
+ => "Sample Document"             # title in english
+ >> I18n.locale = 'es'            # set to other language
+ => "es"
+ >> doc = Document.find(:first)   # Reload to avoid caching problems!
+   -- output hidden --
+ >> doc.title
+ => "Titulo español"              # Title now in spanish
+ >> doc.title_default
+ => "Sample Document"             # original field data
+ >> doc.title = "Nuevo Título Español"
+ => "Nuevo Título Español" 
+ >> doc.save                      # set the title and save
+ => true
+ >> I18n.locale = 'en'
+ => "en"                          # return to english
+ >> doc = Document.find(:first)
+   -- output hidden --
+ >> doc.title
+ => "Sample Document"
+
+As can be seen, just by setting the locale we are able to edit the data
+without having to worry about the details.
+
+The current version also has support for disabling translations by giving the 
+parent object a +locale+ field and setting it to something. This is actually a
+very powerful feature as it allows new objects to be created under a specific locale
+and filtered as such. A typical example would be a blog where most of the posts 
+you'd like to be translated into several languages, but occaisionly some posts will only
+be relevant for a specific region:
+
+ >> I18n.locale = I18n.default_locale
+ >> post = Post.new(:title => "Example") # WIN
+ >>
+ >> I18n.locale = 'es'
+ >> post = Post.new(:title => "Ejemplo") # FAIL
+ TranslateColumns::MissingParent: Cannot create translations without a stored parent
+ >> 
+ >> post = Post.new(:locale => 'es', :title => "Ejemplo") # WIN
+ >>
+ >> # Provide posts, with either a translation of for the current locale
+ >> posts = Post.paginate(:conditions => ['posts.locale IS NULL OR posts.locale = ?', I18n.locale.to_s])
+ 
+A useful +named_scope+ could be as follows:
+
+ class Post < ActiveRecord::Base
+   # ... translate columns stuff ...
+   named_scope :for_current_locale, :conditions => ['posts.locale IS NULL OR posts.locale = ?', I18n.locale.to_s]
+ end
+
+ @posts = Post.for_current_locale.paginate
+
+Changing locale of an object after it has been created will cause its translations to be ignored, but 
+by emptying the locale value the translations should work as before.
+Of course, if you don't want this funcionality simply do not add a locale attribute or method to 
+the parent model.
+
+
+== How it works
+
+The plugin overrides the default attribute accessor functions and automatically
+uses the 'translations' association to find the request fields. It also 
+provides a new method that extends the original method name to access 
+the original values.
+
+== Todos / Bugs
+
+* Caching - Using a basic rails setup, everything should work fine, however
+  if you have a more complex caching setup strange things might happen.
+  Please mail me if you have any problems!
+  
+

data/Rakefile

@@ -0,0 +1,23 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test the translate_columns plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.libs << 'test/lib'
+  t.pattern = 'test/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Generate documentation for the translate_columns plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'TranslateColumns'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+1.1.0

data/init.rb

@@ -0,0 +1,3 @@
+
+require 'translate_columns'
+

data/install.rb

@@ -0,0 +1 @@
+# Install hook code here

data/lib/translate_columns.rb

@@ -0,0 +1,228 @@
+# encoding: utf-8
+#
+# TranslateColumns
+# 
+# Copyright (c)2007-2011 Samuel Lown <me@samlown.com>
+# 
+module TranslateColumns
+ 
+  class MissingParent < StandardError
+  end
+
+  def self.included(base)
+    base.extend(ClassMethods)
+  end
+
+  # methods used in the class definition
+  module ClassMethods
+         
+    # Read the provided list of symbols as column names and 
+    # generate methods for each to access translated versions.
+    # 
+    # Possible options, after the columns, include:
+    # 
+    # * :locale_field - Name of the field in the parents translation table
+    # of the locale. This defaults to 'locale'.
+    #
+    def translate_columns( *options )
+   
+      locale_field = 'locale'
+      
+      columns = [ ]
+      if ! options.is_a? Array
+        raise "Provided parameter to translate_columns is not an array!"
+      end
+      # extract all the options
+      options.each do | opt |
+        if opt.is_a? Symbol
+          columns << opt
+        elsif opt.is_a? Hash
+          # Override the locale class if set.
+          locale_field = opt[:locale_field]
+        end
+      end
+
+      define_method 'columns_to_translate' do
+        columns.collect{ |c| c.to_s }
+      end
+      
+      # set the instance Methods first
+      include TranslateColumns::InstanceMethods
+      
+      # Rails magic to override the normal save process
+      alias_method_chain :save, :translation
+      alias_method_chain :save!, :translation
+      alias_method_chain :attributes=, :locale
+
+      # Generate a module containing methods that override access 
+      # to the ActiveRecord methods.
+      # This dynamic module is then included in the parent such that
+      # the super method will function correctly.
+      mod = Module.new do | m |
+        
+        columns.each do | column |
+
+          next if ['id', locale_field].include?(column.to_s)
+        
+          # This is strange, so allow me to explain:
+          #  We define access to the original method and its super,
+          #  a normal "alias" can't find the super which is the method
+          #  created by ActionBase.
+          #  The Alias_method function takes a copy, and retains the 
+          #  ability to call the parent with the same name.
+          #  Finally, the method is overwritten to support translation.
+          #  
+          #  All this is to avoid defining parameters for the overwritten
+          #  accessor which normally doesn't have them.
+          #  (Warnings are produced on execution when a metaprogrammed
+          #  function is called without parameters and its expecting them)
+          #  
+          #  Sam Lown (2007-01-17) dev at samlown dot com
+          define_method(column) do
+            # This super should call the missing_method method in ActiveRecord.
+            super()
+          end
+          
+          alias_method("#{column}_before_translation", column)
+          
+          # overwrite accessor to read
+          define_method("#{column}") do
+            if translation and ! translation.send(column).blank?
+              translation.send(column)
+            else
+              super()
+            end
+          end
+          
+          define_method("#{column}_before_type_cast") do 
+            if (translation)
+              translation.send("#{column}_before_type_cast")
+            else
+              super
+            end
+          end
+          
+          define_method("#{column}=") do |value|
+            # translation object must have already been set up for this to work!
+            if (translation)
+              translation.send("#{column}=",value)
+            else
+              super( value )
+            end  
+          end          
+
+        end
+      end # dynamic module
+
+      # include the anonymous module so that the "super" method
+      # will work correctly in the child!
+      include mod
+    end
+    
+  end
+
+  # Methods that are specific to the current class
+  # and only called when translate_columns is used
+  module InstanceMethods
+   
+    # Provide the locale which is currently in use with the object or the current global locale.
+    # If the default is in use, always return nil.
+    def translation_locale
+      locale = @translation_locale || I18n.locale.to_s
+      locale == I18n.default_locale.to_s ? nil : locale
+    end
+    
+    # Setting the locale will always enable translation.
+    # If set to nil the global locale is used.
+    def translation_locale=(locale)
+      enable_translation
+      # TODO some checks for available translations would be nice.
+      # I18n.available_locales only available as standard with rails 2.3
+      @translation_locale = locale.to_s.empty? ? nil : locale.to_s
+    end
+    
+    # Do not allow translations!
+    def disable_translation
+      @disable_translation = true
+    end
+    def enable_translation
+      @disable_translation = false 
+    end     
+   
+    # Important check to see if the parent has a locale method.
+    # If so, translations should be disabled if it is set to something!
+    def has_locale_value?
+      respond_to?(:locale) && !self.locale.to_s.empty?
+    end
+
+    # determine if the conditions are set for a translation to be used
+    def translation_enabled?
+      (!@disable_translation && translation_locale) and !has_locale_value? 
+    end
+    
+    # Provide a translation object based on the parent and the translation_locale
+    # current value.
+    def translation
+      if translation_enabled? 
+        if !@translation || (@translation.locale != translation_locale)
+          raise MissingParent, "Cannot create translations without a stored parent" if new_record?
+          # try to find translation or build a new one
+          @translation = translations.find_by_locale(translation_locale) || translations.build(:locale => translation_locale)
+        end
+        @translation
+      else
+        nil
+      end
+    end
+    
+    # As this is included in a mixin, a "super" call from inside the
+    # child (inheriting) class will infact look here before looking to
+    # ActiveRecord for the real 'save'. This method should therefore
+    # be safely overridden if needed.      
+    #
+    # Assumes validation enabled in ActiveRecord and performs validation
+    # before saving. This means the base records validation checks will always
+    # be used.
+    #
+    def save_with_translation(*args)
+      perform_validation = args.is_a?(Hash) ? args[:validate] : args
+      if perform_validation && valid? || !perform_validation
+        translation.save(*args) if (translation)
+        disable_translation
+        save_without_translation(*args)
+        enable_translation
+        true
+      else
+        false
+      end
+    end
+    
+    def save_with_translation!
+      if valid?        
+        translation.save! if (translation)
+        disable_translation
+        save_without_translation!
+        enable_translation
+      else
+        raise ActiveRecord::RecordInvalid.new(self) 
+      end
+    rescue
+      enable_translation
+      raise
+    end
+
+    # Override the default mass assignment method so that the locale variable is always
+    # given preference.
+    def attributes_with_locale=(new_attributes, guard_protected_attributes = true)
+      return if new_attributes.nil?
+      attributes = new_attributes.dup
+      attributes.stringify_keys!
+
+      attributes = sanitize_for_mass_assignment(attributes) if guard_protected_attributes
+      send(:locale=, attributes["locale"]) if attributes.has_key?("locale") and respond_to?(:locale=)
+
+      send(:attributes_without_locale=, attributes, guard_protected_attributes)
+    end
+
+  end
+end

data/tasks/translate_columns_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :translate_columns do
+#   # Task goes here
+# end

data/test/database.yml

@@ -0,0 +1,4 @@
+sqlite3:
+  database: ":memory:"
+  adapter: sqlite3
+  timeout: 500

data/test/fixtures/document.rb

@@ -0,0 +1,11 @@
+class Document < ActiveRecord::Base
+  include TranslateColumns
+
+  has_many :translations, :class_name => 'DocumentTranslation'
+  translate_columns :title, :body
+
+  validates_presence_of :title
+  validates_length_of :title, :within => 3..200
+
+  validates_length_of :body, :within => 3..500
+end

data/test/fixtures/document_translation.rb

@@ -0,0 +1,3 @@
+class DocumentTranslation < ActiveRecord::Base
+
+end

data/test/fixtures/document_translations.yml

@@ -0,0 +1,14 @@
+translation1:
+  id: 1
+  document_id: 1
+  locale: es
+  title: Este es el titulo de un documento en Español
+  body: Nada
+
+translation2:
+  id: 2
+  document_id: 1
+  locale: fr
+  title: Un title en francais
+  body:
+  

data/test/fixtures/documents.yml

@@ -0,0 +1,13 @@
+document1:
+  id: 1
+  title: Test Document Number 1
+  body: This is a test document with some kind of body.
+  published_at: "2009-09-23 21:53:04"
+
+document2:
+  id: 2
+  title: Test Document Number 2
+  locale: en
+  body: This is a second test document with some random content for the body.
+  published_at: "2009-09-23 21:53:46"
+

data/test/fixtures/schema.rb

@@ -0,0 +1,18 @@
+ActiveRecord::Schema.define do
+  create_table "documents", :force => true do |t|
+    t.column "locale", :string, :length => 8
+    t.column "title", :string
+    t.column "body",  :text
+    t.column "published_at", :datetime
+    t.timestamps
+  end
+
+  create_table "document_translations", :force => true do |t|
+    t.references "document"
+    t.string :locale
+    t.column "title", :string
+    t.column "body", :text
+    t.timestamps
+  end
+end
+

data/test/lib/activerecord_connector.rb

@@ -0,0 +1,6 @@
+require 'active_record'
+require 'active_record/fixtures'
+
+conf = YAML::load(File.open(File.dirname(__FILE__) + '/../database.yml'))
+ActiveRecord::Base.establish_connection(conf['sqlite3'])
+

data/test/lib/activerecord_test_helper.rb

@@ -0,0 +1,10 @@
+
+require 'activerecord_connector'
+require File.join(File.dirname(__FILE__), '../fixtures/schema.rb')
+
+module ActiverecordTestHelper
+  FIXTURES_PATH = File.join(File.dirname(__FILE__), '/../fixtures')
+  dep = defined?(ActiveSupport::Dependencies) ? ActiveSupport::Dependencies : ::Dependencies
+  dep.autoload_paths.unshift FIXTURES_PATH
+end
+

data/test/translate_columns_test.rb

@@ -0,0 +1,153 @@
+# encoding: utf-8
+
+require 'bundler/setup'
+require 'test/unit'
+require 'mocha'
+
+require 'activerecord_test_helper'
+require 'translate_columns'
+
+class TranslateColumnsTest < Test::Unit::TestCase 
+
+  include ActiverecordTestHelper
+
+  def setup
+    @docs = Fixtures.create_fixtures(FIXTURES_PATH, ['documents', 'document_translations'])
+  end
+
+  def teardown
+    Fixtures.reset_cache
+  end
+
+  def test_basic_document_fields
+    doc = Document.find(:first)
+    assert_equal "Test Document Number 1", doc.title, "Document not found!"
+    assert_not_nil doc.body, "Empty document body"
+    assert_not_nil doc.published_at, "Missing published date"
+  end
+
+  def test_basic_document_fields_for_default_locale
+    I18n.locale = "en"
+    doc = Document.find(:first)
+    assert_equal "Test Document Number 1", doc.title, "Document not found!"
+    assert_not_nil doc.body, "Empty document body"
+    assert_not_nil doc.published_at, "Missing published date"
+  end
+
+  def test_count_translations
+    doc = Document.find(:first)
+    assert_equal 2, doc.translations.count, "Count doesn't match!"
+  end
+
+  def test_basic_document_fields_for_spanish
+    I18n.locale = "es"
+    doc = Document.find(:first)
+    assert_equal "Este es el titulo de un documento en Espa\303\261ol", doc.title, "Document not found!"
+    assert_equal "Nada", doc.body, "Different document body"
+    assert_not_nil doc.published_at, "Missing published date"
+    assert_equal "Test Document Number 1", doc.title_before_translation
+  end
+
+  def test_missing_fields_resort_to_original
+    I18n.locale = 'fr'
+    doc = Document.find(:first)
+    assert_equal "Un title en francais", doc.title
+    assert_match /body/, doc.body
+    assert doc.body_before_type_cast.to_s.empty?
+  end
+
+  def test_switching_languages_for_reading
+    I18n.locale = I18n.default_locale
+    doc1 = Document.find(:first)
+    assert_equal "Test Document Number 1", doc1.title 
+    I18n.locale = 'es'
+    doc2 = Document.find(:first)
+    assert_equal doc1.title, doc2.title
+    assert_not_equal "Test Document Number 1", doc1.title 
+    I18n.locale = 'en'
+    assert_equal doc1.title, doc2.title
+    assert_equal "Test Document Number 1", doc1.title 
+  end
+
+  def test_setting_fields_in_default_language
+    time_now = Time.now
+    I18n.locale = I18n.default_locale
+    doc1 = Document.find(:first)
+    doc1.title = "A new title"
+    doc1.published_at = time_now
+    assert doc1.save, "Unable to save document"
+    assert_equal "A new title", doc1.title
+    # Now change language
+    I18n.locale = 'es'
+    doc1 = Document.find(:first)
+    assert_not_equal "A new title", doc1.title
+    assert_equal time_now.to_s, doc1.published_at.to_s
+  end
+
+  def test_saving_changes_in_translations
+    time_now = Time.now
+    I18n.locale = 'es'
+    doc1 = Document.find(:first)
+    doc1.title = "Un nuevo título"
+    doc1.published_at = time_now
+    assert doc1.save
+    I18n.locale = I18n.default_locale
+    doc1 = Document.find(:first)
+    assert_not_equal "Un nuevo título", doc1.title
+    assert_equal time_now.to_s, doc1.published_at.to_s
+  end
+
+  def test_creating_new_documents
+    I18n.locale = I18n.default_locale 
+    doc = Document.new(:title => "A new document", :body => "The Body")
+    assert doc.save
+  end
+
+  def test_creating_new_documents_under_locale_fails
+    I18n.locale = 'es' 
+    assert_raise TranslateColumns::MissingParent do
+      Document.new(:title => "Un nuevo documento", :body => 'El cuerpo')
+    end
+  end
+
+  def test_failed_validations
+    I18n.locale = I18n.default_locale
+    doc = Document.find(:first)
+    doc.title = "a"
+    assert !doc.save
+    assert !doc.errors[:title].empty?
+  end
+
+  def test_failed_validations_on_translation
+    I18n.locale = 'es'
+    doc = Document.find(:first)
+    doc.title = "a"
+    assert !doc.save
+    assert !doc.errors[:title].empty?
+  end
+
+  def test_locale_attribute_detection
+    doc = Document.find(:first)
+    assert !doc.has_locale_value?
+    doc.locale = "en"
+    assert doc.has_locale_value?
+  end
+
+  def test_locale_attribute_detection_without_attribute
+    doc = Document.find(:first)
+    doc.locale = "en"
+    doc.stubs(:respond_to?).with(:locale).returns(false)
+    assert !doc.has_locale_value?
+  end
+
+  def test_create_new_document_with_specific_locale
+    I18n.locale = 'es'
+    doc = nil
+    assert_nothing_thrown do
+      doc = Document.new(:locale => 'es', :title => "A new document", :body => "Test Body")
+    end
+    assert doc.locale, 'es'
+    assert doc.save
+  end
+  
+end

data/translate_columns.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{translate_columns}
+  s.version = File.read(File.join(File.dirname(__FILE__), 'VERSION')).strip
+
+  s.required_rubygems_version = Gem::Requirement.new("> 1.3.5") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Sam Lown"]
+  s.date = %q{2011-01-21}
+  s.description = %q{Automatically translate ActiveRecord columns using a second model containing the translations.}
+  s.email = %q{me@samlown.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+    "README.rdoc"
+  ]
+  s.homepage = %q{http://github.com/samlown/translate_columns}
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{Use fields from other translation models easily}
+  
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.require_paths = ["lib"]
+  
+  s.add_dependency("activerecord", "~> 3.0.0")
+  s.add_development_dependency(%q<mocha>, "~> 0.9.3")
+  s.add_development_dependency(%q<sqlite3>, "~> 1.3.3")
+end
+

metadata

@@ -0,0 +1,131 @@
+--- !ruby/object:Gem::Specification 
+name: translate_columns
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 1
+  - 1
+  - 0
+  version: 1.1.0
+platform: ruby
+authors: 
+- Sam Lown
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-01-21 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: activerecord
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 3
+        - 0
+        - 0
+        version: 3.0.0
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: mocha
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 9
+        - 3
+        version: 0.9.3
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: sqlite3
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 3
+        - 3
+        version: 1.3.3
+  type: :development
+  version_requirements: *id003
+description: Automatically translate ActiveRecord columns using a second model containing the translations.
+email: me@samlown.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- init.rb
+- install.rb
+- lib/translate_columns.rb
+- tasks/translate_columns_tasks.rake
+- test/database.yml
+- test/fixtures/document.rb
+- test/fixtures/document_translation.rb
+- test/fixtures/document_translations.yml
+- test/fixtures/documents.yml
+- test/fixtures/schema.rb
+- test/lib/activerecord_connector.rb
+- test/lib/activerecord_test_helper.rb
+- test/translate_columns_test.rb
+- translate_columns.gemspec
+has_rdoc: true
+homepage: http://github.com/samlown/translate_columns
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 1
+      - 3
+      - 5
+      version: 1.3.5
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Use fields from other translation models easily
+test_files: []
+