Readme.md in enumify-0.0.3 vs Readme.md in enumify-0.0.4
- old
+ new
@@ -1,64 +1,76 @@
# Enumify [![Build Status](https://secure.travis-ci.org/yonbergman/enumify.png)](http://travis-ci.org/yonbergman/enumify)
+Enumify adds an enum command to all ActiveRecord models which enables you to work with string attributes as if they were enums
-enumify adds an enum command to all ActiveRecord models which enables you to work with string attributes as if they were enums
-
## Installing
Just add the enumify gem to your GemFile
+```ruby
+gem 'enumify'
+```
+
## How to use
Just call the enum function in any ActiveRecord object, the function accepts the field name as the first variable and the possible values as an array
- class Event < ActiveRecord::Base
- enum :status, [:available, :canceled, :completed]
- end
+```ruby
+class Event < ActiveRecord::Base
+ enum :status, [:available, :canceled, :completed]
+end
+```
After that you get several autogenerated commands to use with the enum
- # Access through field name
+```ruby
+# Access through field name
- event.status # returns the enum's current value as a symbol
- event.status = :canceled # sets the enum's value to canceled (can also get a string)
+event.status # returns the enum's current value as a symbol
+event.status = :canceled # sets the enum's value to canceled (can also get a string)
- # Shorthand methods, access through the possible values
+# Shorthand methods, access through the possible values
- event.available? # returns true if enum's current status is available
- event.canceled! # changes the enum's value to canceled
+event.available? # returns true if enum's current status is available
+event.canceled! # changes the enum's value to canceled
- # Get all the possible values
-
- Event::STATUSES # returns all available status of the enum
+# Get all the possible values
+Event::STATUSES # returns all available status of the enum
+```
+
## Callbacks
Another cool feature of enumify is the option to add a callback function that will be called each time the value of the field changes
This is cool to do stuff like log stuff or create behaviour on state changes
All you need to do is add a x_changed method in your class and the enumify will call it
- class Event < ActiveRecord::Base
- enum :status, [:available, :canceled, :completed]
+```ruby
+class Event < ActiveRecord::Base
+ enum :status, [:available, :canceled, :completed]
- def status_changed(old, new)
- puts "status changed from #{old} to #{new}"
- end
+ def status_changed(old, new)
+ puts "status changed from #{old} to #{new}"
end
+end
+```
-
## Scopes
One last thing that the enumify gem does is created scope (formerly nested_scopes) so you can easly query by the enum
For example if you want to count all the events that are canceled you can just run
- Event.canceled.count
+```ruby
+Event.canceled.count
+```
In addition you can also use a negation scope to retrieve all the records that are not set to the given value.
For example to count all the events that are not canceled you can run
- Event.not_canceled.count
+```ruby
+Event.not_canceled.count
+```
---
Copyright (c) 2011 Yonatan Bergman, released under the MIT license