truemail 2.2.3 → 2.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 57ce495b7ea8e70dc9788b5d5528f3386a57d69233f645ab665f1a187ca08e08
-  data.tar.gz: e5696bb995de86253fec296cd6985ddb5a26f93ccc24e4a95a21b5f4ded05681
+  metadata.gz: 280b30990301626ac98d8017552dfb3980cdca25e0023905cf46fc47f5360f32
+  data.tar.gz: '009e89519a4bc12be4d2c3d2cb33a8571af146ffe0998b0559274b0cd5224d1e'
 SHA512:
-  metadata.gz: 3ac657676afa3a27b5b2192ec7650fd742200fd4a0d5da7a21346f4a3fb75bc2038b1183d4ebdf63ad0fcd579f05169bff6bebdf1a9c2817092d634a7974a30f
-  data.tar.gz: 3f7f43b6ee28ef483c5fdd9a31fb615f98c688e849e0363370e59d3818d3a572272c50daa7a4422dd1f12b0c5ada49e12468f8016e9a17144fc94354d6478eb7
+  metadata.gz: 15cad3cce31888d867608331a8907d4257220d0f18ddaf2d8f98c40b9f568bf410346fc69a77fc5cc8c69d340ab9fec7c6f99c25a5d6ffe6436297c3781dcd1d
+  data.tar.gz: 85b3f6aca2f21867b96fe6544e228aae369ed660bb3f886b4546f1fff76c99f2b8d4c1a324c4668bcf83e4b64bb91105531d0c272cec485edb56146568e8c92b

data/.codeclimate.yml

@@ -7,7 +7,7 @@ checks:
 plugins:
   rubocop:
     enabled: true
-    channel: rubocop-1-5
+    channel: rubocop-1-9
 
   reek:
     enabled: true

data/.reek.yml

@@ -44,6 +44,8 @@ detectors:
       - Truemail::Configuration#logger_options
       - Truemail::Log::Serializer::Base#errors
       - Truemail::Log::Serializer::ValidatorBase#replace_invalid_chars
+      - Truemail::Dns::Worker#nameserver_port
+      - Truemail::Configuration#check_dns_settings
 
   ControlParameter:
     exclude:
@@ -73,5 +75,10 @@ detectors:
     exclude:
       - Truemail::Configuration#logger=
 
+  TooManyConstants:
+    exclude:
+      - Truemail::Configuration
+      - Truemail::RegexConstant
+
 exclude_paths:
   - spec/support/helpers

data/.rubocop.yml

@@ -145,6 +145,9 @@ Style/HashExcept:
 Style/EndlessMethod:
   Enabled: true
 
+Style/IfWithBooleanLiteralBranches:
+  Enabled: true
+
 Layout/LineLength:
   Max: 140
 
@@ -287,6 +290,18 @@ Lint/LambdaWithoutLiteralBlock:
 Lint/RedundantDirGlobSort:
   Enabled: true
 
+Lint/NumberedParameterAssignment:
+  Enabled: true
+
+Lint/OrAssignmentToConstant:
+  Enabled: true
+
+Lint/SymbolConversion:
+  Enabled: true
+
+Lint/TripleQuotes:
+  Enabled: true
+
 Performance/AncestorsInclude:
   Enabled: true
 

data/CHANGELOG.md

@@ -2,6 +2,39 @@
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.3.0] - 2020.02.05
+
+### Added
+
+- Ability to use custom DNS gateway. Thanks [@le0pard](https://github.com/le0pard) for the great idea and [@verdi8](https://github.com/verdi8) for feature [request](https://github.com/truemail-rb/truemail/issues/126).
+
+```ruby
+Truemail.configure do |config|
+  # Optional parameter. This option will provide to use custom DNS gateway when Truemail interacts
+  # with DNS. If you won't specify nameserver's ports DNS validation layer will use default DNS
+  # TCP/UDP port 53. By default Truemail uses DNS gateway from system settings and this option
+  # is equal to empty array.
+  config.dns = ['10.0.0.1', '10.0.0.2:5300']
+end
+```
+
+- Added `Truemail::Dns::Resolver`
+- Added `Truemail::Dns::Worker`
+
+### Changed
+
+- Updated `Truemail::Configuration`, tests
+- Updated `Truemail::Validate::Mx`, tests
+- Updated `Truemail::Audit::Base`
+- Updated `Truemail::Audit::Dns`, tests
+- Updated `Truemail::Audit::Ptr`, tests
+- Updated `Truemail::Log::Serializer::Base`, dependent tests
+- Updated namespaces for stdlib classes
+- Updated gem development dependencies
+- Updated linters/codeclimate configs
+- Updated gem runtime/development dependencies
+- Updated gem documentation, changelog, version
+
 ## [2.2.3] - 2020.01.12
 
 ### Fixed

data/Gemfile.lock

@@ -1,13 +1,15 @@
 PATH
   remote: .
   specs:
-    truemail (2.2.3)
-      simpleidn (~> 0.1.1)
+    truemail (2.3.0)
+      simpleidn (~> 0.2.1)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    ast (2.4.1)
+    addressable (2.7.0)
+      public_suffix (>= 2.0.2, < 5.0)
+    ast (2.4.2)
     bundler-audit (0.7.0.1)
       bundler (>= 1.2.0, < 3)
       thor (>= 0.18, < 2)
@@ -15,15 +17,19 @@ GEM
     childprocess (4.0.0)
     coderay (1.1.3)
     colorize (0.8.1)
-    concurrent-ruby (1.1.7)
+    concurrent-ruby (1.1.8)
+    crack (0.4.5)
+      rexml
     diff-lcs (1.4.4)
-    docile (1.3.4)
+    dns_mock (1.2.0)
+    docile (1.3.5)
     faker (2.15.1)
       i18n (>= 1.6, < 2)
     fasterer (0.8.3)
       colorize (~> 0.7)
       ruby_parser (>= 3.14.1)
-    i18n (1.8.7)
+    hashdiff (1.0.1)
+    i18n (1.8.8)
       concurrent-ruby (~> 1.0)
     iniparse (1.5.0)
     json (2.5.1)
@@ -45,6 +51,7 @@ GEM
       byebug (~> 11.0)
       pry (~> 0.13.0)
     psych (3.3.0)
+    public_suffix (4.0.6)
     rainbow (3.0.0)
     rake (13.0.3)
     reek (6.0.3)
@@ -63,11 +70,11 @@ GEM
     rspec-expectations (3.10.1)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.10.0)
