enumerate_it 0.5.0 → 0.6.0

data/README.rdoc

@@ -40,7 +40,7 @@ Enter EnumerateIt.
 == Creating enumerations
 
 Enumerations are created as models, but you can put then anywhere in your application. In Rails 
-applications, I put them inside models/. 
+applications, you can put them inside models/. 
 
    class RelationshipStatus < EnumerateIt::Base
      associate_values(
@@ -126,6 +126,17 @@ This will create:
    p.valid? # => false
    p.errors[:relationship_status] # => "is not included in the list"
 
+* If your class can manage validations and responds to :validates_presence_of, you can pass the :required options as true and this validation will be created for you (this option defaults to false):
+
+   class Person < ActiveRecord::Base
+     has_enumeration_for :relationship_status, :required => true
+   end
+
+   p = Person.new :relationship_status => nil
+   p.valid? # => false
+   p.errors[:relationship_status] # => "can't be blank"
+
+
 Remember that in Rails 3 you can add validations to any kind of class and not only to those derived from 
 ActiveRecord::Base.
 
@@ -170,6 +181,14 @@ located on enumerations.'enumeration_name'.'key' :
 
 * Add the 'enumerate_it' gem as a dependency in your environment.rb (Rails 2.3.x) or Gemfile (if you're using Bundler)
 
+An interesting approach to use it in Rails apps is to create an app/models/enumerations folder and add it to your autoload path in config/application.rb:
+
+  module YourApp
+    class Application < Rails::Application
+      config.autoload_paths << "#{Rails.root}/app/models/enumerations"
+    end
+  end
+
 == Ruby 1.9
 
 EnumerateIt is fully compatible with Ruby 1.9.1 (all tests pass)

data/VERSION

@@ -1 +1 @@
-0.5.0
+0.6.0

data/enumerate_it.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{enumerate_it}
-  s.version = "0.5.0"
+  s.version = "0.6.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-14}
+  s.date = %q{2010-10-20}
   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 = [
@@ -34,7 +34,7 @@ Gem::Specification.new do |s|
   s.homepage = %q{http://github.com/cassiomarques/enumerate_it}
   s.rdoc_options = ["--charset=UTF-8"]
   s.require_paths = ["lib"]
-  s.rubygems_version = %q{1.3.6}
+  s.rubygems_version = %q{1.3.7}
   s.summary = %q{Ruby Enumerations}
   s.test_files = [
     "spec/enumerate_it_spec.rb",
@@ -45,7 +45,7 @@ Gem::Specification.new do |s|
     current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
     s.specification_version = 3
 
-    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
       s.add_development_dependency(%q<rspec>, [">= 1.2.9"])
     else
       s.add_dependency(%q<rspec>, [">= 1.2.9"])

data/lib/enumerate_it.rb

@@ -130,6 +130,13 @@
 # p.valid? # => false
 # p.errors[:relationship_status] # => "is not included in the list"
 #
+# - Also, if your class responds to :validates_presence_of, you can pass an :required option and this validation
+# will be added to your attribute:
+#
+# class Person < ActiveRecord::Base
+#   has_enumeration_for :relationship_status, :required => true # => defaults to false
+# end
+#
 # Remember that in Rails 3 you can add validations to any kind of class and not only to those derived from 
 # ActiveRecord::Base.
 #
@@ -206,9 +213,7 @@ module EnumerateIt
   module ClassMethods
     def has_enumeration_for(attribute, options = {})
       define_enumeration_class attribute, options
-      if self.respond_to? :validates_inclusion_of
-        validates_inclusion_of attribute, :in => options[:with].list, :allow_blank => true
-      end
+      set_validations attribute, options
       create_enumeration_humanize_method options[:with], attribute
       if options[:create_helpers]
         create_helper_methods options[:with], attribute
@@ -241,6 +246,11 @@ module EnumerateIt
         options[:with] = attribute.to_s.camelize.constantize
       end
     end
+
+    def set_validations(attribute, options)
+      validates_inclusion_of(attribute, :in => options[:with].list, :allow_blank => true) if self.respond_to?(:validates_inclusion_of)
+      validates_presence_of(attribute) if options[:required] and self.respond_to?(:validates_presence_of)
+    end
   end
 
   def self.included(receiver)

data/spec/enumerate_it_spec.rb

@@ -90,7 +90,7 @@ describe EnumerateIt do
     end
   end
 
-  context "using the option :create_helpers option" do
+  context "using the :create_helpers option" do
     before :each do
       class TestClass
         has_enumeration_for :foobar, :with => TestEnumeration, :create_helpers => true
@@ -137,8 +137,15 @@ describe EnumerateIt do
 
     context "when included in ActiveRecord::Base" do
       before :each do
-        class ActiveRecordStub; attr_accessor :bla; end
-        ActiveRecordStub.stub!(:respond_to?).with(:validates_inclusion_of).and_return(true)
+        class ActiveRecordStub
+          attr_accessor :bla
+
+          class << self
+            def validates_inclusion_of(options); true; end
+            def validates_presence_of; true; end
+          end
+        end
+        
         ActiveRecordStub.stub!(:validates_inclusion_of).and_return(true)
         ActiveRecordStub.send :include, EnumerateIt
       end
@@ -149,6 +156,26 @@ describe EnumerateIt do
           has_enumeration_for :bla, :with => TestEnumeration
         end
       end
+
+      context "using the :required option" do
+        before :each do
+          ActiveRecordStub.stub!(:validates_presence_of).and_return(true)
+        end
+
+        it "creates a validation for presence" do
+          ActiveRecordStub.should_receive(:validates_presence_of)
+          class ActiveRecordStub
+            has_enumeration_for :bla, :with => TestEnumeration, :required => true
+          end
+        end
+
+        it "do not require the attribute by default" do
+          ActiveRecordStub.should_not_receive(:validates_presence_of)
+          class ActiveRecordStub
+            has_enumeration_for :bla, :with => TestEnumeration
+          end
+        end
+      end
     end
   end
 end

metadata

@@ -1,12 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: enumerate_it
 version: !ruby/object:Gem::Version 
+  hash: 7
   prerelease: false
   segments: 
   - 0
-  - 5
+  - 6
   - 0
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors: 
 - "C\xC3\xA1ssio Marques"
@@ -14,16 +15,18 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-04-14 00:00:00 -03:00
+date: 2010-10-20 00:00:00 -02:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: rspec
   prerelease: false
   requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
+        hash: 13
         segments: 
         - 1
         - 2
@@ -64,23 +67,27 @@ rdoc_options:
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
       segments: 
       - 0
       version: "0"
 required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
       segments: 
       - 0
       version: "0"
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.3.6
+rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
 summary: Ruby Enumerations