addressfinder 1.14.0 → 1.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0d90188a9c9fc48c8fe6f6969422dbd58fca983e1df1fcd847b30a901e517d57
-  data.tar.gz: dbf03555650c7b18d98e95984eba7355dc23e6002bde8992222203d2cb5d33bc
+  metadata.gz: '0365876ccfbc2b618dd2e417b9d2fa238eaee83f8e1c0afa17230c3895f3542e'
+  data.tar.gz: a76840892fae1cdd10c646031edc4ff8f7675d499e0c21e7d7e7c73ebf63c35c
 SHA512:
-  metadata.gz: 26482cf4b76f70993a20dac62aeb5c6bc4b9cda257343fb47dccd049adea2098a4bab8bf1027ae40377071b6eba02162e9bd6fa94a3391ee4afaf9bf74e2f008
-  data.tar.gz: ed1ce7451090295ebf848e75133e2b19c376bed7c802dd584b72a516695b0e67172e043a4e88c85b3f93714dc5655b9b5f744f0a4b1a193b92f2c62671790383
+  metadata.gz: c9fd2bc3220f84afdaa24c4075594dda01a846b8670ced3d5a4a019529e0995488b6981ccd8a28609ed759a3da9598cd0c81133f61a73519dd64f27b03809136
+  data.tar.gz: 386b3217887a2c3601a2290e2638f38989592cc33688eedde74df030afad8af7ed70ae867a39c8a9f65d03b4634b902b93175546f5f346aa0932ade795b89b68

data/CHANGELOG.md

@@ -1,3 +1,14 @@
+# Addressfinder 1.16.0 (September 2025) #
+
+* Add CGI as dependency for Ruby 3.5+
+* Add batch capability to Phone Numbers verification
+* Don't enforce ssl as part of Net::HTTP configuration
+
+# Addressfinder 1.15.0 (March 2025) #
+
+* Automatically skip empty strings within Batch verification
+* Mark unverified addresses as false within Batch verification
+
 # Addressfinder 1.14.0 (February 2025) #
 
 * Add support for Ruby 3.4

data/README.md

