email_address 0.1.19 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: adfafdd9c68cbc88c13f77175ab945fce253b0c67d93cbf92f27d95358d9286d
-  data.tar.gz: 07ea20d4fddbc9a2626a870b40162fe5ecaedfd7f588ba56f8d9efffce9a4eac
+  metadata.gz: c6784502377cd86fe2b6bb53c53ef7700673ed0317d2c96850ba0e9faad32c72
+  data.tar.gz: 5a558e95e390bf608225149fa2cb0948dcd9455607592e0c92156f34dced0807
 SHA512:
-  metadata.gz: 45005aaae90329115140e038aa9f17325d66a939de376a2efc0fdda6542a1b47850ae40b80503fd69e1308f3cfe2fb5392904d2ca5ba0f997b00b6712e01ccb9
-  data.tar.gz: e69900c156e676aac54f5f2d3ca395f08f08d07f768913df990d8b3c012e12e5cda678145f1dcdb0d141691ebf93d2beb85ba3b8dd654522fbb121962529585c
+  metadata.gz: 65cd1a6acccd37f3580762ba5d97e2956833c979a9fa639369385427bfe0ebf3cca693014d442ab530a005349e6fd36bce3d0b7372f432230bfcc4e0d3d15d79
+  data.tar.gz: 6543b62b3d0650717c81d2b25de2008fe6b898707a82c8779646364cb351654322958d38dfbf6b9420728a1eb7d6047d2d4205f0e11254e9d868930f6db74243

data/.github/workflows/ci.yml

@@ -0,0 +1,18 @@
+name: CI Build
+on: [push, pull_request]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        ruby-version: [2.6, 2.7, 3.0, 3.1, jruby]
+    steps:
+      - uses: actions/checkout@v2
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby-version }}
+          bundler-cache: true # runs `bundle install` and caches installed gems automatically
+      - name: Install dependencies
+        run: bundle install
+      - name: Run tests
+        run: bundle exec rake

data/Gemfile

@@ -1,4 +1,4 @@
-source 'https://rubygems.org'
+source "https://rubygems.org"
 
 # Specify your gem's dependencies in email_address.gemspec
 gemspec

data/README.md

