A ruby implementation of the npm freemail module, which provides a database of free and disposable email domains.
All credit for free.txt
and disposable.txt
goes to the npm
freemail maintainers.
Add this line to your application's Gemfile:
gem 'freemail', require: false
And then execute:
$ bundle
require 'freemail'
Freemail.free?('[email protected]')
# true
Freemail.free?('[email protected]')
# false
Freemail.disposable?('[email protected]')
# false
Freemail.disposable?('[email protected]')
# true
require 'freemail'
email = '[email protected]'
Freemail.free?(email)
# false
Freemail.add_free_domains('superlocalfreeemail.com')
# or by Array
Freemail.add_free_domains(['superlocalfreeemail.com'])
Freemail.free?(email)
# true
After checking out the repo, run bin/setup
to install dependencies. Then, run rake spec
to run the tests. You can also run bin/console
for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run bundle exec rake install
, or specify a path option in your gemfile:
gem 'freemail', path: '../path/to/your/copy'
Bug reports and pull requests are welcome on GitHub at https://github.com/smudge/freemail.
The gem is available as open source under the terms of the MIT License.