truemail 1.6.1 → 1.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 31b9d354c841d370094f66ba22e481aded3501b0b17206b61eeb1c768d756ea1
-  data.tar.gz: dbe57fe9cdc4763b4fc60c75aaf313aa1dd4ddff2cb5f60c1af9b3a6caddb659
+  metadata.gz: eb8cb5fec7b8a099bb4861bf2e07d72236d93a22c1dfd79eaef2c722d9160765
+  data.tar.gz: 05174034b4c4f493cd43c0d2dbb2380972bd6ee884f75592bde43300efc33e28
 SHA512:
-  metadata.gz: 3e319f8eeaadba558bc79173fb5765c615c0b67112d49b45eeaee07b3c3f496019eb89ebb95f736c0413eb08d0e7b1b1b6579389bd02e13c33464eefef8aaa82
-  data.tar.gz: 4093fc875a8363d7fe7211c0d1e698ac081c80ff63e8a01e3fc7bef913a65b71743afbc47f0de7eaa4d203f32e3560b40336b5d311b48449dde6542c9c8e9164
+  metadata.gz: cd660c9f167bdd910788d66eca957c7332917ce8fa1e5a1dca807efa2c256f7b0feb5c6fdecd43321afd0eb50b27f3c8d768f796e3ca1bb3c2173f1565aac58f
+  data.tar.gz: 78eefc8c3737e5f878fcb6bf18ddba001e555b230ff02b422b0b1d77002c4834dda2924e38f660f340fec4438af3967b81ae9e095e00fe5a213c13a5d256f30a

data/.reek.yml

@@ -26,6 +26,7 @@ detectors:
   Attribute:
     exclude:
       - Truemail::Configuration#whitelist_validation
+      - Truemail::Configuration#not_rfc_mx_lookup_flow
       - Truemail::Configuration#smtp_safe_check
       - Truemail::Wrapper#attempts
 

data/CHANGELOG.md

@@ -1,8 +1,33 @@
 # Changelog
 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).
 
+## [1.7.0] - 2020.05.09
+
+## Added
+
+- Possibility to use not RFC MX lookup flow (MX and Null MX records will be checked on the DNS validation layer only)
+
+```ruby
+Truemail.configure do |config|
+  # 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.
+  config.not_rfc_mx_lookup_flow = true
+end
+```
+
+### Changed
+
+- `Truemail.configuration`
+- `Truemail::Validate::Mx`
+- `Truemail::VERSION`
+- gem development dependencies
+- gem documentation
+
 ## [1.6.1] - 2020.03.23
+
 ### Changed
+
 - `Truemail.configuration`
 - `Truemail::ArgumentError`
 - `Truemail::Audit::Ptr`
@@ -11,26 +36,35 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 - gem documentation
 
 ### Removed
+
 `Truemail::Configuration.retry_count` deprecated, and alias for this method has been removed. Please use `Truemail::Configuration.connection_attempts` instead.
 
 ## [1.6.0] - 2020-02-01
+
 ### Added
+
 - Possibility to use `Truemail::Validator` instance represented as json directly
 
 ### Changed
+
 - gem development dependencies
 - gem documentation
 
 ## [1.5.1] - 2020-01-20
+
 ### Changed
+
 - gem development dependencies
 - gem documentation
 
 ## [1.5.0] - 2019-12-29
+
 ### Added
