truemail 0.1.4 → 0.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8dbdc2b39f8f74cdf2965ab1bde2fd613647247827b64c322250046f1a9a22d5
-  data.tar.gz: f1acdd0da6664afa9e03e4031c45d957fbc765378dbc38553f4bae5f4f9569bf
+  metadata.gz: 26d3676d287c46be8f5a9d6b62afe0bb8bf9258f49fd2020d08ff12ffbbb3b58
+  data.tar.gz: cfe874f2fc20513acfd761527fce3ef79eabdd6f020f0a377f6f6cb0027bccd3
 SHA512:
-  metadata.gz: 772bba708fc85b90f2bc3785e40959f067a1ca10bce27c16016ef1f089928f480eb008ec53d18832ce110ae3b5a4c2043ea8c09095af1ce9b92ede14818975d8
-  data.tar.gz: 8d915247fa460b109c18f0e8bd359135c7e4ed738cd5265aa4cec76894910e6199c6e2370d0271674f45597e832501589dfc85e564ffc69846e20f050e20d9ce
+  metadata.gz: 795c62d127fdc4d173817db4c3ad3ea70e671dff16fd822777473239b4238206afd4553dbeb8c4cfff98717fef3548d252d27a095aab39e809283ac88fed9070
+  data.tar.gz: 3e21af180880bedaff7457cdfee47c55bcb9f79562d71eb15aeeb39813f73af880421da7e7c96b5ce569da133c9763471f864b1521ffa8bcb67d3bc9fe4d0dd6

data/Gemfile.lock

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

data/README.md

@@ -64,8 +64,10 @@ Truemail.configure do |config|
   # Optional parameter. A SMTP server response timeout is equal to 2 ms by default.
   config.response_timeout = 1
 
-  # Optional parameter. Total of timeout retry. It is equal to 1 by default.
-  config.retry_count = 2
+  # Optional parameter. Total of connection attempts. It is equal to 2 by default.
+  # This parameter uses in mx lookup timeout error and smtp request (for cases when
+  # there is one mx server).
+  config.connection_attempts = 3
 
   # Optional parameter. You can predefine which type of validation will be used for domains.
   # Available validation types: :regex, :mx, :smtp
@@ -91,7 +93,7 @@ Truemail.configuration
  @connection_timeout=1,
  @email_pattern=/regex_pattern/,
  @response_timeout=1,
- @retry_count=2,
+ @connection_attempts=3,
  @validation_type_by_domain={},
  @verifier_domain="somedomain.com",
  @verifier_email="verifier@example.com"
@@ -105,7 +107,7 @@ Truemail.configuration.connection_timeout = 3
 => 3
 Truemail.configuration.response_timeout = 4
 => 4
-Truemail.configuration.retry_count = 1
+Truemail.configuration.connection_attempts = 1
 => 1
 
 Truemail.configuration
@@ -113,7 +115,7 @@ Truemail.configuration
  @connection_timeout=3,
  @email_pattern=/regex_pattern/,
  @response_timeout=4,
- @retry_count=1,
+ @connection_attempts=1,
  @validation_type_by_domain={},
  @verifier_domain="somedomain.com",
  @verifier_email="verifier@example.com",
@@ -187,7 +189,13 @@ Truemail.validate('email@example.com', with: :regex)
 
 #### MX validation
 
