quaswex / mailchecker

:mailbox: Cross-language temporary (disposable/throwaway) email detection library. Covers 2740 fake email providers.

MailChecker

Cross-language email validation. Backed by a database of 2740 throwable email providers.

• Validate the format of your email (uses validator.js email regex underneath and FILTER_VALIDATE_EMAIL for PHP)
• Validate if the email is not a temporary mail (yopmail-like..., add your own dataset to list.json)

This will be very helpful when you have to contact your users and you want to avoid errors causing lack of communication or want to block "spamboxes".

---

Need to embed a charts into an email?

It's over with Image-Charts, no more server-side rendering pain, 1 url = 1 chart.

https://image-charts.com/chart?
cht=lc // chart type
&chd=s:cEAELFJHHHKUju9uuXUc // chart data
&chxt=x,y // axis
&chxl=0:|0|1|2|3|4|5| // axis labels
&chs=873x200 // size

Use Image-Charts for free

---

Upgrade from 1.x to 3.x

Mailchecker public API has been normalized, here are the changes:

• NodeJS/JavaScript: MailChecker(email) -> MailChecker.isValid(email)
• PHP: MailChecker($email) -> MailChecker::isValid($email)
• Python

import MailChecker
m = MailChecker.MailChecker()
if not m.is_valid('[email protected]'):
  # ...

became:

import MailChecker
if not MailChecker.is_valid('[email protected]'):
  # ...

---

MailChecker currently supports:

• NodeJS (CommonJS)
• JavaScript (Client-Side)
• PHP
• Python
• Ruby
• Elixir
• Clojure
• Easily add support for your own language with MailChecker template system and send us a pull-request!

---

Usage

NodeJS

var MailChecker = require('mailchecker');

if(!MailChecker.isValid('[email protected]')){
  console.error('O RLY !');
  process.exit(1);
}

if(!MailChecker.isValid('myemail.com')){
  console.error('O RLY !');
  process.exit(1);
}

JavaScript

<script type="text/javascript" src="MailChecker/platform/javascript/MailChecker.js"></script>
<script type="text/javascript">
if(!MailChecker.isValid('[email protected]')){
  console.error('O RLY !');
}

if(!MailChecker.isValid('myemail.com')){
  console.error('O RLY !');
}
</script>

PHP

include __DIR__."/MailChecker/platform/php/MailChecker.php";

if(!MailChecker::isValid('[email protected]')){
  die('O RLY !');
}

if(!MailChecker::isValid('myemail.com')){
  die('O RLY !');
}

Elixir

Code.require_file("mail_checker.ex", "mailchecker/platform/elixir/")

unless MailChecker.valid?("[email protected]") do
  raise "O RLY !"
end

unless MailChecker.valid?("myemail.com") do
  raise "O RLY !"
end

Python

# no package yet; just drop in MailChecker.py where you want to use it.
import MailChecker

if not MailChecker.is_valid('[email protected]'):
    print "O RLY !"

Ruby

require 'mail_checker'

unless MailChecker.valid?('[email protected]')
  fail('O RLY!')
end

Clojure

; no package yet; just drop in mailchecker.clj where you want to use it.
(load-file "platform/clojure/mailchecker.clj")

(if (not (mailchecker/valid? "[email protected]"))
  (throw (Throwable. "O RLY!")))

(if (not (mailchecker/valid? "myemail.com"))
  (throw (Throwable. "O RLY!")))

---

Installation

NodeJS/JavaScript

npm install mailchecker

Ruby

gem install ruby-mailchecker

PHP

composer require fgribreau/mailchecker

We accept pull-requests for other package manager.

Data sources

TorVPN

  $('td', 'table:last').map(function(){
    return this.innerText;
  }).toArray();

BloggingWV

  Array.prototype.slice.call(document.querySelectorAll('.entry > ul > li a')).map(function(el){return el.innerText});

... please add your own dataset to list.json.

Regenerate libraries from list.json

Just run (requires NodeJS):

npm run build

Backers

Maintainers

These amazing people are maintaining this project:

• Francois-Guillaume Ribreau — view contributions

Sponsors

No sponsors yet! Will you be the first?

Contributors

These amazing people have contributed code to this project:

• Owen Stephens — view contributions
• Jacob Burenstam — view contributions
• Herman Slatman — view contributions
• trisix — view contributions
• Greenkeeper — view contributions
• Dustin Clark — view contributions
• Anton Zhiyanov — view contributions
• Bruel Nicolas — view contributions
• Robin — view contributions
• Spir — view contributions
• Vincent Giersch — view contributions
• watadarkstar — view contributions
• Dave Powers — view contributions
• Frank Phillips — view contributions
• LuckyDino — view contributions
• ven — view contributions
• Romain Gay — view contributions
• Sebastian Cohnen — view contributions
• Dalai — view contributions
• quaswex — view contributions
• sxyuan — view contributions
• Francois-Guillaume Ribreau — view contributions

Changelog

License

Unless stated otherwise all works are:

• Copyright © Francois-Guillaume Ribreau

and licensed under:

• MIT License