Class: Poncho::Validator

Inherits:
Object
  • Object
show all
Defined in:
lib/poncho/validator.rb

Overview

class Person

  include Poncho::Validations
  validates_with MyValidator
end

class MyValidator < Poncho::Validator
  def validate(record)
    if some_complex_logic
      record.errors[:base] = "This record is invalid"
    end
  end

  private
    def some_complex_logic
      # ...
    end
end

Any class that inherits from Poncho::Validator must implement a method called validate which accepts a record.

class Person
  include Poncho::Validations
  validates_with MyValidator
end

class MyValidator < Poncho::Validator
  def validate(record)
    record # => The person instance being validated
    options # => Any non-standard options passed to validates_with
  end
end

To cause a validation error, you must add to the record‘s errors directly from within the validators message

class MyValidator < Poncho::Validator
  def validate(record)
    record.errors.add :base, "This is some custom error message"
    record.errors.add :first_name, "This is some complex validation"
    # etc...
  end
end

To add behavior to the initialize method, use the following signature:

class MyValidator < Poncho::Validator
  def initialize(options)
    super
    @my_custom_field = options[:field_name] || :first_name
  end
end

The easiest way to add custom validators for validating individual attributes is with the convenient Poncho::EachValidator. For example:

class TitleValidator < Poncho::EachValidator
  def validate_each(record, attribute, value)
    record.errors.add attribute, 'must be Mr. Mrs. or Dr.' unless value.in?(['Mr.', 'Mrs.', 'Dr.'])
  end
end

This can now be used in combination with the validates method (see Poncho::Validations::ClassMethods.validates for more on this)

class Person
  include Poncho::Validations
  attr_accessor :title

  validates :title, :presence => true
end

Validator may also define a setup instance method which will get called with the class that using that validator as its argument. This can be useful when there are prerequisites such as an attr_accessor being present for example:

class MyValidator < Poncho::Validator
  def setup(klass)
    klass.send :attr_accessor, :custom_attribute
  end
end

This setup method is only called when used with validation macros or the class level validates_with method.

Direct Known Subclasses

EachValidator

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(options) ⇒ Validator

Accepts options that will be made available through the options reader.



101
102
103
 
# File 'lib/poncho/validator.rb', line 101

def initialize(options)
  @options = options.freeze
end

Instance Attribute Details

#options ⇒ Object (readonly)

Returns the value of attribute options.



98
99
100
 
# File 'lib/poncho/validator.rb', line 98

def options
  @options
end

Class Method Details

.kind ⇒ Object 



90
91
92
93
94
95
96
 
# File 'lib/poncho/validator.rb', line 90

def self.kind
  @kind ||= begin
    full_name = name.split('::').last
    full_name = full_name.gsub(/([a-z\d])([A-Z])/,'\1_\2').downcase
    full_name.sub(/_validator$/, '').to_sym
  end
end

Instance Method Details

#kind ⇒ Object 



111
112
113
 
# File 'lib/poncho/validator.rb', line 111

def kind
  self.class.kind
end

#validate(record) ⇒ Object

Override this method in subclasses with validation logic, adding errors to the records errors array where necessary.

Raises:

  • (NotImplementedError) 


107
108
109
 
# File 'lib/poncho/validator.rb', line 107

def validate(record)
  raise NotImplementedError, "Subclasses must implement a validate(record) method."
end