Module: ActiveRecord::Validations::ClassMethods

Defined in:
lib/validates_email_format_of.rb

Instance Method Summary collapse

Instance Method Details

#validates_email_format_of(*attr_names) ⇒ Object

Validates whether the value of the specified attribute is a valid email address

class User < ActiveRecord::Base
  validates_email_format_of :email, :on => :create
end

Configuration options:

  • message - A custom error message (default is: “ does not appear to be a valid e-mail address”)

  • on - Specifies when this validation is active (default is :save, other options :create, :update)

  • allow_nil - Allow nil values (default is false)

  • allow_blank - Allow blank values (default is false)

  • if - Specifies a method, proc or string to call to determine if the validation should occur (e.g. :if => :allow_validation, or :if => Proc.new { |user| user.signup_step > 2 }). The method, proc or string should return or evaluate to a true or false value.

  • unless - See :if



26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
 
# File 'lib/validates_email_format_of.rb', line 26

def validates_email_format_of(*attr_names)
  options = { :message => ' does not appear to be a valid e-mail address', 
              :on => :save, 
              :allow_nil => false,
              :allow_blank => false,
              :with => ValidatesEmailFormatOf::Regex }

  options.update(attr_names.pop) if attr_names.last.is_a?(Hash)

  validates_each(attr_names, options) do |record, attr_name, value|
    v = value.to_s

    # local part max is 64 chars, domain part max is 255 chars
    # TODO: should this decode escaped entities before counting?
    begin
      domain, local = v.reverse.split('@', 2)
    rescue
      record.errors.add(attr_name, options[:message])
      next
    end

    unless v =~ options[:with] and not v =~ /\.\./ and domain.length <= 255 and local.length <= 64
      record.errors.add(attr_name, options[:message])
    end
  end
end