@@ -9,58 +9,58 @@ Created by Jay Fields, updated by John Nunemaker $ gem install jnunemaker-validatable -s http://gemcutter.org == License - + You may use, copy and redistribute this library under the same terms as Ruby itself (see http://www.ruby-lang.org/en/LICENSE.txt). == Examples Validation of an entire hierarchy of objects with errors aggregated at the root object. - class Person - include Validatable - validates_presence_of :name - attr_accessor :name - end + class Person + include Validatable + validates_presence_of :name + attr_accessor :name + end - class PersonPresenter - include Validatable - include_validations_for :person - attr_accessor :person + class PersonPresenter + include Validatable + include_validations_for :person + attr_accessor :person - def initialize(person) - @person = person - end - end + def initialize(person) + @person = person + end + end - presenter = PersonPresenter.new(Person.new) - presenter.valid? #=> false - presenter.errors.on(:name) #=> "can't be blank" + presenter = PersonPresenter.new(Person.new) + presenter.valid? #=> false + presenter.errors.on(:name) #=> "can't be blank" Validations that turn off after X times of failed attempts. - class Person - include Validatable - validates_presence_of :name, :times => 1 - attr_accessor :name - end + class Person + include Validatable + validates_presence_of :name, :times => 1 + attr_accessor :name + end - person = Person.new - person.valid? #=> false - person.valid? #=> true + person = Person.new + person.valid? #=> false + person.valid? #=> true Validations can be given levels. If a validation fails on a level the validations for subsequent levels will not be executed. - class Person - include Validatable - validates_presence_of :name, :level => 1, :message => "name message" - validates_presence_of :address, :level => 2 - attr_accessor :name, :address - end + class Person + include Validatable + validates_presence_of :name, :level => 1, :message => "name message" + validates_presence_of :address, :level => 2 + attr_accessor :name, :address + end - person = Person.new - person.valid? #=> false - person.errors.on(:name) #=> "name message" - person.errors.on(:address) #=> nil + person = Person.new + person.valid? #=> false + person.errors.on(:name) #=> "name message" + person.errors.on(:address) #=> nil Validations can also be given groups. Groups can be used to validate an object when it can be valid in various states. For example a mortgage application may be valid for saving (saving a partial application), but that same mortgage application would not be valid for underwriting. In our example a application can be saved as long as a Social Security Number is present; however, an application can not be underwritten unless the name attribute contains a value. @@ -80,31 +80,31 @@ As you can see, you can use an array if the validation needs to be part of vario Similar to Rails, Validatable also supports conditional validation. - class Person - include Validatable - attr_accessor :name - validates_format_of :name, :with => /.+/, :if => Proc.new { !name.nil? } - end - Person.new.valid? #=> true - + class Person + include Validatable + attr_accessor :name + validates_format_of :name, :with => /.+/, :if => Proc.new { !name.nil? } + end + Person.new.valid? #=> true + Validatable also exposes an after_validate hook method. - class Person - include Validatable - validates_presence_of :name - attr_accessor :name - end - - class ValidatesPresenceOf - after_validate do |result, instance, attribute| - instance.errors.add("#{attribute} can't be blank") unless result - end - end - - person = Person.new - person.valid? #=> false - person.errors.on(:name) #=> "name can't be blank" - + class Person + include Validatable + validates_presence_of :name + attr_accessor :name + end + + class ValidatesPresenceOf + after_validate do |result, instance, attribute| + instance.errors.add("#{attribute} can't be blank") unless result + end + end + + person = Person.new + person.valid? #=> false + person.errors.on(:name) #=> "name can't be blank" + The after_validate hook yields the result of the validation being run, the instance the validation was run on, and the attribute that was validated README.rdoc 492947f835ed66a9e255cd6ceb85681af79cb0a7 Sam Pohlenz sam@sampohlenz.com http://github.com/spohlenz/validatable/commit/5d49a34f2c0e013665e1818a43c259014d92608d 5d49a34f2c0e013665e1818a43c259014d92608d 2009-10-18T18:33:22-07:00 2009-10-18T18:33:22-07:00 Convert all tabs to spaces in README c488b0e4fbb4957baaba16ca80607dfd0407e76e Sam Pohlenz sam@sampohlenz.com