-    rspec-mocks (3.10.1)
+    rspec-mocks (3.10.2)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.10.0)
-    rspec-support (3.10.1)
-    rubocop (1.8.1)
+    rspec-support (3.10.2)
+    rubocop (1.9.1)
       parallel (~> 1.10)
       parser (>= 3.0.0.0)
       rainbow (>= 2.2.2, < 4.0)
@@ -76,12 +83,12 @@ GEM
       rubocop-ast (>= 1.2.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 1.4.0, < 3.0)
-    rubocop-ast (1.4.0)
+    rubocop-ast (1.4.1)
       parser (>= 2.7.1.5)
     rubocop-performance (1.9.2)
       rubocop (>= 0.90.0, < 2.0)
       rubocop-ast (>= 0.4.0)
-    rubocop-rspec (2.1.0)
+    rubocop-rspec (2.2.0)
       rubocop (~> 1.0)
       rubocop-ast (>= 1.1.0)
     ruby-progressbar (1.11.0)
@@ -93,9 +100,9 @@ GEM
       json (>= 1.8, < 3)
       simplecov-html (~> 0.10.0)
     simplecov-html (0.10.2)
-    simpleidn (0.1.1)
+    simpleidn (0.2.1)
       unf (~> 0.1.4)
-    thor (1.0.1)
+    thor (1.1.0)
     truemail-rspec (0.3.3)
       faker (~> 2.15, >= 2.15.1)
       rspec (~> 3.10)
@@ -104,6 +111,10 @@ GEM
       unf_ext
     unf_ext (0.0.7.7)
     unicode-display_width (2.0.0)
+    webmock (3.11.2)
+      addressable (>= 2.3.6)
+      crack (>= 0.3.2)
+      hashdiff (>= 0.4.0, < 2.0.0)
 
 PLATFORMS
   ruby
@@ -111,6 +122,7 @@ PLATFORMS
 DEPENDENCIES
   bundler (~> 1.16)
   bundler-audit (~> 0.7.0.1)
+  dns_mock (~> 1.2)
   faker (~> 2.15, >= 2.15.1)
   fasterer (~> 0.8.3)
   json_matchers (~> 0.11.1)
@@ -119,12 +131,13 @@ DEPENDENCIES
   rake (~> 13.0, >= 13.0.3)
   reek (~> 6.0, >= 6.0.3)
   rspec (~> 3.10)
-  rubocop (~> 1.8, >= 1.8.1)
+  rubocop (~> 1.9, >= 1.9.1)
   rubocop-performance (~> 1.9, >= 1.9.2)
-  rubocop-rspec (~> 2.1)
+  rubocop-rspec (~> 2.2)
   simplecov (~> 0.17.1)
   truemail!
   truemail-rspec (~> 0.3.3)
+  webmock (~> 3.11, >= 3.11.2)
 
 BUNDLED WITH
    1.16.6

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2019-2020 Vladislav Trotsenko
+Copyright (c) 2019-2021 Vladislav Trotsenko
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -132,6 +132,7 @@ You can use global gem configuration or custom independent configuration. Availa
 - whitelisted domains
 - whitelist validation
 - blacklisted domains
+- custom DNS gateway(s)
 - RFC MX lookup flow
 - SMTP fail fast
 - SMTP safe check
@@ -201,6 +202,12 @@ Truemail.configure do |config|
   # It is equal to empty array by default.
   config.blacklisted_domains = ['somedomain1.com', 'somedomain2.com']
 
