enumerate_it 0.4.0 → 0.5.0

data/README.rdoc

@@ -47,7 +47,7 @@ applications, I put them inside models/.
        :single   => [1, 'Single'],
        :married  => [2, 'Married'],
        :widow    => [3, 'Widow'],
-       :divorced => [4, 'Divorced'],
+       :divorced => [4, 'Divorced']
      )
    end
 
@@ -129,6 +129,35 @@ This will create:
 Remember that in Rails 3 you can add validations to any kind of class and not only to those derived from 
 ActiveRecord::Base.
 
+== I18n
+
+I18n lookup is provided on both '_humanized' and 'Enumeration#to_a' methods, given the hash key is a Symbol. The I18n strings are
+located on enumerations.'enumeration_name'.'key' :
+
+  class RelationshipStatus < EnumerateIt::Base
+   associate_values(
+     :married => 1,
+     :single => 2,
+     :divorced => [3, 'He's divorced']
+   )
+  end
+
+  # your locale file
+  pt:
+    enumerations:
+      relationship_status:
+        single: Casado
+  
+  p = Person.new
+  p.relationship_status = RelationshipStatus::MARRIED
+  p.relationship_status_humanize # => 'Casado' 
+  
+  p.relationship_status = RelationshipStatus::SINGLE
+  p.relationship_status_humanize # => 'Single' => nonexistent key 
+  
+  p.relationship_status = RelationshipStatus::DIVORCED
+  p.relationship_status_humanize # => 'He's divorced' => uses the provided string 
+
 == Installation
 
   gem install enumerate_it

data/VERSION

@@ -1 +1 @@
-0.4.0
+0.5.0

data/enumerate_it.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{enumerate_it}
-  s.version = "0.4.0"
+  s.version = "0.5.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["C\303\241ssio Marques"]
-  s.date = %q{2010-04-10}
+  s.date = %q{2010-04-14}
   s.description = %q{Have a legacy database and need some enumerations in your models to match those stupid '4 rows/2 columns' tables with foreign keys and stop doing joins just to fetch a simple description? Or maybe use some integers instead of strings as the code for each value of your enumerations? Here's EnumerateIt.}
   s.email = %q{cassiommc@gmail.com}
   s.extra_rdoc_files = [
@@ -26,6 +26,8 @@ Gem::Specification.new do |s|
      "enumerate_it.gemspec",
      "lib/enumerate_it.rb",
      "spec/enumerate_it_spec.rb",
+     "spec/i18n/en.yml",
+     "spec/i18n/pt.yml",
      "spec/spec.opts",
      "spec/spec_helper.rb"
   ]

data/lib/enumerate_it.rb

@@ -167,7 +167,7 @@ module EnumerateIt
     def self.normalize_enumeration(values_hash)
       values_hash.each_pair do |key, value| 
         unless value.is_a? Array
-          values_hash[key] = [value, key.to_s.gsub(/_/, ' ').split.map(&:capitalize).join(' ')] 
+          values_hash[key] = [value, key]
         end
       end
       values_hash
@@ -183,15 +183,22 @@ module EnumerateIt
 
     def self.define_enumeration_list(values_hash)
       def self.list 
-        @@registered_enumerations[self].values.map { |value| value[0] }.sort
+        @@registered_enumerations[self].values.map { |value| translate(value[0]) }.sort
       end
 
       def self.enumeration
         @@registered_enumerations[self]
       end
-
+      
       def self.to_a
-        @@registered_enumerations[self].values.map {|value| value.reverse }.sort_by { |value| value[0] }
+        @@registered_enumerations[self].values.map {|value| [translate(value[1]), value[0]] }.sort_by { |value| value[0] }
+      end
+      
+      def self.translate(value)
+        return value unless value.is_a? Symbol
+      
+        default = value.to_s.to_s.gsub(/_/, ' ').split.map(&:capitalize).join(' ')
+        I18n.t("enumerations.#{self.name.underscore}.#{value.to_s.underscore}", :default => default)
       end
     end
   end
@@ -213,7 +220,8 @@ module EnumerateIt
       class_eval do
         define_method "#{attribute_name}_humanize" do
           values = klass.enumeration.values.detect { |v| v[0] == self.send(attribute_name) }
-          values ? values[1] : nil
+          
+          values ? klass.translate(values[1]) : nil
         end
       end
     end    

data/spec/enumerate_it_spec.rb

@@ -24,6 +24,7 @@ describe EnumerateIt do
       has_enumeration_for :foobar, :with => TestEnumeration
 
       def initialize(foobar); @foobar = foobar; end
+      I18n.locale = :en
     end
     
     @target = TestClass.new(TestEnumeration::VALUE_2)
@@ -55,10 +56,19 @@ describe EnumerateIt do
 
         @target = TestClassForEnumerationWithoutArray.new(TestEnumerationWithoutArray::VALUE_TWO)
       end
-
+      
       it "humanizes the respective hash key" do
         @target.foobar_humanize.should == 'Value Two'
       end
+      
+      it "translates the respective hash key when a translation is found" do
+        @target.foobar = TestEnumerationWithoutArray::VALUE_ONE
+        @target.foobar_humanize.should == 'First Value'
+        I18n.locale = :pt
+        
+        @target.foobar_humanize.should == 'Primeiro Valor'
+      end
+      
     end
 
     context "without passing the enumeration class" do
@@ -117,6 +127,12 @@ describe EnumerateIt do
       it "returns an array with the values and human representations" do
         TestEnumeration.to_a.should == [['Hey, I am 1!', '1'], ['Hey, I am 2!', '2'], ['Hey, I am 3!', '3']]
       end
+      
+      it "translates the available values" do
+        TestEnumerationWithoutArray.to_a.should == [['First Value', '1'], ['Value Two', '2']]
+        I18n.locale = :pt
+        TestEnumerationWithoutArray.to_a.should == [['Primeiro Valor', '1'], ['Value Two', '2']]
+      end
     end
 
     context "when included in ActiveRecord::Base" do

data/spec/i18n/en.yml

@@ -0,0 +1,4 @@
+en:
+  enumerations:
+    test_enumeration_without_array:
+      value_one: First Value

data/spec/i18n/pt.yml

@@ -0,0 +1,4 @@
+pt:
+  enumerations:
+    test_enumeration_without_array:
+      value_one: Primeiro Valor

data/spec/spec_helper.rb

@@ -7,3 +7,4 @@ require 'spec/autorun'
 require 'rubygems'
 require 'active_record'
 
+I18n.load_path = Dir['spec/i18n/*.yml']

metadata

@@ -4,9 +4,9 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 0
-  - 4
+  - 5
   - 0
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors: 
 - "C\xC3\xA1ssio Marques"
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-04-10 00:00:00 -03:00
+date: 2010-04-14 00:00:00 -03:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -50,6 +50,8 @@ files:
 - enumerate_it.gemspec
 - lib/enumerate_it.rb
 - spec/enumerate_it_spec.rb
+- spec/i18n/en.yml
+- spec/i18n/pt.yml
 - spec/spec.opts
 - spec/spec_helper.rb
 has_rdoc: true