truemail 1.2.1 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bea26f52dfcf96b622b86b964aad8cca27ee059ed50dc5d2e24b55173ec7cdf7
-  data.tar.gz: 030f628c6102f3bd4bbb7fb05480850fef362528a5d7c56955d9bd0052e7c64e
+  metadata.gz: 4a79768ed850e2481e1a818783ece53c2dcda4dc93e1b69c2c183fa7ba172f1e
+  data.tar.gz: 51f0d6958b0036733feda8b9dea2226a9dcab65536c111e0c2a503fe32d742eb
 SHA512:
-  metadata.gz: d2f6e20972ded71818590c21b9cdc286594995d01db45d1974c653a9d4b59a8697731a2b7813bd1345e9122c0932bb381b8c32e9971e7a9922ba15b0f28b657e
-  data.tar.gz: e6134e62d76c3faddc9a88a6ff5f99715585dd1c5a1a5f62d360971bdfd4010129511c13f0b28712af79262b7dc8e8756f28e6b5f2003a7aa6c6489fba9c1bf7
+  metadata.gz: 76f5d8eb6f238ef14bae1012df322ceafe53c149263be9230cce6e60c5ba729cdc7c66f8d0f7d4f780521aae2e91139b888b49239caceeccb4bc3def7970e9a0
+  data.tar.gz: f472b4a46800af9c56303b99dd27854326a9afb040d33af11e8e0da12a1dd860cbcbe671ef879c1ef9f8c03065d2bbc1383e38954c845a60053d3f8be7075986

data/.reek.yml

@@ -17,6 +17,7 @@ detectors:
   TooManyInstanceVariables:
     exclude:
      - Truemail::Configuration
+     - Truemail::Validate::Smtp::Request
 
   Attribute:
     exclude:
@@ -40,11 +41,13 @@ detectors:
       - Truemail::Worker#success
       - Truemail#raise_unless
       - Truemail::Configuration#raise_unless
+      - Truemail#determine_configuration
 
   FeatureEnvy:
     exclude:
       - Truemail::Validate::Smtp#not_includes_user_not_found_errors
       - Truemail::GenerateEmailHelper#prepare_user_name
