No release in over 3 years
Low commit activity in last 3 years
The ultimate email validator
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

 Project Readme

Validate as Email Circle CI

Validation of email addresses via the excellent Mail gem that is available in all Rails 3 and 4 applications.

Installation

Add this line to your application's Gemfile:

gem 'validate_as_email'

And then execute:

$ bundle

Or install it yourself as:

$ gem install validate_as_email

Usage

This gem is tested against MRI, JRuby, and Rubinius using Travis CI.

You will need to be using Rails 3 or greater to make use of this validator, as it is built on top of ActiveModel, which was introduced in Rails 3.

Usage with ActiveModel

class Person
  include ActiveModel::Validations
  validates_as_email :email
  attr_accessor :email
end

# OR

class Person
  include ActiveModel::Validations
  validates :email, email: true
  attr_accessor :email
end

Usage with ActiveRecord

class Person < ActiveRecord::Base
  validates_as_email :email
  attr_accessor :email
end

# OR

class Person < ActiveRecord::Base
  validates :email, email: true
  attr_accessor :email
end

Built-in RSpec Matcher

The custom matcher will be loaded automatically if RSpec is loaded first. Otherwise, you'll need to require the RSpec matcher manually using require 'validate_as_email/rspec'.

require 'validate_as_email/rspec'

class Person < ActiveRecord::Base
  validates_as_email :email
  attr_accessor :email
end

describe Person do
  it { should have_a_valid_email_address_for(:email) }
  it { should_not have_a_valid_email_address_for(:email) }
end

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request