throwaway 1.1.0

data/README.md

@@ -0,0 +1,23 @@
+# Throwaway
+
+This is a very simple Ruby gem which validates that email addresses are not from a disposable email address provider. The list of providers is simply hardcoded, so no network time is required. I'll try and keep it up to date, but such an endeavour is pretty impossible. Catching the most common providers does help with fraud prevention etc though.
+
+
+## Usage
+
+### Query
+
+	Throwaway.is_throwaway?(email)
+	=> true/false
+
+### Validator
+
+	validates :email, :throwaway => false
+
+Default message: *is from a disposable email provider*
+
+	validates :email, :throwaway => false, :message => "emails from disposable providers are not allowed here. Sorry."
+
+ If, for some bizarre reason, you want to validate that address *are* from a throwaway provider, you can do that too.
+
+	validates :email, :throwaway => true

data/Rakefile

@@ -0,0 +1 @@
+require 'bundler/gem_tasks'

data/lib/providers.yml

@@ -0,0 +1,261 @@
+providers:
+  - '0-mail.com'
+  - '0815.ru'
+  - '0clickemail.com'
+  - '10minutemail.com'
+  - '20minutemail.com'
+  - '2prong.com'
+  - '30minutemail.com'
+  - '3d-painting.com'
+  - '4warding.com'
+  - '4warding.net'
+  - '4warding.org'
+  - '60minutemail.com'
+  - 'amilegit.com'
+  - 'anonbox.net'
+  - 'anonymbox.com'
+  - 'antispam.de'
+  - 'beefmilk.com'
+  - 'binkmail.com'
+  - 'bio-muesli.net'
+  - 'bobmail.info'
+  - 'bofthew.com'
+  - 'brefmail.com'
+  - 'bsnow.net'
+  - 'bugmenot.com'
+  - 'bumpymail.com'
+  - 'cosmorph.com'
+  - 'courrieltemporaire.com'
+  - 'cubiclink.com'
+  - 'curryworld.de'
+  - 'cust.in'
+  - 'dacoolest.com'
+  - 'dandikmail.com'
+  - 'dayrep.com'
+  - 'deadaddress.com'
+  - 'despam.it'
+  - 'devnullmail.com'
+  - 'discardmail.com'
+  - 'discardmail.de'
+  - 'disposemail.com'
+  - 'dispostable.com'
+  - 'dodgeit.com'
+  - 'dodgit.com'
+  - 'dodgit.org'
+  - 'donemail.ru'
+  - 'dontreg.com'
+  - 'dontsendmespam.de'
+  - 'dump-email.info'
+  - 'dumpyemail.com'
+  - 'e4ward.com'
+  - 'email60.com'
+  - 'emailigo.de'
+  - 'emailinfive.com'
+  - 'emailmiser.com'
+  - 'emailsensei.com'
+  - 'emailtemporario.com.br'
+  - 'emailwarden.com'
+  - 'emailx.at.hm'
+  - 'fakeinbox.com'
+  - 'fakeinformation.com'
+  - 'fastacura.com'
+  - 'filzmail.com'
+  - 'fizmail.com'
+  - 'fr33mail.info'
+  - 'get1mail.com'
+  - 'get2mail.fr'
+  - 'getonemail.com'
+  - 'getonemail.net'
+  - 'gishpuppy.com'
+  - 'great-host.in'
+  - 'guerillamail.com'
+  - 'guerrillamail.com'
+  - 'guerrillamailblock.com'
+  - 'h.mintemail.com'
+  - 'haltospam.com'
+  - 'hochsitze.com'
+  - 'hotpop.com'
+  - 'hulapla.de'
+  - 'ieatspam.eu'
+  - 'ieatspam.info'
+  - 'imails.info'
+  - 'incognitomail.com'
+  - 'incognitomail.net'
+  - 'incognitomail.org'
+  - 'insorg-mail.info'
+  - 'ipoo.org'
+  - 'jetable.com'
+  - 'jetable.net'
+  - 'jetable.org'
+  - 'jnxjn.com'
+  - 'junk1e.com'
+  - 'keepmymail.com'
+  - 'kir.ch.tc'
+  - 'klzlk.com'
+  - 'kulturbetrieb.info'
+  - 'lhsdv.com'
+  - 'litedrop.com'
+  - 'lol.ovpn.to'
+  - 'lookugly.com'
+  - 'lopl.co.cc'
+  - 'm4ilweb.info'
+  - 'mail-temporaire.fr'
+  - 'mail.by'
+  - 'mail4trash.com'
+  - 'mailcatch.com'
+  - 'maileater.com'
+  - 'mailexpire.com'
+  - 'mailin8r.com'
+  - 'mailinator.com'
+  - 'mailinator.net'
+  - 'mailinator2.com'
+  - 'mailme.ir'
+  - 'mailme.lv'
+  - 'mailmetrash.com'
+  - 'mailnator.com'
+  - 'mailnesia.com'
+  - 'mailnull.com'
+  - 'mailslite.com'
+  - 'mailzilla.org'
+  - 'mbx.cc'
+  - 'meltmail.com'
+  - 'messagebeamer.de'
+  - 'mierdamail.com'
+  - 'mintemail.com'
+  - 'moburl.com'
+  - 'monemail.fr.nf'
+  - 'msa.minsmail.com'
+  - 'mt2009.com'
+  - 'mypartyclip.de'
+  - 'myphantomemail.com'
+  - 'mytrashmail.com'
+  - 'nepwk.com'
+  - 'no-spam.ws'
+  - 'nobulk.com'
+  - 'noclickemail.com'
+  - 'nogmailspam.info'
+  - 'nomail2me.com'
+  - 'nomorespamemails.com'
+  - 'nospam4.us'
+  - 'nospamfor.us'
+  - 'nospamthanks.info'
+  - 'notmailinator.com'
+  - 'nowmymail.com'
+  - 'nus.edu.sg'
+  - 'nwldx.com'
+  - 'onewaymail.com'
+  - 'online.ms'
+  - 'ovpn.to'
+  - 'owlpic.com'
+  - 'pjjkp.com'
+  - 'politikerclub.de'
+  - 'pookmail.com'
+  - 'prtnx.com'
+  - 'qq.com'
+  - 'quickinbox.com'
+  - 'recode.me'
+  - 'regbypass.com'
+  - 'rmqkr.net'
+  - 'rppkn.com'
+  - 'rtrtr.com'
+  - 's0ny.net'
+  - 'safe-mail.net'
+  - 'safetymail.info'
+  - 'safetypost.de'
+  - 'sandelf.de'
+  - 'saynotospams.com'
+  - 'selfdestructingmail.com'
+  - 'sendspamhere.com'
+  - 'sharklasers.com'
+  - 'shitmail.me'
+  - 'skeefmail.com'
+  - 'slopsbox.com'
+  - 'smellfear.com'
+  - 'snakemail.com'
+  - 'sofimail.com'
+  - 'sofort-mail.de'
+  - 'sogetthis.com'
+  - 'spam.la'
+  - 'spam.su'
+  - 'spamavert.com'
+  - 'spambob.net'
+  - 'spambob.org'
+  - 'spambog.com'
+  - 'spambog.de'
+  - 'spambog.ru'
+  - 'spambox.info'
+  - 'spambox.irishspringrealty.com'
+  - 'spambox.us'
+  - 'spamcero.com'
+  - 'spamday.com'
+  - 'spamfree24.com'
+  - 'spamfree24.de'
+  - 'spamfree24.eu'
+  - 'spamfree24.info'
+  - 'spamfree24.net'
+  - 'spamfree24.org'
+  - 'spamgourmet.com'
+  - 'spamherelots.com'
+  - 'spamhole.com'
+  - 'spamify.com'
+  - 'spaminator.de'
+  - 'spamkill.info'
+  - 'spaml.com'
+  - 'spaml.de'
+  - 'spammotel.com'
+  - 'spamobox.com'
+  - 'spamspot.com'
+  - 'spamthis.co.uk'
+  - 'spamthisplease.com'
+  - 'supergreatmail.com'
+  - 'supermailer.jp'
+  - 'suremail.info'
+  - 'teewars.org'
+  - 'teleworm.com'
+  - 'teleworm.us'
+  - 'tempalias.com'
+  - 'tempe-mail.com'
+  - 'tempemail.biz'
+  - 'tempemail.com'
+  - 'tempemail.net'
+  - 'tempinbox.co.uk'
+  - 'tempinbox.com'
+  - 'tempmail.it'
+  - 'tempmail2.com'
+  - 'tempomail.fr'
+  - 'temporarioemail.com.br'
+  - 'temporaryemail.net'
+  - 'temporaryinbox.com'
+  - 'thanksnospam.info'
+  - 'thankyou2010.com'
+  - 'thisisnotmyrealemail.com'
+  - 'throwawayemailaddress.com'
+  - 'tmailinator.com'
+  - 'tradermail.info'
+  - 'trash-amil.com'
+  - 'trash-mail.com'
+  - 'trash-mail.de'
+  - 'trash2009.com'
+  - 'trashemail.de'
+  - 'trashmail.at'
+  - 'trashmail.com'
+  - 'trashmail.net'
+  - 'trashmail.ws'
+  - 'trashmailer.com'
+  - 'trashymail.com'
+  - 'trashymail.net'
+  - 'trillianpro.com'
+  - 'tyldd.com'
+  - 'uggsrock.com'
+  - 'veryrealemail.com'
+  - 'webm4il.info'
+  - 'wegwerfemail.de'
+  - 'wh4f.org'
+  - 'whyspam.me'
+  - 'willselfdestruct.com'
+  - 'wuzupmail.net'
+  - 'yopmail.com'
+  - 'yuurok.com'
+  - 'zehnminutenmail.de'
+  - 'zippymail.info'
+  - 'zoaxe.com'

