addressfinder 1.5.2 → 1.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 05ba956f56eb4abdf67174b1c8dc8fa60e429855
-  data.tar.gz: 473d3c098ab85f3255409d42fc114dbbddd278bf
+  metadata.gz: 9b79f5f19495e699810a70554f1b039b18593358
+  data.tar.gz: db666ffb8a6b4c80f83dc596d21a94134aa333cf
 SHA512:
-  metadata.gz: 9056caa0b3632c4069dc0f78fea84c876fa3fda0438af6cd771bee2a09aab93087e912decf5eabf923b442994360ec09c063f62d014ea86dd959be1dbf031082
-  data.tar.gz: 0d20f2503daaeed9e724231973414731e65bfa4aa468f37ad7dadd059b226832bdf0f1ac3eadd49fbc395dc746cf5887e092e98691e9aa09ff4473764c1cba24
+  metadata.gz: b0c51e33b40f79d5b60375c608d875818aba925c2aeb54835bfb37f01f3a2470b0a62dc5d5484c7d7499fb474ae34dd326d196b8d66e9253c570a160fa01551a
+  data.tar.gz: 8c3f3805a0db4e847fdf4a854d8b1c55c7c43973ef84d51b5123b3c7de10c74e6d846eaf67c5a9742cf5d75175c9d4ece5e7e461e9ddc0ef8e30f9b44ec13cf9

data/.travis.yml

@@ -2,3 +2,5 @@ language: ruby
 rvm:
   - 2.1.2
   - 2.2.3
+  - 2.3.1
+  - 2.4.1

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+# AddressFinder 1.6.0 (August 10, 2017) #
+
+* Add support for a configurable number of request retries
+
 # AddressFinder 1.5.2 (December 21, 2015) #
 
 * Update for the nested response format used in Address Cleanse Australia

data/README.md

