View Source Disposable

Hex.pm Hex Docs

Disposable is an Elixir library for checking if an email address is from a disposable email service. It provides a fast, memory-efficient way to validate email domains against a known list of disposable email providers. With over 169.000 domains in the list, Disposable is a reliable tool for preventing users from signing up with temporary email addresses.

Features

  • Fast in-memory checking of email domains
  • Easy to use API
  • Configurable disposable domains list
  • Ability to reload domains without application restart

Installation

The package can be installed by adding disposable to your list of dependencies in mix.exs:

def deps do
  [
    {:disposable, "~> 0.1.3"}
  ]
end

Usage

Basic usage 

iex> Disposable.check("user@gmail.com")
false

iex> Disposable.check("user@tempmail.com")
true

Configuration

By default, Disposable uses a built-in list of disposable email domains. You can provide your own list by setting the :disposable_domains_file configuration in your config.exs:

config :disposable, disposable_domains_file: "/path/to/your/domains.txt"

Reloading domains

If you update your domains list, you can reload it without restarting your application:

Disposable.reload()

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork it
  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 new Pull Request

License

This project is licensed under the MIT License - see the LICENSE.md file for details.

Acknowledgments

  • Thanks to all contributors who have helped with this project.
  • Special thanks to the maintainers of various disposable email domain lists that helped in creating our initial list.