2017 © Pedro Peláez
 

library mailchecker

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

image

fgribreau/mailchecker

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  • Tuesday, July 17, 2018
  • by FGRibreau
  • Repository
  • 27 Watchers
  • 898 Stars
  • 37,157 Installations
  • Rust
  • 1 Dependents
  • 0 Suggesters
  • 98 Forks
  • 2 Open issues
  • 75 Versions
  • 15 % Grown

The README.md

MailChecker

PyPi version PyPI - Downloads, (*1)

Cargo version Crates.io, (*2)

NPM version npm, (*3)

Gem version Gem, (*4)

Packagist version Packagist, (*5)

GoDoc, (*6)

Get help on Codementor available-for-advisory extra Slack, (*7)

Cross-language email validation. Backed by a database of over 55 000 throwable email domains., (*8)

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"., (*9)

Need to provide Webhooks inside your SaaS? - Try Hook0, an open-source self-hostable webhook micro-service, (*10)

Need to embed a charts into an email?, (*11)

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

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
, (*13)

Upgrade

From 3.x to 4.x

  • PHP
# import using the fully qualified name.
use Fgribreau\MailChecker;

// ...
echo MailChecker::isValid('myemail@yopmail.com');

From 1.x to 3.x

Mailchecker public API has been normalized, here are the changes:, (*14)

  • NodeJS/JavaScript: MailChecker(email) -> MailChecker.isValid(email)
  • PHP: MailChecker($email) -> MailChecker::isValid($email)
  • Python
import MailChecker
m = MailChecker.MailChecker()
if not m.is_valid('bla@example.com'):
  # ...

became:, (*15)

import MailChecker
if not MailChecker.is_valid('bla@example.com'):
  # ...

MailChecker currently supports: * NodeJS (CommonJS, Instructions) * JavaScript (Client-Side, Instructions) * PHP (Instructions) * Python (Instructions) * Ruby (Instructions) * Rust (Instructions) * Elixir (Instructions) * Clojure (Instructions) * Go (Instructions) * Easily add support for your own language with MailChecker template system and send us a pull-request!, (*16)

Usage

NodeJS

var MailChecker = require('mailchecker');

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

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

JavaScript

PHP


use Fgribreau\MailChecker;

require __DIR__ . '/vendor/autoload.php';

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

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

Python

pip install mailchecker

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

if not MailChecker.is_valid('bla@example.com'):
    print "O RLY !"

Django validator: https://github.com/jonashaag/django-indisposable, (*17)

Ruby

require 'mail_checker'

unless MailChecker.valid?('myemail@yopmail.com')
  fail('O RLY!')
end

Rust

 extern crate mailchecker;

assert_eq!(true, mailchecker::is_valid("plop@plop.com"));
assert_eq!(false, mailchecker::is_valid("\nok@gmail.com\n"));
assert_eq!(false, mailchecker::is_valid("ok@guerrillamailblock.com"));

Elixir

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

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

unless MailChecker.valid?("myemail.com") do
  raise "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? "myemail@yopmail.com"))
  (throw (Throwable. "O RLY!")))

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

Go

package main

import (
  "log"

  mail_checker "github.com/FGRibreau/mailchecker/v6/platform/go"
)

if !mail_checker.IsValid("myemail@yopmail.com") {
  log.Fatal("O RLY !");
}

if !mail_checker.IsValid("myemail.com") {
  log.Fatal("O RLY !")
}

Installation

Go, (*18)

go get github.com/FGRibreau/mailchecker/v6/platform/go

NodeJS/JavaScript, (*19)

npm install mailchecker

Ruby, (*20)

gem install ruby-mailchecker

PHP, (*21)

composer require fgribreau/mailchecker

We accept pull-requests for other package manager., (*22)

Data sources

TorVPN, (*23)

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

BloggingWV, (*24)

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

... please add your own dataset to list.txt., (*25)

Regenerate libraries from list.txt

Just run (requires NodeJS):, (*26)

npm run build

Development

Development environment requires docker., (*27)

# install and setup every language dependencies in parallel through docker
npm install

# run every language setup in parallel through docker
npm run setup

# run every language tests in parallel through docker
npm test

Backers

Maintainers

These amazing people are maintaining this project:, (*28)

Sponsors

No sponsors yet! Will you be the first?, (*29)

Patreon donate button Gratipay donate button Flattr donate button PayPal donate button crypto donate button, (*30)

Contributors

These amazing people have contributed code to this project:, (*31)

Discover how you can contribute by heading on over to the CONTRIBUTING.md file., (*32)

Changelog

License

Unless stated otherwise all works are:, (*33)

and licensed under:, (*34)

The Versions

17/07 2018

dev-master

9999999-dev

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

17/07 2018

v3.2.7

3.2.7.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

10/07 2018

v3.2.6

3.2.6.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

14/05 2018

v3.2.5

3.2.5.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

14/05 2018

v3.2.4

3.2.4.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

10/04 2018

v3.2.3

3.2.3.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

02/04 2018

v3.2.2

3.2.2.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

30/03 2018

v3.2.1

3.2.1.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

12/03 2018

v3.2.0

3.2.0.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

11/03 2018

v3.1.0

3.1.0.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