@@ -3,7 +3,7 @@
 [![Gem Version](https://badge.fury.io/rb/addressfinder.svg)](http://badge.fury.io/rb/addressfinder)
 [![Build  Status](https://travis-ci.org/AbleTech/addressfinder-ruby.svg)](https://travis-ci.org/AbleTech/addressfinder-ruby)
 
-A client library for accessing the AddressFinder APIs.
+A client library for accessing the [AddressFinder](https://addressfinder.nz/?utm_source=github&utm_medium=readme&utm_campaign=addressfinder_rubygem&utm_term=AddressFinder) APIs.
 
 ## Installation
 
@@ -19,40 +19,41 @@ Or install it yourself as:
 
     $ gem install addressfinder
 
-## Usage
-
-### Configuration
+## Configuration
 
-You should call the configure block on startup of your app. In a Ruby on Rails application this
-is normally performed in an initializer file. For example `./config/initializers/addressfinder.rb`
+Use the configure block to set your `api_key` and `api_secret`.
 
 ```ruby
 AddressFinder.configure do |af|
-  # Mandatory configuration
+  # Required
   af.api_key = 'XXXXXXXXXX'
   af.api_secret = 'YYYYYYYYYY'
-  af.default_country = 'nz'
 
-  # Optional configuration
-  af.timeout = 10 # seconds
-  af.proxy_host = 'corp.proxy.com'
+  # Optional
+  af.default_country = 'nz' # default: nz
+  af.timeout = 10 # default: 10 seconds
+  af.retries = 12 # default: 12
+  af.retry_delay = 5 # default: 5 seconds
+  af.domain = 'yourdomain.com'
+  af.proxy_host = 'yourproxy.com'
   af.proxy_port = 8080
   af.proxy_user = 'username'
   af.proxy_password = 'password'
-  af.domain = 'myserver.mycompany.co.nz'
 end
 ```
 
-You can obtain your API key and secret from the AddressFinder Portal.
+**_Don't know your key and secret?_**
+*Login to the [AddressFinder portal](https://portal.addressfinder.io/?utm_source=github&utm_medium=readme&utm_campaign=addressfinder_rubygem&utm_term=AddressFinder%20Portal) to obtain your key and secret.*
 
-### Address Cleansing
+**_For Ruby on Rails:_**
+*The configure block is best placed in an initializer file (`./config/initializers/addressfinder.rb`).*
+
+## Usage
 
-See the documentation on the available parameters and expected response here:
+For available parameters and example responses, see the API documentation pages for [New Zealand](https://addressfinder.nz/docs?utm_source=github&utm_medium=readme&utm_campaign=addressfinder_rubygem&utm_term=New%20Zealand) or [Australia](https://addressfinder.com.au/docs?utm_source=github&utm_medium=readme&utm_campaign=addressfinder_rubygem&utm_term=Australia).
 
-https://addressfinder.nz/docs/address_cleanse_api/
-https://addressfinder.com.au/docs/address_cleanse_api/
 
-Usage example:
+#### Address Verification
 
 ```ruby
 result = AddressFinder.cleanse(q: '186 Willis St, Wellington', country: 'nz')
@@ -64,102 +65,78 @@ else
 end
 ```
 
-### Location Search
-
-See documentation on the available parameters and expected response here:
-
-https://addressfinder.nz/docs/location_api/
-
-Usage example:
+#### Address Autocomplete
 
 ```ruby
 begin
-  results = AddressFinder.location_search(q: 'Queen Street')
+  results = AddressFinder.address_search(q: '186 Willis Street')
   if results.any?
-    $standout.puts "Success: #{results}"
+    $stdout.puts "Success: #{results}"
   else
-    $standout.puts "Sorry, there were no location matches"
+    $stdout.puts "Sorry, there were no address matches"
   end
 rescue AddressFinder::RequestRejectedError => e
   response = JSON.parse(e.body)
-  $standout.puts response['message']
+  $stdout.puts response['message']
 end
 ```
 
-### Location Info
-
-See documentation on the available parameters and expected response here:
-
-https://addressfinder.nz/docs/location_info_api/
-
-Usage example:
+#### Address Metadata
 
 ```ruby
 begin
-  result = AddressFinder.location_info(pxid: '1-.B.3l')
+  result = AddressFinder.address_info(pxid: '1-.B.3l')
   if result
-    $standout.puts "Success: #{result.a}"
+    $stdout.puts "Success: #{result.a}"
   else
-    $standout.puts "Sorry, can't find that location"
+    $stdout.puts "Sorry, can't find that address"
   end
 rescue AddressFinder::RequestRejectedError => e
   response = JSON.parse(e.body)
-  $standout.puts response['message']
+  $stdout.puts response['message']
 end
 ```
 
-### Address Search
-
-See documentation on the available parameters and expected response here:
-
-https://addressfinder.nz/docs/address_api/
-
-Usage example:
+#### Location Autocomplete
 
 ```ruby
 begin
-  results = AddressFinder.address_search(q: '186 Willis Street')
+  results = AddressFinder.location_search(q: 'Queen Street')
   if results.any?
-    $standout.puts "Success: #{results}"
+    $stdout.puts "Success: #{results}"
   else
-    $standout.puts "Sorry, there were no address matches"
+    $stdout.puts "Sorry, there were no location matches"
   end
 rescue AddressFinder::RequestRejectedError => e
   response = JSON.parse(e.body)
-  $standout.puts response['message']
+  $stdout.puts response['message']
 end
 ```
 
-### Address Info
-
-See documentation on the available parameters and expected response here:
-
-https://addressfinder.nz/docs/address_info_api/
-
-Usage example:
+#### Location Metadata
 
 ```ruby
 begin
-  result = AddressFinder.address_info(pxid: '1-.B.3l')
+  result = AddressFinder.location_info(pxid: '1-.B.3l')
   if result
-    $standout.puts "Success: #{result.a}"
+    $stdout.puts "Success: #{result.a}"
   else
-    $standout.puts "Sorry, can't find that address"
+    $stdout.puts "Sorry, can't find that location"
   end
 rescue AddressFinder::RequestRejectedError => e
   response = JSON.parse(e.body)
-  $standout.puts response['message']
+  $stdout.puts response['message']
 end
 ```
 
-### Bulk Operations
+## Advanced Usage
 
-If you have a series of calls you need to make to AddressFinder, you can use the
-bulk method which re-uses the HTTP connection.
+#### Bulk Operations
 
-The bulk method is only available for #cleanse operation.
+If you have a series of API requests, you can use the
+bulk method to re-use the HTTP connection.
 
-Usage example:
+**Note:** The bulk method is currently only available for Address Verification (`#cleanse`).
 
 ```ruby
 AddressFinder.bulk do |af|
@@ -175,34 +152,22 @@ AddressFinder.bulk do |af|
 end
 ```
 
-## Advanced Usage
-
-### Key and Secret Override
-
-What if you want to use another acccount for a specific query using the AddressFinder gem in your ruby app?
-
-You can override the `api_key` and `api_secret` set in the AddressFinder.configure block in `./config/initializers/addressfinder.rb` when using the AddressFinder gem.
 
-Those AddressFinder methods accept `:key` and `:secret` arguments:
-- `#cleanse`,
-- `#location_search`,
-- `#location_info`,
-- `#address_search`
-- `#address_info`
+#### Key and Secret override
 
-Usage example:
+What if you want to use another account for a specific query? You can override the `api_key` and `api_secret`.
 
 ```ruby
 begin
   result = AddressFinder.address_info(pxid: '1-.B.3l', key: 'AAAAAAAAAAAAA', secret: 'BBBBBBBBBBBBB')
   if result
-    $standout.puts "Success: #{result.a}"
+    $stdout.puts "Success: #{result.a}"
   else
-    $standout.puts "Sorry, can't find that address"
+    $stdout.puts "Sorry, can't find that address"
   end
 rescue AddressFinder::RequestRejectedError => e
   response = JSON.parse(e.body)
-  $standout.puts response['message']
+  $stdout.puts response['message']
 end
 ```
 

data/addressfinder.gemspec

@@ -22,4 +22,5 @@ Gem::Specification.new do |gem|
   gem.add_development_dependency 'guard-rspec', '~> 4.6'
   gem.add_development_dependency 'rake', '~> 10.4'
   gem.add_development_dependency 'webmock', '~> 1.21'
+  gem.add_development_dependency 'listen', '~> 3.0.0'
 end

data/lib/addressfinder.rb

@@ -1,4 +1,3 @@
-require 'net/http'
 require 'multi_json'
 require 'addressfinder/version'
 require 'addressfinder/configuration'
@@ -10,6 +9,7 @@ require 'addressfinder/address_search'
 require 'addressfinder/bulk'
 require 'addressfinder/errors'
 require 'addressfinder/util'
+require 'addressfinder/http'
 
 module AddressFinder
   class << self
@@ -28,41 +28,27 @@ module AddressFinder
     end
 
     def cleanse(args={})
-      AddressFinder::Cleanse.new(args.merge(http: configure_http)).perform.result
+      AddressFinder::Cleanse.new(args.merge(http: AddressFinder::HTTP.new(configuration))).perform.result
     end
 
     def location_search(args={})
-      AddressFinder::LocationSearch.new(params: args, http: configure_http).perform.results
+      AddressFinder::LocationSearch.new(params: args, http: AddressFinder::HTTP.new(configuration)).perform.results
     end
 
     def location_info(args={})
-      AddressFinder::LocationInfo.new(params: args, http: configure_http).perform.result
+      AddressFinder::LocationInfo.new(params: args, http: AddressFinder::HTTP.new(configuration)).perform.result
     end
 
     def address_search(args={})
-      AddressFinder::AddressSearch.new(params: args, http: configure_http).perform.results
+      AddressFinder::AddressSearch.new(params: args, http: AddressFinder::HTTP.new(configuration)).perform.results
     end
 
     def address_info(args={})
-      AddressFinder::AddressInfo.new(params: args, http: configure_http).perform.result
+      AddressFinder::AddressInfo.new(params: args, http: AddressFinder::HTTP.new(configuration)).perform.result
     end
 
     def bulk(&block)
-      # TODO include parameter http: configure_http
-      AddressFinder::Bulk.new(&block).perform
-    end
-
-    private
-
-    def configure_http
-      http = Net::HTTP.new(configuration.hostname, configuration.port,
-                           configuration.proxy_host, configuration.proxy_port,
-                           configuration.proxy_user, configuration.proxy_password)
-      http.open_timeout = configuration.timeout
-      http.read_timeout = configuration.timeout
-      http.use_ssl = true
-
-      http
+      AddressFinder::Bulk.new(http: AddressFinder::HTTP.new(configuration), &block).perform
     end
   end
 end

data/lib/addressfinder/bulk.rb

@@ -1,24 +1,19 @@
 module AddressFinder
   class Bulk
-    def initialize(&block)
+    def initialize(http:, &block)
       @block = block
+      @http_config = http
     end
 
     def perform
-      Net::HTTP.start(config.hostname, config.port, use_ssl: true,
-                                                    open_timeout: config.timeout,
-                                                    read_timeout: config.timeout) do |http|
+      http_config.start do |http|
         block.call ClientProxy.new(http: http)
       end
     end
 
     private
 
-    attr_reader :block
-
-    def config
-      @_config ||= AddressFinder.configuration
-    end
+    attr_reader :block, :http_config
 
     class ClientProxy
       def initialize(http:)

data/lib/addressfinder/configuration.rb

@@ -11,11 +11,15 @@ module AddressFinder
     attr_accessor :timeout
     attr_accessor :default_country
     attr_accessor :domain
+    attr_accessor :retries
+    attr_accessor :retry_delay
 
     def initialize
       self.hostname = 'api.addressfinder.io'
       self.port = 443
       self.timeout = 10
+      self.retries = 12
+      self.retry_delay = 5
       self.default_country = 'nz'
     end
   end

data/lib/addressfinder/http.rb

@@ -0,0 +1,55 @@
+require 'net/http'
+
+module AddressFinder
+  class HTTP
+    attr_reader :config
+
+    def initialize(config)
+      @config = config
+      @connection_is_bad = false
+    end
+
+    def start(&block)
+      net_http.start do
+        block.call(self)
+      end
+    end
+
+    def request(args)
+      retries = 0
+      begin
+        re_establish_connection if @connection_is_bad
+        net_http.request(args)
+      rescue Net::ReadTimeout, Net::OpenTimeout, SocketError => error
+        if retries < config.retries
+          retries += 1
+          sleep(config.retry_delay)
+          @connection_is_bad = true if net_http.started?
+          retry
+        else
+          raise error
+        end
+      end
+    end
+
+    private
+
+    def re_establish_connection
+      @connection_is_bad = false
+      net_http.finish
+      net_http.start
+    end
+
+    def net_http
+      @net_http ||= begin
+        http = Net::HTTP.new(config.hostname, config.port, config.proxy_host,
+                             config.proxy_port, config.proxy_user,
+                             config.proxy_password)
+        http.open_timeout = config.timeout
+        http.read_timeout = config.timeout
+        http.use_ssl = true
+        http
+      end
+    end
+  end
+end

data/lib/addressfinder/version.rb

@@ -1,3 +1,3 @@
 module AddressFinder
-  VERSION = '1.5.2'
+  VERSION = '1.6.0'
 end

data/spec/lib/addressfinder/address_info_spec.rb

@@ -11,7 +11,7 @@ RSpec.describe AddressFinder::AddressInfo do
 
   describe '#build_request' do
     let(:locator){ AddressFinder::AddressInfo.new(params: args, http: http) }
-    let(:http){ AddressFinder.send(:configure_http) }
+    let(:http){ AddressFinder::HTTP.new(AddressFinder.configuration) }
 
     subject(:request_uri){ locator.send(:build_request) }
 

data/spec/lib/addressfinder/address_search_spec.rb

@@ -11,7 +11,7 @@ RSpec.describe AddressFinder::AddressSearch do
 
   describe '#build_request' do
     let(:locator){ AddressFinder::AddressSearch.new(params: args, http: http) }
-    let(:http){ AddressFinder.send(:configure_http) }
+    let(:http){ AddressFinder::HTTP.new(AddressFinder.configuration) }
 
     subject(:request_uri){ locator.send(:build_request) }
 

data/spec/lib/addressfinder/bulk_spec.rb

@@ -0,0 +1,57 @@
+require 'spec_helper'
+
+RSpec.describe AddressFinder::Bulk do
+  before do
+    AddressFinder.configure do |af|
+      af.api_key = 'XXX'
+      af.api_secret = 'YYY'
+      af.default_country = 'nz'
+      af.timeout = 5
+      af.retries = 5
+    end
+  end
+
+  describe '#perform' do
+    let(:http){ AddressFinder::HTTP.new(AddressFinder.configuration) }
+    let(:net_http){ http.send(:net_http) }
+
+    before do
+      WebMock.allow_net_connect!(net_http_connect_on_start: true)
+      allow(http).to receive(:sleep)
+    end
+
+    after do
+      WebMock.disable_net_connect!
+    end
+
+    context "with 3 requests in the provided block" do
+      let(:response){ double(:response, body: %Q({"success": true}), code: "200") }
+      let(:block){
+        Proc.new do |proxy|
+          proxy.cleanse(q: "1 Willis")
+          proxy.cleanse(q: "2 Willis")
+          proxy.cleanse(q: "3 Willis")
+        end
+      }
+
+      it "uses 1 http connection" do
+        expect(net_http).to receive(:do_start).once.and_call_original
+        expect(net_http).to receive(:transport_request).exactly(3).times.and_return(response)
+        expect(net_http).to receive(:do_finish).once.and_call_original
+        AddressFinder::Bulk.new(http: http, &block).perform
+      end
+
+      it "re-establishes the http connection and continues where we left off when a Net::OpenTimeout, Net::ReadTimeout or SocketError is raised" do
+        expect(http).to receive(:re_establish_connection).exactly(3).times.and_call_original
+        expect(net_http).to receive(:do_start).exactly(4).times.and_call_original
+        expect(net_http).to receive(:transport_request).once.and_return(response) # 1 Willis (success)
+        expect(net_http).to receive(:transport_request).once.and_raise(Net::OpenTimeout) # 2 Willis (error)
+        expect(net_http).to receive(:transport_request).once.and_raise(Net::ReadTimeout) # Retry 2 Willis (error)
+        expect(net_http).to receive(:transport_request).once.and_raise(SocketError) # Retry 2 Willis (error)
+        expect(net_http).to receive(:transport_request).exactly(2).and_return(response) # Retry 2 Willis (success) & 3 Willis (success)
+        expect(net_http).to receive(:do_finish).exactly(4).times.and_call_original
+        AddressFinder::Bulk.new(http: http, &block).perform
+      end
+    end
+  end
+end

data/spec/lib/addressfinder/cleanse_spec.rb

@@ -6,13 +6,62 @@ RSpec.describe AddressFinder::Cleanse do
       af.api_key = 'XXX'
       af.api_secret = 'YYY'
       af.default_country = 'nz'
+      af.timeout = 5
+      af.retries = 3
     end
   end
 
-  describe '#build_request' do
-    let(:cleanser){ AddressFinder::Cleanse.new(args) }
-    let(:http){ AddressFinder.send(:configure_http) }
+  let(:cleanser){ AddressFinder::Cleanse.new(args) }
+  let(:http){ AddressFinder::HTTP.new(AddressFinder.configuration) }
+  let(:net_http){ http.send(:net_http) }
+
+  describe '#execute_request' do
+    let(:args){ {q: "186 Willis Street", http: http} }
+
+    before do
+      WebMock.allow_net_connect!(net_http_connect_on_start: true)
+      allow(http).to receive(:sleep)
+      allow(cleanser).to receive(:request_uri).and_return("/test/path")
+      expect(http).to_not receive(:re_establish_connection)
+    end
+
+    after do
+      WebMock.disable_net_connect!
+    end
+
+    subject(:execute_request){ cleanser.send(:execute_request) }
+
+    it "retries an errored request another time before succeeding" do
+      expect(net_http).to receive(:do_start).twice.and_call_original
+      expect(net_http).to receive(:transport_request).once.and_raise(Net::OpenTimeout)
+      expect(net_http).to receive(:transport_request).once.and_return(double(:response, body: "OK", code: "200"))
+      expect(net_http).to receive(:do_finish).twice.and_call_original
+      execute_request
+    end
+
+    it "re-raises a Net::OpenTimeout error after 3 retries" do
+      expect(net_http).to receive(:do_start).exactly(4).times.and_call_original
+      expect(net_http).to receive(:transport_request).exactly(4).times.and_raise(Net::OpenTimeout)
+      expect(net_http).to receive(:do_finish).exactly(4).times.and_call_original
+      expect{execute_request}.to raise_error(Net::OpenTimeout)
+    end
+
+    it "re-raises a Net::ReadTimeout error after 3 retries" do
+      expect(net_http).to receive(:do_start).exactly(4).times.and_call_original
+      expect(net_http).to receive(:transport_request).exactly(4).times.and_raise(Net::ReadTimeout)
+      expect(net_http).to receive(:do_finish).exactly(4).times.and_call_original
+      expect{execute_request}.to raise_error(Net::ReadTimeout)
+    end
 
+    it "re-raises a SocketError error after 3 retries" do
+      expect(net_http).to receive(:do_start).exactly(4).times.and_call_original
+      expect(net_http).to receive(:transport_request).exactly(4).times.and_raise(SocketError)
+      expect(net_http).to receive(:do_finish).exactly(4).times.and_call_original
+      expect{execute_request}.to raise_error(SocketError)
+    end
+  end
+
+  describe '#build_request' do
     subject(:request_uri){ cleanser.send(:build_request) }
 
     context 'with minimal arguments' do
@@ -64,7 +113,7 @@ RSpec.describe AddressFinder::Cleanse do
   end
 
   describe '#build_result' do
-    let(:cleanser){ AddressFinder::Cleanse.new(q: 'ignored', http: nil) }
+    let(:args){ {q: 'ignored', http: nil} }
 
     before do
       cleanser.send('response_body=', body)

data/spec/lib/addressfinder/location_info_spec.rb

@@ -11,7 +11,7 @@ RSpec.describe AddressFinder::LocationInfo do
 
   describe '#build_request' do
     let(:locator){ AddressFinder::LocationInfo.new(params: args, http: http) }
-    let(:http){ AddressFinder.send(:configure_http) }
+    let(:http){ AddressFinder::HTTP.new(AddressFinder.configuration) }
 
     subject(:request_uri){ locator.send(:build_request) }
 

data/spec/lib/addressfinder/location_search_spec.rb

@@ -11,7 +11,7 @@ RSpec.describe AddressFinder::LocationSearch do
 
   describe '#build_request' do
     let(:locator){ AddressFinder::LocationSearch.new(params: args, http: http) }
-    let(:http){ AddressFinder.send(:configure_http) }
+    let(:http){ AddressFinder::HTTP.new(AddressFinder.configuration) }
 
     subject(:request_uri){ locator.send(:build_request) }
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: addressfinder
 version: !ruby/object:Gem::Version
-  version: 1.5.2
+  version: 1.6.0
 platform: ruby
 authors:
 - Nigel Ramsay
@@ -11,7 +11,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-12-21 00:00:00.000000000 Z
+date: 2017-08-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: multi_json
@@ -83,6 +83,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.21'
+- !ruby/object:Gem::Dependency
+  name: listen
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.0.0
 description: Ruby client library for AddressFinder
 email:
 - nigel.ramsay@abletech.co.nz
@@ -109,12 +123,14 @@ files:
 - lib/addressfinder/cleanse.rb
 - lib/addressfinder/configuration.rb
 - lib/addressfinder/errors.rb
+- lib/addressfinder/http.rb
 - lib/addressfinder/location_info.rb
 - lib/addressfinder/location_search.rb
 - lib/addressfinder/util.rb
 - lib/addressfinder/version.rb
 - spec/lib/addressfinder/address_info_spec.rb
 - spec/lib/addressfinder/address_search_spec.rb
+- spec/lib/addressfinder/bulk_spec.rb
 - spec/lib/addressfinder/cleanse_spec.rb
 - spec/lib/addressfinder/location_info_spec.rb
 - spec/lib/addressfinder/location_search_spec.rb
@@ -147,6 +163,7 @@ summary: Provides easy access to AddressFinder APIs
 test_files:
 - spec/lib/addressfinder/address_info_spec.rb
 - spec/lib/addressfinder/address_search_spec.rb
+- spec/lib/addressfinder/bulk_spec.rb
 - spec/lib/addressfinder/cleanse_spec.rb
 - spec/lib/addressfinder/location_info_spec.rb
 - spec/lib/addressfinder/location_search_spec.rb