brodock-validates_as_email 0.7.0 → 0.7.2

data/CHANGELOG

@@ -1,3 +1,6 @@
+0.7.1 - April 26th 2010
+ * Added support for allow_blank and documentation
+
 0.7.0 - April 24th 2010
  * Updated to support Sexy Validations on Rails 3
  * Requires Rails 3

data/README

@@ -36,7 +36,7 @@ end
 
 class MyOtherClass < ActiveRecord::Base
   # will not accept addresses with a single part domain, e.g user@example
-  validates_as_email :email, :message => 'Invalid Email Address', :allow_nil => true, :restrict_domain => true
+  validates_as_email :email, :message => 'Invalid Email Address', :allow_nil => true
 end
 
 Tests:

data/lib/validates_as_email.rb

@@ -26,6 +26,7 @@ module ActiveModel
       def validate_each(record, attribute, value)
         
         return if options[:allow_nil] && value.nil?
+        return if options[:allow_blank] && value.blank?
         
         unless value =~ /\A([^@\s]+)@((?:[-a-z0-9]+\.)+[a-z]{2,})\Z/i
           record.errors[attribute] << (options[:message])
@@ -35,6 +36,20 @@ module ActiveModel
     end
     
     module ClassMethods
+
+      # Validates that the specified attribute is a valid email address.
+      # 
+      # Configuration options:
+      # * <tt>:allow_nil</tt> - Attribute may be +nil+; skip validation.
+      # * <tt>:allow_blank</tt> - Attribute may be blank; skip validation.
+      # * <tt>:message</tt> - The error message to be displayed
+      # * <tt>:on</tt> - Specifies when this validation is active (default is <tt>:save</tt>, other options <tt>:create</tt>, <tt>:update</tt>).
+      # * <tt>:if</tt> - Specifies a method, proc or string to call to determine if the validation should
+      #   occur (e.g. <tt>:if => :allow_validation</tt>, or <tt>:if => Proc.new { |user| user.signup_step > 2 }</tt>).  The
+      #   method, proc or string should return or evaluate to a true or false value.
+      # * <tt>:unless</tt> - Specifies a method, proc or string to call to determine if the validation should
+      #   not occur (e.g. <tt>:unless => :skip_validation</tt>, or <tt>:unless => Proc.new { |user| user.signup_step <= 2 }</tt>).  The
+      #   method, proc or string should return or evaluate to a true or false value.
       def validates_as_email(*attr_names)
         validates_with EmailValidator, _merge_attributes(attr_names)
       end

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 7
-  - 0
-  version: 0.7.0
+  - 2
+  version: 0.7.2
 platform: ruby
 authors: 
 - Michal Zima
@@ -19,7 +19,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-04-24 00:00:00 -03:00
+date: 2010-05-02 00:00:00 -03:00
 default_executable: 
 dependencies: []