11/03 2018

v3.0.40

3.0.40.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

10/03 2018

v3.0.39

3.0.39.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

10/03 2018

v3.0.38

3.0.38.0 https://github.com/FGRibreau/mailchecker

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email spam detection fake

07/03 2018

v3.0.37

3.0.37.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

14/02 2018

dev-greenkeeper/mocha-5.0.1

dev-greenkeeper/mocha-5.0.1

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

18/01 2018

dev-greenkeeper/mocha-5.0.0

dev-greenkeeper/mocha-5.0.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

03/01 2018

v3.0.36

3.0.36.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

01/01 2018

v3.0.35

3.0.35.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

26/12 2017

v3.0.34

3.0.34.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

29/11 2017

v3.0.33

3.0.33.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

31/10 2017

v3.0.32

3.0.32.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

28/10 2017

v3.0.31

3.0.31.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

28/10 2017

dev-greenkeeper/should-13.1.3

dev-greenkeeper/should-13.1.3

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

23/10 2017

dev-greenkeeper/nodeunit-0.11.2

dev-greenkeeper/nodeunit-0.11.2

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

10/10 2017

dev-greenkeeper/should-13.1.2

dev-greenkeeper/should-13.1.2

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

07/10 2017

dev-greenkeeper/should-13.1.1

dev-greenkeeper/should-13.1.1

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

06/10 2017

dev-greenkeeper/mocha-4.0.1

dev-greenkeeper/mocha-4.0.1

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

03/10 2017

dev-greenkeeper/mocha-4.0.0

dev-greenkeeper/mocha-4.0.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

25/09 2017

v3.0.30

3.0.30.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

20/09 2017

dev-greenkeeper/should-13.1.0

dev-greenkeeper/should-13.1.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

12/09 2017

dev-greenkeeper/mocha-3.5.3

dev-greenkeeper/mocha-3.5.3

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

11/09 2017

v3.0.29

3.0.29.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

11/09 2017

dev-greenkeeper/mocha-3.5.2

dev-greenkeeper/mocha-3.5.2

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

10/09 2017

dev-greenkeeper/mocha-3.5.1

dev-greenkeeper/mocha-3.5.1

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

05/09 2017

dev-greenkeeper/should-13.0.0

dev-greenkeeper/should-13.0.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

28/08 2017

dev-greenkeeper/should-12.0.0

dev-greenkeeper/should-12.0.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

11/08 2017

v3.0.28

3.0.28.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

01/06 2017

v3.0.27

3.0.27.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

25/05 2017

v3.0.26

3.0.26.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

14/05 2017

dev-greenkeeper/mocha-3.4.1

dev-greenkeeper/mocha-3.4.1

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

14/05 2017

dev-greenkeeper/mocha-3.4.0

dev-greenkeeper/mocha-3.4.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

30/03 2017

v3.0.25

3.0.25.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

13/03 2017

v3.0.24

3.0.24.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

14/02 2017

v3.0.23

3.0.23.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

07/02 2017

dev-greenkeeper/nodeunit-0.11.0

dev-greenkeeper/nodeunit-0.11.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

01/02 2017

v3.0.22

3.0.22.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

28/01 2017

v3.0.21

3.0.21.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

24/01 2017

v3.0.20

3.0.20.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

23/11 2016

v3.0.19

3.0.19.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

22/11 2016

v3.0.18

3.0.18.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

31/10 2016

dev-greenkeeper-lodash-4.16.5

dev-greenkeeper-lodash-4.16.5

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

29/10 2016

v3.0.17

3.0.17.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

05/10 2016

v3.0.16

3.0.16.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

19/09 2016

dev-greenkeeper-lodash-4.16.0

dev-greenkeeper-lodash-4.16.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

05/09 2016

v3.0.15

3.0.15.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

21/07 2016

v3.0.14

3.0.14.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

18/07 2016

v3.0.13

3.0.13.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

18/07 2016

dev-new-emails

dev-new-emails

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

13/07 2016

v3.0.12

3.0.12.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

09/07 2016

v3.0.11

3.0.11.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

09/07 2016

v3.0.10

3.0.10.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

09/07 2016

v3.0.9

3.0.9.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

14/06 2016

v3.0.8

3.0.8.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

30/05 2016

v3.0.7

3.0.7.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

24/05 2016

v3.0.6

3.0.6.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

24/05 2016

v3.0.5

3.0.5.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

25/04 2016

v3.0.4

3.0.4.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

15/04 2016

v3.0.3

3.0.3.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

12/04 2016

v3.0.2

3.0.2.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

21/03 2016

v3.0.1

3.0.1.0

Temporary (disposable/throwaway) email detection library. Covers 1987 fake email providers.

  Sources   Download

MIT

The Development Requires

email detection fake

21/03 2016

v3.0.0

3.0.0.0

  Sources   Download

The Development Requires

19/03 2016

v2.0.1

2.0.1.0

  Sources   Download

The Development Requires

19/03 2016

v2.0.0

2.0.0.0

  Sources   Download

The Development Requires

19/03 2016

v1.6.3

1.6.3.0

  Sources   Download

The Development Requires

19/03 2016

v1.6.2

1.6.2.0

  Sources   Download

The Development Requires