= ValidatesWithBlock
A plugin that allows for dynamic, more readable block-driven validation for ActiveRecord models.
== Installing as a plugin
EDGE Rails has support for plugin installation from Git, so if you're using EDGE Rails you can install with:
./script/plugin install git://github.com/fhwang/validates_with_block.git
We're maintaining an SVN clone of the plugin for those of you who aren't on EDGE Rails yet:
./script/plugin install svn://rubyforge.org/var/svn/nycrb/validates_with_block
== Using ValidatesWithBlock
Basically this plugin is meant to help you make your models a little cleaner if you've got a lot of validations. Instead of:
validates_presence_of :login, :message => 'Please enter a login.'
validates_uniqueness_of :login, :case_sensitive => false
validates_format_of :login, :with => /\A\w*\Z/
validates_length_of :login, :within => 4..15
You can write:
validates_login do |login|
login.present :message => 'Please enter a login.'
login.unique :case_sensitive => false
login.formatted :with => /\A\w*\Z/
login.length :within => 4..15
end
The methods map to validation methods as follows:
login.confirmed => validates_confirmation_of
login.formatted => validates_format_of
login.formatted_as_email => validates_email_format_of
login.length => validates_length_of
login.present => validates_presence_of
login.unique => validates_uniqueness_of
== formatted_as_email
You may have noticed the inclusion of validates_email_format_of; that's not a standard ActiveRecord validation. It comes from the very useful validates_email_format_of plugin, which is available at http://code.dunae.ca/validates_email_format_of.html . Obviously formatted_as_email won't work if you haven't installed this plugin.
== Contact
If you have any bugs, questions, etc., please feel to email me:
Francis Hwang
francis@diversionmedia.com
