power_enum 0.5.0 → 0.5.1

data/README.md

@@ -111,7 +111,8 @@ You can now customize it.
     #   t.string :name, :limit => 50, :null => false
     # end
 
-Now, when you create your Booking model, your migration should create a reference column for status id's and a foreign key relationship to the booking_statuses table.
+Now, when you create your Booking model, your migration should create a reference column for status id's and a foreign
+key relationship to the booking\_statuses table.
     
     create_table :bookings do |t|
       t.integer :status_id
@@ -121,6 +122,14 @@ Now, when you create your Booking model, your migration should create a referenc
 
     # Ideally, you would use a gem of some sort to handle foreign keys.
     execute "ALTER TABLE bookings ADD 'bookings_bookings_status_id_fk' FOREIGN KEY (status_id) REFERENCES booking_statuses (id);"
+
+It's easier to use the `references` method if you intend to stick to the default naming convention for reference columns.
+
+    create_table :bookings do |t|
+      t.references :booking_status # Same as t.integer booking_status_id
+
+      t.timestamps
+    end
     
 There are two methods added to Rails migrations:
 
@@ -128,10 +137,10 @@ There are two methods added to Rails migrations:
 
 Creates a new enum table.  `enum_name` will be automatically pluralized.  The following options are supported:
 
-- [:name_column]  Specify the column name for name of the enum.  By default it's :name.  This can be a String or a Symbol
+- [:name\_column]  Specify the column name for name of the enum.  By default it's :name.  This can be a String or a Symbol
 - [:description]  Set this to `true` to have a 'description' column generated.
-- [:name_limit]  Set this define the limit of the name column.
-- [:desc_limit]  Set this to define the limit of the description column
+- [:name\_limit]  Set this define the limit of the name column.
+- [:desc\_limit]  Set this to define the limit of the description column
 - [:active]  Set this to `true` to have a boolean 'active' column generated.  The 'active' column will have the options of NOT NULL and DEFAULT TRUE.
 - [:timestamps]  Set this to `true` to have the timestamp columns (created\_at and updated\_at) generated
 
@@ -289,7 +298,8 @@ This method is used by the `inactive` class method to select inactive enums.
 #### Notes
 
 `acts_as_enumerated` records are considered immutable. By default you cannot create/alter/destroy instances because they are cached in memory.
-Because of Rails' process-based model it is not safe to allow updating acts\_as\_enumerated records as the caches will get out of sync.
+Because of Rails' process-based model it is not safe to allow updating acts\_as\_enumerated records as the caches will get out of sync.  Also,
+as of version 0.5.1, `to_s` is overriden to return the name of the enum instance.
 
 However, one instance where updating the models *should* be allowed is if you are using seeds.rb to seed initial values into the database.
 

data/lib/active_record/acts/enumerated.rb

@@ -236,6 +236,11 @@ module ActiveRecord
           self.name.to_sym
         end
 
+        # By default enumeration #to_s should return stringified name of the enum. BookingStatus[:foo].to_s returns "foo"
+        def to_s
+          self.name.to_s
+        end
+
         # Returns true if the instance is active, false otherwise.  If it has an attribute 'active',
         # returns the attribute cast to a boolean, otherwise returns true.  This method is used by the 'active'
         # class method to select active enums.

metadata

@@ -1,10 +1,15 @@
---- !ruby/object:Gem::Specification
+--- !ruby/object:Gem::Specification 
 name: power_enum
-version: !ruby/object:Gem::Version
-  version: 0.5.0
+version: !ruby/object:Gem::Version 
+  hash: 9
   prerelease: 
+  segments: 
+  - 0
+  - 5
+  - 1
+  version: 0.5.1
 platform: ruby
-authors:
+authors: 
 - Trevor Squires
 - Pivotal Labs
 - Arthur Shagall
@@ -12,82 +17,98 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-11-12 00:00:00.000000000Z
-dependencies:
-- !ruby/object:Gem::Dependency
-  name: rails
-  requirement: &10818300 !ruby/object:Gem::Requirement
+
+date: 2011-12-02 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id001 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 3
+        - 0
+        - 0
         version: 3.0.0
-  type: :runtime
+  name: rails
   prerelease: false
-  version_requirements: *10818300
-- !ruby/object:Gem::Dependency
-  name: jeweler
-  requirement: &10817360 !ruby/object:Gem::Requirement
+  type: :runtime
+  requirement: *id001
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id002 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  name: jeweler
   prerelease: false
-  version_requirements: *10817360
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: &10816140 !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
   type: :development
-  prerelease: false
-  version_requirements: *10816140
-- !ruby/object:Gem::Dependency
-  name: sqlite3
-  requirement: &10813220 !ruby/object:Gem::Requirement
+  requirement: *id002
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id003 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  name: rspec
+  prerelease: false
   type: :development
+  requirement: *id003
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  name: sqlite3
   prerelease: false
-  version_requirements: *10813220
-- !ruby/object:Gem::Dependency
-  name: genspec
-  requirement: &10812140 !ruby/object:Gem::Requirement
+  type: :development
+  requirement: *id004
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id005 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
-    - - =
-      - !ruby/object:Gem::Version
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        hash: 21
+        segments: 
+        - 0
+        - 2
+        - 1
         version: 0.2.1
-  type: :development
+  name: genspec
   prerelease: false
-  version_requirements: *10812140
-description: ! 'Power Enum allows you to treat instances of your ActiveRecord models
-  as though they were an enumeration of values.
-
-  It allows you to cleanly solve many of the problems that the traditional Rails alternatives
-  handle poorly if at all.
-
-  It is particularly suitable for scenarios where your Rails application is not the
-  only user of the database, such as
-
-  when it''s used for analytics or reporting.
+  type: :development
+  requirement: *id005
+description: |
+  Power Enum allows you to treat instances of your ActiveRecord models as though they were an enumeration of values.
+  It allows you to cleanly solve many of the problems that the traditional Rails alternatives handle poorly if at all.
+  It is particularly suitable for scenarios where your Rails application is not the only user of the database, such as
+  when it's used for analytics or reporting.
 
-'
 email: arthur.shagall@gmail.com
 executables: []
+
 extensions: []
-extra_rdoc_files:
+
+extra_rdoc_files: 
 - LICENSE
 - README.md
-files:
+files: 
 - examples/virtual_enumerations_sample.rb
 - lib/active_record/acts/enumerated.rb
 - lib/active_record/aggregations/has_enumerated.rb
@@ -105,30 +126,36 @@ files:
 - README.md
 homepage: http://github.com/albertosaurus/enumerations_mixin
 licenses: []
+
 post_install_message: 
 rdoc_options: []
-require_paths:
+
+require_paths: 
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement
+required_ruby_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
-      segments:
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
       - 0
-      hash: -2560307407996447465
-required_rubygems_version: !ruby/object:Gem::Requirement
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
 requirements: []
+
 rubyforge_project: 
 rubygems_version: 1.8.10
 signing_key: 
 specification_version: 3
-summary: Allows you to treat instances of your ActiveRecord models as though they
-  were an enumeration of values
+summary: Allows you to treat instances of your ActiveRecord models as though they were an enumeration of values
 test_files: []
+