truemail 1.5.1 → 1.8.0

data/Gemfile.lock

@@ -1,63 +1,50 @@
 PATH
   remote: .
   specs:
-    truemail (1.5.1)
+    truemail (1.8.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.0)
+    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.1)
+    fasterer (0.8.3)
       colorize (~> 0.7)
       ruby_parser (>= 3.14.1)
-    ffaker (2.13.0)
-    ice_nine (0.11.2)
-    iniparse (1.4.4)
+    ffaker (2.14.0)
+    iniparse (1.5.0)
     jaro_winkler (1.5.4)
     json (2.3.0)
     json_matchers (0.11.1)
       json_schema
     json_schema (0.20.8)
     kwalify (0.7.2)
-    method_source (0.9.2)
-    overcommit (0.52.1)
+    method_source (1.0.0)
+    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.12.2)
-      coderay (~> 1.1.0)
-      method_source (~> 0.9.0)
-    pry-byebug (3.7.0)
+    pry (0.13.1)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    pry-byebug (3.9.0)
       byebug (~> 11.0)
-      pry (~> 0.10)
+      pry (~> 0.13.0)
     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,12 +71,12 @@ 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.1)
+    ruby_parser (3.14.2)
       sexp_processor (~> 4.9)
-    sexp_processor (4.13.0)
+    sexp_processor (4.14.1)
     simplecov (0.17.1)
       docile (~> 1.1)
       json (>= 1.8, < 3)
@@ -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.1)
-  ffaker (~> 2.13)
+  fasterer (~> 0.8.3)
+  ffaker (~> 2.14)
   json_matchers (~> 0.11.1)
-  overcommit (~> 0.52.1)
-  pry-byebug (~> 3.7)
+  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

@@ -1,6 +1,6 @@
 # <img src='https://repository-images.githubusercontent.com/173723932/6dffee00-e88e-11e9-94b6-c97aacc0df00' height='250' alt='Truemail - configurable framework agnostic plain Ruby email validator' />
 
