Description
Elixir library for detecting disposable (burner) or personal email addresses.
Comes with two lists:
`DisposableList` — containing 3846 domains of free email providers;
`FreeList` — providers of temporary email addresses, total 5072 domains.
Configurable and easily extendable with your own custom lists.
EmailGuard alternatives and similar packages
Based on the "Security" category.
Alternatively, view EmailGuard alternatives based on common mentions on social networks and blogs.
InfluxDB high-performance time series database
Do you think we are missing an alternative of EmailGuard or a related project?
README
EmailGuard 
Elixir library for detecting disposable (burner) or personal email addresses.
Focused on performance and features the largest database of domains availble.
Comes with two lists out of the box:
DisposableList- based on mailchecker's list, total 33,606 domains;FreeList- based on this list excl. already listed inDisposableList, total 5009 domains.
You can also plug your own dataset by implementing the EmailGuard.List behaviour ✌️
Installation
Add to your mix.exs:
def deps do
[
{:email_guard, "~> 1.0"}
]
end
If you're not using application inference, then add :email_guard to your applications list.
Usage
Checks if given email or domain is present in email lists:
iex> EmailGuard.check("[email protected]")
:ok
iex> EmailGuard.check("gmail.com")
:ok
By default it will check against EmailGuard.DisposableList:
iex> EmailGuard.check("[email protected]")
{:error, EmailGuard.DisposableList}
You can specify the email list modules, e.g. including the provided one for free email service providers:
iex> lists = [EmailGuard.DisposableList, EmailGuard.FreeList]
[EmailGuard.DisposableList, EmailGuard.FreeList]
iex> EmailGuard.check("[email protected]", lists)
{:error, EmailGuard.FreeList}
To provide your own custom list see the EmailGuard.List behaviour.
Note that EmailGuard expects a valid email address or domain as input.
Benchmark
MIX_ENV=bench mix run bench/check_bench.exs
License
See LICENSE file.
*Note that all licence references and agreements mentioned in the EmailGuard README section above
are relevant to that project's source code only.