power_enum 0.8.5 → 0.8.6

data/README.md

@@ -276,6 +276,11 @@ Example:
                            :active      => false
     end
 
+##### acts\_as\_enumerated? (since version 0.8.6)
+
+Returns `true` for ActiveRecord models that act as enumerated, `false` for others.  So
+`BookingStatus.acts_as_enumerated?` would return `true`, while `Booking.acts_as_enumerated?` would return `false`.
+
 #### Instance Methods
 
 Each enumeration model gets the following instance methods.
@@ -533,6 +538,18 @@ This is also valid:
       end
     end
 
+#### match\_enum (Since version 0.8.6)
+
+Tests if an enum instance matches the given value, which may be a symbol, id, string, or enum instance:
+
+    describe Booking do
+      it "status should be 'received' for a new booking" do
+        Booking.new.status.should match_enum(:received)
+      end
+    end
+
+Of course `Booking.new.status.should === :received` still works, but is liable to produce false positives.
+
 ## How to run tests
 
 Go to the 'dummy' project:

data/lib/active_record/acts/enumerated.rb

@@ -9,6 +9,11 @@ module ActiveRecord
       
       module ClassMethods
 
+        # Returns false for ActiveRecord models that do not act as enumerated.
+        def acts_as_enumerated?
+          false
+        end
+
         # Declares the model as enumerated.  See the README for detailed usage instructions.
         #
         # === Supported options
@@ -101,6 +106,11 @@ module ActiveRecord
       module EnumClassMethods
         attr_accessor :enumeration_model_updates_permitted
 
+        # Returns true for ActiveRecord models that act as enumerated.
+        def acts_as_enumerated?
+          true
+        end
+
         # Returns all the enum values.  Caches results after the first time this method is run.
         def all
           return @all if @all

data/lib/testing/rspec.rb

@@ -42,9 +42,8 @@ if defined? RSpec
     match do |enum|
       enum_class = get_enum_class(enum)
 
-      if enum_class.respond_to?(:[]) &&
-          enum_class.respond_to?(:enumeration_model_updates_permitted) &&
-          enum_class.respond_to?(:purge_enumerations_cache)
+      if enum_class.respond_to?(:acts_as_enumerated?) &&
+          enum_class.acts_as_enumerated?
 
         if @items
           begin
@@ -143,4 +142,39 @@ if defined? RSpec
     end
   end
 
+  # Tests if an enum instance matches the given value, which may be a symbol,
+  # id, string, or enum instance:
+  #
+  #     describe Booking do
+  #       it "status should be 'received' for a new booking" do
+  #         Booking.new.status.should match_enum(:received)
+  #       end
+  #     end
+  RSpec::Matchers.define :match_enum do |attribute|
+    match do |item|
+      if item.class.respond_to?(:acts_as_enumerated?) &&
+          item.class.acts_as_enumerated?
+        begin
+          item.class[attribute] == item
+        rescue Exception
+          false
+        end
+      else
+        false
+      end
+    end
+
+    failure_message_for_should do
+      "expected #{attribute} to match the enum"
+    end
+
+    failure_message_for_should_not do
+      "expected #{attribute} to not match the enum"
+    end
+
+    description do
+      "match enum value of #{attribute}"
+    end
+  end
+
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: power_enum
 version: !ruby/object:Gem::Version
-  version: 0.8.5
+  version: 0.8.6
   prerelease: 
 platform: ruby
 authors:
@@ -12,7 +12,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-08-28 00:00:00.000000000 Z
+date: 2012-08-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -143,7 +143,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -1049060871827763452
+      hash: -1167487358875782212
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: