truemail 1.5.1 → 1.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1e9e02894c33475d6d0120e3304a15bdd0d1d017458c12af327b595be290ac42
-  data.tar.gz: 75da2935003cb1fe244083753d1d1b3ea5f935cd1a4511dff45ae97dd99b2140
+  metadata.gz: ce37fd460cb5da28f5880be61ac6abb5ca5e8d0fe1010738e45a02a70417fa31
+  data.tar.gz: 3f66bb5169a012e7bd77af80c40c51c021332cb86be4f2ef6f1450611001cebf
 SHA512:
-  metadata.gz: ef2ee9b00968ce13e882ff16b3d73a830ff1d11ba4fdc53d8e4fb318a002fc8103df69c2ac8a27cf181e3dfcb82a6643521809a68a83edfa9fc1b68c6056a7a2
-  data.tar.gz: 18da4be96e32a657bf2cc00f8b09ea71692ff1e1bbd9042f00ba992e8bee5f1c1e86ce3d07e966c5ffcaf52d0b00e87e86295aefe36e6d4a053473f9851626e1
+  metadata.gz: 4902f4e7d2c68cc8714c536ae1844904b99c7609a2b36d057902e6a838d2e2e33bb301f99b7cb067e108bb4bae845ec2e9dfbb9be529db8d53c9bf50a31dfdf9
+  data.tar.gz: f049315d919448d56d8082da28df31d1bc7ad6e191fc5b30629b38011ff4450f870fb7597a6bc4645007fe7bcbc4a7fa3b0855ee408f4115466e9a3496c926c8

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,16 +1,166 @@
 # 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.8.0] - 2020.06.21
+
+## Added
+
+Separated audit features for verifier host.
+
+- `Truemail::Audit::Ip`
+- `Truemail::Audit::Dns`
+
+```ruby
+Truemail.host_audit
+
+=> #<Truemail::Auditor:0x00005580df358828
+@result=
+  #<struct Truemail::Auditor::Result
+    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=[],
+      @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=[]>
+```
+
+### Changed
+
+- `Truemail::Auditor`
+- `Truemail::Auditor::Result`
+- `Truemail::Audit::Base`
+- `Truemail::Audit::Ptr`
+- `Truemail::VERSION`
+- gem documentation
+
+## [1.7.1] - 2020.05.10
+
+## Added
+
+- Ability to show `not_rfc_mx_lookup_flow` attribute in serialized validation result
+
+```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"
+  }
+}
+```
+
+### Changed
+
+- `Truemail::Log::Serializer::Base`
+- `Truemail::VERSION`
+- gem documentation
+
+## [1.7.0] - 2020.05.09
+
+## Added
+
+- Ability 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`
+- `Truemail::VERSION`
+- gem development dependencies
+- 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`
@@ -22,22 +172,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)
@@ -65,6 +222,7 @@ Truemail::Log::Serializer::Json.call(Truemail.validate('nonexistent_email@bestwe
 ```
 
 ### Changed
+
 - `Truemail::Configuration`
 - `Truemail::Validator`
 - `Truemail::Validate::Regex`
@@ -73,11 +231,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`
@@ -95,15 +256,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```.
@@ -148,11 +314,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```
@@ -165,11 +334,14 @@ end
 ```
 
 ### Changed
+
 - `Truemail::VERSION`
 - gem documentation
 
 ## [1.0.1] - 2019-06-08
+
 ### Added
+
 - Result validation type marker for domain list match check
 
 ```ruby
@@ -199,11 +371,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
@@ -217,6 +392,7 @@ Truemail.configure do |config|
   config.blacklisted_domains = ['somedomain1.com', 'somedomain2.com']
 end
 ```
+
 and
 
 ```ruby
@@ -225,17 +401,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
@@ -243,68 +424,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)
@@ -313,14 +519,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
@@ -329,11 +539,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
@@ -381,5 +594,6 @@ Truemail.validate('email@example.com')
 ```
 
 ### Changed
+
 - `Truemail::VERSION`
 - gem documentation