@@ -1,7 +1,7 @@
 # Addressfinder Ruby Gem
 
 [![Gem Version](https://badge.fury.io/rb/addressfinder.svg)](http://badge.fury.io/rb/addressfinder)
-[![Build  Status](https://travis-ci.com/github/AddressFinder/addressfinder-ruby.svg)](https://travis-ci.com/github/AddressFinder/addressfinder-ruby)
+[![Build Status](https://github.com/addressfinder/addressfinder-ruby/actions/workflows/ruby.yml/badge.svg?branch=master)](https://github.com/addressfinder/addressfinder-ruby/actions/workflows/ruby.yml/badge.svg?branch=master)
 
 A client library for accessing the [Addressfinder](https://addressfinder.nz/?utm_source=github&utm_medium=readme&utm_campaign=addressfinder_rubygem&utm_term=AddressFinder) APIs.
 

data/addressfinder.gemspec

@@ -20,12 +20,15 @@ Gem::Specification.new do |gem|
   gem.add_dependency 'multi_json', '~> 1.15'
   gem.add_dependency "concurrent-ruby", "~> 1.2"
   gem.add_dependency 'ostruct', '> 0.6'
+  if Gem::Version.new(RUBY_VERSION) >= Gem::Version.new("3.5")
+    gem.add_dependency "cgi", "~> 0.5"
+  end
 
   gem.add_development_dependency 'guard-rspec', '~> 4.7'
   gem.add_development_dependency 'listen', '~> 3.7'
   gem.add_development_dependency 'rake', '~> 13.0'
   gem.add_development_dependency 'rspec', '~> 3.11'
-  gem.add_development_dependency 'webmock', '~> 1.21'
+  gem.add_development_dependency 'webmock', '~> 3.25'
   gem.add_development_dependency 'debug', '>= 1.0.0'
   gem.add_development_dependency 'standard', '>= 1.35'
 end

data/lib/addressfinder/http.rb

@@ -64,9 +64,9 @@ module AddressFinder
                              config.proxy_password)
         http.open_timeout = config.timeout
         http.read_timeout = config.timeout
-        http.use_ssl = true
+        http.use_ssl = config.port == 443
         http
       end
     end
   end
-end
+end

data/lib/addressfinder/v1/email/batch_verification.rb

@@ -47,7 +47,7 @@ module AddressFinder
           @emails.each_with_index do |email, index_of_email|
             # Start a new thread for each task
             pool.post do
-              verify_email(email, index_of_email)
+              @results[index_of_email] = verify_email(email)
             end
           end
 
@@ -57,11 +57,12 @@ module AddressFinder
         end
 
         # Verifies a single email addresses, and writes the result into @results
-        def verify_email(email, index_of_email)
-          @results[index_of_email] =
-            AddressFinder::V1::Email::Verification.new(email: email, http: http.clone, **args).perform.result
+        def verify_email(email)
+          return if email.empty?
+
+          AddressFinder::V1::Email::Verification.new(email: email, http: http.clone, **args).perform.result
         rescue AddressFinder::RequestRejectedError => e
-          @results[index_of_email] = OpenStruct.new(success: false, body: e.body, status: e.status)
+          OpenStruct.new(success: false, body: e.body, status: e.status)
         end
       end
     end

data/lib/addressfinder/v1/nz/batch_verification.rb

@@ -48,7 +48,7 @@ module AddressFinder
           addresses.each_with_index do |address, index_of_address|
             # Start a new thread for each task
             pool.post do
-              verify_address(address, index_of_address)
+              @results[index_of_address] = verify_address(address)
             end
           end
 
@@ -58,11 +58,12 @@ module AddressFinder
         end
 
         # Verifies a single address, and writes the result into @results
-        def verify_address(address, index_of_address)
-          @results[index_of_address] =
-            AddressFinder::Verification.new(q: address, http: http.clone, **args).perform.result
+        def verify_address(address)
+          return if address.empty?
+
+          AddressFinder::Verification.new(q: address, http: http.clone, **args).perform.result || false
         rescue AddressFinder::RequestRejectedError => e
-          @results[index_of_address] = OpenStruct.new(success: false, body: e.body, status: e.status)
+          OpenStruct.new(success: false, body: e.body, status: e.status)
         end
       end
     end

data/lib/addressfinder/v1/phone/batch_verification.rb

@@ -0,0 +1,72 @@
+module AddressFinder
+  module V1
+    module Phone
+      class BatchVerification
+        attr_reader :phone_numbers, :results
+
+        # Verifies an array of phone numbers using concurrency to reduce the execution time.
+        # The results of the verification are stored in the `results` attribute, in the same order
+        # in which they were supplied.
+        #
+        # @param [Array<String>] phone_numbers
+        # @param [String] default_country_code
+        # @param [AddressFinder::HTTP] http HTTP connection helper
+        # @param [Integer] concurrency How many threads to use for verification
+        # @param [Hash] args Any additional arguments that will be passed onto the EV API
+        def initialize(phone_numbers:, default_country_code:, http:, concurrency: 5, **args)
+          @phone_numbers = phone_numbers
+          @concurrency = concurrency
+          @default_country_code = default_country_code
+          @http = http
+          @args = args
+        end
+
+        def perform
+          confirm_concurrency_level
+          verify_each_phone_number_concurrently
+
+          self
+        end
+
+        private
+
+        attr_reader :args, :concurrency, :http, :default_country_code
+
+        MAX_CONCURRENCY_LEVEL = 10
+
+        def confirm_concurrency_level
+          return unless @concurrency > MAX_CONCURRENCY_LEVEL
+
+          warn "WARNING: Concurrency level of #{@concurrency} is higher than the maximum of #{MAX_CONCURRENCY_LEVEL}. Using #{MAX_CONCURRENCY_LEVEL}."
+          @concurrency = MAX_CONCURRENCY_LEVEL
+        end
+
+        def verify_each_phone_number_concurrently
+          @results = Concurrent::Array.new(phone_numbers.length)
+
+          pool = Concurrent::FixedThreadPool.new(concurrency)
+
+          @phone_numbers.each_with_index do |phone_number, index_of_phone_number|
+            # Start a new thread for each task
+            pool.post do
+              @results[index_of_phone_number] = verify_phone_number(phone_number)
+            end
+          end
+
+          ## Shutdown the pool and wait for all tasks to complete
+          pool.shutdown
+          pool.wait_for_termination
+        end
+
+        # Verifies a single phone number, and writes the result into @results
+        def verify_phone_number(phone_number)
+          return if phone_number.empty?
+
+          AddressFinder::V1::Phone::Verification.new(phone_number: phone_number, default_country_code: default_country_code, http: http.clone, **args).perform.result
+        rescue AddressFinder::RequestRejectedError => e
+          OpenStruct.new(success: false, body: e.body, status: e.status)
+        end
+      end
+    end
+  end
+end

data/lib/addressfinder/v2/au/batch_verification.rb

@@ -48,7 +48,7 @@ module AddressFinder
           addresses.each_with_index do |address, index_of_address|
             # Start a new thread for each task
             pool.post do
-              verify_address(address, index_of_address)
+              @results[index_of_address] = verify_address(address)
             end
           end
 
@@ -58,11 +58,12 @@ module AddressFinder
         end
 
         # Verifies a single address, and writes the result into @results
-        def verify_address(address, index_of_address)
-          @results[index_of_address] =
-            AddressFinder::V2::Au::Verification.new(q: address, http: http.clone, **args).perform.result
+        def verify_address(address)
+          return if address.empty?
+
+          AddressFinder::V2::Au::Verification.new(q: address, http: http.clone, **args).perform.result || false
         rescue AddressFinder::RequestRejectedError => e
-          @results[index_of_address] = OpenStruct.new(success: false, body: e.body, status: e.status)
+          OpenStruct.new(success: false, body: e.body, status: e.status)
         end
       end
     end

data/lib/addressfinder/version.rb

@@ -1,3 +1,3 @@
 module AddressFinder
-  VERSION = "1.14.0"
+  VERSION = "1.16.0"
 end

data/lib/addressfinder.rb

@@ -16,6 +16,7 @@ require "addressfinder/bulk"
 require "addressfinder/v1/email/verification"
 require "addressfinder/v1/email/batch_verification"
 require "addressfinder/v1/phone/verification"
+require "addressfinder/v1/phone/batch_verification"
 require "addressfinder/errors"
 require "addressfinder/util"
 require "addressfinder/http"
@@ -96,6 +97,10 @@ module AddressFinder
       AddressFinder::V1::Phone::Verification.new(**args.merge(http: AddressFinder::HTTP.new(configuration))).perform.result
     end
 
+    def phone_verification_batch(args = {})
+      AddressFinder::V1::Phone::BatchVerification.new(**args.merge(http: AddressFinder::HTTP.new(configuration))).perform.results
+    end
+
     def bulk(&block)
       AddressFinder::Bulk.new(
         http: AddressFinder::HTTP.new(configuration), verification_version: configuration.verification_version, default_country: configuration.default_country, &block

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: addressfinder
 version: !ruby/object:Gem::Version
-  version: 1.14.0
+  version: 1.16.0
 platform: ruby
 authors:
 - Nigel Ramsay
@@ -9,9 +9,10 @@ authors:
 - Sean Arnold
 - Alexandre Barret
 - Cassandre Guinut
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-02-28 00:00:00.000000000 Z
+date: 2025-09-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: multi_json
@@ -117,14 +118,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.21'
+        version: '3.25'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.21'
+        version: '3.25'
 - !ruby/object:Gem::Dependency
   name: debug
   requirement: !ruby/object:Gem::Requirement
@@ -184,6 +185,7 @@ files:
 - lib/addressfinder/v1/email/batch_verification.rb
 - lib/addressfinder/v1/email/verification.rb
 - lib/addressfinder/v1/nz/batch_verification.rb
+- lib/addressfinder/v1/phone/batch_verification.rb
 - lib/addressfinder/v1/phone/verification.rb
 - lib/addressfinder/v2/au/batch_verification.rb
 - lib/addressfinder/v2/au/verification.rb
@@ -193,6 +195,7 @@ homepage: https://github.com/AddressFinder/addressfinder-ruby
 licenses:
 - MIT
 metadata: {}
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -207,7 +210,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.3.27
+signing_key:
 specification_version: 4
 summary: Provides easy access to Addressfinder APIs
 test_files: []