brite_verify 0.0.1

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+.rvmrc

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in brite_verify.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Simon Schoeters
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,57 @@
+# BriteVerify
+
+[BriteVerify](http://www.briteverify.com/) is a paying e-mail verification service. You pass it an e-mail address and it tells you if the e-mail address is real or not. They offer a typical REST like API. This gem wraps the API in a more Ruby friendly syntax.
+
+This gem is no way endorsed or certified by BriteVerify. I extracted the code from a project where we are using the BriteVerify e-mail verification service.
+
+## Shortcomings
+
+This gem does not cover all of BriteVerify's services. It only does e-mail verification and does not help you with any of BriteVerify's other services as I did not have a need for any of those so far. Feel free to contribute if you can help, it can only help the Ruby community.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'brite_verify'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install brite_verify
+
+## Usage
+
+Minimum viable example:
+
+    email = BriteVerify::Email.new("john@example.com", "1298c367-ca34-6e11-3ab5-56027f1d1ec7")
+    email.verified?
+     => true
+    email.status
+     => :invalid
+    email.account
+     => "john"
+    email.domain
+     => "example.com"
+    email.connected
+     => nil
+    email.disposable
+     => false 
+    email.role_address
+     => false 
+    email.duration
+     => 0.039381279
+    email.error_code
+     => "email_domain_invalid"
+    email.error
+     => "Email domain invalid"
+
+You can skip the API key parameter and specify the `ENV['BRITEVERIFY_API_KEY']` environment variable for convenience.
+
+A more detailed description of the API can be found in the [BriteVerify e-mail documentation](https://github.com/BriteVerify/BriteCode/blob/master/email.md).
+
+## Contributing
+
+Something missing? Found a bug? Horrified by the code? Open a [github issue](https://github.com/cimm/brite_verify/issues), write a failing test or add some code using pull requests. Your help is greatly appreciated!

data/Rakefile

@@ -0,0 +1,8 @@
+require "bundler/gem_tasks"
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+  t.libs.push "lib"
+  t.test_files = FileList['test/*_test.rb']
+  t.verbose = true
+end

data/brite_verify.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'brite_verify/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "brite_verify"
+  gem.version       = BriteVerify::VERSION
+  gem.authors       = ["Simon Schoeters"]
+  gem.email         = ["hamfilter@gmail.com"]
+  gem.description   = %q{Ruby interface for BriteVerify's paying e-mail verification service.}
+  gem.summary       = %q{BriteVerify is a paying e-mail verification service. You pass it an e-mail address and it tells you if the e-mail address is real or not. They offer a typical REST like API. This gem wraps the API in a more Ruby friendly syntax.}
+  gem.homepage      = "https://github.com/cimm/brite_verify"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test)/})
+  gem.require_paths = ["lib"]
+
+  gem.add_development_dependency 'webmock', '~> 1.9.0'
+end

data/lib/brite_verify/email.rb

@@ -0,0 +1,60 @@
+module BriteVerify
+  class Email
+    def initialize(address, key = ENV['BRITEVERIFY_API_KEY'])
+      raise ArgumentError, "Missing BriteVerify API key" if key.nil? || key.strip.empty?
+      @address = address
+      @key     = key
+    end
+
+    def verified?
+      raw_email.keys.any?
+    end
+
+    def address
+      raw_email["address"]
+    end
+
+    def account
+      raw_email["account"]
+    end
+
+    def domain
+      raw_email["domain"]
+    end
+
+    def status
+      raw_email["status"].to_sym if raw_email["status"]
+    end
+
+    def connected
+      raw_email["connected"].downcase == "true" if raw_email["connected"]
+    end
+
+    def duration
+      raw_email["duration"]
+    end
+
+    def disposable
+      raw_email["disposable"]
+    end
+
+    def role_address
+      raw_email["role_address"]
+    end
+
+    def error_code
+      raw_email["error_code"]
+    end
+
+    def error
+      raw_email["error"]
+    end
+
+    private
+
+    def raw_email
+      email_fetcher = EmailFetcher.new(@key)
+      @raw_email ||= email_fetcher.fetch_raw_email(@address)
+    end
+  end
+end

data/lib/brite_verify/email_fetcher.rb

@@ -0,0 +1,35 @@
+require 'net/https'
+require 'openssl'
+require 'uri'
+
+module BriteVerify
+  class EmailFetcher
+    EMAIL_PATH = "/emails.json"
+
+    def initialize(key)
+      @key = key
+    end
+
+    def fetch_raw_email(address)
+      email_response = fetch_email(address)
+      email_response.raw_email
+    rescue Timeout::Error => e
+      {}
+    end
+
+    def fetch_email(address)
+      uri              = verification_uri(address)
+      http             = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl     = true
+      http.verify_mode = OpenSSL::SSL::VERIFY_PEER
+      request          = Net::HTTP::Get.new(uri.request_uri)
+      response         = http.request(request)
+      EmailResponse.new(response)
+    end
+
+    def verification_uri(address)
+      query = URI.encode_www_form(address: address, apikey: @key)
+      URI::HTTPS.build({host: HOST, path: EMAIL_PATH, query: query})
+    end
+  end
+end

data/lib/brite_verify/email_response.rb

@@ -0,0 +1,21 @@
+require 'json'
+
+module BriteVerify
+  class EmailResponse
+    SUCCESS_STATUS_CODE = 200
+    EMPTY_JSON          = "{}"
+
+    def initialize(response)
+      @response = response
+    end
+
+    def successful?
+      @response.code.to_i == SUCCESS_STATUS_CODE
+    end
+
+    def raw_email
+      body = successful? ? @response.body : EMPTY_JSON
+      JSON.parse(body)
+    end
+  end
+end

data/lib/brite_verify/version.rb

@@ -0,0 +1,3 @@
+module BriteVerify
+  VERSION = "0.0.1"
+end

data/lib/brite_verify.rb

@@ -0,0 +1,8 @@
+require 'brite_verify/version'
+require 'brite_verify/email_fetcher'
+require 'brite_verify/email_response'
+require 'brite_verify/email'
+
+module BriteVerify
+  HOST = "bpi.briteverify.com"
+end

data/test/email_fetcher_test.rb

@@ -0,0 +1,50 @@
+require File.expand_path("#{File.dirname(__FILE__)}/test_helper")
+
+module BriteVerify
+  describe EmailFetcher do
+    ADDRESS = "john.doe@example.com"
+    KEY     = "123-abc-123-abc"
+
+    before do
+      @email_verification_request = stub_email_verification_request(ADDRESS, KEY, valid_email_body)
+    end
+
+    it "accepts a key" do
+      email_fetcher = EmailFetcher.new(KEY)
+      email_fetcher.wont_be_nil
+    end
+
+    it "requires a key" do
+      lambda { EmailFetcher.new }.must_raise(ArgumentError)
+    end
+
+    describe :fetch_raw_email do
+      it "returns the raw e-mail" do
+        email_fetcher           = EmailFetcher.new(KEY)
+        parsed_valid_email_body = JSON.parse(valid_email_body)
+        email_fetcher.fetch_raw_email(ADDRESS).must_equal(parsed_valid_email_body)
+      end
+    end
+
+    describe :fetch_email do
+      it "verifies the e-mail with BriteVerify" do
+        email_fetcher = EmailFetcher.new(KEY)
+        email_fetcher.fetch_email(ADDRESS)
+        assert_requested(@email_verification_request)
+      end
+
+      it "returns an e-mail response" do
+        email_fetcher = EmailFetcher.new(KEY)
+        email_fetcher.fetch_email(ADDRESS).must_be_instance_of(EmailResponse)
+      end
+    end
+
+    describe :verification_uri do
+      it "returns the verification URI" do
+        email_fetcher = EmailFetcher.new(KEY)
+        uri = email_fetcher.verification_uri(ADDRESS)
+        uri.to_s.must_equal("https://bpi.briteverify.com/emails.json?address=john.doe%40example.com&apikey=123-abc-123-abc")
+      end
+    end
+  end
+end

data/test/email_response_test.rb

@@ -0,0 +1,57 @@
+require File.expand_path("#{File.dirname(__FILE__)}/test_helper")
+require 'json'
+
+module BriteVerify
+  describe EmailResponse do
+    before do
+      @response = Net::HTTPResponse.new(1.0, 200, "OK")
+    end
+
+    describe :successful? do
+      describe "when it succeeded" do
+        it "returns true" do
+          email_response = EmailResponse.new(@response)
+          email_response.successful?.must_equal(true)
+        end
+      end
+
+      describe "when something went wrong" do
+        before do
+          @response = Net::HTTPResponse.new(1.0, 500, "Internal Server Error")
+        end
+
+        it "returns false" do
+          email_response = EmailResponse.new(@response)
+          email_response.successful?.must_equal(false)
+        end
+      end
+    end
+
+    describe :raw_email do
+      describe "when it succeeded" do
+        before do
+          @response = MiniTest::Mock.new # can't set response.body for some reason
+          @response.expect(:code, "200")
+          @response.expect(:body, valid_email_body)
+        end
+
+        it "returns the raw email" do
+          email_response          = EmailResponse.new(@response)
+          parsed_valid_email_body = JSON.parse(valid_email_body)
+          email_response.raw_email.must_equal(parsed_valid_email_body)
+        end
+      end
+
+      describe "when something went wrong" do
+        before do
+          @response = Net::HTTPResponse.new(1.0, 500, "Internal Server Error")
+        end
+
+        it "returns an empty raw email" do
+          email_response = EmailResponse.new(@response)
+          email_response.raw_email.must_equal({})
+        end
+      end
+    end
+  end
+end

data/test/email_test.rb

@@ -0,0 +1,374 @@
+require File.expand_path("#{File.dirname(__FILE__)}/test_helper")
+require 'json'
+
+module BriteVerify
+  describe Email do
+    ADDRESS = "john.doe@example.com"
+    KEY     = "123-abc-123-abc"
+
+    before do
+      stub_email_verification_request(ADDRESS, KEY, valid_email_body)
+    end
+
+    it "accepts a key" do
+      email = Email.new(ADDRESS, KEY)
+      email.wont_be_nil
+    end
+
+    it "requires a key" do
+      lambda { Email.new(ADDRESS) }.must_raise(ArgumentError)
+    end
+
+    it "does not accept an empty key" do
+      lambda { Email.new(ADDRESS, "") }.must_raise(ArgumentError)
+    end
+
+    it "uses the environment variable the key wasn't given" do
+      ENV['BRITEVERIFY_API_KEY'] = "456-def-456-def"
+      lambda { Email.new(ADDRESS) }.must_be_silent
+      ENV['BRITEVERIFY_API_KEY'] = nil
+    end
+
+    describe :verified? do
+      describe "when the response was successful" do
+        it "returns true" do
+          email = Email.new(ADDRESS, KEY)
+          email.verified?.must_equal(true)
+        end
+      end
+
+      describe "when the response was not successful" do
+        before do
+          stub_error_email_verification_request(ADDRESS, KEY, 500)
+        end
+
+        it "returns false" do
+          email = Email.new(ADDRESS, KEY)
+          email.verified?.must_equal(false)
+        end
+      end
+
+      describe "when the response timed out" do
+        before do
+          stub_error_email_verification_request(ADDRESS, KEY, :timeout)
+        end
+
+        it "returns false" do
+          email = Email.new(ADDRESS, KEY)
+          email.verified?.must_equal(false)
+        end
+      end
+
+      describe "when the response is unauthorized" do
+        before do
+          stub_error_email_verification_request(ADDRESS, KEY, 401)
+        end
+
+        it "returns false" do
+          email = Email.new(ADDRESS, KEY)
+          email.verified?.must_equal(false)
+        end
+      end
+    end
+
+    describe :address do
+      describe "when the response was successful" do
+        it "returns the verified address returned from BriteVerify" do
+          email = Email.new(ADDRESS, KEY)
+          email.address.must_equal("john.doe@example.com")
+        end
+      end
+
+      describe "when the response was not successful" do
+        before do
+          stub_error_email_verification_request(ADDRESS, KEY, 500)
+        end
+
+        it "returns nil" do
+          email = Email.new(ADDRESS, KEY)
+          email.address.must_be_nil
+        end
+      end
+    end
+
+    describe :account do
+      describe "when the response was successful" do
+        it "returns the account returned from BriteVerify" do
+          email = Email.new(ADDRESS, KEY)
+          email.account.must_equal("john.doe")
+        end
+      end
+
+      describe "when the response was not successful" do
+        before do
+          stub_error_email_verification_request(ADDRESS, KEY, 500)
+        end
+
+        it "returns nil" do
+          email = Email.new(ADDRESS, KEY)
+          email.account.must_be_nil
+        end
+      end
+    end
+
+    describe :domain do
+      describe "when the response was successful" do
+        it "returns the domain returned from BriteVerify" do
+          email = Email.new(ADDRESS, KEY)
+          email.domain.must_equal("example.com")
+        end
+      end
+
+      describe "when the response was not successful" do
+        before do
+          stub_error_email_verification_request(ADDRESS, KEY, 500)
+        end
+
+        it "returns nil" do
+          email = Email.new(ADDRESS, KEY)
+          email.domain.must_be_nil
+        end
+      end
+    end
+
+    describe :status do
+      describe "when the response was successful" do
+        describe "when the address is valid" do
+          it "returns the valid status" do
+            email = Email.new(ADDRESS, KEY)
+            email.status.must_equal(:valid)
+          end
+        end
+
+        describe "when the address is invalid" do
+          before do
+            stub_email_verification_request(ADDRESS, KEY, invalid_email_body)
+          end
+
+          it "returns the invalid status" do
+            email = Email.new(ADDRESS, KEY)
+            email.status.must_equal(:invalid)
+          end
+        end
+
+        describe "when the address is unknown" do
+          before do
+            stub_email_verification_request(ADDRESS, KEY, unknown_email_body)
+          end
+
+          it "returns the unknown status" do
+            email = Email.new(ADDRESS, KEY)
+            email.status.must_equal(:unknown)
+          end
+        end
+
+        describe "when the address is an accept all address" do
+          before do
+            stub_email_verification_request(ADDRESS, KEY, accept_all_email_body)
+          end
+
+          it "returns the unknown status" do
+            email = Email.new(ADDRESS, KEY)
+            email.status.must_equal(:accept_all)
+          end
+        end
+      end
+
+      describe "when the response was not successful" do
+        before do
+          stub_error_email_verification_request(ADDRESS, KEY, 500)
+        end
+
+        it "returns nil" do
+          email = Email.new(ADDRESS, KEY)
+          email.status.must_be_nil
+        end
+      end
+    end
+
+    describe :connected do
+      describe "when the response was successful" do
+        describe "when the address is connected" do
+          before do
+            stub_email_verification_request(ADDRESS, KEY, connected_email_body)
+          end
+
+          it "returns true" do
+            email = Email.new(ADDRESS, KEY)
+            email.connected.must_equal(true)
+          end
+        end
+
+        describe "when it is not known if the address is connected" do
+          it "returns nil" do
+            email = Email.new(ADDRESS, KEY)
+            email.connected.must_be_nil
+          end
+        end
+      end
+
+      describe "when the response was not successful" do
+        before do
+          stub_error_email_verification_request(ADDRESS, KEY, 500)
+        end
+
+        it "returns nil" do
+          email = Email.new(ADDRESS, KEY)
+          email.connected.must_be_nil
+        end
+      end
+    end
+
+    describe :duration do
+      describe "when the response was successful" do
+        it "returns the time it took BriteVerify to verify the address" do
+          email = Email.new(ADDRESS, KEY)
+          email.duration.must_equal(0.104516605)
+        end
+      end
+
+      describe "when the response was not successful" do
+        before do
+          stub_error_email_verification_request(ADDRESS, KEY, 500)
+        end
+
+        it "returns nil" do
+          email = Email.new(ADDRESS, KEY)
+          email.duration.must_be_nil
+        end
+      end
+    end
+
+    describe :disposable do
+      describe "when the response was successful" do
+        describe "the address is disposable" do
+          before do
+            stub_email_verification_request(ADDRESS, KEY, disposable_email_body)
+          end
+
+          it "returns true" do
+            email = Email.new(ADDRESS, KEY)
+            email.disposable.must_equal(true)
+          end
+        end
+
+        describe "when it is not known if the address is disposable" do
+          it "returns nil" do
+            email = Email.new(ADDRESS, KEY)
+            email.disposable.must_be_nil
+          end
+        end
+      end
+
+      describe "when the response was not successful" do
+        before do
+          stub_error_email_verification_request(ADDRESS, KEY, 500)
+        end
+
+        it "returns nil" do
+          email = Email.new(ADDRESS, KEY)
+          email.disposable.must_be_nil
+        end
+      end
+    end
+
+    describe :role_address do
+      describe "when the response was successful" do
+        describe "when the address is a role address" do
+          before do
+            stub_email_verification_request(ADDRESS, KEY, role_address_email_body)
+          end
+
+          it "returns true" do
+            email = Email.new(ADDRESS, KEY)
+            email.role_address.must_equal(true)
+          end
+        end
+
+        describe "when it is not known if the address is a role address" do
+          it "returns nil" do
+            email = Email.new(ADDRESS, KEY)
+            email.role_address.must_be_nil
+          end
+        end
+      end
+
+      describe "when the response was not successful" do
+        before do
+          stub_error_email_verification_request(ADDRESS, KEY, 500)
+        end
+
+        it "returns nil" do
+          email = Email.new(ADDRESS, KEY)
+          email.role_address.must_be_nil
+        end
+      end
+    end
+
+    describe :error_code do
+      describe "when the response was successful" do
+        describe "when the address is valid" do
+          it "has no error code" do
+            email = Email.new(ADDRESS, KEY)
+            email.error_code.must_be_nil
+          end
+        end
+
+        describe "when the address is not valid" do
+          before do
+            stub_email_verification_request(ADDRESS, KEY, invalid_email_body)
+          end
+
+          it "has an error code" do
+            email = Email.new(ADDRESS, KEY)
+            email.error_code.must_equal("email_domain_invalid")
+          end
+        end
+      end
+
+      describe "when the response was not successful" do
+        before do
+          stub_error_email_verification_request(ADDRESS, KEY, 500)
+        end
+
+        it "returns nil" do
+          email = Email.new(ADDRESS, KEY)
+          email.error_code.must_be_nil
+        end
+      end
+    end
+
+    describe :error do
+      describe "when the response was successful" do
+        describe "when the address is valid" do
+          it "has no error" do
+            email = Email.new(ADDRESS, KEY)
+            email.error.must_be_nil
+          end
+        end
+
+        describe "when the address is not valid" do
+          before do
+            stub_email_verification_request(ADDRESS, KEY, invalid_email_body)
+          end
+
+          it "has a more detailed error" do
+            email = Email.new(ADDRESS, KEY)
+            email.error.must_equal("Email domain invalid")
+          end
+        end
+      end
+
+      describe "when the response was not successful" do
+        before do
+          stub_error_email_verification_request(ADDRESS, KEY, 500)
+        end
+
+        it "returns nil" do
+          email = Email.new(ADDRESS, KEY)
+          email.error.must_be_nil
+        end
+      end
+    end
+  end
+end

data/test/fixtures/accept_all_email.json

@@ -0,0 +1,8 @@
+{
+  "address":"john.doe@example.com",
+  "account":"john.doe",
+  "domain":"example.com",
+  "status":"accept_all",
+  "connected":"true",
+  "duration":0.104516605
+}

data/test/fixtures/connected_email.json

@@ -0,0 +1,8 @@
+{
+  "address":"john.doe@example.com",
+  "account":"john.doe",
+  "domain":"example.com",
+  "status":"valid",
+  "connected":"true",
+  "duration":0.104516605
+}

data/test/fixtures/disposable_email.json

@@ -0,0 +1,9 @@
+{
+  "address":"john.doe@example.com",
+  "account":"john.doe",
+  "domain":"example.com",
+  "status":"valid",
+  "connected":"true",
+  "duration":0.104516605,
+  "disposable":true
+}

data/test/fixtures/invalid_email.json

@@ -0,0 +1,10 @@
+{
+  "address":"john.doe@example.com",
+  "account":"john.doe",
+  "domain":"example.com",
+  "status":"invalid",
+  "error_code":"email_domain_invalid",
+  "error":"Email domain invalid",
+  "connected":"true",
+  "duration":0.104516605
+}

data/test/fixtures/role_address_email.json

@@ -0,0 +1,9 @@
+{
+  "address":"john.doe@example.com",
+  "account":"john.doe",
+  "domain":"example.com",
+  "status":"valid",
+  "connected":"true",
+  "duration":0.104516605,
+  "role_address":true
+}

data/test/fixtures/unknown_email.json

@@ -0,0 +1,9 @@
+
+{
+  "address":"john.doe@example.com",
+  "account":"john.doe",
+  "domain":"example.com",
+  "status":"unknown",
+  "connected":"true",
+  "duration":0.104516605
+}

data/test/fixtures/valid_email.json

@@ -0,0 +1,7 @@
+{
+  "address":"john.doe@example.com",
+  "account":"john.doe",
+  "domain":"example.com",
+  "status":"valid",
+  "duration":0.104516605
+}

data/test/test_helper.rb

@@ -0,0 +1,60 @@
+require 'minitest/spec'
+require 'minitest/mock'
+require 'minitest/autorun'
+require 'webmock/minitest'
+require 'brite_verify'
+
+FIXTURES_PATH = File.expand_path("#{File.dirname(__FILE__)}/fixtures")
+
+def valid_email_body
+  @valid_email_body ||= File.read(File.join(FIXTURES_PATH, 'valid_email.json'))
+end
+
+def invalid_email_body
+  @invalid_email_body ||= File.read(File.join(FIXTURES_PATH, 'invalid_email.json'))
+end
+
+def unknown_email_body
+  @unknown_email_body ||= File.read(File.join(FIXTURES_PATH, 'unknown_email.json'))
+end
+
+def accept_all_email_body
+  @accept_all_email_body ||= File.read(File.join(FIXTURES_PATH, 'accept_all_email.json'))
+end
+
+def connected_email_body
+  @connected_email_body ||= File.read(File.join(FIXTURES_PATH, 'connected_email.json'))
+end
+
+def disposable_email_body
+  @disposable_email_body ||= File.read(File.join(FIXTURES_PATH, 'disposable_email.json'))
+end
+
+def role_address_email_body
+  @role_address_email_body ||= File.read(File.join(FIXTURES_PATH, 'role_address_email.json'))
+end
+
+def stub_email_verification_request(address, key, body)
+  request          = { :headers => {'Accept' => '*/*', 'User-Agent' => 'Ruby'} }
+  response         = { :status => 200, :body => body, :headers => {} }
+  stub_request(:get, email_verification_url(address, key)).with(request).to_return(response)
+end
+
+def stub_error_email_verification_request(address, key, code)
+  status           = []
+  verification_url = email_verification_url(address, key)
+  case code
+  when 401
+    stub_request(:get, verification_url).to_return(:status => [401, "Unauthorized"])
+  when 500
+    stub_request(:get, verification_url).to_return(:status => [500, "Internal Server Error"])
+  when :timeout
+    stub_request(:get, verification_url).to_timeout
+  else
+    raise "Unknown response code: #{code}"
+  end
+end
+
+def email_verification_url(address, key)
+  "https://bpi.briteverify.com/emails.json?address=#{address}&apikey=#{key}"
+end

metadata

@@ -0,0 +1,96 @@
+--- !ruby/object:Gem::Specification
+name: brite_verify
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Simon Schoeters
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-12-31 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.9.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.9.0
+description: Ruby interface for BriteVerify's paying e-mail verification service.
+email:
+- hamfilter@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- brite_verify.gemspec
+- lib/brite_verify.rb
+- lib/brite_verify/email.rb
+- lib/brite_verify/email_fetcher.rb
+- lib/brite_verify/email_response.rb
+- lib/brite_verify/version.rb
+- test/email_fetcher_test.rb
+- test/email_response_test.rb
+- test/email_test.rb
+- test/fixtures/accept_all_email.json
+- test/fixtures/connected_email.json
+- test/fixtures/disposable_email.json
+- test/fixtures/invalid_email.json
+- test/fixtures/role_address_email.json
+- test/fixtures/unknown_email.json
+- test/fixtures/valid_email.json
+- test/test_helper.rb
+homepage: https://github.com/cimm/brite_verify
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: BriteVerify is a paying e-mail verification service. You pass it an e-mail
+  address and it tells you if the e-mail address is real or not. They offer a typical
+  REST like API. This gem wraps the API in a more Ruby friendly syntax.
+test_files:
+- test/email_fetcher_test.rb
+- test/email_response_test.rb
+- test/email_test.rb
+- test/fixtures/accept_all_email.json
+- test/fixtures/connected_email.json
+- test/fixtures/disposable_email.json
+- test/fixtures/invalid_email.json
+- test/fixtures/role_address_email.json
+- test/fixtures/unknown_email.json
+- test/fixtures/valid_email.json
+- test/test_helper.rb