-Validation by MX records is the second validation level. It uses Regex validation before running itself. When regex validation has completed successfully then runs itself. Truemail MX validation performs strictly following the [RFC 5321](https://tools.ietf.org/html/rfc5321#section-5) standard.
+Validation by MX records is the second validation level. It uses Regex validation before running itself. When regex validation has completed successfully then runs itself.
+
+```code
+[Regex validation] -> [MX validation]
+```
+
+Truemail MX validation performs strictly following the [RFC 5321](https://tools.ietf.org/html/rfc5321#section-5) standard.
 
 Example of usage:
 
@@ -206,7 +214,7 @@ Truemail.validate('email@example.com', with: :mx)
       success=true,
       email="email@example.com",
       domain="example.com",
-      mail_servers=["mx1.example.com", "mx2.example.com"],
+      mail_servers=["127.0.1.1", "127.0.1.2"],
       errors={},
       smtp_debug=nil>,
   @validation_type=:mx>
@@ -220,6 +228,8 @@ SMTP validation is a final, third validation level. This type of validation trie
 [Regex validation] -> [MX validation] -> [SMTP validation]
 ```
 
+If total count of MX servers is equal to one, ```Truemail::Smtp``` validator will use value from ```Truemail.configuration.connection_attempts``` as connection attempts. By default it's equal 2.
+
 By default, you don't need pass with-parameter to use it. Example of usage is specified below:
 
 With ```smtp_safe_check = false```
@@ -240,7 +250,7 @@ Truemail.validate('email@example.com')
       success=true,
       email="email@example.com",
       domain="example.com",
-      mail_servers=["mx1.example.com", "mx2.example.com"],
+      mail_servers=["127.0.1.1", "127.0.1.2"],
       errors={},
       smtp_debug=nil>,
   @validation_type=:smtp>
@@ -252,7 +262,7 @@ Truemail.validate('email@example.com')
         success=false,
         email="email@example.com",
         domain="example.com",
-        mail_servers=["mx1.example.com", "mx2.example.com", "mx3.example.com"],
+        mail_servers=["127.0.1.1", "127.0.1.2"],
         errors={:smtp=>"smtp error"},
         smtp_debug=
           [#<Truemail::Validate::Smtp::Request:0x0000000002d49b10
@@ -261,12 +271,14 @@ Truemail.validate('email@example.com')
               @connection_timeout=2,
               @email_pattern=/regex_pattern/,
               @response_timeout=2,
+              @connection_attempts=2,
               @smtp_safe_check=false,
               @validation_type_by_domain={},
               @verifier_domain="example.com",
               @verifier_email="verifier@example.com">,
             @email="email@example.com",
-            @host="mx1.example.com",
+            @host="127.0.1.1",
+            @attempts=nil,
             @response=
               #<struct Truemail::Validate::Smtp::Response
                 port_opened=true,
@@ -274,7 +286,7 @@ Truemail.validate('email@example.com')
                 helo=
                   #<Net::SMTP::Response:0x0000000002d5aca8
                     @status="250",
-                    @string="250 mx1.example.com Hello example.com\n">,
+                    @string="250 127.0.1.1 Hello example.com\n">,
                 mailfrom=
                   #<Net::SMTP::Response:0x0000000002d5a618
                     @status="250",
@@ -303,7 +315,7 @@ Truemail.validate('email@example.com')
         success=true,
         email="email@example.com",
         domain="example.com",
-        mail_servers=["mx1.example.com"],
+        mail_servers=["127.0.1.1", "127.0.1.2"],
         errors={},
         smtp_debug=
           [#<Truemail::Validate::Smtp::Request:0x0000000002c95d40
@@ -312,12 +324,14 @@ Truemail.validate('email@example.com')
                 @connection_timeout=2,
                 @email_pattern=/regex_pattern/,
                 @response_timeout=2,
+                @connection_attempts=2,
                 @smtp_safe_check=true,
                 @validation_type_by_domain={},
                 @verifier_domain="example.com",
                 @verifier_email="verifier@example.com">,
               @email="email@example.com",
-              @host="mx1.example.com",
+              @host="127.0.1.1",
+              @attempts=nil,
               @response=
                 #<struct Truemail::Validate::Smtp::Response
                   port_opened=true,
@@ -325,7 +339,7 @@ Truemail.validate('email@example.com')
                   helo=
                     #<Net::SMTP::Response:0x0000000002c934c8
                     @status="250",
-                    @string="250 mx1.example.com\n">,
+                    @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"}>>,]>,
@@ -338,7 +352,7 @@ Truemail.validate('email@example.com')
       success=false,
       email="email@example.com",
       domain="example.com",
-      mail_servers=["mx1.example.com", "mx2.example.com", "mx3.example.com"],
+      mail_servers=["127.0.1.1", "127.0.1.2"],
       errors={:smtp=>"smtp error"},
       smtp_debug=
         [#<Truemail::Validate::Smtp::Request:0x0000000002d49b10
@@ -347,12 +361,14 @@ Truemail.validate('email@example.com')
               @connection_timeout=2,
               @email_pattern=/regex_pattern/,
               @response_timeout=2,
+              @connection_attempts=2,
               @smtp_safe_check=true,
               @validation_type_by_domain={},
               @verifier_domain="example.com",
               @verifier_email="verifier@example.com">,
           @email="email@example.com",
-          @host="mx1.example.com",
+          @host="127.0.1.1",
+          @attempts=nil,
           @response=
             #<struct Truemail::Validate::Smtp::Response
               port_opened=true,
@@ -360,7 +376,7 @@ Truemail.validate('email@example.com')
               helo=
               #<Net::SMTP::Response:0x0000000002d5aca8
                 @status="250",
-                @string="250 mx1.example.com Hello example.com\n">,
+                @string="250 127.0.1.1 Hello example.com\n">,
               mailfrom=#<Net::SMTP::Response:0x0000000002d5a618 @status="250", @string="250 OK\n">,
               rcptto=false,
               errors={:rcptto=>"550 User not found\n"}>>]>,

data/lib/truemail/configuration.rb

@@ -4,23 +4,25 @@ module Truemail
   class Configuration
     DEFAULT_CONNECTION_TIMEOUT = 2
     DEFAULT_RESPONSE_TIMEOUT = 2
-    DEFAULT_RETRY_COUNT = 1
+    DEFAULT_CONNECTION_ATTEMPTS = 2
 
     attr_reader :email_pattern,
                 :verifier_email,
                 :verifier_domain,
                 :connection_timeout,
                 :response_timeout,
-                :retry_count,
+                :connection_attempts,
                 :validation_type_by_domain
 
     attr_accessor :smtp_safe_check
 
+    alias retry_count connection_attempts
+
     def initialize
       @email_pattern = Truemail::RegexConstant::REGEX_EMAIL_PATTERN
       @connection_timeout = Truemail::Configuration::DEFAULT_CONNECTION_TIMEOUT
       @response_timeout = Truemail::Configuration::DEFAULT_RESPONSE_TIMEOUT
-      @retry_count = Truemail::Configuration::DEFAULT_RETRY_COUNT
+      @connection_attempts = Truemail::Configuration::DEFAULT_CONNECTION_ATTEMPTS
       @validation_type_by_domain = {}
       @smtp_safe_check = false
     end
@@ -41,7 +43,7 @@ module Truemail
       @verifier_domain = domain.downcase
     end
 
-    %i[connection_timeout response_timeout retry_count].each do |method|
+    %i[connection_timeout response_timeout connection_attempts].each do |method|
       define_method("#{method}=") do |argument|
         raise ArgumentError.new(argument, __method__) unless argument.is_a?(Integer) && argument.positive?
         instance_variable_set(:"@#{method}", argument)

data/lib/truemail/validate/resolver_execution_wrapper.rb

@@ -10,7 +10,7 @@ module Truemail
       end
 
       def initialize
-        @attempts = Truemail.configuration.retry_count
+        @attempts = Truemail.configuration.connection_attempts
       end
 
       def call(&block)

data/lib/truemail/validate/smtp.rb

@@ -29,13 +29,24 @@ module Truemail
         smtp_results.last
       end
 
+      def mail_servers
+        result.mail_servers
+      end
+
+      def attempts
+        @attempts ||=
+          mail_servers.one? ? { attempts: Truemail.configuration.connection_attempts } : {}
+      end
+
       def rcptto_error
         request.response.errors[:rcptto]
       end
 
       def establish_smtp_connection
-        result.mail_servers.each do |mail_server|
-          smtp_results << Truemail::Validate::Smtp::Request.new(host: mail_server, email: result.email)
+        mail_servers.each do |mail_server|
+          smtp_results << Truemail::Validate::Smtp::Request.new(
+            host: mail_server, email: result.email, **attempts
+          )
           next unless request.check_port
           request.run || rcptto_error ? break : next
         end

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

@@ -13,17 +13,19 @@ module Truemail
 
         attr_reader :host, :email, :response
 
-        def initialize(host:, email:)
+        def initialize(host:, email:, attempts: nil)
           @host = host
           @email = email
           @response = Truemail::Validate::Smtp::Response.new
+          @attempts = attempts
         end
 
         def check_port
           Timeout.timeout(configuration.connection_timeout) do
             return response.port_opened = !TCPSocket.new(host, Truemail::Validate::Smtp::Request::SMTP_PORT).close
           end
-        rescue Timeout::Error
+        rescue => error
+          retry if attempts_exist? && error.is_a?(Timeout::Error)
           response.port_opened = false
         end
 
@@ -33,11 +35,19 @@ module Truemail
             smtp_handshakes(smtp_request, response)
           end
         rescue => error
+          retry if attempts_exist?
           assign_error(attribute: :connection, message: compose_from(error))
         end
 
         private
 
+        attr_reader :attempts
+
+        def attempts_exist?
+          return false unless attempts
+          (@attempts -= 1).positive?
+        end
+
         def configuration
           @configuration ||= Truemail.configuration.dup.freeze
         end

data/lib/truemail/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: truemail
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.5
 platform: ruby
 authors:
 - Vladislav Trotsenko
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-04-01 00:00:00.000000000 Z
+date: 2019-04-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler