Skip to content

hallelujah/valid_email

Repository files navigation

Valid Email

Purpose

It validates email for application use (registering a new account for example).

Usage

In your Gemfile:

gem 'valid_email'

In your code:

require 'valid_email'

class Person
  include ActiveModel::Validations
  attr_accessor :name, :email

  validates :name, presence: true, length: { maximum: 100 }
  validates :email, presence: true, email: true
end


person = Person.new
person.name = 'hallelujah'
person.email = '[email protected]'
person.valid? # => true

person.email = 'john@doe'
person.valid? # => false

person.email = 'John Does <[email protected]>'
person.valid? # => false

You can check if email domain has MX record:

validates :email,
          email: {
            mx: true,
            message: I18n.t('validations.errors.models.user.invalid_email')
          }

Or

validates :email,
          email: {
            message: I18n.t('validations.errors.models.user.invalid_email')
          },
          mx: {
            message: I18n.t('validations.errors.models.user.invalid_mx')
          }

By default, the email domain is validated using a regular expression, which does not require an external service and improves performance. Alternatively, you can check if an email domain has a MX or A record by using :mx_with_fallback instead of :mx.

validates :email, email: { mx_with_fallback: true }

You can detect disposable accounts

validates :email,
          email: {
            ban_disposable_email: true,
            message: I18n.t('validations.errors.models.user.invalid_email')
          }

You can also detect a partial match on disposable accounts, good for services that use subdomains.

validates :email,
          email: {
            message: I18n.t('validations.errors.models.user.invalid_email')
            ban_disposable_email: true,
            partial: true
          }

If you don't want the MX validator stuff, just require the right file

require 'valid_email/email_validator'

Or in your Gemfile

gem 'valid_email', require: 'valid_email/email_validator'

Usage outside of model validation

There is a chance that you want to use e-mail validator outside of model validation. If that's the case, you can use the following methods:

options = {} # You can optionally pass a hash of options, same as validator
ValidateEmail.valid?('[email protected]', options)
ValidateEmail.mx_valid?('[email protected]')
ValidateEmail.mx_valid_with_fallback?('[email protected]')
ValidateEmail.valid?('[email protected]')

Load it (and not the Rails extensions) with

gem 'valid_email', require: 'valid_email/validate_email'

String and Nil object extensions

There is also a String and Nil class extension, if you require the gem in this way in Gemfile:

gem 'valid_email', require: 'valid_email/all_with_extensions'

You will be able to use the following methods:

nil.email? # => false
'[email protected]'.email? # => May return true if it exists.
# It accepts a hash of options like ValidateEmail.valid?

Code Status

Build Status

Credits

  • Ramihajamalala Hery hery[at]rails-royce.org
  • Fire-Dragon-DoL francesco.belladonna[at]gmail.com
  • dush dusanek[at]iquest.cz
  • MIke Carter mike[at]mcarter.me
  • Heng heng[at]reamaze.com
  • Marco Perrando mperrando[at]soluzioninrete.it
  • Jörg Thalheim joerg[at]higgsboson.tk
  • Andrey Deryabin deriabin[at]gmail.com
  • Nicholas Rutherford nick.rutherford[at]gmail.com
  • Oleg Shur workshur[at]gmail.com
  • Joel Chippindale joel[at]joelchippindale.com
  • Sami Haahtinen sami[at]haahtinen.name
  • Jean Boussier jean.boussier[at]gmail.com
  • Masaki Hara - @qnighy

Pull Requests

  1. Fork the project.
  2. Make your feature addition or bug fix.
  3. Add tests for it. This is important so I don’t break it in a future version unintentionally.
  4. Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
  5. Send me a pull request. Bonus points for topic branches.

Copyright

Copyright © 2011 Ramihajamalala Hery. See LICENSE for details

About

Active Model Validations for Email using mail gem

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages