Contents

[![Build Status](https://secure.travis-ci.org/balexand/email_validator.png)](http://travis-ci.org/balexand/email_validator)

## Usage

Add to your Gemfile:

```ruby
gem 'email_validator'
```

Run:

```
bundle install
```

Then add the following to your model:

```ruby
validates :my_email_attribute, email: true
```

## Validation outside a model

If you'd like to validate an email outside of a model then here are some class methods that you can use:

```ruby
EmailValidator.regexp # returns the regex
EmailValidator.valid?('[e-mail]') # => true
EmailValidator.invalid?('[e-mail]') # => false
```

## Validation philosophy

The validation provided by this gem is loose. It just checks that there's an `@` with something before and after it. See [this article by David Gilbertson](https://hackernoon.com/the-100-correct-way-to-validate-email-addresses-7c4818f24643) for an explanation of why.

## Trimming whitespace

Your users may accidentally submit leading or trailing whitespace when submitting a form. You may want to automatically trim this. This is not the job of a validator gem but it's trivial to implement yourself by adding a setter in your model:

```ruby
def email=(e)
  e = e.strip if e
  super
end
```

You may also want to convert emails to lowercase in the same way.

## Alternative gems

Do you prefer a different email validation gem? If so, open an issue with a brief explanation of how it differs from this gem. I'll add a link to it in this README.

## Thread safety

This gem is thread safe.

Version data entries

2 entries across 2 versions & 1 rubygems

Version	Path
email_validator-2.0.1	README.md
email_validator-2.0.0	README.md