Initial commit

.gitignore

@@ -0,0 +1,28 @@
+# Logs
+logs
+*.log
+
+# Runtime data
+pids
+*.pid
+*.seed
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+
+# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Compiled binary addons (http://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directory
+# Commenting this out is preferred by some people, see
+# https://www.npmjs.org/doc/misc/npm-faq.html#should-i-check-my-node_modules-folder-into-git-
+node_modules
+
+# Users Environment Variables
+.lock-wscript

LICENSE

@@ -0,0 +1,14 @@
+Copyright (c) 2015, Will White <[email protected]>
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+

README.md

@@ -0,0 +1,51 @@
+[![Build Status](https://travis-ci.org/willwhite/freemail.svg?branch=master)](https://travis-ci.org/willwhite/freemail)
+
+# freemail
+
+A database of free and [disposable](http://en.wikipedia.org/wiki/Disposable_email_address)
+email domains and a handy Node.js module for querying it.
+
+Use the Node.js module or access the files in the `./data` directory and parse
+with your language of choice.
+
+In an effort to create the most up-to-date list of domains, the database can be
+synchronized with various lists from around the web. You can also add new
+domains directly by opening a pull request.
+
+## Database
+
+There are three key data files in this project:
+
+- **free.txt** contains a list of domains that are known to provide free email service
+- **disposable.txt** contains a list of domains that are known to provide disposable email add
+- **blacklist.txt** contains a list of domains that this project will refuse to add to either list
+
+Domains may only be a member of one list.
+
+## Updating the database
+
+Run `./update` to pull in the latest domains from the sources listed in
+`sources.txt`. All new domains will be placed in `free.txt` by default.
+If any domains provide disposable email service, they may be moved to
+`disposable.txt`.
+
+## Node
+
+### Install
+
+```
+npm install --save freemail
+```
+
+```javascript
+var freemail = require('freemail');
+freemail.isFree('[email protected]');
+> true
+freemail.isFree('[email protected]');
+> true
+freemail.isDisposable('[email protected]');
+> false
+freemail.isDisposable('[email protected]');
+> true
+
+```

_travis.yml

@@ -0,0 +1,4 @@
+language: node_js
+
+node_js:
+- "0.10.28"

data/blacklist.txt

@@ -0,0 +1,4 @@
+.ddns.org
+.findhere.com
+.freeservers.com
+.zzn.com