hstore_translate 0.0.4

data/Gemfile

@@ -0,0 +1,8 @@
+source "http://rubygems.org"
+
+if ENV["EDGE_RAILS"]
+  gem 'pg'
+  gem 'rails', :git => 'git://github.com/rails/rails'
+else
+  gemspec
+end

data/Gemfile.lock

@@ -0,0 +1,99 @@
+PATH
+  remote: .
+  specs:
+    hstore_translate (0.0.3)
+      activerecord
+      activerecord-postgres-hstore (~> 0.4.0)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    actionmailer (3.2.10)
+      actionpack (= 3.2.10)
+      mail (~> 2.4.4)
+    actionpack (3.2.10)
+      activemodel (= 3.2.10)
+      activesupport (= 3.2.10)
+      builder (~> 3.0.0)
+      erubis (~> 2.7.0)
+      journey (~> 1.0.4)
+      rack (~> 1.4.0)
+      rack-cache (~> 1.2)
+      rack-test (~> 0.6.1)
+      sprockets (~> 2.2.1)
+    activemodel (3.2.10)
+      activesupport (= 3.2.10)
+      builder (~> 3.0.0)
+    activerecord (3.2.10)
+      activemodel (= 3.2.10)
+      activesupport (= 3.2.10)
+      arel (~> 3.0.2)
+      tzinfo (~> 0.3.29)
+    activerecord-postgres-hstore (0.4.1)
+      pg
+      rails
+      rake
+    activeresource (3.2.10)
+      activemodel (= 3.2.10)
+      activesupport (= 3.2.10)
+    activesupport (3.2.10)
+      i18n (~> 0.6)
+      multi_json (~> 1.0)
+    arel (3.0.2)
+    builder (3.0.4)
+    erubis (2.7.0)
+    hike (1.2.1)
+    i18n (0.6.1)
+    journey (1.0.4)
+    json (1.7.6)
+    mail (2.4.4)
+      i18n (>= 0.4.0)
+      mime-types (~> 1.16)
+      treetop (~> 1.4.8)
+    mime-types (1.19)
+    multi_json (1.5.0)
+    pg (0.14.1)
+    polyglot (0.3.3)
+    rack (1.4.1)
+    rack-cache (1.2)
+      rack (>= 0.4)
+    rack-ssl (1.3.2)
+      rack
+    rack-test (0.6.2)
+      rack (>= 1.0)
+    rails (3.2.10)
+      actionmailer (= 3.2.10)
+      actionpack (= 3.2.10)
+      activerecord (= 3.2.10)
+      activeresource (= 3.2.10)
+      activesupport (= 3.2.10)
+      bundler (~> 1.0)
+      railties (= 3.2.10)
+    railties (3.2.10)
+      actionpack (= 3.2.10)
+      activesupport (= 3.2.10)
+      rack-ssl (~> 1.3.2)
+      rake (>= 0.8.7)
+      rdoc (~> 3.4)
+      thor (>= 0.14.6, < 2.0)
+    rake (10.0.3)
+    rdoc (3.12)
+      json (~> 1.4)
+    sprockets (2.2.2)
+      hike (~> 1.2)
+      multi_json (~> 1.0)
+      rack (~> 1.0)
+      tilt (~> 1.1, != 1.3.0)
+    thor (0.16.0)
+    tilt (1.3.3)
+    treetop (1.4.12)
+      polyglot
+      polyglot (>= 0.3.1)
+    tzinfo (0.3.35)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  hstore_translate!
+  rake

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2012 Rob Worley
+
+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.md