+      - Truemail::ConfigurationHelper#create_configuration
 
   NilCheck:
     exclude:

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    truemail (1.2.1)
+    truemail (1.3.0)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -2,7 +2,7 @@
 
 [![Maintainability](https://api.codeclimate.com/v1/badges/657aa241399927dcd2e2/maintainability)](https://codeclimate.com/github/rubygarage/truemail/maintainability) [![Test Coverage](https://api.codeclimate.com/v1/badges/657aa241399927dcd2e2/test_coverage)](https://codeclimate.com/github/rubygarage/truemail/test_coverage) [![CircleCI](https://circleci.com/gh/rubygarage/truemail/tree/master.svg?style=svg)](https://circleci.com/gh/rubygarage/truemail/tree/master) [![Gem Version](https://badge.fury.io/rb/truemail.svg)](https://badge.fury.io/rb/truemail) [![Downloads](https://img.shields.io/gem/dt/truemail.svg?colorA=004d99&colorB=0073e6)](https://rubygems.org/gems/truemail) [![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-v1.4%20adopted-ff69b4.svg)](CODE_OF_CONDUCT.md)
 
-The Truemail gem helps you validate emails by regex pattern, presence of domain mx-records, and real existence of email account on a current email server. Also Truemail gem allows performing an audit of the host in which runs.
+The Truemail gem helps you validate emails via regex pattern, presence of DNS records, and real existence of email account on a current email server. Also Truemail gem allows performing an audit of the host in which runs.
 
 ## Features
 
@@ -34,17 +34,19 @@ Email validation is a tricky thing. There are a number of different ways to vali
 
 **Syntax Checking**: Checks the email addresses via regex pattern.
 
-**Mail Server Existence Check**: Checks the availability of the email address domain using DNS MX records.
+**Mail Server Existence Check**: Checks the availability of the email address domain using DNS records.
 
 **Mail Existence Check**: Checks if the email address really exists and can receive email via SMTP connections and email-sending emulation techniques.
 
 ## Usage
 
-### Configuration features 
+### Configuration features
 
-#### Set configuration
+You can use global gem configuration or custom independent configuration.
 
-To have an access for ```Truemail.configuration``` and gem features, you must configure it first as in the example below:
+#### Setting global configuration
+
+To have an access for ```Truemail.configuration``` and gem configuration features, you must configure it first as in the example below:
 
 ```ruby
 require 'truemail'
@@ -110,7 +112,7 @@ Truemail.configure do |config|
 end
 ```
 
-#### Read configuration
+##### Read global configuration
 
 After successful configuration, you can read current Truemail configuration instance anywhere in your application.
 
@@ -132,7 +134,7 @@ Truemail.configuration
  @smtp_safe_check=true>
 ```
 
-#### Update configuration
+##### Update global configuration
 
 ```ruby
 Truemail.configuration.connection_timeout = 3
@@ -158,7 +160,7 @@ Truemail.configuration
  @smtp_safe_check=true>
 ```
 
-#### Reset configuration
+##### Reset global configuration
 
 Also you can reset Truemail configuration.
 
@@ -169,6 +171,23 @@ Truemail.configuration
 => nil
 ```
 
+#### Using custom independent configuration
+
+Allows to use independent configuration for each validation/audition instance. When using this feature you do not need to have Truemail global configuration.
+
+```ruby
+custom_configuration = Truemail::Configuration.new do |config|
+  config.verifier_email = 'verifier@example.com'
+end
+
+Truemail.validate('email@example.com', custom_configuration: custom_configuration)
+Truemail.valid?('email@example.com', custom_configuration: custom_configuration)
+Truemail.host_audit('email@example.com', custom_configuration: custom_configuration)
+```
+
+Please note, you should have global or custom configuration for use Truemail gem.
+
+
 ### Validation features
 
 #### Whitelist/Blacklist check
@@ -210,6 +229,20 @@ Truemail.validate('email@white-domain.com')
     mail_servers=[],
     errors={},
     smtp_debug=nil>,
+    configuration=#<Truemail::Configuration:0x00005629f801bd28
+     @blacklisted_domains=["black-domain.com", "somedomain.com"],
+     @connection_attempts=2,
+     @connection_timeout=2,
+     @default_validation_type=:smtp,
+     @email_pattern=/(?=\A.{6,255}\z)(\A([a-zA-Z0-9]+[\w|\-|\.|\+]*)@((?i-mx:[a-z0-9]+([\-\.]{1}[a-z0-9]+)*\.[a-z]{2,63}))\z)/,
+     @response_timeout=2,
+     @smtp_error_body_pattern=/(?=.*550)(?=.*(user|account|customer|mailbox)).*/i,
+     @smtp_safe_check=false,
+     @validation_type_by_domain={"somedomain.com"=>:mx},
+     @verifier_domain="example.com",
+     @verifier_email="verifier@example.com",
+     @whitelist_validation=false,
+     @whitelisted_domains=["white-domain.com", "somedomain.com"]>,
   @validation_type=:whitelist>
 ```
 
@@ -241,6 +274,21 @@ Truemail.validate('email@white-domain.com', with: :regex)
     mail_servers=[],
     errors={},
     smtp_debug=nil>,
+    configuration=
+    #<Truemail::Configuration:0x0000563f0d2605c8
+     @blacklisted_domains=[],
+     @connection_attempts=2,
+     @connection_timeout=2,
+     @default_validation_type=:smtp,
+     @email_pattern=/(?=\A.{6,255}\z)(\A([a-zA-Z0-9]+[\w|\-|\.|\+]*)@((?i-mx:[a-z0-9]+([\-\.]{1}[a-z0-9]+)*\.[a-z]{2,63}))\z)/,
+     @response_timeout=2,
+     @smtp_error_body_pattern=/(?=.*550)(?=.*(user|account|customer|mailbox)).*/i,
+     @smtp_safe_check=false,
+     @validation_type_by_domain={},
+     @verifier_domain="example.com",
+     @verifier_email="verifier@example.com",
+     @whitelist_validation=true,
+     @whitelisted_domains=["white-domain.com"]>,
   @validation_type=:regex>
 ```
 
@@ -257,6 +305,21 @@ Truemail.validate('email@domain.com', with: :regex)
     mail_servers=[],
     errors={},
     smtp_debug=nil>,
+    configuration=
+    #<Truemail::Configuration:0x0000563f0cd82ab0
+     @blacklisted_domains=[],
+     @connection_attempts=2,
+     @connection_timeout=2,
+     @default_validation_type=:smtp,
+     @email_pattern=/(?=\A.{6,255}\z)(\A([a-zA-Z0-9]+[\w|\-|\.|\+]*)@((?i-mx:[a-z0-9]+([\-\.]{1}[a-z0-9]+)*\.[a-z]{2,63}))\z)/,
+     @response_timeout=2,
+     @smtp_error_body_pattern=/(?=.*550)(?=.*(user|account|customer|mailbox)).*/i,
+     @smtp_safe_check=false,
+     @validation_type_by_domain={},
+     @verifier_domain="example.com",
+     @verifier_email="verifier@example.com",
+     @whitelist_validation=true,
+     @whitelisted_domains=["white-domain.com"]>,
   @validation_type=:blacklist>
 ```
 
@@ -275,6 +338,21 @@ Truemail.validate('email@black-domain.com')
     mail_servers=[],
     errors={},
     smtp_debug=nil>,
+    configuration=
+    #<Truemail::Configuration:0x0000563f0d36f4f0
+     @blacklisted_domains=[],
+     @connection_attempts=2,
+     @connection_timeout=2,
+     @default_validation_type=:smtp,
+     @email_pattern=/(?=\A.{6,255}\z)(\A([a-zA-Z0-9]+[\w|\-|\.|\+]*)@((?i-mx:[a-z0-9]+([\-\.]{1}[a-z0-9]+)*\.[a-z]{2,63}))\z)/,
+     @response_timeout=2,
+     @smtp_error_body_pattern=/(?=.*550)(?=.*(user|account|customer|mailbox)).*/i,
+     @smtp_safe_check=false,
+     @validation_type_by_domain={},
+     @verifier_domain="example.com",
+     @verifier_email="verifier@example.com",
+     @whitelist_validation=true,
+     @whitelisted_domains=["white-domain.com"]>,
   @validation_type=:blacklist>
 ```
 
@@ -293,6 +371,21 @@ Truemail.validate('email@somedomain.com')
     mail_servers=[],
     errors={},
     smtp_debug=nil>,
+    configuration=
+    #<Truemail::Configuration:0x0000563f0d3f8fc0
+     @blacklisted_domains=[],
+     @connection_attempts=2,
+     @connection_timeout=2,
+     @default_validation_type=:smtp,
+     @email_pattern=/(?=\A.{6,255}\z)(\A([a-zA-Z0-9]+[\w|\-|\.|\+]*)@((?i-mx:[a-z0-9]+([\-\.]{1}[a-z0-9]+)*\.[a-z]{2,63}))\z)/,
+     @response_timeout=2,
+     @smtp_error_body_pattern=/(?=.*550)(?=.*(user|account|customer|mailbox)).*/i,
+     @smtp_safe_check=false,
+     @validation_type_by_domain={},
+     @verifier_domain="example.com",
+     @verifier_email="verifier@example.com",
+     @whitelist_validation=true,
+     @whitelisted_domains=["white-domain.com"]>,
   @validation_type=:whitelist>
 ```
 
@@ -327,6 +420,21 @@ Truemail.validate('email@example.com', with: :regex)
       mail_servers=[],
       errors={},
       smtp_debug=nil>,
+      configuration=
+      #<Truemail::Configuration:0x000055aa56a54d48
+       @blacklisted_domains=[],
+       @connection_attempts=2,
+       @connection_timeout=2,
+       @default_validation_type=:smtp,
+       @email_pattern=/(?=\A.{6,255}\z)(\A([a-zA-Z0-9]+[\w|\-|\.|\+]*)@((?i-mx:[a-z0-9]+([\-\.]{1}[a-z0-9]+)*\.[a-z]{2,63}))\z)/,
+       @response_timeout=2,
+       @smtp_error_body_pattern=/(?=.*550)(?=.*(user|account|customer|mailbox)).*/i,
+       @smtp_safe_check=false,
+       @validation_type_by_domain={},
+       @verifier_domain="example.com",
+       @verifier_email="verifier@example.com",
+       @whitelist_validation=false,
+       @whitelisted_domains=[]>,
   @validation_type=:regex>
 ```
 
@@ -351,6 +459,21 @@ Truemail.validate('email@example.com', with: :regex)
       mail_servers=[],
       errors={},
       smtp_debug=nil>,
+      configuration=
+      #<Truemail::Configuration:0x0000560e58d80830
+       @blacklisted_domains=[],
+       @connection_attempts=2,
+       @connection_timeout=2,
+       @default_validation_type=:smtp,
+       @email_pattern=/regex_pattern/,
+       @response_timeout=2,
+       @smtp_error_body_pattern=/(?=.*550)(?=.*(user|account|customer|mailbox)).*/i,
+       @smtp_safe_check=false,
+       @validation_type_by_domain={},
+       @verifier_domain="example.com",
+       @verifier_email="verifier@example.com",
+       @whitelist_validation=false,
+       @whitelisted_domains=[]>,
   @validation_type=:regex>
 ```
 
@@ -384,6 +507,21 @@ Truemail.validate('email@example.com', with: :mx)
       mail_servers=["127.0.1.1", "127.0.1.2"],
       errors={},
       smtp_debug=nil>,
+      configuration=
+      #<Truemail::Configuration:0x0000559b6e44af70
+       @blacklisted_domains=[],
+       @connection_attempts=2,
+       @connection_timeout=2,
+       @default_validation_type=:smtp,
+       @email_pattern=/(?=\A.{6,255}\z)(\A([a-zA-Z0-9]+[\w|\-|\.|\+]*)@((?i-mx:[a-z0-9]+([\-\.]{1}[a-z0-9]+)*\.[a-z]{2,63}))\z)/,
+       @response_timeout=2,
+       @smtp_error_body_pattern=/(?=.*550)(?=.*(user|account|customer|mailbox)).*/i,
+       @smtp_safe_check=false,
+       @validation_type_by_domain={},
+       @verifier_domain="example.com",
+       @verifier_email="verifier@example.com",
+       @whitelist_validation=false,
+       @whitelisted_domains=[]>,
   @validation_type=:mx>
 ```
 
@@ -420,6 +558,21 @@ Truemail.validate('email@example.com')
       mail_servers=["127.0.1.1", "127.0.1.2"],
       errors={},
       smtp_debug=nil>,
+      configuration=
+      #<Truemail::Configuration:0x00005615e87b9298
+       @blacklisted_domains=[],
+       @connection_attempts=2,
+       @connection_timeout=2,
+       @default_validation_type=:smtp,
+       @email_pattern=/(?=\A.{6,255}\z)(\A([a-zA-Z0-9]+[\w|\-|\.|\+]*)@((?i-mx:[a-z0-9]+([\-\.]{1}[a-z0-9]+)*\.[a-z]{2,63}))\z)/,
+       @response_timeout=2,
+       @smtp_error_body_pattern=/(?=.*550)(?=.*(user|account|customer|mailbox)).*/i,
+       @smtp_safe_check=false,
+       @validation_type_by_domain={},
+       @verifier_domain="example.com",
+       @verifier_email="verifier@example.com",
+       @whitelist_validation=false,
+       @whitelisted_domains=[]>,
   @validation_type=:smtp>
 
 # SMTP validation failed
@@ -434,17 +587,9 @@ Truemail.validate('email@example.com')
         smtp_debug=
           [#<Truemail::Validate::Smtp::Request:0x0000000002d49b10
             @configuration=
-              #<Truemail::Configuration:0x0000000002d49930
+              #<Truemail::Validate::Smtp::Request::Configuration:0x00005615e8d21848
               @connection_timeout=2,
-              @email_pattern=/regex_pattern/,
-              @smtp_error_body_pattern=/regex_pattern/,
               @response_timeout=2,
-              @connection_attempts=2,
-              @smtp_safe_check=false,
-              @validation_type_by_domain={},
-              @whitelisted_domains=[],
-              @whitelist_validation=false,
-              @blacklisted_domains=[],
               @verifier_domain="example.com",
               @verifier_email="verifier@example.com">,
             @email="email@example.com",
@@ -464,6 +609,21 @@ Truemail.validate('email@example.com')
                     @string="250 OK\n">,
                 rcptto=false,
                 errors={:rcptto=>"550 User not found\n"}>>]>,
+          configuration=
+            #<Truemail::Configuration:0x00005615e87b9298
+             @blacklisted_domains=[],
+             @connection_attempts=2,
+             @connection_timeout=2,
+             @default_validation_type=:smtp,
+             @email_pattern=/(?=\A.{6,255}\z)(\A([a-zA-Z0-9]+[\w|\-|\.|\+]*)@((?i-mx:[a-z0-9]+([\-\.]{1}[a-z0-9]+)*\.[a-z]{2,63}))\z)/,
+             @response_timeout=2,
+             @smtp_error_body_pattern=/(?=.*550)(?=.*(user|account|customer|mailbox)).*/i,
+             @smtp_safe_check=false,
+             @validation_type_by_domain={},
+             @verifier_domain="example.com",
+             @verifier_email="verifier@example.com",
+             @whitelist_validation=false,
+             @whitelisted_domains=[]>,
     @validation_type=:smtp>
 ```
 
@@ -491,33 +651,40 @@ Truemail.validate('email@example.com')
         smtp_debug=
           [#<Truemail::Validate::Smtp::Request:0x0000000002c95d40
             @configuration=
-              #<Truemail::Configuration:0x0000000002c95b38
-                @connection_timeout=2,
-                @email_pattern=/regex_pattern/,
-                @smtp_error_body_pattern=/regex_pattern/,
-                @response_timeout=2,
-                @connection_attempts=2,
-                @smtp_safe_check=true,
-                @validation_type_by_domain={},
-                @whitelisted_domains=[],
-                @whitelist_validation=false,
-                @blacklisted_domains=[],
-                @verifier_domain="example.com",
-                @verifier_email="verifier@example.com">,
-              @email="email@example.com",
-              @host="127.0.1.1",
-              @attempts=nil,
-              @response=
-                #<struct Truemail::Validate::Smtp::Response
-                  port_opened=true,
-                  connection=false,
-                  helo=
-                    #<Net::SMTP::Response:0x0000000002c934c8
-                    @status="250",
-                    @string="250 127.0.1.1\n">,
-                  mailfrom=false,
-                  rcptto=nil,
-                  errors={:mailfrom=>"554 5.7.1 Client host blocked\n", :connection=>"server dropped connection after response"}>>,]>,
+              #<Truemail::Validate::Smtp::Request::Configuration:0x00005615e8d21848
+              @connection_timeout=2,
+              @response_timeout=2,
+              @verifier_domain="example.com",
+              @verifier_email="verifier@example.com">,
+            @email="email@example.com",
+            @host="127.0.1.1",
+            @attempts=nil,
+            @response=
+              #<struct Truemail::Validate::Smtp::Response
+                port_opened=true,
+                connection=false,
+                helo=
+                  #<Net::SMTP::Response:0x0000000002c934c8
+                  @status="250",
+                  @string="250 127.0.1.1\n">,
+                mailfrom=false,
+                rcptto=nil,
+                errors={:mailfrom=>"554 5.7.1 Client host blocked\n", :connection=>"server dropped connection after response"}>>,]>,
+        configuration=
+            #<Truemail::Configuration:0x00005615e87b9298
+             @blacklisted_domains=[],
+             @connection_attempts=2,
+             @connection_timeout=2,
+             @default_validation_type=:smtp,
+             @email_pattern=/(?=\A.{6,255}\z)(\A([a-zA-Z0-9]+[\w|\-|\.|\+]*)@((?i-mx:[a-z0-9]+([\-\.]{1}[a-z0-9]+)*\.[a-z]{2,63}))\z)/,
+             @response_timeout=2,
+             @smtp_error_body_pattern=/(?=.*550)(?=.*(user|account|customer|mailbox)).*/i,
+             @smtp_safe_check=false,
+             @validation_type_by_domain={},
+             @verifier_domain="example.com",
+             @verifier_email="verifier@example.com",
+             @whitelist_validation=false,
+             @whitelisted_domains=[]>,
     @validation_type=:smtp>
 
 # SMTP validation failed
@@ -532,17 +699,9 @@ Truemail.validate('email@example.com')
       smtp_debug=
         [#<Truemail::Validate::Smtp::Request:0x0000000002d49b10
           @configuration=
-            #<Truemail::Configuration:0x0000000002d49930
+              #<Truemail::Validate::Smtp::Request::Configuration:0x00005615e8d21848
               @connection_timeout=2,
-              @email_pattern=/regex_pattern/,
-              @smtp_error_body_pattern=/regex_pattern/,
               @response_timeout=2,
-              @connection_attempts=2,
-              @smtp_safe_check=true,
-              @validation_type_by_domain={},
-              @whitelisted_domains=[],
-              @whitelist_validation=false,
-              @blacklisted_domains=[],
               @verifier_domain="example.com",
               @verifier_email="verifier@example.com">,
           @email="email@example.com",
@@ -559,6 +718,21 @@ Truemail.validate('email@example.com')
               mailfrom=#<Net::SMTP::Response:0x0000000002d5a618 @status="250", @string="250 OK\n">,
               rcptto=false,
               errors={:rcptto=>"550 User not found\n"}>>]>,
+      configuration=
+            #<Truemail::Configuration:0x00005615e87b9298
+             @blacklisted_domains=[],
+             @connection_attempts=2,
+             @connection_timeout=2,
+             @default_validation_type=:smtp,
+             @email_pattern=/(?=\A.{6,255}\z)(\A([a-zA-Z0-9]+[\w|\-|\.|\+]*)@((?i-mx:[a-z0-9]+([\-\.]{1}[a-z0-9]+)*\.[a-z]{2,63}))\z)/,
+             @response_timeout=2,
+             @smtp_error_body_pattern=/(?=.*550)(?=.*(user|account|customer|mailbox)).*/i,
+             @smtp_safe_check=false,
+             @validation_type_by_domain={},
+             @verifier_domain="example.com",
+             @verifier_email="verifier@example.com",
+             @whitelist_validation=false,
+             @whitelisted_domains=[]>,
     @validation_type=:smtp>
 ```
 
@@ -576,14 +750,44 @@ Truemail.host_audit
 => #<Truemail::Auditor:0x00005580df358828
    @result=
      #<struct Truemail::Auditor::Result
-       warnings={}>>
+       warnings={}>,
+       configuration=
+        #<Truemail::Configuration:0x00005615e86327a8
+         @blacklisted_domains=[],
+         @connection_attempts=2,
+         @connection_timeout=2,
+         @default_validation_type=:smtp,
+         @email_pattern=/(?=\A.{6,255}\z)(\A([a-zA-Z0-9]+[\w|\-|\.|\+]*)@((?i-mx:[a-z0-9]+([\-\.]{1}[a-z0-9]+)*\.[a-z]{2,63}))\z)/,
+         @response_timeout=2,
+         @smtp_error_body_pattern=/(?=.*550)(?=.*(user|account|customer|mailbox)).*/i,
+         @smtp_safe_check=false,
+         @validation_type_by_domain={},
+         @verifier_domain="example.com",
+         @verifier_email="verifier@example.com",
+         @whitelist_validation=false,
+         @whitelisted_domains=[]>
 
 # Has PTR warning
 => #<Truemail::Auditor:0x00005580df358828
    @result=
      #<struct Truemail::Auditor::Result
        warnings=
-         {:ptr=>"ptr record does not reference to current verifier domain"}>>
+         {:ptr=>"ptr record does not reference to current verifier domain"}>,
+       configuration=
+        #<Truemail::Configuration:0x00005615e86327a8
+         @blacklisted_domains=[],
+         @connection_attempts=2,
+         @connection_timeout=2,
+         @default_validation_type=:smtp,
+         @email_pattern=/(?=\A.{6,255}\z)(\A([a-zA-Z0-9]+[\w|\-|\.|\+]*)@((?i-mx:[a-z0-9]+([\-\.]{1}[a-z0-9]+)*\.[a-z]{2,63}))\z)/,
+         @response_timeout=2,
+         @smtp_error_body_pattern=/(?=.*550)(?=.*(user|account|customer|mailbox)).*/i,
+         @smtp_safe_check=false,
+         @validation_type_by_domain={},
+         @verifier_domain="example.com",
+         @verifier_email="verifier@example.com",
+         @whitelist_validation=false,
+         @whitelisted_domains=[]>
 ```
 
 ### Truemail helpers

data/lib/truemail/audit/base.rb

@@ -9,8 +9,12 @@ module Truemail
         result.warnings[self.class.name.split('::').last.downcase.to_sym] = message
       end
 
+      def configuration
+        result.configuration
+      end
+
       def verifier_domain
-        Truemail.configuration.verifier_domain
+        configuration.verifier_domain
       end
     end
   end

data/lib/truemail/audit/ptr.rb

@@ -27,7 +27,9 @@ module Truemail
       end
 
       def current_host_address
-        @current_host_address ||= Truemail::Wrapper.call { IPAddr.new(detect_ip_via_ipify) }
+        @current_host_address ||= Truemail::Wrapper.call(configuration: configuration) do
+          IPAddr.new(detect_ip_via_ipify)
+        end
       end
 
       def current_host_reverse_lookup
@@ -35,7 +37,7 @@ module Truemail
       end
 
       def ptr_records
-        @ptr_records ||= Truemail::Wrapper.call do
+        @ptr_records ||= Truemail::Wrapper.call(configuration: configuration) do
           Resolv::DNS.new.getresources(
             current_host_reverse_lookup, Resolv::DNS::Resource::IN::PTR
           ).map { |ptr_record| ptr_record.name.to_s }
@@ -47,11 +49,13 @@ module Truemail
       end
 
       def a_record
-        Truemail::Wrapper.call { Resolv::DNS.new.getaddress(verifier_domain).to_s }
+        Truemail::Wrapper.call(configuration: configuration) do
+          Resolv::DNS.new.getaddress(verifier_domain).to_s
+        end
       end
 
       def verifier_domain_refer_to_current_host_address?
-        a_record == current_host_address.to_s
+        a_record.eql?(current_host_address.to_s)
       end
     end
   end

data/lib/truemail/auditor.rb

@@ -2,18 +2,16 @@
 
 module Truemail
   class Auditor
-    Result = Struct.new(:warnings, keyword_init: true) do
+    Result = Struct.new(:warnings, :configuration, keyword_init: true) do
       def initialize(warnings: {}, **args)
         super
       end
     end
 
-    def self.run
-      new.run
-    end
+    attr_reader :result
 
-    def result
-      @result ||= Truemail::Auditor::Result.new
+    def initialize(configuration:)
+      @result = Truemail::Auditor::Result.new(configuration: configuration)
     end
 
     def run

data/lib/truemail/configuration.rb

@@ -23,10 +23,11 @@ module Truemail
 
     alias retry_count connection_attempts
 
-    def initialize
+    def initialize(&block)
       instance_initializer.each do |instace_variable, value|
         instance_variable_set(:"@#{instace_variable}", value)
       end
+      tap(&block) if block_given?
     end
 
     %i[email_pattern smtp_error_body_pattern].each do |method|

data/lib/truemail/validate/base.rb

@@ -14,7 +14,7 @@ module Truemail
       end
 
       def configuration
-        Truemail.configuration
+        result.configuration
       end
     end
   end

data/lib/truemail/validate/mx.rb

@@ -24,7 +24,7 @@ module Truemail
 
       def mx_lookup
         host_extractor_methods.any? do |method|
-          Truemail::Wrapper.call { send(method) }
+          Truemail::Wrapper.call(configuration: configuration) { send(method) }
         end
       end
 

data/lib/truemail/validate/smtp/request.rb

@@ -11,12 +11,13 @@ module Truemail
         RESPONSE_TIMEOUT_ERROR = 'server response timeout'
         CONNECTION_DROPPED = 'server dropped connection after response'
 
-        attr_reader :host, :email, :response
+        attr_reader :configuration, :host, :email, :response
 
-        def initialize(host:, email:, attempts: nil)
+        def initialize(configuration:, host:, email:, attempts: nil)
+          @configuration = Truemail::Validate::Smtp::Request::Configuration.new(configuration)
+          @response = Truemail::Validate::Smtp::Response.new
           @host = host
           @email = email
-          @response = Truemail::Validate::Smtp::Response.new
           @attempts = attempts
         end
 
@@ -41,6 +42,17 @@ module Truemail
 
         private
 
+        class Configuration
+          REQUEST_PARAMS = %i[connection_timeout response_timeout verifier_domain verifier_email].freeze
+
+          def initialize(configuration)
+            REQUEST_PARAMS.each do |attribute|
+              self.class.class_eval { attr_reader attribute }
+              instance_variable_set(:"@#{attribute}", configuration.public_send(attribute))
+            end
+          end
+        end
+
         attr_reader :attempts
 
         def attempts_exist?
@@ -48,10 +60,6 @@ module Truemail
           (@attempts -= 1).positive?
         end
 
-        def configuration
-          @configuration ||= Truemail.configuration.dup.freeze
-        end
-
         def session
           Net::SMTP.new(host, Truemail::Validate::Smtp::Request::SMTP_PORT).tap do |settings|
             settings.open_timeout = configuration.connection_timeout

data/lib/truemail/validate/smtp.rb

@@ -40,7 +40,7 @@ module Truemail
       def establish_smtp_connection
         mail_servers.each do |mail_server|
           smtp_results << Truemail::Validate::Smtp::Request.new(
-            host: mail_server, email: result.email, **attempts
+            configuration: configuration, host: mail_server, email: result.email, **attempts
           )
           next unless request.check_port
           request.run || rcptto_error ? break : next

data/lib/truemail/validator.rb

@@ -2,7 +2,7 @@
 
 module Truemail
   class Validator
-    RESULT_ATTRS = %i[success email domain mail_servers errors smtp_debug].freeze
+    RESULT_ATTRS = %i[success email domain mail_servers errors smtp_debug configuration].freeze
     VALIDATION_TYPES = %i[regex mx smtp].freeze
 
     Result = Struct.new(*RESULT_ATTRS, keyword_init: true) do
@@ -14,10 +14,11 @@ module Truemail
 
     attr_reader :validation_type, :result
 
-    def initialize(email, with: Truemail.configuration.default_validation_type)
+    def initialize(email, with: nil, configuration:)
+      with ||= configuration.default_validation_type
       raise Truemail::ArgumentError.new(with, :argument) unless Truemail::Validator::VALIDATION_TYPES.include?(with)
+      @result = Truemail::Validator::Result.new(email: email, configuration: configuration)
       @validation_type = select_validation_type(email, with)
-      @result = Truemail::Validator::Result.new(email: email)
     end
 
     def run
@@ -38,7 +39,7 @@ module Truemail
 
     def select_validation_type(email, current_validation_type)
       domain = email[Truemail::RegexConstant::REGEX_EMAIL_PATTERN, 3]
-      Truemail.configuration.validation_type_by_domain[domain] || current_validation_type
+      result.configuration.validation_type_by_domain[domain] || current_validation_type
     end
   end
 end

data/lib/truemail/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Truemail
-  VERSION = '1.2.1'
+  VERSION = '1.3.0'
 end

data/lib/truemail/wrapper.rb

@@ -2,18 +2,20 @@
 
 module Truemail
   class Wrapper
+    attr_reader :timeout
     attr_accessor :attempts
 
-    def self.call(&block)
-      new.call(&block)
+    def self.call(configuration:, &block)
+      new(configuration).call(&block)
     end
 
-    def initialize
-      @attempts = Truemail.configuration.connection_attempts
+    def initialize(configuration)
+      @attempts = configuration.connection_attempts
+      @timeout = configuration.connection_timeout
     end
 
     def call(&block)
-      Timeout.timeout(Truemail.configuration.connection_timeout, &block)
+      Timeout.timeout(timeout, &block)
     rescue Resolv::ResolvError, IPAddr::InvalidAddressError
       false
     rescue Timeout::Error

data/lib/truemail.rb

@@ -4,7 +4,7 @@ require 'truemail/core'
 
 module Truemail
   INCOMPLETE_CONFIG = 'verifier_email is required parameter'
-  NOT_CONFIGURED = 'use Truemail.configure before'
+  NOT_CONFIGURED = 'use Truemail.configure before or pass custom configuration'
 
   class << self
     def configuration
@@ -12,7 +12,7 @@ module Truemail
         return unless block_given?
         configuration = Truemail::Configuration.new
         yield(configuration)
-        raise_unless(configuration.complete?, INCOMPLETE_CONFIG)
+        raise_unless(configuration.complete?, Truemail::INCOMPLETE_CONFIG)
         configuration
       end
     end
@@ -25,24 +25,29 @@ module Truemail
       @configuration = nil
     end
 
-    def validate(email, **options)
-      raise_unless(configuration, NOT_CONFIGURED)
-      Truemail::Validator.new(email, **options).run
+    def validate(email, custom_configuration: nil, **options)
+      Truemail::Validator.new(email, configuration: determine_configuration(custom_configuration), **options).run
     end
 
     def valid?(email, **options)
       validate(email, **options).result.valid?
     end
 
-    def host_audit
-      raise_unless(configuration, NOT_CONFIGURED)
-      Truemail::Auditor.run
+    def host_audit(custom_configuration: nil)
+      Truemail::Auditor.new(configuration: determine_configuration(custom_configuration)).run
     end
 
     private
 
     def raise_unless(condition, message)
-      raise ConfigurationError, message unless condition
+      raise Truemail::ConfigurationError, message unless condition
+    end
+
+    def determine_configuration(custom_configuration)
+      current_configuration = custom_configuration || configuration
+      raise_unless(current_configuration, Truemail::NOT_CONFIGURED)
+      raise_unless(current_configuration.complete?, Truemail::INCOMPLETE_CONFIG)
+      current_configuration.dup.freeze
     end
   end
 end

data/truemail.gemspec

@@ -11,7 +11,8 @@ Gem::Specification.new do |spec|
   spec.email         = ['admin@bestweb.com.ua']
 
   spec.summary       = %(truemail)
-  spec.description   = %(Configurable plain ruby email validator. Validate email by regexp, mx records and real email existence)
+  spec.description   = %(Configurable plain Ruby email validator. Verify email via Regex, DNS and SMTP. Be sure that email address exists)
+
   spec.homepage      = 'https://github.com/rubygarage/truemail'
   spec.license       = 'MIT'
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: truemail
 version: !ruby/object:Gem::Version
-  version: 1.2.1
+  version: 1.3.0
 platform: ruby
 authors:
 - Vladislav Trotsenko
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-06-27 00:00:00.000000000 Z
+date: 2019-09-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -164,8 +164,8 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: Configurable plain ruby email validator. Validate email by regexp, mx
-  records and real email existence
+description: Configurable plain Ruby email validator. Verify email via Regex, DNS
+  and SMTP. Be sure that email address exists
 email:
 - admin@bestweb.com.ua
 executables: []