@@ -1,7 +1,7 @@
 # Email Address
 
 [![Gem Version](https://badge.fury.io/rb/email_address.svg)](http://rubygems.org/gems/email_address)
-[![Build Status](https://travis-ci.org/afair/email_address.svg?branch=v0.1)](https://travis-ci.org/afair/email_address)
+[![CI Build](https://github.com/afair/email_address/actions/workflows/ci.yml/badge.svg)](https://github.com/afair/email_address/actions/workflows/ci.yml)
 [![Code Climate](https://codeclimate.com/github/afair/email_address/badges/gpa.svg)](https://codeclimate.com/github/afair/email_address)
 
 The `email_address` gem provides a ruby language library for working
@@ -98,7 +98,7 @@ introduces terms to distinguish types of email addresses.
     madness!."()<>[]:,;@\\\"!#$%&'*+-/=?^_`{}| ~.a(comment )"@example.org
 
 * *Base* - A unique mailbox without tags. For gmail, is uses the incoming
-  punctation, essential when building an MD5 or SHA1 to match services
+  punctation, essential when building an MD5, SHA1, or SHA256 to match services
   like Gravatar, and email address digest interchange.
 
 * *Canonical* - An unique account address, lower-cased, without the
@@ -234,6 +234,7 @@ Here are some other methods that are available.
 ```ruby
 email.redact        #=> "{bea3f3560a757f8142d38d212a931237b218eb5e}@gmail.com"
 email.sha1          #=> "bea3f3560a757f8142d38d212a931237b218eb5e"
+email.sha256        #=> "9e2a0270f2d6778e5f647fc9eaf6992705ca183c23d1ed1166586fd54e859f75"
 email.md5           #=> "c5be3597c391169a5ad2870f9ca51901"
 email.host_name     #=> "gmail.com"
 email.provider      #=> :google
@@ -272,6 +273,25 @@ class User < ActiveRecord::Base
 end
 ```
 
+#### Rails I18n
+
+Copy and adapt `lib/email_address/messages.yaml` into your locales and
+create an after initialization callback:
+
+```ruby
+# config/initializers/email_address.rb
+
+Rails.application.config.after_initialize do
+  I18n.available_locales.each do |locale|
+    translations = I18n.t(:email_address, locale: locale)
+
+    next unless translations.is_a? Hash
+
+    EmailAddress::Config.error_messages translations.transform_keys(&:to_s), locale.to_s
+  end
+end
+```
+
 #### Rails Email Address Type Attribute
 
 Initial support is provided for Active Record 5.0 attributes API.
@@ -476,6 +496,11 @@ Full translation support would be ideal though.
   the SHA1 Digest, making it unique to your application so it can't easily be
   discovered by comparing against a known list of email/sha1 pairs.
 
+* sha256_secret -
+  This application-level secret is appended to the email_address to compute
+  the SHA256 Digest, making it unique to your application so it can't easily be
+  discovered by comparing against a known list of email/sha256 pairs.
+
 * munge_string - "*****", the string to replace into munged addresses.
 
 For local part configuration:

data/Rakefile

@@ -1,9 +1,9 @@
 require "bundler/gem_tasks"
 
 require "bundler/setup"
-require 'rake/testtask'
+require "rake/testtask"
 
-task :default => :test
+task default: :test
 
 desc "Run the Test Suite, toot suite"
 Rake::TestTask.new do |t|

data/email_address.gemspec

@@ -1,37 +1,37 @@
-# coding: utf-8
-lib = File.expand_path('../lib', __FILE__)
+lib = File.expand_path("../lib", __FILE__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'email_address/version'
+require "email_address/version"
 
 Gem::Specification.new do |spec|
-  spec.name          = "email_address"
-  spec.version       = EmailAddress::VERSION
-  spec.authors       = ["Allen Fair"]
-  spec.email         = ["allen.fair@gmail.com"]
-  spec.description   = %q{The EmailAddress Gem to work with and validate email addresses.}
-  spec.summary       = %q{This gem provides a ruby language library for working with and validating email addresses. By default, it validates against conventional usage, the format preferred for user email addresses. It can be configured to validate against RFC “Standard” formats, common email service provider formats, and perform DNS validation.}
-  spec.homepage      = "https://github.com/afair/email_address"
-  spec.license       = "MIT"
+  spec.name = "email_address"
+  spec.version = EmailAddress::VERSION
+  spec.authors = ["Allen Fair"]
+  spec.email = ["allen.fair@gmail.com"]
+  spec.description = "The EmailAddress Gem to work with and validate email addresses."
+  spec.summary = "This gem provides a ruby language library for working with and validating email addresses. By default, it validates against conventional usage, the format preferred for user email addresses. It can be configured to validate against RFC “Standard” formats, common email service provider formats, and perform DNS validation."
+  spec.homepage = "https://github.com/afair/email_address"
+  spec.license = "MIT"
 
-  #spec.required_ruby_version = ">= 2.3.0"
-  spec.files         = `git ls-files`.split($/)
-  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
-  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.required_ruby_version = ">= 2.5", "< 4"
+  spec.files = `git ls-files`.split($/)
+  spec.executables = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ["lib"]
 
   spec.add_development_dependency "rake"
-  spec.add_development_dependency "minitest",     "~> 5.11"
-  spec.add_development_dependency "bundler" #,      "~> 1.16.0"
-  if RUBY_PLATFORM == 'java'
-    spec.add_development_dependency "activerecord", "=  4.2.10"
-    spec.add_development_dependency "activerecord-jdbcsqlite3-adapter", '~> 1.3.24'
+  spec.add_development_dependency "minitest", "~> 5.11"
+  spec.add_development_dependency "bundler" # ,      "~> 1.16.0"
+  if RUBY_PLATFORM == "java"
+    spec.add_development_dependency "activerecord", "~> 5.2.6"
+    spec.add_development_dependency "activerecord-jdbcsqlite3-adapter", "~> 52.7"
   else
-    spec.add_development_dependency "activerecord", "~> 5.2.4"
+    spec.add_development_dependency "activerecord", "~> 6.1.4"
     spec.add_development_dependency "sqlite3"
+    spec.add_development_dependency "standard", "~> 1.5.0"
   end
-  #spec.add_development_dependency "codeclimate-test-reporter"
+  # spec.add_development_dependency "net-smtp"
   spec.add_development_dependency "simplecov"
+  spec.add_development_dependency "pry"
 
   spec.add_dependency "simpleidn"
-  spec.add_dependency "netaddr", '>= 2.0.4', '< 3'
 end

data/lib/email_address/active_record_validator.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 module EmailAddress
-
   # ActiveRecord validator class for validating an email
   # address with this library.
   # Note the initialization happens once per process.
@@ -16,14 +15,13 @@ module EmailAddress
   # Default field: :email or :email_address (first found)
   #
   class ActiveRecordValidator < ActiveModel::Validator
-
-    def initialize(options={})
+    def initialize(options = {})
       @opt = options
     end
 
     def validate(r)
       if @opt[:fields]
-        @opt[:fields].each {|f| validate_email(r, f) }
+        @opt[:fields].each { |f| validate_email(r, f) }
       elsif @opt[:field]
         validate_email(r, @opt[:field])
       elsif r.respond_to? :email
@@ -33,17 +31,15 @@ module EmailAddress
       end
     end
 
-    def validate_email(r,f)
+    def validate_email(r, f)
       return if r[f].nil?
       e = Address.new(r[f])
       unless e.valid?
         error_message = @opt[:message] ||
-                        Config.error_messages[:invalid_address] ||
-                        "Invalid Email Address"
+          Config.error_message(:invalid_address, I18n.locale.to_s) ||
+          "Invalid Email Address"
         r.errors.add(f, error_message)
       end
     end
-
   end
-
 end

data/lib/email_address/address.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "digest/sha1"
+require "digest/sha2"
 require "digest/md5"
 
 module EmailAddress
@@ -10,7 +11,7 @@ module EmailAddress
     include Comparable
     include Rewriter
 
-    attr_accessor :original, :local, :host, :config, :reason
+    attr_accessor :original, :local, :host, :config, :reason, :locale
 
     CONVENTIONAL_REGEX = /\A#{Local::CONVENTIONAL_MAILBOX_WITHIN}
                            @#{Host::DNS_HOST_REGEX}\z/x
@@ -22,15 +23,16 @@ module EmailAddress
     # Given an email address of the form "local@hostname", this sets up the
     # instance, and initializes the address to the "normalized" format of the
     # address. The original string is available in the #original method.
-    def initialize(email_address, config = {})
+    def initialize(email_address, config = {}, locale = "en")
       @config = Config.new(config)
       @original = email_address
+      @locale = locale
       email_address = (email_address || "").strip
       email_address = parse_rewritten(email_address) unless config[:skip_rewrite]
       local, host = Address.split_local_host(email_address)
 
-      @host = Host.new(host, @config)
-      @local = Local.new(local, @config, @host)
+      @host = Host.new(host, @config, locale)
+      @local = Local.new(local, @config, @host, locale)
       @error = @error_message = nil
     end
 
@@ -86,8 +88,8 @@ module EmailAddress
     def host_name
       @host.host_name
     end
-    alias right host_name
-    alias hostname host_name
+    alias_method :right, :host_name
+    alias_method :hostname, :host_name
 
     # Returns the ESP (Email Service Provider) or ISP name derived
     # using the provider configuration rules.
@@ -111,7 +113,7 @@ module EmailAddress
         "#{local}@#{host}"
       end
     end
-    alias to_s normal
+    alias_method :to_s, :normal
 
     def inspect
       "#<#{self.class}:0x#{object_id.to_s(16)} address=\"#{self}\">"
@@ -159,32 +161,36 @@ module EmailAddress
       [local.munge, host.munge].join("@")
     end
 
-    # Returns and MD5 of the canonical address form. Some cross-system systems
+    # Returns and MD5 of the base address form. Some cross-system systems
     # use the email address MD5 instead of the actual address to refer to the
     # same shared user identity without exposing the actual address when it
     # is not known in common.
     def reference(form = :base)
       Digest::MD5.hexdigest(send(form))
     end
-    alias md5 reference
+    alias_method :md5, :reference
 
-    # This returns the SHA1 digest (in a hex string) of the canonical email
+    # This returns the SHA1 digest (in a hex string) of the base email
     # address. See #md5 for more background.
     def sha1(form = :base)
       Digest::SHA1.hexdigest((send(form) || "") + (@config[:sha1_secret] || ""))
     end
 
+    def sha256(form = :base)
+      Digest::SHA256.hexdigest((send(form) || "") + (@config[:sha256_secret] || ""))
+    end
+
     #---------------------------------------------------------------------------
     # Comparisons & Matching
     #---------------------------------------------------------------------------
 
     # Equal matches the normalized version of each address. Use the Threequal to check
     # for match on canonical or redacted versions of addresses
-    def ==(other_email)
-      to_s == other_email.to_s
+    def ==(other)
+      to_s == other.to_s
     end
-    alias eql? ==
-    alias equal? ==
+    alias_method :eql?, :==
+    alias_method :equal?, :==
 
     # Return the <=> or CMP comparison operator result (-1, 0, +1) on the comparison
     # of this addres with another, using the canonical or redacted forms.
@@ -197,12 +203,12 @@ module EmailAddress
         redact == other_email.canonical ||
         canonical == other_email.redact
     end
-    alias include? same_as?
+    alias_method :include?, :same_as?
 
     # Return the <=> or CMP comparison operator result (-1, 0, +1) on the comparison
     # of this addres with another, using the normalized form.
-    def <=>(other_email)
-      to_s <=> other_email.to_s
+    def <=>(other)
+      to_s <=> other.to_s
     end
 
     # Address matches one of these Matcher rule patterns
@@ -214,7 +220,7 @@ module EmailAddress
 
       # Does "root@*.com" match "root@example.com" domain name
       rules.each do |r|
-        if r.match(/.+@.+/)
+        if /.+@.+/.match?(r)
           return r if File.fnmatch?(r, to_s)
         end
       end
@@ -252,6 +258,10 @@ module EmailAddress
     # Connects to host to test if user can receive email. This should NOT be performed
     # as an email address check, but is provided to assist in problem resolution.
     # If you abuse this, you *could* be blocked by the ESP.
+    #
+    # NOTE: As of Ruby 3.1, Net::SMTP was moved from the standard library to the
+    # 'net-smtp' gem. In order to avoid adding that dependency for this experimental
+    # feature, please add the gem to your Gemfile and require it to use this feature.
     def connect
       smtp = Net::SMTP.new(host_name || ip_address)
       smtp.start(@config[:smtp_helo_name] || "localhost")
@@ -276,7 +286,7 @@ module EmailAddress
     def set_error(err, reason = nil)
       @error = err
       @reason = reason
-      @error_message = Config.error_message(err)
+      @error_message = Config.error_message(err, locale)
       false
     end
 

data/lib/email_address/config.rb

@@ -17,6 +17,11 @@ module EmailAddress
   #   the SHA1 Digest, making it unique to your application so it can't easily be
   #   discovered by comparing against a known list of email/sha1 pairs.
   #
+  # * sha256_secret         ""
+  #   This application-level secret is appended to the email_address to compute
+  #   the SHA256 Digest, making it unique to your application so it can't easily be
+  #   discovered by comparing against a known list of email/sha256 pairs.
+  #
   # For local part configuration:
   # * local_downcase:     true
   #   Downcase the local part. You probably want this for uniqueness.
@@ -104,6 +109,7 @@ module EmailAddress
       dns_lookup: :mx, # :mx, :a, :off
       dns_timeout: nil,
       sha1_secret: "",
+      sha256_secret: "",
       munge_string: "*****",
 
       local_downcase: true,
@@ -182,15 +188,20 @@ module EmailAddress
     end
 
     def self.error_message(name, locale = "en")
-      @errors[locale]["email_address"][name.to_s] || name.to_s
+      @errors.dig(locale, "email_address", name.to_s) || name.to_s
     end
 
     # Customize your own error message text.
     def self.error_messages(hash = {}, locale = "en", *extra)
       hash = extra.first if extra.first.is_a? Hash
-      unless hash.empty?
+
+      @errors[locale] ||= {}
+      @errors[locale]["email_address"] ||= {}
+
+      unless hash.nil? || hash.empty?
         @errors[locale]["email_address"] = @errors[locale]["email_address"].merge(hash)
       end
+
       @errors[locale]["email_address"]
     end
 

data/lib/email_address/exchanger.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require "resolv"
-require "netaddr"
 require "socket"
 
 module EmailAddress
@@ -58,8 +57,8 @@ module EmailAddress
 
         ress = begin
           dns.getresources(@host, Resolv::DNS::Resource::IN::MX)
-               rescue Resolv::ResolvTimeout
-                 []
+        rescue Resolv::ResolvTimeout
+          []
         end
 
         records = ress.map { |r|
@@ -105,22 +104,9 @@ module EmailAddress
 
     # Given a cidr (ip/bits) and ip address, returns true on match. Caches cidr object.
     def in_cidr?(cidr)
-      if cidr.include?(":")
-        c = NetAddr::IPv6Net.parse(cidr)
-        return true if mx_ips.find do |ip|
-          next unless ip.include?(":")
-          rel = c.rel NetAddr::IPv6Net.parse(ip)
-          !rel.nil? && rel >= 0
-        end
-      elsif cidr.include?(".")
-        c = NetAddr::IPv4Net.parse(cidr)
-        return true if mx_ips.find do |ip|
-          next if ip.include?(":")
-          rel = c.rel NetAddr::IPv4Net.parse(ip)
-          !rel.nil? && rel >= 0
-        end
-      end
-      false
+      net = IPAddr.new(cidr)
+      found = mx_ips.detect { |ip| net.include?(IPAddr.new(ip)) }
+      !!found
     end
   end
 end

data/lib/email_address/host.rb

@@ -1,7 +1,5 @@
 require "simpleidn"
 require "resolv"
-require "netaddr"
-require "net/smtp"
 
 module EmailAddress
   ##############################################################################
@@ -34,15 +32,15 @@ module EmailAddress
     attr_reader :host_name
     attr_accessor :dns_name, :domain_name, :registration_name,
       :tld, :tld2, :subdomains, :ip_address, :config, :provider,
-      :comment, :error_message, :reason
+      :comment, :error_message, :reason, :locale
     MAX_HOST_LENGTH = 255
 
     # Sometimes, you just need a Regexp...
-    DNS_HOST_REGEX = / [\p{L}\p{N}]+ (?: (?: \-{1,2} | \.) [\p{L}\p{N}]+ )*/x
+    DNS_HOST_REGEX = / [\p{L}\p{N}]+ (?: (?: -{1,2} | \.) [\p{L}\p{N}]+ )*/x
 
     # The IPv4 and IPv6 were lifted from Resolv::IPv?::Regex and tweaked to not
     # \A...\z anchor at the edges.
-    IPv6_HOST_REGEX = /\[IPv6:
+    IPV6_HOST_REGEX = /\[IPv6:
       (?: (?:(?x-mi:
       (?:[0-9A-Fa-f]{1,4}:){7}
          [0-9A-Fa-f]{1,4}
@@ -61,7 +59,7 @@ module EmailAddress
       (?: \d+)\.(?: \d+)\.(?: \d+)\.(?: \d+)
       )))\]/ix
 
-    IPv4_HOST_REGEX = /\[((?x-mi:0
+    IPV4_HOST_REGEX = /\[((?x-mi:0
                |1(?:[0-9][0-9]?)?
                |2(?:[0-4][0-9]?|5[0-5]?|[6-9])?
                |[3-9][0-9]?))\.((?x-mi:0
@@ -80,12 +78,13 @@ module EmailAddress
 
     # Matches Host forms: DNS name, IPv4, or IPv6 formats
     STANDARD_HOST_REGEX = /\A (?: #{DNS_HOST_REGEX}
-                              | #{IPv4_HOST_REGEX} | #{IPv6_HOST_REGEX}) \z/ix
+                              | #{IPV4_HOST_REGEX} | #{IPV6_HOST_REGEX}) \z/ix
 
     # host name -
     #   * host type - :email for an email host, :mx for exchanger host
-    def initialize(host_name, config = {})
+    def initialize(host_name, config = {}, locale = "en")
       @original = host_name ||= ""
+      @locale = locale
       config[:host_type] ||= :email
       @config = config.is_a?(Hash) ? Config.new(config) : config
       @error = @error_message = nil
@@ -104,7 +103,7 @@ module EmailAddress
         dns_name
       end
     end
-    alias to_s name
+    alias_method :to_s, :name
 
     # The canonical host name is the simplified, DNS host name
     def canonical
@@ -149,7 +148,7 @@ module EmailAddress
       if @config[:host_remove_spaces]
         @host_name = @host_name.delete(" ")
       end
-      @dns_name = if /[^[:ascii:]]/.match(host_name)
+      @dns_name = if /[^[:ascii:]]/.match?(host_name)
         ::SimpleIDN.to_ascii(host_name)
       else
         host_name
@@ -229,7 +228,7 @@ module EmailAddress
     def parts
       {host_name: host_name, dns_name: dns_name, subdomain: subdomains,
        registration_name: registration_name, domain_name: domain_name,
-       tld2: tld2, tld: tld, ip_address: ip_address,}
+       tld2: tld2, tld: tld, ip_address: ip_address}
     end
 
     def hosted_provider
@@ -246,7 +245,7 @@ module EmailAddress
     end
 
     def ip?
-      ip_address.nil? ? false : true
+      !!ip_address
     end
 
     def ipv4?
@@ -290,7 +289,7 @@ module EmailAddress
     # Does "sub.example.com" match ".com" and ".example.com" top level names?
     # Matches TLD (uk) or TLD2 (co.uk)
     def tld_matches?(rule)
-      rule.match(/\A\.(.+)\z/) && ($1 == tld || $1 == tld2) ? true : false
+      rule.match(/\A\.(.+)\z/) && ($1 == tld || $1 == tld2) # ? true : false
     end
 
     def provider_matches?(rule)
@@ -310,13 +309,8 @@ module EmailAddress
     # the passed CIDR string ("10.9.8.0/24" or "2001:..../64")
     def ip_matches?(cidr)
       return false unless ip_address
-      return cidr if !cidr.include?("/") && cidr == ip_address
-      if cidr.include?(":") && ip_address.include?(":")
-        return cidr if NetAddr::IPv6Net.parse(cidr).contains(NetAddr::IPv6.parse(ip_address))
-      elsif cidr.include?(".") && ip_address.include?(".")
-        return cidr if NetAddr::IPv4Net.parse(cidr).contains(NetAddr::IPv4.parse(ip_address))
-      end
-      false
+      net = IPAddr.new(cidr)
+      net.include?(IPAddr.new(ip_address))
     end
 
     ############################################################################
@@ -333,7 +327,7 @@ module EmailAddress
     # Returns: [official_hostname, alias_hostnames, address_family, *address_list]
     def dns_a_record
       @_dns_a_record = "0.0.0.0" if @config[:dns_lookup] == :off
-      @_dns_a_record ||= Socket.gethostbyname(dns_name)
+      @_dns_a_record ||= Addrinfo.getaddrinfo(dns_name, 80) # Port 80 for A rec, 25 for MX
     rescue SocketError # not found, but could also mean network not work
       @_dns_a_record ||= []
     end
@@ -353,8 +347,8 @@ module EmailAddress
         records = begin
           dns.getresources(alternate_host || dns_name,
             Resolv::DNS::Resource::IN::TXT)
-                  rescue Resolv::ResolvTimeout
-                    []
+        rescue Resolv::ResolvTimeout
+          []
         end
 
         records.empty? ? nil : records.map(&:data).join(" ")
@@ -407,11 +401,7 @@ module EmailAddress
     # True if the host name has a DNS A Record
     def valid_dns?
       return true unless dns_enabled?
-      bool = dns_a_record.size > 0 || set_error(:domain_unknown)
-      if localhost? && !@config[:host_local]
-        bool = set_error(:domain_no_localhost)
-      end
-      bool
+      dns_a_record.size > 0 || set_error(:domain_unknown)
     end
 
     # True if the host name has valid MX servers configured in DNS
@@ -435,7 +425,9 @@ module EmailAddress
     # True if the host_name passes Regular Expression match and size limits.
     def valid_format?
       if host_name =~ CANONICAL_HOST_REGEX && to_s.size <= MAX_HOST_LENGTH
-        return true if localhost?
+        if localhost?
+          return @config[:host_local] ? true : set_error(:domain_no_localhost)
+        end
         return true if host_name.include?(".") # require FQDN
       end
       set_error(:domain_invalid)
@@ -459,26 +451,18 @@ module EmailAddress
     end
 
     def localhost?
-      if ip_address
-        rel =
-          if ip_address.include?(":")
-            NetAddr::IPv6Net.parse("" + "::1").rel(
-              NetAddr::IPv6Net.parse(ip_address)
-            )
-          else
-            NetAddr::IPv4Net.parse("" + "127.0.0.0/8").rel(
-              NetAddr::IPv4Net.parse(ip_address)
-            )
-          end
-        !rel.nil? && rel >= 0
-      else
-        host_name == "localhost"
-      end
+      return true if host_name == "localhost"
+      return false unless ip_address
+      IPAddr.new(ip_address).loopback?
     end
 
     # Connects to host to test it can receive email. This should NOT be performed
     # as an email address check, but is provided to assist in problem resolution.
     # If you abuse this, you *could* be blocked by the ESP.
+    #
+    # NOTE: As of Ruby 3.1, Net::SMTP was moved from the standard library to the
+    # 'net-smtp' gem. In order to avoid adding that dependency for this experimental
+    # feature, please add the gem to your Gemfile and require it to use this feature.
     def connect
       smtp = Net::SMTP.new(host_name || ip_address)
       smtp.start(@config[:helo_name] || "localhost")
@@ -497,7 +481,7 @@ module EmailAddress
     def set_error(err, reason = nil)
       @error = err
       @reason = reason
-      @error_message = Config.error_message(err)
+      @error_message = Config.error_message(err, locale)
       false
     end