truemail 2.3.4 → 2.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9a738f1fd2c236927014ba6a2303921ae8a90f33866bc4bc58e95fd8c8061e71
-  data.tar.gz: 43c708aa1253358616601ffce03a9ba743eb44ba428d47c67b02ea13712dea26
+  metadata.gz: 93c31449fbc6da2f25c4ded78c2a976e67f71e2b7112aac70db27bf6e1b75f20
+  data.tar.gz: 53599be276e8b72ff3f338c2991c7a10bbdd0c5876e506c40f0965e06941f8c8
 SHA512:
-  metadata.gz: f9546a0c5c6db1e8653536f084e746bd98d48454c9b8ff7c05a23c2551315b500ed2d6be55d050f4f5ba4d1794107330453dd6b5a346e3a20feb432aeb47d5e3
-  data.tar.gz: 5b955a25e540ef7330360e8b8b8ce65b02eea78af89d6f1f288c9db2e83122ea7894f33df1772e126107a63911e7cca20dd671ba22c2c1db9f519da50b2855c1
+  metadata.gz: fc0e3012563e61ee123486a4aa2b27e2b81da60668eccef8ed5d998ca82884f6365cc25c9cabe1cf6ef444eecc4663435b661b7de6b4100dcc5e83dbe65868cb
+  data.tar.gz: 4a27edc3f01d46eb948f172eeb95bcabe5f47a10eb770f8e0f2769454bb94fe8b30f55ec9a19f388592cf70cfd36f224343a879f02ab7b67c13db97b2a3329a2

data/.codeclimate.yml

@@ -7,7 +7,7 @@ checks:
 plugins:
   rubocop:
     enabled: true
-    channel: rubocop-1-12
+    channel: rubocop-1-13
 
   reek:
     enabled: true

data/.reek.yml

@@ -34,18 +34,19 @@ detectors:
 
   UtilityFunction:
     exclude:
-      - Truemail::Validate::Smtp::Request#compose_from
-      - Truemail::Validator#select_validation_type
-      - Truemail::Validate::Base#configuration
-      - Truemail::Validate::Mx#null_mx?
-      - Truemail::Validate::Mx#a_record
       - Truemail::Audit::Base#verifier_domain
-      - Truemail::Configuration#domain_matcher
       - Truemail::Configuration#logger_options
+      - Truemail::Configuration#match_regex?
+      - Truemail::Configuration#regex_by_method
+      - Truemail::Dns::Worker#nameserver_port
       - Truemail::Log::Serializer::Base#errors
       - Truemail::Log::Serializer::ValidatorBase#replace_invalid_chars
-      - Truemail::Dns::Worker#nameserver_port
-      - Truemail::Configuration#check_dns_settings
+      - Truemail::Validator#select_validation_type
+      - Truemail::Validator#constantize
+      - Truemail::Validate::Base#configuration
+      - Truemail::Validate::Mx#null_mx?
+      - Truemail::Validate::Mx#a_record
+      - Truemail::Validate::Smtp::Request#compose_from
 
   ControlParameter:
     exclude:

data/.rubocop.yml

@@ -356,6 +356,9 @@ Performance/RedundantEqualityComparisonBlock:
 Performance/RedundantSplitRegexpArgument:
   Enabled: true
 
+Performance/MapCompact:
+  Enabled: true
+
 RSpec/ExampleLength:
   Enabled: false
 

data/CHANGELOG.md

@@ -2,6 +2,35 @@
 
 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.4.0] - 2021.04.28