data/lib/throwaway.rb

@@ -0,0 +1,17 @@
+curdir = File.dirname(__FILE__)
+Dir["#{curdir}/throwaway/**/*.rb"].each { |f| require f }
+
+require 'yaml'
+
+module Throwaway
+  class << self
+    def root
+      File.expand_path '../..', __FILE__
+    end
+
+    def is_throwaway?(email)
+      providers = YAML.load_file("#{Throwaway.root}/lib/providers.yml")['providers']
+      providers.include?(email.split("@").last)
+    end
+  end
+end

data/lib/throwaway/throwaway_validator.rb

@@ -0,0 +1,10 @@
+require "throwaway/version"
+
+class ThrowawayValidator < ActiveModel::EachValidator
+  def validate_each(record, attribute, value)
+    result = Throwaway.is_throwaway?(value)
+
+    record.errors[attribute] << (options[:message] || "is not from a disposable email provider.") if options[:with].nil? and !result
+    record.errors[attribute] << (options[:message] || "is from a disposable email provider.") if !options[:with].nil? and result
+  end
+end

data/lib/throwaway/version.rb

@@ -0,0 +1,3 @@
+module Throwaway
+  VERSION = "1.1.0"
+end

data/spec/spec_helper.rb

@@ -0,0 +1,16 @@
+begin
+  require 'simplecov';
+  SimpleCov.start do
+    add_group "Lib", 'lib'
+  end
+rescue LoadError
+end
+
+begin; require 'turn'; rescue LoadError; end
+
+require 'rspec'
+require 'active_model'
+
+$:.push File.expand_path("../../lib", __FILE__)
+require 'throwaway'
+require 'mocha/api'