+  # Optional parameter. This option will provide to use custom DNS gateway when Truemail interacts
+  # with DNS. If you won't specify nameserver's ports DNS validation layer will use default DNS
+  # TCP/UDP port 53. By default Truemail uses DNS gateway from system settings and this option
+  # is equal to empty array.
+  config.dns = ['10.0.0.1', '10.0.0.2:54']
+
   # Optional parameter. This option will provide to use not RFC MX lookup flow.
   # It means that MX and Null MX records will be cheked on the DNS validation layer only.
   # By default this option is disabled.
@@ -242,6 +249,7 @@ Truemail.configuration
  @whitelisted_domains=[],
  @whitelist_validation=true,
  @blacklisted_domains=[],
+ @dns=[],
  @verifier_domain="somedomain.com",
  @verifier_email="verifier@example.com",
  @not_rfc_mx_lookup_flow=true,
@@ -272,6 +280,7 @@ Truemail.configuration
  @whitelisted_domains=[],
  @whitelist_validation=true,
  @blacklisted_domains=[],
+ @dns=[],
  @verifier_domain="somedomain.com",
  @verifier_email="verifier@example.com",
  @not_rfc_mx_lookup_flow=true,
@@ -352,6 +361,7 @@ Truemail.validate('email@white-domain.com')
     smtp_debug=nil>,
     configuration=#<Truemail::Configuration:0x00005629f801bd28
      @blacklisted_domains=["black-domain.com", "somedomain.com"],
+     @dns=[],
      @connection_attempts=2,
      @connection_timeout=2,
      @default_validation_type=:smtp,
@@ -399,6 +409,7 @@ Truemail.validate('email@white-domain.com', with: :regex)
     configuration=
     #<Truemail::Configuration:0x0000563f0d2605c8
      @blacklisted_domains=[],
+     @dns=[],
      @connection_attempts=2,
      @connection_timeout=2,
      @default_validation_type=:smtp,
@@ -432,6 +443,7 @@ Truemail.validate('email@domain.com', with: :regex)
     configuration=
     #<Truemail::Configuration:0x0000563f0cd82ab0
      @blacklisted_domains=[],
+     @dns=[],
      @connection_attempts=2,
      @connection_timeout=2,
      @default_validation_type=:smtp,
@@ -467,6 +479,7 @@ Truemail.validate('email@black-domain.com')
     configuration=
     #<Truemail::Configuration:0x0000563f0d36f4f0
      @blacklisted_domains=[],
+     @dns=[],
      @connection_attempts=2,
      @connection_timeout=2,
      @default_validation_type=:smtp,
@@ -502,6 +515,7 @@ Truemail.validate('email@somedomain.com')
     configuration=
     #<Truemail::Configuration:0x0000563f0d3f8fc0
      @blacklisted_domains=[],
+     @dns=[],
      @connection_attempts=2,
      @connection_timeout=2,
      @default_validation_type=:smtp,
@@ -553,6 +567,7 @@ Truemail.validate('email@example.com', with: :regex)
       configuration=
       #<Truemail::Configuration:0x000055aa56a54d48
        @blacklisted_domains=[],
+       @dns=[],
        @connection_attempts=2,
        @connection_timeout=2,
        @default_validation_type=:smtp,
@@ -596,6 +611,7 @@ Truemail.validate('email@example.com', with: :regex)
       configuration=
       #<Truemail::Configuration:0x0000560e58d80830
        @blacklisted_domains=[],
+       @dns=[],
        @connection_attempts=2,
        @connection_timeout=2,
        @default_validation_type=:smtp,
@@ -650,6 +666,7 @@ Truemail.validate('email@example.com', with: :mx)
       configuration=
       #<Truemail::Configuration:0x0000559b6e44af70
        @blacklisted_domains=[],
+       @dns=[],
        @connection_attempts=2,
        @connection_timeout=2,
        @default_validation_type=:smtp,
@@ -695,6 +712,7 @@ Truemail.validate('email@example.com', with: :mx)
       configuration=
       #<Truemail::Configuration:0x0000559b6e44af70
        @blacklisted_domains=[],
+       @dns=[],
        @connection_attempts=2,
        @connection_timeout=2,
        @default_validation_type=:smtp,
@@ -769,6 +787,7 @@ Truemail.validate('email@example.com')
         configuration=
           #<Truemail::Configuration:0x00007fdc4504f5c8
             @blacklisted_domains=[],
+            @dns=[],
             @connection_attempts=2,
             @connection_timeout=2,
             @default_validation_type=:smtp,
@@ -812,6 +831,7 @@ Truemail.validate('email@example.com')
       configuration=
       #<Truemail::Configuration:0x00005615e87b9298
        @blacklisted_domains=[],
+       @dns=[],
        @connection_attempts=2,
        @connection_timeout=2,
        @default_validation_type=:smtp,
@@ -862,6 +882,7 @@ Truemail.validate('email@example.com')
           configuration=
             #<Truemail::Configuration:0x00005615e87b9298
              @blacklisted_domains=[],
+             @dns=[],
              @connection_attempts=2,
              @connection_timeout=2,
              @default_validation_type=:smtp,
@@ -924,6 +945,7 @@ Truemail.validate('email@example.com')
         configuration=
             #<Truemail::Configuration:0x00005615e87b9298
              @blacklisted_domains=[],
+             @dns=[],
              @connection_attempts=2,
              @connection_timeout=2,
              @default_validation_type=:smtp,
@@ -971,6 +993,7 @@ Truemail.validate('email@example.com')
       configuration=
             #<Truemail::Configuration:0x00005615e87b9298
              @blacklisted_domains=[],
+             @dns=[],
              @connection_attempts=2,
              @connection_timeout=2,
              @default_validation_type=:smtp,
@@ -1019,6 +1042,7 @@ Truemail.host_audit
        configuration=
         #<Truemail::Configuration:0x00005615e86327a8
          @blacklisted_domains=[],
+         @dns=[],
          @connection_attempts=2,
          @connection_timeout=2,
          @default_validation_type=:smtp,
@@ -1046,6 +1070,7 @@ Truemail.host_audit
        configuration=
         #<Truemail::Configuration:0x00005615e86327a8
          @blacklisted_domains=[],
+         @dns=[],
          @connection_attempts=2,
          @connection_timeout=2,
          @default_validation_type=:smtp,
@@ -1101,6 +1126,7 @@ Truemail::Log::Serializer::AuditorJson.call(Truemail.host_audit)
     "whitelist_validation": false,
     "whitelisted_domains": null,
     "blacklisted_domains": null,
+    "dns": null,
     "not_rfc_mx_lookup_flow": false,
     "smtp_fail_fast": false,
     "smtp_safe_check": false,
