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
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request