+
+### Added
+
+- Implemented `MxBlacklist` validation. This layer provides checking mail servers with predefined blacklisted IP addresses list and can be used as a part of DEA ([disposable email address](https://en.wikipedia.org/wiki/Disposable_email_address)) validations.
+
+```ruby
+Truemail.configure do |config|
+  # Optional parameter. With this option Truemail will filter out unwanted mx servers via
+  # predefined list of ip addresses. It can be used as a part of DEA (disposable email
+  # address) validations. It is equal to empty array by default.
+  config.blacklisted_mx_ip_addresses = ['1.1.1.1', '2.2.2.2']
+end
+
+```
+
+- Added `Truemail::Validate::MxBlacklist`, tests
+
+### Changed
+
+- Updated `Truemail::Core`, tests
+- Updated `Truemail::Configuration`, tests
+- Updated `Truemail::Validator`
+- Updated `Truemail::Validate::Smtp`, tests
+- Updated `Truemail::Log::Serializer::Base`, dependent tests
+- Updated `Truemail::Log::Serializer::ValidatorText`, tests
+- Updated gem development dependencies
+- Updated gem documentation, changelog, version
+
 ## [2.3.4] - 2021.04.16
 
 ### Fixed

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    truemail (2.3.4)
+    truemail (2.4.0)
       simpleidn (~> 0.2.1)
 
 GEM
@@ -54,7 +54,7 @@ GEM
     public_suffix (4.0.6)
     rainbow (3.0.0)
     rake (13.0.3)
-    reek (6.0.3)
+    reek (6.0.4)
       kwalify (~> 0.7.0)
       parser (~> 3.0.0)
       psych (~> 3.1)
@@ -74,7 +74,7 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.10.0)
     rspec-support (3.10.2)
-    rubocop (1.12.1)
+    rubocop (1.13.0)
       parallel (~> 1.10)
       parser (>= 3.0.0.0)
       rainbow (>= 2.2.2, < 4.0)
@@ -85,10 +85,10 @@ GEM
       unicode-display_width (>= 1.4.0, < 3.0)
     rubocop-ast (1.4.1)
       parser (>= 2.7.1.5)
-    rubocop-performance (1.10.2)
-      rubocop (>= 0.90.0, < 2.0)
+    rubocop-performance (1.11.0)
+      rubocop (>= 1.7.0, < 2.0)
       rubocop-ast (>= 0.4.0)
-    rubocop-rspec (2.2.0)
+    rubocop-rspec (2.3.0)
       rubocop (~> 1.0)
       rubocop-ast (>= 1.1.0)
     ruby-progressbar (1.11.0)
@@ -129,11 +129,11 @@ DEPENDENCIES
   overcommit (~> 0.57.0)
   pry-byebug (~> 3.9)
   rake (~> 13.0, >= 13.0.3)
-  reek (~> 6.0, >= 6.0.3)
+  reek (~> 6.0, >= 6.0.4)
   rspec (~> 3.10)
-  rubocop (~> 1.12, >= 1.12.1)
-  rubocop-performance (~> 1.10, >= 1.10.2)
-  rubocop-rspec (~> 2.2)
+  rubocop (~> 1.13)
+  rubocop-performance (~> 1.11)
+  rubocop-rspec (~> 2.3)
   simplecov (~> 0.17.1)
   truemail!
   truemail-rspec (~> 0.4)

data/README.md

@@ -39,6 +39,7 @@ Configurable framework agnostic plain Ruby email validator. Verify email via Reg
     - [DNS (MX) validation](#mx-validation)
       - [RFC MX lookup flow](#rfc-mx-lookup-flow)
       - [Not RFC MX lookup flow](#not-rfc-mx-lookup-flow)
+    - [MX blacklist validation](#mx-blacklist-validation)
     - [SMTP validation](#smtp-validation)
       - [SMTP fail fast enabled](#smtp-fail-fast-enabled)
       - [SMTP safe check disabled](#smtp-safe-check-disabled)
@@ -132,6 +133,7 @@ You can use global gem configuration or custom independent configuration. Availa
 - whitelisted domains
 - whitelist validation
 - blacklisted domains
+- blacklisted mx ip-addresses
 - custom DNS gateway(s)
 - RFC MX lookup flow
 - SMTP fail fast
@@ -200,7 +202,12 @@ Truemail.configure do |config|
   # Optional parameter. Validation of email which contains blacklisted domain always will
   # return false. Other validations will not processed even if it was defined in validation_type_for
   # It is equal to empty array by default.
-  config.blacklisted_domains = ['somedomain1.com', 'somedomain2.com']
+  config.blacklisted_domains = ['somedomain3.com', 'somedomain4.com']
+
+  # Optional parameter. With this option Truemail will filter out unwanted mx servers via
+  # predefined list of ip addresses. It can be used as a part of DEA (disposable email
+  # address) validations. It is equal to empty array by default.
+  config.blacklisted_mx_ip_addresses = ['1.1.1.1', '2.2.2.2']
 
   # Optional parameter. This option will provide to use custom DNS gateway when Truemail
   # interacts with DNS. Valid port numbers are in the range 1-65535. If you won't specify
@@ -245,11 +252,13 @@ Truemail.configuration
  @smtp_error_body_pattern=/regex_pattern/,
  @response_timeout=1,
  @connection_attempts=3,
- @validation_type_by_domain={},
- @whitelisted_domains=[],
+ @default_validation_type=:mx,
+ @validation_type_by_domain={"somedomain.com" => :regex, "otherdomain.com" => :mx},
+ @whitelisted_domains=["somedomain1.com", "somedomain2.com"],
  @whitelist_validation=true,
- @blacklisted_domains=[],
- @dns=[],
+ @blacklisted_domains=["somedomain3.com", "somedomain4.com"],
+ @blacklisted_mx_ip_addresses=["1.1.1.1", "2.2.2.2"],
+ @dns=["10.0.0.1", "10.0.0.2:54"],
  @verifier_domain="somedomain.com",
  @verifier_email="verifier@example.com",
  @not_rfc_mx_lookup_flow=true,
@@ -276,11 +285,13 @@ Truemail.configuration
  @smtp_error_body_pattern=/regex_pattern/,
  @response_timeout=4,
  @connection_attempts=1,
- @validation_type_by_domain={},
- @whitelisted_domains=[],
+ @default_validation_type=:mx,
+ @validation_type_by_domain={"somedomain.com" => :regex, "otherdomain.com" => :mx},
+ @whitelisted_domains=["somedomain1.com", "somedomain2.com"],
  @whitelist_validation=true,
- @blacklisted_domains=[],
- @dns=[],
+ @blacklisted_domains=["somedomain3.com", "somedomain4.com"],
+ @blacklisted_mx_ip_addresses=["1.1.1.1", "2.2.2.2"],
+ @dns=["10.0.0.1", "10.0.0.2:54"],
  @verifier_domain="somedomain.com",
  @verifier_email="verifier@example.com",
  @not_rfc_mx_lookup_flow=true,
@@ -361,6 +372,7 @@ Truemail.validate('email@white-domain.com')
     smtp_debug=nil>,
     configuration=#<Truemail::Configuration:0x00005629f801bd28
      @blacklisted_domains=["black-domain.com", "somedomain.com"],
+     @blacklisted_mx_ip_addresses=[],
      @dns=[],
      @connection_attempts=2,
      @connection_timeout=2,
@@ -409,6 +421,7 @@ Truemail.validate('email@white-domain.com', with: :regex)
     configuration=
     #<Truemail::Configuration:0x0000563f0d2605c8
      @blacklisted_domains=[],
+     @blacklisted_mx_ip_addresses=[],
      @dns=[],
      @connection_attempts=2,
      @connection_timeout=2,
@@ -443,6 +456,7 @@ Truemail.validate('email@domain.com', with: :regex)
     configuration=
     #<Truemail::Configuration:0x0000563f0cd82ab0
      @blacklisted_domains=[],
+     @blacklisted_mx_ip_addresses=[],
      @dns=[],
      @connection_attempts=2,
      @connection_timeout=2,
@@ -463,7 +477,7 @@ Truemail.validate('email@domain.com', with: :regex)
 
 ##### Blacklist case
 
-When email in blacklist, validation type will be redefined too. Validation result returns ```false```
+When email in blacklist, validation type will be redefined too. Validation result returns `false`
 
 ```ruby
 Truemail.validate('email@black-domain.com')
@@ -479,6 +493,7 @@ Truemail.validate('email@black-domain.com')
     configuration=
     #<Truemail::Configuration:0x0000563f0d36f4f0
      @blacklisted_domains=[],
+     @blacklisted_mx_ip_addresses=[],
      @dns=[],
      @connection_attempts=2,
      @connection_timeout=2,
@@ -515,6 +530,7 @@ Truemail.validate('email@somedomain.com')
     configuration=
     #<Truemail::Configuration:0x0000563f0d3f8fc0
      @blacklisted_domains=[],
+     @blacklisted_mx_ip_addresses=[],
      @dns=[],
      @connection_attempts=2,
      @connection_timeout=2,
@@ -567,6 +583,7 @@ Truemail.validate('email@example.com', with: :regex)
       configuration=
       #<Truemail::Configuration:0x000055aa56a54d48
        @blacklisted_domains=[],
+       @blacklisted_mx_ip_addresses=[],
        @dns=[],
        @connection_attempts=2,
        @connection_timeout=2,
@@ -611,6 +628,7 @@ Truemail.validate('email@example.com', with: :regex)
       configuration=
       #<Truemail::Configuration:0x0000560e58d80830
        @blacklisted_domains=[],
+       @blacklisted_mx_ip_addresses=[],
        @dns=[],
        @connection_attempts=2,
        @connection_timeout=2,
@@ -666,6 +684,7 @@ Truemail.validate('email@example.com', with: :mx)
       configuration=
       #<Truemail::Configuration:0x0000559b6e44af70
        @blacklisted_domains=[],
+       @blacklisted_mx_ip_addresses=[],
        @dns=[],
        @connection_attempts=2,
        @connection_timeout=2,
@@ -712,6 +731,7 @@ Truemail.validate('email@example.com', with: :mx)
       configuration=
       #<Truemail::Configuration:0x0000559b6e44af70
        @blacklisted_domains=[],
+       @blacklisted_mx_ip_addresses=[],
        @dns=[],
        @connection_attempts=2,
        @connection_timeout=2,
@@ -730,12 +750,63 @@ Truemail.validate('email@example.com', with: :mx)
   @validation_type=:mx>
 ```
 
+#### MX blacklist validation
+
+MX blacklist validation is the third validation level. This layer provides checking extracted mail server(s) IP address from MX validation with predefined blacklisted IP addresses list. It can be used as a part of DEA ([disposable email address](https://en.wikipedia.org/wiki/Disposable_email_address)) validations.
+
+```code
+[Whitelist/Blacklist] -> [Regex validation] -> [MX validation] -> [MX blacklist validation]
+```
+
+Example of usage:
+
+```ruby
+require 'truemail'
+
+Truemail.configure do |config|
+  config.verifier_email = 'verifier@example.com'
+  config.blacklisted_mx_ip_addresses = ['127.0.1.2']
+end
+
+Truemail.validate('email@example.com', with: :mx_blacklist)
+
+=> #<Truemail::Validator:0x00007fca0c8aea70
+ @result=
+  #<struct Truemail::Validator::Result
+   success=false,
+   email="email@example.com",
+   domain="example.com",
+   mail_servers=["127.0.1.1", "127.0.1.2"],
+   errors={:mx_blacklist=>"blacklisted mx server ip address"},
+   smtp_debug=nil,
+   configuration=
+    #<Truemail::Configuration:0x00007fca0c8aeb38
+     @blacklisted_domains=[],
+     @blacklisted_mx_ip_addresses=["127.0.1.2"],
+     @connection_attempts=2,
+     @connection_timeout=2,
+     @default_validation_type=:smtp,
+     @dns=[],
+     @email_pattern=/(?=\A.{6,255}\z)(\A([\p{L}0-9]+[\w|\-.+]*)@((?i-mx:[\p{L}0-9]+([\-.]{1}[\p{L}0-9]+)*\.\p{L}{2,63}))\z)/,
+     @not_rfc_mx_lookup_flow=false,
+     @response_timeout=2,
+     @smtp_error_body_pattern=/(?=.*550)(?=.*(user|account|customer|mailbox)).*/i,
+     @smtp_fail_fast=false,
+     @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_blacklist>
+```
+
 #### SMTP validation
 
-SMTP validation is a final, third validation level. This type of validation tries to check real existence of email account on a current email server. This validation runs a chain of previous validations and if they're complete successfully then runs itself.
+SMTP validation is a final, fourth validation level. This type of validation tries to check real existence of email account on a current email server. This validation runs a chain of previous validations and if they're complete successfully then runs itself.
 
 ```code
-[Whitelist/Blacklist] -> [Regex validation] -> [MX validation] -> [SMTP validation]
+[Whitelist/Blacklist] -> [Regex validation] -> [MX validation] -> [MX blacklist 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`.
@@ -787,6 +858,7 @@ Truemail.validate('email@example.com')
         configuration=
           #<Truemail::Configuration:0x00007fdc4504f5c8
             @blacklisted_domains=[],
+            @blacklisted_mx_ip_addresses=[],
             @dns=[],
             @connection_attempts=2,
             @connection_timeout=2,
@@ -831,6 +903,7 @@ Truemail.validate('email@example.com')
       configuration=
       #<Truemail::Configuration:0x00005615e87b9298
        @blacklisted_domains=[],
+       @blacklisted_mx_ip_addresses=[],
        @dns=[],
        @connection_attempts=2,
        @connection_timeout=2,
@@ -882,6 +955,7 @@ Truemail.validate('email@example.com')
           configuration=
             #<Truemail::Configuration:0x00005615e87b9298
              @blacklisted_domains=[],
+             @blacklisted_mx_ip_addresses=[],
              @dns=[],
              @connection_attempts=2,
              @connection_timeout=2,
@@ -945,6 +1019,7 @@ Truemail.validate('email@example.com')
         configuration=
             #<Truemail::Configuration:0x00005615e87b9298
              @blacklisted_domains=[],
+             @blacklisted_mx_ip_addresses=[],
              @dns=[],
              @connection_attempts=2,
              @connection_timeout=2,
@@ -993,6 +1068,7 @@ Truemail.validate('email@example.com')
       configuration=
             #<Truemail::Configuration:0x00005615e87b9298
              @blacklisted_domains=[],
+             @blacklisted_mx_ip_addresses=[],
              @dns=[],
              @connection_attempts=2,
              @connection_timeout=2,
@@ -1042,6 +1118,7 @@ Truemail.host_audit
        configuration=
         #<Truemail::Configuration:0x00005615e86327a8
          @blacklisted_domains=[],
+         @blacklisted_mx_ip_addresses=[],
          @dns=[],
          @connection_attempts=2,
          @connection_timeout=2,
@@ -1070,6 +1147,7 @@ Truemail.host_audit
        configuration=
         #<Truemail::Configuration:0x00005615e86327a8
          @blacklisted_domains=[],
+         @blacklisted_mx_ip_addresses=[],
          @dns=[],
          @connection_attempts=2,
          @connection_timeout=2,
@@ -1123,6 +1201,7 @@ Truemail::Log::Serializer::AuditorJson.call(Truemail.host_audit)
   },
  "configuration": {
     "blacklisted_domains": null,
+    "blacklisted_mx_ip_addresses": null,
     "dns": null,
     "email_pattern": "default gem value",
     "not_rfc_mx_lookup_flow": false,
@@ -1163,6 +1242,7 @@ Truemail::Log::Serializer::ValidatorJson.call(Truemail.validate('nonexistent_ema
   ],
   "configuration": {
     "blacklisted_domains": null,
+    "blacklisted_mx_ip_addresses": null,
     "dns": null,
     "email_pattern": "default gem value",
     "not_rfc_mx_lookup_flow": false,
@@ -1205,6 +1285,7 @@ Truemail.host_audit.as_json
   },
  "configuration": {
     "blacklisted_domains": null,
+    "blacklisted_mx_ip_addresses": null,
     "dns": null,
     "email_pattern": "default gem value",
     "not_rfc_mx_lookup_flow": false,
@@ -1242,6 +1323,7 @@ Truemail.validate('nonexistent_email@bestweb.com.ua').as_json
   ],
   "configuration": {
     "blacklisted_domains": null,
+    "blacklisted_mx_ip_addresses": null,
     "dns": null,
     "email_pattern": "default gem value",
     "not_rfc_mx_lookup_flow": false,

data/lib/truemail/configuration.rb

@@ -15,13 +15,14 @@ module Truemail
       connection_attempts
       whitelisted_domains
       blacklisted_domains
+      blacklisted_mx_ip_addresses
+      dns
     ].freeze
 
     attr_reader :verifier_email,
                 :verifier_domain,
                 :default_validation_type,
                 :validation_type_by_domain,
-                :dns,
                 :logger,
                 *Truemail::Configuration::SETTERS
 
@@ -55,9 +56,9 @@ module Truemail
       validation_type_by_domain.merge!(settings)
     end
 
-    def argument_consistent?(argument)
+    def argument_consistent?(method, argument)
       case argument
-      when ::Array then check_domain_list(argument)
+      when ::Array then items_match_regex?(argument, regex_by_method(method))
       when ::Integer then argument.positive?
       when ::Regexp then true
       end
@@ -65,16 +66,11 @@ module Truemail
 
     Truemail::Configuration::SETTERS.each do |method|
       define_method("#{method}=") do |argument|
-        raise_unless(argument, __method__, argument_consistent?(argument))
+        raise_unless(argument, __method__, argument_consistent?(method, 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)
@@ -104,6 +100,7 @@ module Truemail
         whitelisted_domains: [],
         whitelist_validation: false,
         blacklisted_domains: [],
+        blacklisted_mx_ip_addresses: [],
         dns: [],
         not_rfc_mx_lookup_flow: false,
         smtp_fail_fast: false,
@@ -115,25 +112,27 @@ module Truemail
       raise Truemail::ArgumentError.new(argument_context, argument_name) unless condition
     end
 
+    def match_regex?(regex_pattern, object)
+      regex_pattern.match?(object.to_s)
+    end
+
     def validate_arguments(argument, method)
-      constant = Truemail::RegexConstant.const_get("regex_#{method[/\A.+_(.+)=\z/, 1]}_pattern".upcase)
-      raise_unless(argument, method, constant.match?(argument.to_s))
+      regex_pattern = Truemail::RegexConstant.const_get("regex_#{method[/\A.+_(.+)=\z/, 1]}_pattern".upcase)
+      raise_unless(argument, method, match_regex?(regex_pattern, argument))
     end
 
     def default_verifier_domain
       self.verifier_domain ||= verifier_email[Truemail::RegexConstant::REGEX_EMAIL_PATTERN, 3]
     end
 
-    def domain_matcher
-      ->(domain) { Truemail::RegexConstant::REGEX_DOMAIN_PATTERN.match?(domain.to_s) }
+    def regex_by_method(method)
+      return Truemail::RegexConstant::REGEX_IP_ADDRESS_PATTERN if method.eql?(:blacklisted_mx_ip_addresses)
+      return Truemail::RegexConstant::REGEX_DNS_SERVER_ADDRESS_PATTERN if method.eql?(:dns)
+      Truemail::RegexConstant::REGEX_DOMAIN_PATTERN
     end
 
-    def check_domain(domain)
-      raise_unless(domain, 'domain', domain_matcher.call(domain))
-    end
-
-    def check_domain_list(domains)
-      domains.all?(&domain_matcher)
+    def items_match_regex?(items, regex_pattern)
+      items.all? { |item| match_regex?(regex_pattern, item) }
     end
 
     def check_validation_type(validation_type)
@@ -143,15 +142,11 @@ module Truemail
     def validate_validation_type(settings)
       raise_unless(settings, 'hash with settings', settings.is_a?(::Hash))
       settings.each do |domain, validation_type|
-        check_domain(domain)
+        raise_unless(domain, 'domain', match_regex?(Truemail::RegexConstant::REGEX_DOMAIN_PATTERN, 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

@@ -24,8 +24,10 @@ module Truemail
     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_IP_ADDRESS = /((1\d|[1-9]|2[0-4])?\d|25[0-5])(\.\g<1>){3}/.freeze
+    REGEX_IP_ADDRESS_PATTERN = /\A#{REGEX_IP_ADDRESS}\z/.freeze
     REGEX_PORT_NUMBER = /6553[0-5]|655[0-2]\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
+    REGEX_DNS_SERVER_ADDRESS_PATTERN = /\A#{REGEX_IP_ADDRESS}(:#{REGEX_PORT_NUMBER})?\z/.freeze
   end
 
   module Dns
@@ -46,6 +48,7 @@ module Truemail
     require_relative '../truemail/validate/domain_list_match'
     require_relative '../truemail/validate/regex'
     require_relative '../truemail/validate/mx'
+    require_relative '../truemail/validate/mx_blacklist'
     require_relative '../truemail/validate/smtp'
     require_relative '../truemail/validate/smtp/response'
     require_relative '../truemail/validate/smtp/request'

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

@@ -6,6 +6,14 @@ module Truemail
       class Base
         require 'json'
 
+        CONFIGURATION_ARRAY_ATTRS = %i[
+          validation_type_by_domain
+          whitelisted_domains
+          blacklisted_domains
+          blacklisted_mx_ip_addresses
+          dns
+        ].freeze
+        CONFIGURATION_REGEX_ATTRS = %i[email_pattern smtp_error_body_pattern].freeze
         DEFAULT_GEM_VALUE = 'default gem value'
 
         def self.call(executor_instance)
@@ -30,7 +38,7 @@ module Truemail
 
         alias warnings errors
 
-        %i[validation_type_by_domain whitelisted_domains blacklisted_domains dns].each do |method|
+        Truemail::Log::Serializer::Base::CONFIGURATION_ARRAY_ATTRS.each do |method|
           define_method(method) do
             value = executor_configuration.public_send(method)
             return if value.empty?
@@ -38,7 +46,7 @@ module Truemail
           end
         end
 
-        %i[email_pattern smtp_error_body_pattern].each do |method|
+        Truemail::Log::Serializer::Base::CONFIGURATION_REGEX_ATTRS.each do |method|
           define_method(method) do
             value = executor_configuration.public_send(method)
             default_pattern = Truemail::RegexConstant.const_get(
@@ -55,6 +63,7 @@ module Truemail
             whitelist_validation: executor_configuration.whitelist_validation,
             whitelisted_domains: whitelisted_domains,
             blacklisted_domains: blacklisted_domains,
+            blacklisted_mx_ip_addresses: blacklisted_mx_ip_addresses,
             dns: dns,
             not_rfc_mx_lookup_flow: executor_configuration.not_rfc_mx_lookup_flow,
             smtp_fail_fast: executor_configuration.smtp_fail_fast,

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

@@ -19,9 +19,9 @@ module Truemail
         def data_composer(enumerable_object)
           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(', ')
+              case value
+              when ::Hash then "\n#{printer(value)}"
+              when ::Array then value.join(', ')
               else value
               end
             formatted_data << "#{key.to_s.tr('_', ' ')}: #{data}".chomp << "\n"

data/lib/truemail/validate/mx_blacklist.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Truemail
+  module Validate
+    class MxBlacklist < Truemail::Validate::Base
+      ERROR = 'blacklisted mx server ip address'
+
+      def run
+        return false unless Truemail::Validate::Mx.check(result)
+        return true if success(mail_servers.none?(&blacklisted_ip?))
+        add_error(Truemail::Validate::MxBlacklist::ERROR)
+        false
+      end
+
+      private
+
+      def blacklisted_ip?
+        ->(mail_server) { configuration.blacklisted_mx_ip_addresses.include?(mail_server) }
+      end
+    end
+  end
+end

data/lib/truemail/validate/smtp.rb

@@ -13,7 +13,7 @@ module Truemail
       end
 
       def run
-        return false unless Truemail::Validate::Mx.check(result)
+        return false unless Truemail::Validate::MxBlacklist.check(result)
         establish_smtp_connection
         return true if success(success_response?)
         result.smtp_debug = smtp_results

data/lib/truemail/validator.rb

@@ -3,7 +3,7 @@
 module Truemail
   class Validator < Truemail::Executor
     RESULT_ATTRS = %i[success email domain mail_servers errors smtp_debug configuration].freeze
-    VALIDATION_TYPES = %i[regex mx smtp].freeze
+    VALIDATION_TYPES = %i[regex mx mx_blacklist smtp].freeze
 
     Result = ::Struct.new(*RESULT_ATTRS, keyword_init: true) do
       def initialize(mail_servers: [], errors: {}, **args)
@@ -27,7 +27,7 @@ module Truemail
 
     def run
       Truemail::Validate::DomainListMatch.check(result)
-      result_not_changed? ? Truemail::Validate.const_get(validation_type.capitalize).check(result) : update_validation_type
+      result_not_changed? ? Truemail::Validate.const_get(constantize(validation_type)).check(result) : update_validation_type
       logger&.push(self)
       self
     end
@@ -43,6 +43,10 @@ module Truemail
       result.configuration.validation_type_by_domain[domain] || current_validation_type
     end
 
+    def constantize(symbol)
+      symbol.capitalize.to_s.gsub(/_[a-z]/, &:upcase).tr('_', '').to_sym
+    end
+
     def update_validation_type
       @validation_type = result.success ? :whitelist : :blacklist
     end

data/lib/truemail/version.rb

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

data/truemail.gemspec

@@ -11,7 +11,7 @@ Gem::Specification.new do |spec|
   spec.email         = ['admin@bestweb.com.ua']
 
   spec.summary       = %(truemail)
-  spec.description   = %(Configurable framework agnostic plain Ruby email validator. Verify email via Regex, DNS and SMTP.)
+  spec.description   = %(Configurable framework agnostic plain Ruby email validator. Verify email via Regex, DNS, SMTP and even more.)
 
   spec.homepage      = 'https://github.com/truemail-rb/truemail'
   spec.license       = 'MIT'
@@ -42,11 +42,11 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'overcommit', '~> 0.57.0'
   spec.add_development_dependency 'pry-byebug', '~> 3.9'
   spec.add_development_dependency 'rake', '~> 13.0', '>= 13.0.3'
-  spec.add_development_dependency 'reek', '~> 6.0', '>= 6.0.3'
+  spec.add_development_dependency 'reek', '~> 6.0', '>= 6.0.4'
   spec.add_development_dependency 'rspec', '~> 3.10'
-  spec.add_development_dependency 'rubocop', '~> 1.12', '>= 1.12.1'
-  spec.add_development_dependency 'rubocop-performance', '~> 1.10', '>= 1.10.2'
-  spec.add_development_dependency 'rubocop-rspec', '~> 2.2'
+  spec.add_development_dependency 'rubocop', '~> 1.13'
+  spec.add_development_dependency 'rubocop-performance', '~> 1.11'
+  spec.add_development_dependency 'rubocop-rspec', '~> 2.3'
   spec.add_development_dependency 'simplecov', '~> 0.17.1'
   spec.add_development_dependency 'truemail-rspec', '~> 0.4'
   spec.add_development_dependency 'webmock', '~> 3.12', '>= 3.12.2'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: truemail
 version: !ruby/object:Gem::Version
-  version: 2.3.4
+  version: 2.4.0
 platform: ruby
 authors:
 - Vladislav Trotsenko
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-04-16 00:00:00.000000000 Z
+date: 2021-04-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: simpleidn
@@ -171,7 +171,7 @@ dependencies:
         version: '6.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 6.0.3
+        version: 6.0.4
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -181,7 +181,7 @@ dependencies:
         version: '6.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 6.0.3
+        version: 6.0.4
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -202,54 +202,42 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.12'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.12.1
+        version: '1.13'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.12'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.12.1
+        version: '1.13'
 - !ruby/object:Gem::Dependency
   name: rubocop-performance
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.10'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.10.2
+        version: '1.11'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.10'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.10.2
+        version: '1.11'
 - !ruby/object:Gem::Dependency
   name: rubocop-rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.2'
+        version: '2.3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.2'
+        version: '2.3'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -299,7 +287,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 3.12.2
 description: Configurable framework agnostic plain Ruby email validator. Verify email
-  via Regex, DNS and SMTP.
+  via Regex, DNS, SMTP and even more.
 email:
 - admin@bestweb.com.ua
 executables: []
@@ -353,6 +341,7 @@ files:
 - lib/truemail/validate/base.rb
 - lib/truemail/validate/domain_list_match.rb
 - lib/truemail/validate/mx.rb
+- lib/truemail/validate/mx_blacklist.rb
 - lib/truemail/validate/regex.rb
 - lib/truemail/validate/smtp.rb
 - lib/truemail/validate/smtp/request.rb