@@ -0,0 +1,90 @@
+# hstore_translate
+
+Rails I18n library for ActiveRecord model/data translation using PostgreSQL's 
+hstore datatype. It provides an interface inspired by 
+[Globalize3](https://github.com/svenfuchs/globalize3) but removes the need to 
+maintain separate translation tables.
+
+[![Build Status](https://api.travis-ci.org/robworley/hstore_translate.png)](https://travis-ci.org/robworley/hstore_translate)
+
+## Requirements
+
+* ActiveRecord > 3.1.0
+* I18n
+
+## Installation
+
+gem install hstore_translate
+
+When using bundler, put it in your Gemfile:
+
+```ruby
+source 'https://rubygems.org'
+
+gem 'pg'
+gem 'activerecord'
+gem 'activerecord-postgres-hstore', '~> 0.4.0' # only required for ActiveRecord 3.x
+gem 'hstore_translate'
+```
+
+## 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 # => This database rocks!
+
+I18n.locale = :he
+post.title # => אתר זה טוב
+```
+
+You also have locale-specific convenience methods:
+
+```ruby
+I18n.locale = :en
+post.title # => This database rocks!
+post.title_he # => אתר זה טוב
+```
+
+In order to make this work, you'll need to define an hstore column for each of
+your translated attributes, using the suffix "_translations":
+
+```ruby
+class CreatePosts < ActiveRecord::Migration
+  def up
+    create_table :posts do |t|
+      t.column :title_translations, 'hstore'
+      t.column :text_translations,  'hstore'
+      t.timestamps
+    end
+  end
+  def down
+    drop_table :posts
+  end
+end
+```
+
+## I18n fallbacks for missing translations
+
+It is possible to enable fallbacks for missing 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
+```
+
+Sven Fuchs wrote a [detailed explanation of the fallback
+mechanism](https://github.com/svenfuchs/i18n/wiki/Fallbacks).

data/Rakefile

@@ -0,0 +1,12 @@
+require 'rake'
+require 'rake/testtask'
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test the ltree_hierarchy plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end

data/lib/hstore_translate.rb

@@ -0,0 +1,13 @@
+require "active_record/connection_adapters/postgresql_adapter"
+require "hstore_translate/translates"
+require "hstore_translate/version"
+
+module HstoreTranslate
+  def self.native_hstore?
+    @native_hstore ||= ActiveRecord::ConnectionAdapters::PostgreSQLAdapter::NATIVE_DATABASE_TYPES.key?(:hstore)
+  end
+end
+
+require 'activerecord-postgres-hstore' unless HstoreTranslate::native_hstore?
+
+ActiveRecord::Base.extend(HstoreTranslate::Translates)

data/lib/hstore_translate/translates.rb

@@ -0,0 +1,64 @@
+module HstoreTranslate
+  module Translates
+    def translates(*attrs)
+      include InstanceMethods
+
+      class_attribute :translated_attrs
+      self.translated_attrs = attrs
+
+      attrs.each do |attr_name|
+        serialize "#{attr_name}_translations", ActiveRecord::Coders::Hstore unless HstoreTranslate::native_hstore?
+
+        class_eval <<-RUBY
+          def #{attr_name}
+            read_hstore_translation('#{attr_name}')
+          end
+
+          def #{attr_name}=(value)
+            write_hstore_translation('#{attr_name}', value)
+          end
+        RUBY
+      end
+
+      alias_method_chain :method_missing, :translates
+    end
+
+    module InstanceMethods
+      protected
+
+      def read_hstore_translation(attr_name, locale = I18n.locale)
+        translations = send("#{attr_name}_translations") || {}
+        translation  = translations[locale.to_s]
+
+        if translation.nil? && I18n.respond_to?(:fallbacks) && (fallbacks = I18n.fallbacks[locale])
+          fallbacks.find { |f| translation = translations[f.to_s] }
+        end
+
+        translation
+      end
+
+      def write_hstore_translation(attr_name, value, locale = I18n.locale)
+        translation_store = "#{attr_name}_translations"
+        translations = send(translation_store) || {}
+        translations[locale.to_s] = value
+        send("#{translation_store}=", translations)
+        value
+      end
+
+      def method_missing_with_translates(method_name, *args)
+        return method_missing_without_translates(method_name, *args) unless
+          method_name =~ /\A([a-z_]+)_([a-z]{2})(=?)\z/ &&
+          (attr_name = $1.to_sym) && translated_attrs.include?(attr_name)
+
+        locale    = $2.to_sym
+        assigning = $3.present?
+
+        if assigning
+          write_hstore_translation(attr_name, args.first, locale)
+        else
+          read_hstore_translation(attr_name, locale)
+        end
+      end
+    end
+  end
+end

data/lib/hstore_translate/version.rb

@@ -0,0 +1,3 @@
+module HstoreTranslate
+  VERSION = "0.0.4"
+end

metadata

@@ -0,0 +1,103 @@
+--- !ruby/object:Gem::Specification
+name: hstore_translate
+version: !ruby/object:Gem::Version
+  version: 0.0.4
+  prerelease: 
+platform: ruby
+authors:
+- Rob Worley
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-03-15 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.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 3.1.0
+- !ruby/object:Gem::Dependency
+  name: activerecord-postgres-hstore
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.4.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.4.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'
+description: Rails I18n library for ActiveRecord model/data translation using PostgreSQL's
+  hstore datatype. Translations are stored directly in the model table rather than
+  shadow tables.
+email: robert.worley@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/hstore_translate/translates.rb
+- lib/hstore_translate/version.rb
+- lib/hstore_translate.rb
+- Gemfile
+- Gemfile.lock
+- MIT-LICENSE
+- Rakefile
+- README.md
+homepage: https://github.com/robworley/hstore_translate
+licenses: []
+post_install_message: 
+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: ! '[none]'
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Rails I18n library for ActiveRecord model/data translation using PostgreSQL's
+  hstore datatype.
+test_files: []