+
 - Supporting of internationalized emails ([EAI](https://en.wikipedia.org/wiki/International_email)). Now you can validate emails, like: `dörte@sörensen.de`, `квіточка@пошта.укр`, `alegría@mañana.es`
 
 ### Changed
+
 - `Truemail::RegexConstant::REGEX_DOMAIN`
 - `Truemail::RegexConstant::REGEX_EMAIL_PATTERN`
 - `Truemail::Validator::Result`
@@ -42,22 +76,29 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 - linters configs
 
 ## [1.4.2] - 2019-11-27
+
 ### Changed
+
 - `Truemail::Configuration`
 - gem development dependencies
 - linters configs
 
 ## [1.4.1] - 2019-11-20
+
 ### Changed
+
 - gem development dependencies
 - gem documentation
 - linters configs
 
 ### Removed
+
 - truemail rspec helpers (moved to independent gem [`truemail-rspec`](https://github.com/truemail-rb/truemail-rspec))
 
 ## [1.4.0] - 2019-10-28
+
 ### Added
+
 - Event logger (ability to output validation logs to stdout/file)
 - JSON serializer for validator instance
 - [Changelog](CHANGELOG.md)
@@ -85,6 +126,7 @@ Truemail::Log::Serializer::Json.call(Truemail.validate('nonexistent_email@bestwe
 ```
 
 ### Changed
+
 - `Truemail::Configuration`
 - `Truemail::Validator`
 - `Truemail::Validate::Regex`
@@ -93,11 +135,14 @@ Truemail::Log::Serializer::Json.call(Truemail.validate('nonexistent_email@bestwe
 - gem description
 
 ## [1.3.0] - 2019-09-16
+
 ### Added
+
 - Ability to create new `Truemail::Configuration` instance with block
 - `Truemail::Validate::Smtp::Request::Configuration`
 
 ### Changed
+
 - `Truemail::Wrapper`
 - `Truemail::Validate::Base`
 - `Truemail::Validator`
@@ -115,15 +160,20 @@ Truemail::Log::Serializer::Json.call(Truemail.validate('nonexistent_email@bestwe
 - gem description
 
 ## [1.2.1] - 2019-06-27
+
 ### Fixed
+
 - Removed memoization from ```DomainListMatch#whitelisted_domain?```
 
 ### Changed
+
 - `Truemail::VERSION`
 - gem documentation
 
 ## [1.2.0] - 2019-06-26
+
 ### Added
+
 - Configurable option: validation for whitelisted domains only.
 
 When email domain in whitelist and ```whitelist_validation``` is sets equal to ```true``` validation type will be passed to other validators. Validation of email which not contains whitelisted domain always will return ```false```.
@@ -168,11 +218,14 @@ Truemail.validate('email@domain.com', with: :regex)
 ```
 
 ### Changed
+
 - `Truemail::VERSION`
 - gem documentation
 
 ## [1.1.0] - 2019-06-18
+
 ### Added
+
 - Configurable default validation type, [issue details](https://github.com/rubygarage/truemail/issues/48)
 
 You can predefine default validation type for ```Truemail.validate('email@email.com')``` call without with-parameter. Available validation types: ```:regex```, ```:mx```, ```:smtp```. By default validation type still remains ```:smtp```
@@ -185,11 +238,14 @@ end
 ```
 
 ### Changed
+
 - `Truemail::VERSION`
 - gem documentation
 
 ## [1.0.1] - 2019-06-08
+
 ### Added
+
 - Result validation type marker for domain list match check
 
 ```ruby
@@ -219,11 +275,14 @@ Truemail.validate('email@black-domain.com')
 ```
 
 ### Changed
+
 - `Truemail::VERSION`
 - gem documentation
 
 ## [1.0] - 2019-06-04
+
 ### Added
+
 - Feature domain whitelist blacklist. Other validations will not processed even if it was defined in ```validation_type_for```.
 
 ```ruby
@@ -237,6 +296,7 @@ Truemail.configure do |config|
   config.blacklisted_domains = ['somedomain1.com', 'somedomain2.com']
 end
 ```
+
 and
 
 ```ruby
@@ -245,17 +305,22 @@ Truemail.configuration.blacklisted_domains = ['somedomain1.com', 'somedomain2.co
 ```
 
 ### Removed
+
 - ```:skip``` validation type for ```validation_type_for```
 
 ### Fixed
+
 - error key in `lower_snake_case`
 
 ### Changed
+
 - `Truemail::VERSION`
 - gem documentation
 
 ## [0.2] - 2019-05-23
+
 ### Added
+
 - skip validation by domain for validation_type_for configuration option:
 
 ```ruby
@@ -263,68 +328,93 @@ Truemail.configure do |config|
   config.validation_type_for = { 'somedomain.com' => :skip }
 end
 ```
+
 and
+
 ```ruby
 Truemail.configuration.validation_type_for = { 'somedomain.com' => :skip }
 ```
+
 ### Changed
+
 - `Truemail::VERSION`
 - gem documentation
 
 ## [0.1.10] - 2019-05-10
+
 ### Added
+
 - SMTP error body configurable option, [issue details](https://github.com/rubygarage/truemail/issues/19)
 
 ### Changed
+
 - `Truemail::VERSION`
 - gem documentation
 
 ## [0.1.9] - 2019-04-29
+
 ### Fixed
+
 - Empty ptr constant
 
 ## [0.1.8] - 2019-04-29
+
 ### Added
+
 - Reverse trace, [issue details](https://github.com/rubygarage/truemail/issues/18)
 
 ### Fixed
+
 - Behaviour of current host address resolver, [issue details](https://github.com/rubygarage/truemail/issues/18)
 
 ### Changed
+
 - `Truemail::VERSION`
 - gem documentation
 
 ## [0.1.7] - 2019-04-17
+
 ### Added
+
 - PTR record audit, [issue details](https://github.com/rubygarage/truemail/issues/18)
 
 ### Changed
+
 - `Truemail::VERSION`
 - gem documentation
 
 ## [0.1.6] - 2019-04-08
+
 ### Added
+
 - MX gem logic with [RFC 7505](https://tools.ietf.org/html/rfc7505), null MX record supporting, [issue details](https://github.com/rubygarage/truemail/issues/27)
 - [Contributing guideline](CONTRIBUTING.md)
 
 ### Fixed
+
 - Multihomed MX records supporting, [issue details](https://github.com/rubygarage/truemail/issues/28)
 
 ### Changed
+
 - `Truemail::VERSION`
 - gem documentation
 
 ## [0.1.5] - 2019-04-05
+
 ### Added
+
 - Retries for ```Truemail::Validate::Smtp``` for cases when one mx server
 
 ### Changed
+
 - ```Truemail::Configuration``` class, please use ```.connection_attempts``` instead ```.retry_count```
 - `Truemail::VERSION`
 - gem documentation
 
 ## [0.1.4] - 2019-04-01
+
 ### Added
+
 - Checking A record presence if ```MX``` and ```CNAME``` records not exist, [issue details](https://github.com/rubygarage/truemail/issues/10)
 - Handling of ```CNAME``` records, [issue details](https://github.com/rubygarage/truemail/issues/11)
 - Checking A record if ```MX``` and ```CNAME``` records not found, [issue details](https://github.com/rubygarage/truemail/issues/12)
@@ -333,14 +423,18 @@ Truemail.configuration.validation_type_for = { 'somedomain.com' => :skip }
 - ```.valid?``` helper
 
 ### Changed
+
 - `Truemail::VERSION`
 - gem documentation
 
 ## [0.1.3] - 2019-03-27
+
 ### Added
+
 - Independent domain name extractor to ```Truemail::Validate::Mx#run```
 
 ### Fixed
+
 - Default ```REGEX_EMAIL_PATTERN```, [issue details](https://github.com/rubygarage/truemail/issues/7)
   * local part of address can't start with a dot or special symbol
   * local part of address can include ```+``` symbol
@@ -349,11 +443,14 @@ Truemail.configuration.validation_type_for = { 'somedomain.com' => :skip }
 - Case sensitive domain names, [issue details](https://github.com/rubygarage/truemail/issues/9)
 
 ### Changed
+
 - `Truemail::VERSION`
 - gem documentation
 
 ## [0.1.0] - 2019-03-26
+
 ### Added
+
 - 'SMTP safe check' option for cases when SMTP server does not return an exact answer that the email does not exist.
 
 ```ruby
@@ -401,5 +498,6 @@ Truemail.validate('email@example.com')
 ```
 
 ### Changed
+
 - `Truemail::VERSION`
 - gem documentation

data/Gemfile.lock

@@ -1,39 +1,27 @@
 PATH
   remote: .
   specs:
-    truemail (1.6.1)
+    truemail (1.7.0)
       simpleidn (~> 0.1.1)
 
 GEM
   remote: https://rubygems.org/
   specs:
     ast (2.4.0)
-    axiom-types (0.1.1)
-      descendants_tracker (~> 0.0.4)
-      ice_nine (~> 0.11.0)
-      thread_safe (~> 0.3, >= 0.3.1)
     bundler-audit (0.6.1)
       bundler (>= 1.2.0, < 3)
       thor (~> 0.18)
-    byebug (11.1.1)
+    byebug (11.1.3)
     childprocess (3.0.0)
-    codeclimate-engine-rb (0.4.1)
-      virtus (~> 1.0)
     coderay (1.1.2)
-    coercible (1.0.0)
-      descendants_tracker (~> 0.0.1)
     colorize (0.8.1)
-    descendants_tracker (0.0.4)
-      thread_safe (~> 0.3, >= 0.3.1)
     diff-lcs (1.3)
     docile (1.3.2)
-    equalizer (0.0.11)
-    fasterer (0.8.2)
+    fasterer (0.8.3)
       colorize (~> 0.7)
       ruby_parser (>= 3.14.1)
     ffaker (2.14.0)
-    ice_nine (0.11.2)
-    iniparse (1.4.4)
+    iniparse (1.5.0)
     jaro_winkler (1.5.4)
     json (2.3.0)
     json_matchers (0.11.1)
@@ -41,13 +29,13 @@ GEM
     json_schema (0.20.8)
     kwalify (0.7.2)
     method_source (1.0.0)
-    overcommit (0.52.1)
+    overcommit (0.53.0)
       childprocess (>= 0.6.3, < 4)
       iniparse (~> 1.4)
     parallel (1.19.1)
-    parser (2.7.0.2)
+    parser (2.7.1.2)
       ast (~> 2.4.0)
-    pry (0.13.0)
+    pry (0.13.1)
       coderay (~> 1.1)
       method_source (~> 1.0)
     pry-byebug (3.9.0)
@@ -56,8 +44,7 @@ GEM
     psych (3.1.0)
     rainbow (3.0.0)
     rake (13.0.1)
-    reek (5.6.0)
-      codeclimate-engine-rb (~> 0.4.0)
+    reek (6.0.0)
       kwalify (~> 0.7.0)
       parser (>= 2.5.0.0, < 2.8, != 2.5.1.1)
       psych (~> 3.1.0)
@@ -66,15 +53,15 @@ GEM
       rspec-core (~> 3.9.0)
       rspec-expectations (~> 3.9.0)
       rspec-mocks (~> 3.9.0)
-    rspec-core (3.9.1)
-      rspec-support (~> 3.9.1)
-    rspec-expectations (3.9.0)
+    rspec-core (3.9.2)
+      rspec-support (~> 3.9.3)
+    rspec-expectations (3.9.2)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.9.0)
     rspec-mocks (3.9.1)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.9.0)
-    rspec-support (3.9.2)
+    rspec-support (3.9.3)
     rubocop (0.79.0)
       jaro_winkler (~> 1.5.1)
       parallel (~> 1.10)
@@ -84,7 +71,7 @@ GEM
       unicode-display_width (>= 1.4.0, < 1.7)
     rubocop-performance (1.5.2)
       rubocop (>= 0.71.0)
-    rubocop-rspec (1.37.1)
+    rubocop-rspec (1.39.0)
       rubocop (>= 0.68.1)
     ruby-progressbar (1.10.1)
     ruby_parser (3.14.2)
@@ -98,19 +85,13 @@ GEM
     simpleidn (0.1.1)
       unf (~> 0.1.4)
     thor (0.20.3)
-    thread_safe (0.3.6)
-    truemail-rspec (0.1.1)
-      rspec (~> 3.0)
+    truemail-rspec (0.1.2)
+      rspec (~> 3.9)
       truemail (~> 1.4, >= 1.4.1)
     unf (0.1.4)
       unf_ext
-    unf_ext (0.0.7.6)
+    unf_ext (0.0.7.7)
     unicode-display_width (1.6.1)
-    virtus (1.0.5)
-      axiom-types (~> 0.1)
-      coercible (~> 1.0)
-      descendants_tracker (~> 0.0, >= 0.0.3)
-      equalizer (~> 0.0, >= 0.0.9)
 
 PLATFORMS
   ruby
@@ -118,20 +99,20 @@ PLATFORMS
 DEPENDENCIES
   bundler (~> 1.16)
   bundler-audit (~> 0.6.1)
-  fasterer (~> 0.8.2)
+  fasterer (~> 0.8.3)
   ffaker (~> 2.14)
   json_matchers (~> 0.11.1)
-  overcommit (~> 0.52.1)
+  overcommit (~> 0.53.0)
   pry-byebug (~> 3.9)
   rake (~> 13.0, >= 13.0.1)
-  reek (~> 5.6)
+  reek (~> 6.0)
   rspec (~> 3.9)
   rubocop (~> 0.79.0)
   rubocop-performance (~> 1.5, >= 1.5.2)
-  rubocop-rspec (~> 1.37, >= 1.37.1)
+  rubocop-rspec (~> 1.39)
   simplecov (~> 0.17.1)
   truemail!
-  truemail-rspec (~> 0.1.1)
+  truemail-rspec (~> 0.1.2)
 
 BUNDLED WITH
    1.16.6

data/README.md

@@ -8,6 +8,7 @@ Configurable framework agnostic plain Ruby email validator. Verify email via Reg
 
 - [Synopsis](#synopsis)
 - [Features](#features)
+- [Requirements](#requirements)
 - [Installation](#installation)
 - [Usage](#usage)
   - [Configuration features](#configuration-features)
@@ -26,6 +27,8 @@ Configurable framework agnostic plain Ruby email validator. Verify email via Reg
       - [With default regex pattern](#with-default-regex-pattern)
       - [With custom regex pattern](#with-custom-regex-pattern)
     - [DNS (MX) validation](#mx-validation)
+      - [RFC MX lookup flow](#rfc-mx-lookup-flow)
+      - [Not RFC MX lookup flow](#not-rfc-mx-lookup-flow)
     - [SMTP validation](#smtp-validation)
       - [SMTP safe check disabled](#smtp-safe-check-disabled)
       - [SMTP safe check enabled](#smtp-safe-check-enabled)
@@ -69,6 +72,10 @@ Also Truemail gem allows performing an audit of the host in which runs.
 - Event logger
 - JSON serializer
 
+## Requirements
+
+Ruby MRI 2.5.0+
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -79,11 +86,15 @@ gem 'truemail'
 
 And then execute:
 
-    $ bundle
+```bash
+bundle
+```
 
 Or install it yourself as:
 
-    $ gem install truemail
+```bash
+gem install truemail
+```
 
 ## Usage
 
@@ -168,6 +179,11 @@ 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 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.
+  config.not_rfc_mx_lookup_flow = true
+
   # Optional parameter. This option will be parse bodies of SMTP errors. It will be helpful
   # if SMTP server does not return an exact answer that the email does not exist
   # By default this option is disabled, available for SMTP validation only.
@@ -198,7 +214,8 @@ Truemail.configuration
  @whitelist_validation=true,
  @blacklisted_domains=[],
  @verifier_domain="somedomain.com",
- @verifier_email="verifier@example.com"
+ @verifier_email="verifier@example.com",
+ @not_rfc_mx_lookup_flow=true,
  @smtp_safe_check=true,
  @logger=#<Truemail::Logger:0x0000557f837450b0
    @event=:all, @file="/home/app/log/truemail.log", @stdout=true>>
@@ -227,6 +244,7 @@ Truemail.configuration
  @blacklisted_domains=[],
  @verifier_domain="somedomain.com",
  @verifier_email="verifier@example.com",
+ @not_rfc_mx_lookup_flow=true,
  @smtp_safe_check=true,
  @logger=#<Truemail::Logger:0x0000557f837450b0
    @event=:all, @file="/home/app/log/truemail.log", @stdout=true>>
@@ -309,6 +327,7 @@ Truemail.validate('email@white-domain.com')
      @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)/,
      @response_timeout=2,
      @smtp_error_body_pattern=/(?=.*550)(?=.*(user|account|customer|mailbox)).*/i,
+     @not_rfc_mx_lookup_flow=false,
      @smtp_safe_check=false,
      @validation_type_by_domain={"somedomain.com"=>:mx},
      @verifier_domain="example.com",
@@ -355,6 +374,7 @@ Truemail.validate('email@white-domain.com', with: :regex)
      @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)/,
      @response_timeout=2,
      @smtp_error_body_pattern=/(?=.*550)(?=.*(user|account|customer|mailbox)).*/i,
+     @not_rfc_mx_lookup_flow=false,
      @smtp_safe_check=false,
      @validation_type_by_domain={},
      @verifier_domain="example.com",
@@ -386,6 +406,7 @@ Truemail.validate('email@domain.com', with: :regex)
      @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)/,
      @response_timeout=2,
      @smtp_error_body_pattern=/(?=.*550)(?=.*(user|account|customer|mailbox)).*/i,
+     @not_rfc_mx_lookup_flow=false,
      @smtp_safe_check=false,
      @validation_type_by_domain={},
      @verifier_domain="example.com",
@@ -419,6 +440,7 @@ Truemail.validate('email@black-domain.com')
      @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)/,
      @response_timeout=2,
      @smtp_error_body_pattern=/(?=.*550)(?=.*(user|account|customer|mailbox)).*/i,
+     @not_rfc_mx_lookup_flow=false,
      @smtp_safe_check=false,
      @validation_type_by_domain={},
      @verifier_domain="example.com",
@@ -452,6 +474,7 @@ Truemail.validate('email@somedomain.com')
      @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)/,
      @response_timeout=2,
      @smtp_error_body_pattern=/(?=.*550)(?=.*(user|account|customer|mailbox)).*/i,
+     @not_rfc_mx_lookup_flow=false,
      @smtp_safe_check=false,
      @validation_type_by_domain={},
      @verifier_domain="example.com",
@@ -501,6 +524,7 @@ Truemail.validate('email@example.com', with: :regex)
        @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)/,
        @response_timeout=2,
        @smtp_error_body_pattern=/(?=.*550)(?=.*(user|account|customer|mailbox)).*/i,
+       @not_rfc_mx_lookup_flow=false,
        @smtp_safe_check=false,
        @validation_type_by_domain={},
        @verifier_domain="example.com",
@@ -542,6 +566,7 @@ Truemail.validate('email@example.com', with: :regex)
        @email_pattern=/regex_pattern/,
        @response_timeout=2,
        @smtp_error_body_pattern=/(?=.*550)(?=.*(user|account|customer|mailbox)).*/i,
+       @not_rfc_mx_lookup_flow=false,
        @smtp_safe_check=false,
        @validation_type_by_domain={},
        @verifier_domain="example.com",
@@ -559,7 +584,11 @@ In fact it's DNS validation because it checks not MX records only. DNS validatio
 [Whitelist/Blacklist] -> [Regex validation] -> [MX validation]
 ```
 
-Please note, Truemail MX validator not performs strict compliance of the [RFC 5321](https://tools.ietf.org/html/rfc5321#section-5) standard for best validation outcome.
+Please note, Truemail MX validator [not performs](https://github.com/rubygarage/truemail/issues/26) strict compliance of the [RFC 5321](https://tools.ietf.org/html/rfc5321#section-5) standard for best validation outcome.
+
+##### RFC MX lookup flow
+
+[Truemail MX lookup](https://slides.com/vladislavtrotsenko/truemail#/0/9) based on RFC 5321. It consists of 3 substeps: MX, CNAME and A record resolvers. The point of each resolver is attempt to extract the mail servers from email domain. If at least one server exists that validation is successful. Iteration is processing until resolver returns true.
 
 Example of usage:
 
@@ -590,6 +619,51 @@ Truemail.validate('email@example.com', with: :mx)
        @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)/,
        @response_timeout=2,
        @smtp_error_body_pattern=/(?=.*550)(?=.*(user|account|customer|mailbox)).*/i,
+       @not_rfc_mx_lookup_flow=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>
+```
+
+##### Not RFC MX lookup flow
+
+Also Truemail has possibility to use not RFC MX lookup flow. It means that will be used only one MX resolver on the DNS validation layer. By default this option is disabled.
+
+Example of usage:
+
+```ruby
+require 'truemail'
+
+Truemail.configure do |config|
+  config.verifier_email = 'verifier@example.com'
+  config.not_rfc_mx_lookup_flow = true
+end
+
+Truemail.validate('email@example.com', with: :mx)
+
+=> #<Truemail::Validator:0x000055590c9c1c50
+  @result=
+    #<struct Truemail::Validator::Result
+      success=true,
+      email="email@example.com",
+      domain="example.com",
+      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([\p{L}0-9]+[\w|\-|\.|\+]*)@((?i-mx:[\p{L}0-9]+([\-\.]{1}[\p{L}0-9]+)*\.[\p{L}]{2,63}))\z)/,
+       @response_timeout=2,
+       @smtp_error_body_pattern=/(?=.*550)(?=.*(user|account|customer|mailbox)).*/i,
+       @not_rfc_mx_lookup_flow=true,
        @smtp_safe_check=false,
        @validation_type_by_domain={},
        @verifier_domain="example.com",
@@ -611,7 +685,7 @@ If total count of MX servers is equal to one, ```Truemail::Smtp``` validator wil
 
 By default, you don't need pass with-parameter to use it. Example of usage is specified below:
 
-###### SMTP safe check disabled
+##### SMTP safe check disabled
 
 With ```smtp_safe_check = false```
 
@@ -643,6 +717,7 @@ Truemail.validate('email@example.com')
        @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)/,
        @response_timeout=2,
        @smtp_error_body_pattern=/(?=.*550)(?=.*(user|account|customer|mailbox)).*/i,
+       @not_rfc_mx_lookup_flow=false,
        @smtp_safe_check=false,
        @validation_type_by_domain={},
        @verifier_domain="example.com",
@@ -694,6 +769,7 @@ Truemail.validate('email@example.com')
              @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)/,
              @response_timeout=2,
              @smtp_error_body_pattern=/(?=.*550)(?=.*(user|account|customer|mailbox)).*/i,
+             @not_rfc_mx_lookup_flow=false,
              @smtp_safe_check=false,
              @validation_type_by_domain={},
              @verifier_domain="example.com",
@@ -703,8 +779,7 @@ Truemail.validate('email@example.com')
     @validation_type=:smtp>
 ```
 
-
-###### SMTP safe check enabled
+##### SMTP safe check enabled
 
 With ```smtp_safe_check = true```
 
@@ -758,6 +833,7 @@ Truemail.validate('email@example.com')
              @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)/,
              @response_timeout=2,
              @smtp_error_body_pattern=/(?=.*550)(?=.*(user|account|customer|mailbox)).*/i,
+             @not_rfc_mx_lookup_flow=false,
              @smtp_safe_check=false,
              @validation_type_by_domain={},
              @verifier_domain="example.com",
@@ -806,6 +882,7 @@ Truemail.validate('email@example.com')
              @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)/,
              @response_timeout=2,
              @smtp_error_body_pattern=/(?=.*550)(?=.*(user|account|customer|mailbox)).*/i,
+             @not_rfc_mx_lookup_flow=false,
              @smtp_safe_check=false,
              @validation_type_by_domain={},
              @verifier_domain="example.com",
@@ -895,6 +972,7 @@ Truemail.host_audit
          @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)/,
          @response_timeout=2,
          @smtp_error_body_pattern=/(?=.*550)(?=.*(user|account|customer|mailbox)).*/i,
+         @not_rfc_mx_lookup_flow=false,
          @smtp_safe_check=false,
          @validation_type_by_domain={},
          @verifier_domain="example.com",
@@ -917,6 +995,7 @@ Truemail.host_audit
          @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)/,
          @response_timeout=2,
          @smtp_error_body_pattern=/(?=.*550)(?=.*(user|account|customer|mailbox)).*/i,
+         @not_rfc_mx_lookup_flow=false,
          @smtp_safe_check=false,
          @validation_type_by_domain={},
          @verifier_domain="example.com",
@@ -1008,21 +1087,18 @@ end
 ```
 
 ---
+
 ## Truemail family
 
 All Truemail extensions: https://github.com/truemail-rb
 
-### truemail server
-
-Lightweight rack based web API wrapper for Truemail, https://github.com/truemail-rb/truemail-rack
-
-### truemail-rack-docker-image
-
-Lightweight rack based web API dockerized image :whale: of [Truemail server](https://github.com/truemail-rb/truemail-rack) hosted on [dockerhub](https://hub.docker.com/r/truemail/truemail-rack), https://github.com/truemail-rb/truemail-rack-docker-image
-
-### truemail-rspec
-
-gem `truemail-rspec` - Truemail configuration and validator RSpec helpers, https://github.com/truemail-rb/truemail-rspec
+| Name | Type | Description |
+| --- | --- | --- |
+| [truemail server](https://github.com/truemail-rb/truemail-rack) | ruby app | Lightweight rack based web API wrapper for Truemail |
+| [truemail-rack-docker](https://github.com/truemail-rb/truemail-rack-docker-image) | docker image | Lightweight rack based web API [dockerized image](https://hub.docker.com/r/truemail/truemail-rack) :whale: of Truemail server |
+| [truemail-ruby-client](https://github.com/truemail-rb/truemail-ruby-client) | ruby gem | Truemail web API client library for Ruby |
+| [truemail-crystal-client](https://github.com/truemail-rb/truemail-crystal-client) | crystal shard | Truemail web API client library for Crystal |
+| [truemail-rspec](https://github.com/truemail-rb/truemail-rspec) | ruby gem | Truemail configuration and validator RSpec helpers |
 
 ## Contributing
 

data/lib/truemail/configuration.rb

@@ -20,7 +20,7 @@ module Truemail
                 :blacklisted_domains,
                 :logger
 
-    attr_accessor :whitelist_validation, :smtp_safe_check
+    attr_accessor :whitelist_validation, :not_rfc_mx_lookup_flow, :smtp_safe_check
 
     def initialize(&block)
       instance_initializer.each do |instace_variable, value|
@@ -99,6 +99,7 @@ module Truemail
         whitelisted_domains: [],
         whitelist_validation: false,
         blacklisted_domains: [],
+        not_rfc_mx_lookup_flow: false,
         smtp_safe_check: false
       }
     end

data/lib/truemail/validate/mx.rb

@@ -19,6 +19,7 @@ module Truemail
       private
 
       def host_extractor_methods
+        return %i[hosts_from_mx_records?] if configuration.not_rfc_mx_lookup_flow
         %i[hosts_from_mx_records? hosts_from_cname_records? host_from_a_record?]
       end
 

data/lib/truemail/version.rb

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

data/truemail.gemspec

@@ -27,17 +27,17 @@ Gem::Specification.new do |spec|
 
   spec.add_development_dependency 'bundler', '~> 1.16'
   spec.add_development_dependency 'bundler-audit', '~> 0.6.1'
-  spec.add_development_dependency 'fasterer', '~> 0.8.2'
+  spec.add_development_dependency 'fasterer', '~> 0.8.3'
   spec.add_development_dependency 'ffaker', '~> 2.14'
   spec.add_development_dependency 'json_matchers', '~> 0.11.1'
-  spec.add_development_dependency 'overcommit', '~> 0.52.1'
+  spec.add_development_dependency 'overcommit', '~> 0.53.0'
   spec.add_development_dependency 'pry-byebug', '~> 3.9'
   spec.add_development_dependency 'rake', '~> 13.0', '>= 13.0.1'
-  spec.add_development_dependency 'reek', '~> 5.6'
+  spec.add_development_dependency 'reek', '~> 6.0'
   spec.add_development_dependency 'rspec', '~> 3.9'
   spec.add_development_dependency 'rubocop', '~> 0.79.0'
   spec.add_development_dependency 'rubocop-performance', '~> 1.5', '>= 1.5.2'
-  spec.add_development_dependency 'rubocop-rspec', '~> 1.37', '>= 1.37.1'
+  spec.add_development_dependency 'rubocop-rspec', '~> 1.39'
   spec.add_development_dependency 'simplecov', '~> 0.17.1'
-  spec.add_development_dependency 'truemail-rspec', '~> 0.1.1'
+  spec.add_development_dependency 'truemail-rspec', '~> 0.1.2'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: truemail
 version: !ruby/object:Gem::Version
-  version: 1.6.1
+  version: 1.7.0
 platform: ruby
 authors:
 - Vladislav Trotsenko
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-03-23 00:00:00.000000000 Z
+date: 2020-05-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: simpleidn
@@ -58,14 +58,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.8.2
+        version: 0.8.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.8.2
+        version: 0.8.3
 - !ruby/object:Gem::Dependency
   name: ffaker
   requirement: !ruby/object:Gem::Requirement
@@ -100,14 +100,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.52.1
+        version: 0.53.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.52.1
+        version: 0.53.0
 - !ruby/object:Gem::Dependency
   name: pry-byebug
   requirement: !ruby/object:Gem::Requirement
@@ -148,14 +148,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.6'
+        version: '6.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.6'
+        version: '6.0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -210,20 +210,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.37'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.37.1
+        version: '1.39'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.37'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.37.1
+        version: '1.39'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -244,14 +238,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.1
+        version: 0.1.2
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.1
+        version: 0.1.2
 description: Configurable framework agnostic plain Ruby email validator. Verify email
   via Regex, DNS and SMTP.
 email: