addressfinder 1.15.0 → 1.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c5898fc54f3fcd543748761e03afc308e2f0de4d071c4a507c1d25a3d59f34fd
-  data.tar.gz: 894ba815fb72c6b4e6b340fc44204b376fd04d510a27abe8878e0fa5e5fb2c77
+  metadata.gz: '0365876ccfbc2b618dd2e417b9d2fa238eaee83f8e1c0afa17230c3895f3542e'
+  data.tar.gz: a76840892fae1cdd10c646031edc4ff8f7675d499e0c21e7d7e7c73ebf63c35c
 SHA512:
-  metadata.gz: a12cb1500ce95ca0c64857ac7b8d37957704c51c24da9b86557884c926caa9acee0007f14ae409f7a424f5d53b251383afa7bec92c2d2017ccfed5091a91e83c
-  data.tar.gz: 4e18036778cd7eeaf4178e099bf037963efbf667ee18ac5c7425349dc5f96108d67be76c802839dce66d8b04c312f88935ff55b79f4d807d4a72e905c63e936f
+  metadata.gz: c9fd2bc3220f84afdaa24c4075594dda01a846b8670ced3d5a4a019529e0995488b6981ccd8a28609ed759a3da9598cd0c81133f61a73519dd64f27b03809136
+  data.tar.gz: 386b3217887a2c3601a2290e2638f38989592cc33688eedde74df030afad8af7ed70ae867a39c8a9f65d03b4634b902b93175546f5f346aa0932ade795b89b68

data/CHANGELOG.md

@@ -1,7 +1,13 @@
+# 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 addressses as false within Batch verification
+* Mark unverified addresses as false within Batch verification
 
 # Addressfinder 1.14.0 (February 2025) #
 

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/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/version.rb

@@ -1,3 +1,3 @@
 module AddressFinder
-  VERSION = "1.15.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.15.0
+  version: 1.16.0
 platform: ruby
 authors:
 - Nigel Ramsay
@@ -12,7 +12,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-03-24 00:00:00.000000000 Z
+date: 2025-09-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: multi_json
@@ -118,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
@@ -185,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
@@ -209,7 +210,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
+rubygems_version: 3.3.27
 signing_key:
 specification_version: 4
 summary: Provides easy access to Addressfinder APIs