-[![Maintainability](https://api.codeclimate.com/v1/badges/657aa241399927dcd2e2/maintainability)](https://codeclimate.com/github/rubygarage/truemail/maintainability) [![Test Coverage](https://api.codeclimate.com/v1/badges/657aa241399927dcd2e2/test_coverage)](https://codeclimate.com/github/rubygarage/truemail/test_coverage) [![CircleCI](https://circleci.com/gh/rubygarage/truemail/tree/master.svg?style=svg)](https://circleci.com/gh/rubygarage/truemail/tree/master) [![Gem Version](https://badge.fury.io/rb/truemail.svg)](https://badge.fury.io/rb/truemail) [![Downloads](https://img.shields.io/gem/dt/truemail.svg?colorA=004d99&colorB=0073e6)](https://rubygems.org/gems/truemail) [![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-v1.4%20adopted-ff69b4.svg)](CODE_OF_CONDUCT.md)
+[![Maintainability](https://api.codeclimate.com/v1/badges/657aa241399927dcd2e2/maintainability)](https://codeclimate.com/github/rubygarage/truemail/maintainability) [![Test Coverage](https://api.codeclimate.com/v1/badges/657aa241399927dcd2e2/test_coverage)](https://codeclimate.com/github/rubygarage/truemail/test_coverage) [![CircleCI](https://circleci.com/gh/rubygarage/truemail/tree/master.svg?style=svg)](https://circleci.com/gh/rubygarage/truemail/tree/master) [![Gem Version](https://badge.fury.io/rb/truemail.svg)](https://badge.fury.io/rb/truemail) [![Downloads](https://img.shields.io/gem/dt/truemail.svg?colorA=004d99&colorB=0073e6)](https://rubygems.org/gems/truemail) [![Gitter](https://badges.gitter.im/truemail-rb/community.svg)](https://gitter.im/truemail-rb/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge) [![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-v1.4%20adopted-ff69b4.svg)](CODE_OF_CONDUCT.md)
 
 Configurable framework agnostic plain Ruby email validator. Verify email via Regex, DNS and SMTP. Be sure that email address valid and exists.
 
@@ -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)
@@ -33,9 +36,13 @@ Configurable framework agnostic plain Ruby email validator. Verify email via Reg
     - [Available tracking events](#available-tracking-events)
   - [JSON serializer](#json-serializer)
   - [Host audit features](#host-audit-features)
+    - [IP audit](#ip-audit)
+    - [DNS audit](#dns-audit)
     - [PTR audit](#ptr-audit)
+    - [Example of using](#example-of-using)
   - [Truemail helpers](#truemail-helpers)
     - [.valid?](#valid)
+    - [#as_json](#as_json)
   - [Test environment](#test-environment)
 - [Truemail family](#truemail-family)
 - [Contributing](#contributing)
@@ -66,8 +73,13 @@ Also Truemail gem allows performing an audit of the host in which runs.
 - Whitelist/blacklist validation layers
 - Simple SMTP debugger
 - Event logger
+- Host auditor tools (helps to detect common host problems interfering to proper email verification)
 - JSON serializer
 
+## Requirements
+
+Ruby MRI 2.5.0+
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -78,11 +90,15 @@ gem 'truemail'
 
 And then execute:
 
-    $ bundle
+```bash
+bundle
+```
 
 Or install it yourself as:
 
-    $ gem install truemail
+```bash
+gem install truemail
+```
 
 ## Usage
 
@@ -167,6 +183,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.
@@ -197,7 +218,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>>
@@ -226,6 +248,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>>
@@ -308,6 +331,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",
@@ -354,6 +378,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",
@@ -385,6 +410,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",
@@ -418,6 +444,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",
@@ -451,6 +478,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",
@@ -500,6 +528,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",
@@ -541,6 +570,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",
@@ -558,7 +588,54 @@ 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:
+
+```ruby
+require 'truemail'
+
+Truemail.configure do |config|
+  config.verifier_email = 'verifier@example.com'
+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=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:
 
@@ -567,6 +644,7 @@ 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)
@@ -589,6 +667,7 @@ 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=true,
        @smtp_safe_check=false,
        @validation_type_by_domain={},
        @verifier_domain="example.com",
@@ -610,7 +689,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```
 
@@ -642,6 +721,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",
@@ -693,6 +773,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",
@@ -702,8 +783,7 @@ Truemail.validate('email@example.com')
     @validation_type=:smtp>
 ```
 
-
-###### SMTP safe check enabled
+##### SMTP safe check enabled
 
 With ```smtp_safe_check = true```
 
@@ -757,6 +837,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",
@@ -805,6 +886,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",
@@ -863,6 +945,7 @@ Truemail::Log::Serializer::Json.call(Truemail.validate('nonexistent_email@bestwe
     "whitelist_validation": false,
     "whitelisted_domains": null,
     "blacklisted_domains": null,
+    "not_rfc_mx_lookup_flow": false,
     "smtp_safe_check": false,
     "email_pattern": "default gem value",
     "smtp_error_body_pattern": "default gem value"
@@ -872,18 +955,31 @@ Truemail::Log::Serializer::Json.call(Truemail.validate('nonexistent_email@bestwe
 
 ### Host audit features
 
-Truemail gem allows performing an audit of the host in which runs. Only PTR record audit performs for today.
+Truemail gem allows performing an audit of the host in which runs. It will help to detect common host problems interfering to proper email verification.
+
+#### IP audit
+
+Checks is current Truemail host has proper internet connection and detects current host ip address.
+
+#### DNS audit
+
+Checks is verifier domain refer to current Truemail host IP address.
 
 #### PTR audit
 
 So what is a PTR record? A PTR record, or pointer record, enables someone to perform a reverse DNS lookup. This allows them to determine your domain name based on your IP address. Because generic domain names without a PTR are often associated with spammers, incoming mail servers identify email from hosts without PTR records as spam and you can't verify yours emails qualitatively.
 
+Checks is PTR record exists for your Truemail host ip address exists and refers to current verifier domain.
+
+#### Example of using
+
 ```ruby
 Truemail.host_audit
 # Everything is good
 => #<Truemail::Auditor:0x00005580df358828
    @result=
      #<struct Truemail::Auditor::Result
+       current_host_ip="127.0.0.1",
        warnings={}>,
        configuration=
         #<Truemail::Configuration:0x00005615e86327a8
@@ -894,6 +990,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",
@@ -901,12 +998,15 @@ Truemail.host_audit
          @whitelist_validation=false,
          @whitelisted_domains=[]>
 
-# Has PTR warning
+# Has audit warnings
 => #<Truemail::Auditor:0x00005580df358828
    @result=
      #<struct Truemail::Auditor::Result
-       warnings=
-         {:ptr=>"ptr record does not reference to current verifier domain"}>,
+       current_host_ip="127.0.0.1",
+       warnings={
+         :dns=>"a record of verifier domain not refers to current host ip address",
+         :ptr=>"ptr record does not reference to current verifier domain"
+       },
        configuration=
         #<Truemail::Configuration:0x00005615e86327a8
          @blacklisted_domains=[],
@@ -916,6 +1016,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",
@@ -928,7 +1029,7 @@ Truemail.host_audit
 
 #### .valid?
 
-You can use the ```.valid?``` helper for quick validation of email address. It returns a boolean:
+You can use the `.valid?` helper for quick validation of email address. It returns a boolean:
 
 ```ruby
 # It is shortcut for Truemail.validate('email@example.com').result.valid?
@@ -936,6 +1037,46 @@ Truemail.valid?('email@example.com')
 => true
 ```
 
+#### #as_json
+
+You can use `#as_json` helper for represent `Truemail::Validator` instance as json. Under the hood it uses internal json serializer [`Truemail::Log::Serializer::Json`](#json-serializer):
+
+```ruby
+Truemail.validate('nonexistent_email@bestweb.com.ua').as_json
+
+=>
+# Serialized Truemail::Validator instance
+{
+  "date": "2020-05-10 10:00:00 +0200",
+  "email": "nonexistent_email@bestweb.com.ua",
+  "validation_type": "smtp",
+  "success": false,
+  "errors": {
+    "smtp": "smtp error"
+  },
+  "smtp_debug": [
+    {
+      "mail_host": "213.180.193.89",
+      "port_opened": true,
+      "connection": true,
+      "errors": {
+        "rcptto": "550 5.7.1 No such user!\n"
+      }
+    }
+  ],
+  "configuration": {
+    "validation_type_by_domain": null,
+    "whitelist_validation": false,
+    "whitelisted_domains": null,
+    "blacklisted_domains": null,
+    "not_rfc_mx_lookup_flow": false,
+    "smtp_safe_check": false,
+    "email_pattern": "default gem value",
+    "smtp_error_body_pattern": "default gem value"
+  }
+}
+```
+
 ### Test environment
 
 You can stub out that validation for your test environment. Just add RSpec before action:
@@ -968,13 +1109,18 @@ end
 ```
 
 ---
+
 ## Truemail family
 
 All Truemail extensions: https://github.com/truemail-rb
 
-### 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