@@ -1140,6 +1166,7 @@ Truemail::Log::Serializer::ValidatorJson.call(Truemail.validate('nonexistent_ema
     "whitelist_validation": false,
     "whitelisted_domains": null,
     "blacklisted_domains": null,
+    "dns": null,
     "not_rfc_mx_lookup_flow": false,
     "smtp_fail_fast": false,
     "smtp_safe_check": false,
@@ -1181,6 +1208,7 @@ Truemail.host_audit.as_json
     "whitelist_validation": false,
     "whitelisted_domains": null,
     "blacklisted_domains": null,
+    "dns": null,
     "not_rfc_mx_lookup_flow": false,
     "smtp_fail_fast": false,
     "smtp_safe_check": false,
@@ -1217,6 +1245,7 @@ Truemail.validate('nonexistent_email@bestweb.com.ua').as_json
     "whitelist_validation": false,
     "whitelisted_domains": null,
     "blacklisted_domains": null,
+    "dns": null,
     "not_rfc_mx_lookup_flow": false,
     "smtp_fail_fast": false,
     "smtp_safe_check": false,

data/lib/truemail.rb

@@ -46,7 +46,7 @@ module Truemail
     end
 
     def check_argument_type(argument)
-      raise_unless(argument.is_a?(String), Truemail::INVALID_TYPE, Truemail::TypeError)
+      raise_unless(argument.is_a?(::String), Truemail::INVALID_TYPE, Truemail::TypeError)
     end
 
     def determine_configuration(custom_configuration)

data/lib/truemail/audit/base.rb

@@ -5,7 +5,6 @@ module Truemail
     class Base < Truemail::Worker
       require 'net/http'
       require 'ipaddr'
-      require 'resolv'
 
       private
 

data/lib/truemail/audit/dns.rb

@@ -14,7 +14,7 @@ module Truemail
 
       def a_record
         Truemail::Wrapper.call(configuration: configuration) do
-          Resolv::DNS.new.getaddress(verifier_domain).to_s
+          Truemail::Dns::Resolver.a_record(verifier_domain, configuration: configuration)
         end
       end
 

data/lib/truemail/audit/ip.rb

@@ -15,7 +15,7 @@ module Truemail
       private
 
       def detect_ip_via_ipify
-        Net::HTTP.get(URI(Truemail::Audit::Ip::GET_MY_IP_URL))
+        ::Net::HTTP.get(URI(Truemail::Audit::Ip::GET_MY_IP_URL))
       end
 
       def detect_current_host_ip

data/lib/truemail/audit/ptr.rb

@@ -15,13 +15,14 @@ module Truemail
       private
 
       def current_host_reverse_lookup
-        IPAddr.new(current_host_ip).reverse
+        ::IPAddr.new(current_host_ip).reverse
       end
 
       def ptr_records
         @ptr_records ||= Truemail::Wrapper.call(configuration: configuration) do
-          Resolv::DNS.new.getresources(
-            current_host_reverse_lookup, Resolv::DNS::Resource::IN::PTR
+          Truemail::Dns::Resolver.ptr_records(
+            current_host_reverse_lookup,
+            configuration: configuration
           ).map { |ptr_record| ptr_record.name.to_s }
         end || []
       end

data/lib/truemail/auditor.rb

@@ -2,7 +2,7 @@
 
 module Truemail
   class Auditor < Truemail::Executor
-    Result = Struct.new(:current_host_ip, :warnings, :configuration, keyword_init: true) do
+    Result = ::Struct.new(:current_host_ip, :warnings, :configuration, keyword_init: true) do
       def initialize(warnings: {}, **args)
         super
       end

data/lib/truemail/configuration.rb

@@ -7,19 +7,23 @@ module Truemail
     DEFAULT_CONNECTION_ATTEMPTS = 2
     DEFAULT_VALIDATION_TYPE = :smtp
     DEFAULT_LOGGER_OPTIONS = { tracking_event: :error, stdout: false, log_absolute_path: nil }.freeze
-
-    attr_reader :email_pattern,
-                :smtp_error_body_pattern,
-                :verifier_email,
+    SETTERS = %i[
+      email_pattern
+      smtp_error_body_pattern
+      connection_timeout
+      response_timeout
+      connection_attempts
+      whitelisted_domains
+      blacklisted_domains
+    ].freeze
+
+    attr_reader :verifier_email,
                 :verifier_domain,
-                :connection_timeout,
-                :response_timeout,
-                :connection_attempts,
                 :default_validation_type,
                 :validation_type_by_domain,
-                :whitelisted_domains,
-                :blacklisted_domains,
-                :logger
+                :dns,
+                :logger,
+                *Truemail::Configuration::SETTERS
 
     attr_accessor :whitelist_validation, :not_rfc_mx_lookup_flow, :smtp_fail_fast, :smtp_safe_check
 
@@ -30,13 +34,6 @@ module Truemail
       tap(&block) if block
     end
 
-    %i[email_pattern smtp_error_body_pattern].each do |method|
-      define_method("#{method}=") do |argument|
-        raise_unless(argument, __method__, argument.is_a?(Regexp))
-        instance_variable_set(:"@#{method}", argument)
-      end
-    end
-
     def verifier_email=(email)
       validate_arguments(email, __method__)
       @verifier_email = email.downcase
@@ -48,15 +45,8 @@ module Truemail
       @verifier_domain = domain.downcase
     end
 
-    %i[connection_timeout response_timeout connection_attempts].each do |method|
-      define_method("#{method}=") do |argument|
-        raise_unless(argument, __method__, argument.is_a?(Integer) && argument.positive?)
-        instance_variable_set(:"@#{method}", argument)
-      end
-    end
-
     def default_validation_type=(argument)
-      raise_unless(argument, __method__, argument.is_a?(Symbol) && Truemail::Validator::VALIDATION_TYPES.include?(argument))
+      raise_unless(argument, __method__, argument.is_a?(::Symbol) && Truemail::Validator::VALIDATION_TYPES.include?(argument))
       @default_validation_type = argument
     end
 
@@ -65,18 +55,31 @@ module Truemail
       validation_type_by_domain.merge!(settings)
     end
 
-    %i[whitelisted_domains blacklisted_domains].each do |method|
+    def argument_consistent?(argument)
+      case argument
+      when ::Array then check_domain_list(argument)
+      when ::Integer then argument.positive?
+      when ::Regexp then true
+      end
+    end
+
+    Truemail::Configuration::SETTERS.each do |method|
       define_method("#{method}=") do |argument|
-        raise_unless(argument, __method__, argument.is_a?(Array) && check_domain_list(argument))
+        raise_unless(argument, __method__, argument_consistent?(argument))
         instance_variable_set(:"@#{method}", argument)
       end
     end
 
+    def dns=(argument)
+      raise_unless(argument, __method__, argument.is_a?(::Array) && check_dns_settings(argument))
+      @dns = argument
+    end
+
     def logger=(options)
       tracking_event, stdout, log_absolute_path = logger_options(options)
       valid_event = Truemail::Log::Event::TRACKING_EVENTS.key?(tracking_event)
       stdout_only = stdout && log_absolute_path.nil?
-      file_only = log_absolute_path.is_a?(String)
+      file_only = log_absolute_path.is_a?(::String)
       both_types = stdout && file_only
       argument_info = valid_event ? log_absolute_path : tracking_event
       raise_unless(argument_info, __method__, valid_event && (stdout_only || file_only || both_types))
@@ -89,7 +92,7 @@ module Truemail
 
     private
 
-    def instance_initializer
+    def instance_initializer # rubocop:disable Metrics/MethodLength
       {
         email_pattern: Truemail::RegexConstant::REGEX_EMAIL_PATTERN,
         smtp_error_body_pattern: Truemail::RegexConstant::REGEX_SMTP_ERROR_BODY_PATTERN,
@@ -101,6 +104,7 @@ module Truemail
         whitelisted_domains: [],
         whitelist_validation: false,
         blacklisted_domains: [],
+        dns: [],
         not_rfc_mx_lookup_flow: false,
         smtp_fail_fast: false,
         smtp_safe_check: false
@@ -137,13 +141,17 @@ module Truemail
     end
 
     def validate_validation_type(settings)
-      raise_unless(settings, 'hash with settings', settings.is_a?(Hash))
+      raise_unless(settings, 'hash with settings', settings.is_a?(::Hash))
       settings.each do |domain, validation_type|
         check_domain(domain)
         check_validation_type(validation_type)
       end
     end
 
+    def check_dns_settings(dns_servers)
+      dns_servers.all? { |dns_server| Truemail::RegexConstant::REGEX_DNS_SERVER_ADDRESS_PATTERN.match?(dns_server.to_s) }
+    end
+
     def logger_options(current_options)
       Truemail::Configuration::DEFAULT_LOGGER_OPTIONS.merge(current_options).values
     end

data/lib/truemail/core.rb

@@ -10,32 +10,28 @@ module Truemail
   require_relative '../truemail/validator'
   require_relative '../truemail/logger'
 
-  ConfigurationError = Class.new(StandardError)
-  TypeError = Class.new(StandardError)
-
-  ArgumentError = Class.new(StandardError) do
+  ConfigurationError = ::Class.new(::StandardError)
+  TypeError = ::Class.new(::StandardError)
+  ArgumentError = ::Class.new(::StandardError) do
     def initialize(arg_value, arg_name)
       super("#{arg_value} is not a valid #{arg_name}")
     end
   end
 
-  PunycodeRepresenter = Class.new do
-    require 'simpleidn'
-
-    def self.call(email)
-      return unless email.is_a?(String)
-      return email if email.ascii_only?
-      user, domain = email.split('@')
-      "#{user}@#{SimpleIDN.to_ascii(domain.downcase)}"
-    end
-  end
-
   module RegexConstant
     REGEX_DOMAIN = /[\p{L}0-9]+([\-.]{1}[\p{L}0-9]+)*\.\p{L}{2,63}/i.freeze
     REGEX_EMAIL_PATTERN = /(?=\A.{6,255}\z)(\A([\p{L}0-9]+[\w|\-.+]*)@(#{REGEX_DOMAIN})\z)/.freeze
     REGEX_DOMAIN_PATTERN = /(?=\A.{4,255}\z)(\A#{REGEX_DOMAIN}\z)/.freeze
     REGEX_DOMAIN_FROM_EMAIL = /\A.+@(.+)\z/.freeze
     REGEX_SMTP_ERROR_BODY_PATTERN = /(?=.*550)(?=.*(user|account|customer|mailbox)).*/i.freeze
+    REGEX_PORT_NUMBER = /(6553[0-5]|655[0-2][0-9]\d|65[0-4](\d){2}|6[0-4](\d){3}|[1-5](\d){4}|[1-9](\d){0,3})/.freeze
+    REGEX_DNS_SERVER_ADDRESS_PATTERN = /\A((1\d|[1-9]|2[0-4])?\d|25[0-5])(\.\g<1>){3}(:#{REGEX_PORT_NUMBER})?\z/.freeze
+  end
+
+  module Dns
+    require_relative '../truemail/dns/punycode_representer'
+    require_relative '../truemail/dns/worker'
+    require_relative '../truemail/dns/resolver'
   end
 
   module Audit

data/lib/truemail/dns/punycode_representer.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Truemail
+  module Dns
+    PunycodeRepresenter = Class.new do
+      require 'simpleidn'
+
+      def self.call(email)
+        return unless email.is_a?(::String)
+        return email if email.ascii_only?
+        user, domain = email.split('@')
+        "#{user}@#{SimpleIDN.to_ascii(domain.downcase)}"
+      end
+    end
+  end
+end

data/lib/truemail/dns/resolver.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Truemail
+  module Dns
+    class Resolver
+      WORKER_ACTIONS = %i[dns_lookup a_record a_records cname_records mx_records ptr_records].freeze
+
+      class << self
+        Truemail::Dns::Resolver::WORKER_ACTIONS.each do |worker_action|
+          define_method(worker_action) do |argument, configuration:|
+            Truemail::Dns::Worker.new(configuration.dns).public_send(worker_action, argument)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/truemail/dns/worker.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Truemail
+  module Dns
+    require 'resolv'
+
+    class Worker < ::Resolv::DNS
+      DEFAULT_DNS_PORT = 53
+
+      attr_reader :dns_gateway
+
+      def initialize(dns_servers)
+        super(dns_servers.empty? ? nil : config_info(dns_servers))
+      end
+
+      def dns_lookup(host_address)
+        getname(host_address).to_s
+      end
+
+      def a_record(host_name)
+        getaddress(host_name).to_s
+      end
+
+      def a_records(host_name)
+        getaddresses(host_name).map(&:to_s)
+      end
+
+      def cname_records(host_name)
+        getresources(host_name, ::Resolv::DNS::Resource::IN::CNAME)
+      end
+
+      def mx_records(host_name)
+        getresources(host_name, ::Resolv::DNS::Resource::IN::MX)
+      end
+
+      def ptr_records(host_address)
+        getresources(host_address, ::Resolv::DNS::Resource::IN::PTR)
+      end
+
+      private
+
+      def nameserver_port(server)
+        server_address, server_port = server.split(':')
+        [server_address, server_port ? server_port.to_i : Truemail::Dns::Worker::DEFAULT_DNS_PORT]
+      end
+
+      def config_info(dns_servers)
+        @dns_gateway = { nameserver_port: dns_servers.map { |server| nameserver_port(server) } }
+      end
+    end
+  end
+end

data/lib/truemail/log/serializer/auditor_json.rb

@@ -13,7 +13,7 @@ module Truemail
         def result
           @result ||=
             {
-              date: Time.now,
+              date: ::Time.now,
               current_host_ip: executor_result.current_host_ip,
               warnings: warnings(executor_result.warnings),
               configuration: configuration

data/lib/truemail/log/serializer/base.rb

@@ -30,7 +30,7 @@ module Truemail
 
         alias warnings errors
 
-        %i[validation_type_by_domain whitelisted_domains blacklisted_domains].each do |method|
+        %i[validation_type_by_domain whitelisted_domains blacklisted_domains dns].each do |method|
           define_method(method) do
             value = executor_configuration.public_send(method)
             return if value.empty?
@@ -55,6 +55,7 @@ module Truemail
             whitelist_validation: executor_configuration.whitelist_validation,
             whitelisted_domains: whitelisted_domains,
             blacklisted_domains: blacklisted_domains,
+            dns: dns,
             not_rfc_mx_lookup_flow: executor_configuration.not_rfc_mx_lookup_flow,
             smtp_fail_fast: executor_configuration.smtp_fail_fast,
             smtp_safe_check: executor_configuration.smtp_safe_check,

data/lib/truemail/log/serializer/validator_base.rb

@@ -34,7 +34,7 @@ module Truemail
         def result
           @result ||=
             {
-              date: Time.now,
+              date: ::Time.now,
               email: executor_result.email,
               validation_type: validation_type,
               success: executor_result.success,

data/lib/truemail/log/serializer/validator_text.rb

@@ -20,8 +20,8 @@ module Truemail
           enumerable_object.inject([]) do |formatted_data, (key, value)|
             data =
               case
-              when value.is_a?(Hash) then "\n#{printer(value)}"
-              when value.is_a?(Array) then value.join(', ')
+              when value.is_a?(::Hash) then "\n#{printer(value)}"
+              when value.is_a?(::Array) then value.join(', ')
               else value
               end
             formatted_data << "#{key.to_s.tr('_', ' ')}: #{data}".chomp << "\n"

data/lib/truemail/logger.rb

@@ -23,7 +23,7 @@ module Truemail
     def init_log_file
       output_file = Pathname(file)
       return output_file if output_file.exist?
-      output_file.parent.mkpath && FileUtils.touch(output_file)
+      output_file.parent.mkpath && ::FileUtils.touch(output_file)
       output_file
     end
 

data/lib/truemail/validate/mx.rb

@@ -3,8 +3,6 @@
 module Truemail
   module Validate
     class Mx < Truemail::Validate::Base
-      require 'resolv'
-
       ERROR = 'target host(s) not found'
       NULL_MX_RECORD = 'null_mx_record'
 
@@ -43,11 +41,11 @@ module Truemail
       end
 
       def mx_records(hostname)
-        domain_mx_records = Resolv::DNS.new.getresources(hostname, Resolv::DNS::Resource::IN::MX)
+        domain_mx_records = Truemail::Dns::Resolver.mx_records(hostname, configuration: configuration)
         return [Truemail::Validate::Mx::NULL_MX_RECORD] if null_mx?(domain_mx_records)
-        domain_mx_records.sort_by(&:preference).map do |mx_record|
-          Resolv.getaddresses(mx_record.exchange.to_s)
-        end.flatten
+        domain_mx_records.sort_by(&:preference).flat_map do |mx_record|
+          Truemail::Dns::Resolver.a_records(mx_record.exchange.to_s, configuration: configuration)
+        end
       end
 
       def mail_servers_found?
@@ -64,15 +62,15 @@ module Truemail
       end
 
       def a_record(hostname)
-        Resolv.getaddress(hostname)
+        Truemail::Dns::Resolver.a_record(hostname, configuration: configuration)
       end
 
       def hosts_from_cname_records?
-        cname_records = Resolv::DNS.new.getresources(domain, Resolv::DNS::Resource::IN::CNAME)
+        cname_records = Truemail::Dns::Resolver.cname_records(domain, configuration: configuration)
         return if cname_records.empty?
         cname_records.each do |cname_record|
           host = a_record(cname_record.name.to_s)
-          hostname = Resolv.getname(host)
+          hostname = Truemail::Dns::Resolver.dns_lookup(host, configuration: configuration)
           found_hosts = mx_records(hostname)
           fetch_target_hosts(found_hosts.empty? ? [host] : found_hosts)
         end

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

@@ -23,14 +23,14 @@ module Truemail
         end
 
         def check_port
-          response.port_opened = Socket.tcp(
+          response.port_opened = ::Socket.tcp(
             host,
             Truemail::Validate::Smtp::Request::SMTP_PORT,
             connect_timeout: configuration.connection_timeout,
             &port_open_status
           )
         rescue => error
-          retry if attempts_exist? && error.is_a?(Errno::ETIMEDOUT)
+          retry if attempts_exist? && error.is_a?(::Errno::ETIMEDOUT)
           response.port_opened = false
         end
 
@@ -65,7 +65,7 @@ module Truemail
         end
 
         def session
-          Net::SMTP.new(host, Truemail::Validate::Smtp::Request::SMTP_PORT).tap do |settings|
+          ::Net::SMTP.new(host, Truemail::Validate::Smtp::Request::SMTP_PORT).tap do |settings|
             settings.open_timeout = configuration.connection_timeout
             settings.read_timeout = configuration.response_timeout
           end

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

@@ -5,7 +5,7 @@ module Truemail
     class Smtp
       RESPONSE_ATTRS = %i[port_opened connection helo mailfrom rcptto errors].freeze
 
-      Response = Struct.new(*RESPONSE_ATTRS, keyword_init: true) do
+      Response = ::Struct.new(*RESPONSE_ATTRS, keyword_init: true) do
         def initialize(errors: {}, **args)
           super
         end

data/lib/truemail/validator.rb

@@ -5,13 +5,13 @@ module Truemail
     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
+    Result = ::Struct.new(*RESULT_ATTRS, keyword_init: true) do
       def initialize(mail_servers: [], errors: {}, **args)
         super
       end
 
       def punycode_email
-        @punycode_email ||= Truemail::PunycodeRepresenter.call(email)
+        @punycode_email ||= Truemail::Dns::PunycodeRepresenter.call(email)
       end
       alias_method :valid?, :success
     end

data/lib/truemail/version.rb

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

data/lib/truemail/wrapper.rb

@@ -15,10 +15,10 @@ module Truemail
     end
 
     def call(&block)
-      Timeout.timeout(timeout, &block)
-    rescue Resolv::ResolvError, IPAddr::InvalidAddressError
+      ::Timeout.timeout(timeout, &block)
+    rescue ::Resolv::ResolvError, ::IPAddr::InvalidAddressError
       false
-    rescue Timeout::Error
+    rescue ::Timeout::Error
       retry unless (self.attempts -= 1).zero?
       false
     end

data/truemail.gemspec

@@ -31,10 +31,11 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.add_runtime_dependency 'simpleidn', '~> 0.1.1'
+  spec.add_runtime_dependency 'simpleidn', '~> 0.2.1'
 
   spec.add_development_dependency 'bundler', '~> 1.16'
   spec.add_development_dependency 'bundler-audit', '~> 0.7.0.1'
+  spec.add_development_dependency 'dns_mock', '~> 1.2'
   spec.add_development_dependency 'faker', '~> 2.15', '>= 2.15.1'
   spec.add_development_dependency 'fasterer', '~> 0.8.3'
   spec.add_development_dependency 'json_matchers', '~> 0.11.1'
@@ -43,9 +44,10 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'rake', '~> 13.0', '>= 13.0.3'
   spec.add_development_dependency 'reek', '~> 6.0', '>= 6.0.3'
   spec.add_development_dependency 'rspec', '~> 3.10'
-  spec.add_development_dependency 'rubocop', '~> 1.8', '>= 1.8.1'
+  spec.add_development_dependency 'rubocop', '~> 1.9', '>= 1.9.1'
   spec.add_development_dependency 'rubocop-performance', '~> 1.9', '>= 1.9.2'
-  spec.add_development_dependency 'rubocop-rspec', '~> 2.1'
+  spec.add_development_dependency 'rubocop-rspec', '~> 2.2'
   spec.add_development_dependency 'simplecov', '~> 0.17.1'
   spec.add_development_dependency 'truemail-rspec', '~> 0.3.3'
+  spec.add_development_dependency 'webmock', '~> 3.11', '>= 3.11.2'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: truemail
 version: !ruby/object:Gem::Version
-  version: 2.2.3
+  version: 2.3.0
 platform: ruby
 authors:
 - Vladislav Trotsenko
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-01-12 00:00:00.000000000 Z
+date: 2021-02-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: simpleidn
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.1
+        version: 0.2.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.1
+        version: 0.2.1
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -52,6 +52,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.7.0.1
+- !ruby/object:Gem::Dependency
+  name: dns_mock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
 - !ruby/object:Gem::Dependency
   name: faker
   requirement: !ruby/object:Gem::Requirement
@@ -188,20 +202,20 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.8'
+        version: '1.9'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.8.1
+        version: 1.9.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.8'
+        version: '1.9'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.8.1
+        version: 1.9.1
 - !ruby/object:Gem::Dependency
   name: rubocop-performance
   requirement: !ruby/object:Gem::Requirement
@@ -228,14 +242,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.1'
+        version: '2.2'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.1'
+        version: '2.2'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -264,6 +278,26 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.3.3
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.11'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.11.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.11'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.11.2
 description: Configurable framework agnostic plain Ruby email validator. Verify email
   via Regex, DNS and SMTP.
 email:
@@ -305,6 +339,9 @@ files:
 - lib/truemail/auditor.rb
 - lib/truemail/configuration.rb
 - lib/truemail/core.rb
+- lib/truemail/dns/punycode_representer.rb
+- lib/truemail/dns/resolver.rb
+- lib/truemail/dns/worker.rb
 - lib/truemail/executor.rb
 - lib/truemail/log/event.rb
 - lib/truemail/log/serializer/auditor_json.rb