data/spec/throwaway_spec.rb

@@ -0,0 +1,23 @@
+require 'spec_helper'
+
+describe Throwaway do
+  describe "#is_throwaway?" do
+    before(:each) do
+      yaml_text = <<-EOF
+        providers:
+          - 'woof.com'
+      EOF
+      yaml = YAML.load(yaml_text)
+      filepath = "#{Throwaway.root}/lib/providers.yml"
+      YAML.expects(:load_file).with(filepath).returns(yaml)
+    end
+
+    it "should return true when included in providers.yml" do
+      Throwaway.is_throwaway?("bark@woof.com").should be_true
+    end
+
+    it "should return false when not included in providers.yml" do
+      Throwaway.is_throwaway?("bark@woof.com").should be_true
+    end
+  end
+end

data/spec/throwaway_validator_spec.rb

@@ -0,0 +1,63 @@
+require 'spec_helper'
+
+class ExampleValidatingIsNotThrowaway
+  include ActiveModel::Validations
+  attr_accessor :email
+  validates :email, :throwaway => false
+end
+
+class ExampleValidatingIsThrowaway
+  include ActiveModel::Validations
+  attr_accessor :email
+  validates :email, :throwaway => true
+end
+
+describe ThrowawayValidator do
+  context "validating IS NOT a throwaway" do
+    let(:record) { ExampleValidatingIsNotThrowaway.new }
+
+    it "should mark record with a throwaway email as invalid." do
+      email = "woof@bark.com"
+      Throwaway.expects(:is_throwaway?).with(email).at_least_once.returns(true)
+
+      record.email = email
+
+      record.should_not be_valid
+      record.errors[:email].should_not be_empty
+    end
+
+    it "should not mark a record with a non-throwaway method as invalid." do
+      email = "woof@bark.com"
+      Throwaway.expects(:is_throwaway?).with(email).at_least_once.returns(false)
+
+      record.email = email
+
+      record.should be_valid
+      record.errors[:email].should be_empty
+    end
+  end
+
+  context "validating IS a throwaway" do
+    let(:record) { ExampleValidatingIsThrowaway.new }
+
+    it "should mark record with a throwaway email as valid." do
+      email = "woof@bark.com"
+      Throwaway.expects(:is_throwaway?).with(email).at_least_once.returns(true)
+
+      record.email = email
+
+      record.should be_valid
+      record.errors[:email].should be_empty
+    end
+
+    it "should mark a record with a non-throwaway method as invalid." do
+      email = "woof@bark.com"
+      Throwaway.expects(:is_throwaway?).with(email).at_least_once.returns(false)
+
+      record.email = email
+
+      record.should_not be_valid
+      record.errors[:email].should_not be_empty
+    end
+  end
+end

metadata

@@ -0,0 +1,105 @@
+--- !ruby/object:Gem::Specification 
+name: throwaway
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 1
+  - 1
+  - 0
+  version: 1.1.0
+platform: ruby
+authors: 
+- William Hamilton
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2013-06-21 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: activemodel
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: mocha
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id003
+description: Validates email addresses are not from a throwaway account provider.
+email: 
+- whamilton42@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/providers.yml
+- lib/throwaway/throwaway_validator.rb
+- lib/throwaway/version.rb
+- lib/throwaway.rb
+- Rakefile
+- README.md
+has_rdoc: true
+homepage: https://github.com/whamilton42/throwaway
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: Anti-disposable-email validator
+test_files: 
+- spec/spec_helper.rb
+- spec/throwaway_spec.rb
+- spec/throwaway_validator_spec.rb