Emailist

emailist is a wrapper around Ruby Array, and is meant to assist in managing a list of email addresses.

emailist automatically attempts to clean invalid emails as they're added, and maintains uniqueness of your list. This is good for parsing emails, where you may end up with some invalid characters, or extra, unwanted bit of text on the beginnings/ends of the emails). While there are some caveats using emailist, as long as you don't need and/or expect 100% accuracy, then you should be fine. emailist tries its hardest to adhere to the RFC specs for emails, and checks validity of TLDs against ICANN.

This is just a small project I built for myself. I was building a simple parser to grab emails from a bunch of files. I decided I'd pull it out into its own gem, as I can see it being useful in other cases. Anyway, the code could certainly be a lot better, I only spent a couple of hours on this this morning. I'd love to improve this further, so pull requests are very welcome.

Installation

Add this line to your application's Gemfile:

gem 'emailist'

And then execute:

$ bundle

Or install it yourself as:

$ gem install emailist

Usage

Make sure you require...

    require 'emailist'

Adding and removing emails is very easy:

    emails = Emailist.new
    emails.add('bob.jones@example.com')
    => ['bob.jones@example.com']
    emails.remove('bob.jones@example.com')
    => []

Uniqueness is automatically maintained:

    emails = Emailist.new
    emails.add('fred.smith@example.com')
    => ['fred.smith@example.com']
    emails.add('fred.smith@example.com')
    => ['fred.smith@example.com']

Invalid emails are attempted to be cleaned:

    emails = Emailist.new
    emails.add('.bob.jones@example.com')
    => ['bob.jones@example.com']
    emails.add('fred.smith@example.com.')
    => ['fred.smith@example.com']

Invalid TLDs (after cleaning) raise Emailist::InvalidTLD:

    emails = Emailist.new
    emails.add('bob.jones@fooo.baar')
    => # raises Emailist::InvalidTLD

Finally, if you want to verify hosts (example.com in bob.jones@example.com), do:

    emails = Emailist.new(verify_hosts: true)
    emails.add('bob.jones@af983h98hsdf98hgiau3hnvgbjiobj8.com')
    => # raises Emailist::HostDead

Ideas For Improvement

1. Some kind of "best-guess" algorithm that can take invalid TLDs and find the most likely intended TLD (e.g. I'm getting some emails from my parser that have an 'E', like 'bob.jones@blah.comE' -- this clearly is supposed to be '.com'). Perhaps Levenshtein distance could be useful for this.
2. Fix possible_email gem -- Rapportive still has an API but they've modified it, so the code for the gem doesn't work. This will require reverse-engineering the API, as they don't offer access publicly. Not sure if it's even possible, but worth a try.

Contributing

1. Fork it ( https://github.com/[my-github-username]/emailist/fork )
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 a new Pull Request