Email Format
This gem uses the thorough email validation implemented by the email_regex gem written by Doug Wiegley which "provides a valid email regex that conforms to most valid RFC edges cases (disallows backticks), and allows for a few illegal patterns that are in common use".
Installation
Add this line to your application's Gemfile:
gem 'email_format'
And then execute:
$ bundle
Or install it yourself as:
$ gem install email_format
Usage
EmailFormat Module
There's a valid? method in the EmailFormat module that accepts an email as an argument:
require 'email_format'
EmailFormat.valid?('invalid_email') # => false
EmailFormat.valid?('[email protected]') # => true
ActiveModel::Validations
Using it is as simple as using the validates keyword in your model:
class User < ActiveRecord::Base
# ...
validates :email, email_format: true
# ...
end
Now the email attribute will be validated accordingly:
User.new('[email protected]').valid? # => true
User.new('invalid_email@@').valid? # => false
Also, the model in question doesn't need to inherit from ActiveRecord::Base, you only need to include ActiveModel::Validations in your class:
require 'email_format'
class Awesome
include ActiveModel::Validations
attr_accessor :email
validates :email, email_format: true
end
awesome = Awesome.new
awesome.email = "[email protected]"
awesome.valid? # => true
awesome.email = "invalid_email"
awesome.valid? # => false
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