validate_email 0.1.0

data/README.markdown

@@ -0,0 +1,52 @@
+# ValidateEmail
+
+This gem adds the capability of validating email addresses to `ActiveModel`. 
+The gem only supports Rails 3 (has dependencies in ActiveModel and ActiveSupport 3.0)
+
+### Installation
+    # add this to your Gemfile
+    gem "validate_email"
+
+    # and then run
+    rake gems:install
+
+    # or just run
+    sudo gem install validate_email
+
+### Usage
+
+#### With ActiveRecord
+    class Pony < ActiveRecord::Base
+      # standard validation
+      validates :email_address, :email => true
+
+      # with allow_nil
+      validates :email_address, :email => {:allow_nil => true}
+
+      # with allow_blank
+      validates :email_address, :email => {:allow_blank => true}
+    end
+
+#### With ActiveModel
+    class Unicorn
+      include ActiveModel::Validations
+
+      attr_accessor :email_address
+
+      # with legacy syntax (the syntax above works also)
+      validates_email :email_address, :allow_blank => true
+    end
+
+#### I18n
+
+The default error message `is not valid email`.
+You can pass the `:message => "my custom error"` option to your validation to define your own, custom message.
+
+## Authors
+
+**Tanel Suurhans** (<http://twitter.com/tanelsuurhans>)
+**Tarmo Lehtpuu** (<http://twitter.com/tarmolehtpuu>)
+
+## License
+Copyright 2010 by PerfectLine LLC (<http://www.perfectline.co.uk>) and is released under the MIT license.
+

data/install.rb

@@ -0,0 +1 @@
+puts IO.read(File.join(File.dirname(__FILE__), 'README.markdown'))

data/lib/validate_email.rb

@@ -0,0 +1,36 @@
+require 'active_model'
+require 'active_model/validations'
+require 'active_support/concern'
+require 'mail'
+
+module Perfectline
+  module ValidateEmail
+    extend ActiveSupport::Concern
+
+    class EmailValidator < ActiveModel::EachValidator
+      def initialize(options)
+        options[:message] ||= "is not a valid email"
+        super(options)
+      end
+
+      def validate_each(record, attribute, value)
+        begin
+          mail = Mail::Address.new(value)          
+          unless mail.address == value && mail.domain.split(".").length > 1
+            record.errors.add(attribute, options[:message])
+          end
+        rescue
+          record.errors.add(attribute, options[:message])
+        end
+      end
+    end
+
+    module ClassMethods
+      def validates_email(*attr_names)
+        validates_with EmailValidator, _merge_attributes(attr_names)
+      end
+    end
+  end
+end
+
+ActiveModel::Validations.send(:include, Perfectline::ValidateEmail)

data/rails/init.rb

@@ -0,0 +1 @@
+require 'validate_email'

data/spec/resources/user.rb

@@ -0,0 +1,9 @@
+require 'active_model/validations'
+
+class User
+  include ActiveModel::Validations
+
+  attr_accessor :email_address
+
+  validates :email_address, :email => true
+end

data/spec/resources/user_with_blank.rb

@@ -0,0 +1,9 @@
+require 'active_model/validations'
+
+class UserWithBlank
+  include ActiveModel::Validations
+
+  attr_accessor :email_address
+
+  validates :email_address, :email => {:allow_blank => true}
+end

data/spec/resources/user_with_legacy_syntax.rb

@@ -0,0 +1,9 @@
+require 'active_model/validations'
+
+class UserWithLegacySyntax
+  include ActiveModel::Validations
+
+  attr_accessor :email_address
+
+  validates_email :email_address, :allow_blank => true
+end

data/spec/resources/user_with_nil.rb

@@ -0,0 +1,9 @@
+require 'active_model/validations'
+
+class UserWithNil
+  include ActiveModel::Validations
+
+  attr_accessor :email_address
+
+  validates :email_address, :email => {:allow_nil => true}
+end

data/spec/spec_helper.rb

@@ -0,0 +1,12 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__) + '/../lib')
+$LOAD_PATH.unshift(File.dirname(__FILE__) + '/resources')
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+
+require 'spec'
+require 'validate_email'
+
+autoload :User,                 'resources/user'
+autoload :UserWithNil,          'resources/user_with_nil'
+autoload :UserWithBlank,        'resources/user_with_blank'
+autoload :UserWithLegacySyntax, 'resources/user_with_legacy_syntax'
+

data/spec/validate_email_spec.rb

@@ -0,0 +1,114 @@
+require 'spec_helper'
+
+describe "Enail validation", Perfectline::ValidateEmail::EmailValidator do
+
+  context "with regular validator" do
+    before do
+      @user = User.new
+    end
+
+    it "should not allow nil as email" do
+      @user.email_address = nil
+      @user.should_not be_valid
+    end
+
+    it "should not allow blank as email" do
+      @user.email_address = ""
+      @user.should_not be_valid
+    end
+
+    it "should not allow an email without domain extension" do
+      @user.email_address = "user@example"
+      @user.should_not be_valid
+    end
+
+    it "should not allow an email without @" do
+      @user.email_address = "user"
+      @user.should_not be_valid
+    end
+
+    it "should not allow an email without prefix" do
+      @user.email_address = "@example.com"
+      @user.should_not be_valid
+    end
+
+    it "should not allow an email without domain" do
+      @user.email_address = "user@.com"
+      @user.should_not be_valid
+    end
+
+    it "should accept a valid email address" do
+      @user.email_address = "user@example.com"
+      @user.should be_valid
+    end
+  end
+
+  context "with allow nil" do
+    before do
+      @user = UserWithNil.new
+    end
+
+    it "should allow nil as email" do
+      @user.email_address = nil
+      @user.should be_valid
+    end
+
+    it "should not allow blank as email" do
+      @user.email_address = ""
+      @user.should_not be_valid
+    end
+
+    it "shoild allow a valid email address" do
+      @user.email_address = "user@example.com"
+      @user.should be_valid
+    end
+  end
+
+  context "with allow blank" do
+    before do
+      @user = UserWithBlank.new
+    end
+
+    it "should allow nil as email" do
+      @user.email_address = nil
+      @user.should be_valid
+    end
+
+    it "should allow blank as email" do
+      @user.email_address = ""
+      @user.should be_valid
+    end
+
+    it "should allow a valid email address" do
+      @user.email_address = "user@example.com"
+      @user.should be_valid
+    end
+  end
+
+  context "with legacy syntax" do
+    before do
+      @user = UserWithLegacySyntax.new
+    end
+
+    it "should allow nil as email" do
+      @user.email_address = nil
+      @user.should be_valid
+    end
+
+    it "should allow blank as email" do
+      @user.email_address = ""
+      @user.should be_valid
+    end
+
+    it "should allow a valid email address" do
+      @user.email_address = "user@example.com"
+      @user.should be_valid
+    end
+
+    it "should not allow invalid email" do
+      @user.email_address = "random"
+      @user.should_not be_valid
+    end
+  end
+
+end

metadata

@@ -0,0 +1,151 @@
+--- !ruby/object:Gem::Specification 
+name: validate_email
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Tanel Suurhans
+- Tarmo Lehtpuu
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-09-07 00:00:00 +03:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: diff-lcs
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 1
+        - 2
+        version: 1.1.2
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: mail
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 2
+        - 5
+        version: 2.2.5
+  type: :runtime
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: activesupport
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 3
+        - 0
+        version: "3.0"
+  type: :runtime
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: activemodel
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 3
+        - 0
+        version: "3.0"
+  type: :runtime
+  version_requirements: *id005
+description: Library for validating email addresses in Rails 3 models.
+email: 
+- tanel.suurhans@perfectline.ee
+- tarmo.lehtpuu@perfectline.ee
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.markdown
+files: 
+- README.markdown
+- install.rb
+- lib/validate_email.rb
+- rails/init.rb
+- spec/resources/user.rb
+- spec/resources/user_with_blank.rb
+- spec/resources/user_with_legacy_syntax.rb
+- spec/resources/user_with_nil.rb
+- spec/spec_helper.rb
+- spec/validate_email_spec.rb
+has_rdoc: true
+homepage: http://github.com/perfectline/validate_email/tree/master
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Library for validating email addresses in Rails 3 models.
+test_files: 
+- spec/resources/user.rb
+- spec/resources/user_with_blank.rb
+- spec/resources/user_with_legacy_syntax.rb
+- spec/resources/user_with_nil.rb
+- spec/spec_helper.rb
+- spec/validate_email_spec.rb