email_domain_checker 0.1.2 → 0.1.3

data/lib/email_domain_checker/dns_resolver.rb

@@ -1,25 +1,38 @@
 # frozen_string_literal: true
 
 require "resolv"
+require_relative "config"
 
 module EmailDomainChecker
   class DnsResolver
     attr_reader :timeout
 
-    def initialize(timeout: 5)
+    def initialize(timeout: 5, cache: nil)
       @timeout = timeout
+      @cache = cache
     end
 
     def has_mx_record?(domain)
-      check_dns_record(domain, Resolv::DNS::Resource::IN::MX)
+      has_record?(domain, "mx", Resolv::DNS::Resource::IN::MX)
     end
 
     def has_a_record?(domain)
-      check_dns_record(domain, Resolv::DNS::Resource::IN::A)
+      has_record?(domain, "a", Resolv::DNS::Resource::IN::A)
     end
 
     private
 
+    def has_record?(domain, record_type, resource_type)
+      cache_key = "#{record_type}:#{domain}"
+      if cache
+        cache.with(cache_key, ttl: cache_ttl) do
+          check_dns_record(domain, resource_type)
+        end
+      else
+        check_dns_record(domain, resource_type)
+      end
+    end
+
     def check_dns_record(domain, resource_type)
       resolver = create_resolver
 
@@ -36,5 +49,15 @@ module EmailDomainChecker
       resolver.timeouts = [timeout]
       resolver
     end
+
+    def cache
+      # Use instance variable if set, otherwise try to get from Config
+      return @cache if defined?(@cache) && !@cache.nil?
+      return Config.cache_adapter if Config.cache_enabled?
+    end
+
+    def cache_ttl
+      Config.cache_ttl
+    end
   end
 end

data/lib/email_domain_checker/domain_validator.rb

@@ -13,7 +13,8 @@ module EmailDomainChecker
         check_a: false,
         timeout: 5
       }.merge(options)
-      @dns_resolver = DnsResolver.new(timeout: @options[:timeout])
+      cache = Config.cache_enabled? ? Config.cache_adapter : nil
+      @dns_resolver = DnsResolver.new(timeout: @options[:timeout], cache: cache)
     end
 
     def valid?(domain)

data/lib/email_domain_checker/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module EmailDomainChecker
-  VERSION = "0.1.2"
+  VERSION = "0.1.3"
 end

data/lib/email_domain_checker.rb

@@ -2,6 +2,7 @@
 
 require_relative "email_domain_checker/version"
 require_relative "email_domain_checker/config"
+require_relative "email_domain_checker/cache"
 require_relative "email_domain_checker/normalizer"
 require_relative "email_domain_checker/dns_resolver"
 require_relative "email_domain_checker/domain_validator"
@@ -46,4 +47,35 @@ module EmailDomainChecker
   def self.configure(options = {}, &block)
     Config.configure(options, &block)
   end
+
+  # Clear all cached DNS validation results
+  def self.clear_cache
+    Config.clear_cache
+  end
+
+  # Clear cached DNS validation results for a specific domain
+  def self.clear_cache_for_domain(domain)
+    Config.clear_cache_for_domain(domain)
+  end
+
+  # Get cache adapter instance (returns nil if cache is disabled)
+  # @return [Cache::BaseAdapter, nil] Cache adapter instance
+  def self.cache
+    Config.cache_adapter
+  end
+
+  # Convenience method for cache.with (Rails-style)
+  # Only works if cache is enabled
+  # @param key [String] cache key
+  # @param ttl [Integer, nil] time to live in seconds
+  # @param force [Boolean] force cache refresh
+  # @yield Block to execute on cache miss
+  # @return [Object] cached value or block result
+  # @raise [ArgumentError] if cache is disabled or block is not given
+  def self.with_cache(key, ttl: nil, force: false, &block)
+    adapter = cache
+    raise ArgumentError, "Cache is not enabled. Please enable cache in configuration." unless adapter
+
+    adapter.with(key, ttl: ttl, force: force, &block)
+  end
 end

data/mkdocs.yml

@@ -0,0 +1,65 @@
+site_name: EmailDomainChecker
+site_description: Email address validation and domain checking library
+site_url: https://tatematsu-k.github.io/email_domain_checker
+repo_url: https://github.com/tatematsu-k/email_domain_checker
+repo_name: email_domain_checker
+
+theme:
+  name: material
+  palette:
+    - scheme: default
+      primary: indigo
+      accent: indigo
+      toggle:
+        icon: material/brightness-7
+        name: Switch to dark mode
+    - scheme: slate
+      primary: indigo
+      accent: indigo
+      toggle:
+        icon: material/brightness-4
+        name: Switch to light mode
+  features:
+    - navigation.tabs
+    - navigation.sections
+    - navigation.expand
+    - navigation.top
+    - search.suggest
+    - search.highlight
+    - content.code.copy
+    - content.code.annotate
+
+markdown_extensions:
+  - pymdownx.highlight:
+      anchor_linenums: true
+  - pymdownx.inlinehilite
+  - pymdownx.snippets
+  - pymdownx.superfences:
+      custom_fences:
+        - name: mermaid
+          class: mermaid
+          format: !!python/name:pymdownx.superfences.fence_code_format
+  - admonition
+  - pymdownx.details
+  - pymdownx.tasklist:
+      custom_checkbox: true
+  - attr_list
+  - md_in_html
+
+nav:
+  - Home: index.md
+  - Getting Started:
+    - Installation: getting-started/installation.md
+    - Quick Start: getting-started/quick-start.md
+  - Usage:
+    - Module-level Methods: usage/module-methods.md
+    - Checker Class: usage/checker-class.md
+    - ActiveModel Integration: usage/activemodel-integration.md
+  - Configuration:
+    - Configuration Options: configuration/options.md
+    - Test Mode: configuration/test-mode.md
+    - Cache Configuration: configuration/cache.md
+  - Contributing: contributing.md
+
+plugins:
+  - search

data/requirements.txt

@@ -0,0 +1,2 @@
+mkdocs>=1.5.0
+mkdocs-material>=9.0.0

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: email_domain_checker
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors:
 - Koki Tatematsu
@@ -77,9 +77,24 @@ files:
 - CHANGELOG.md
 - README.md
 - Rakefile
+- docs-templates/index.html
+- docs/configuration/cache.md
+- docs/configuration/options.md
+- docs/configuration/test-mode.md
+- docs/contributing.md
+- docs/getting-started/installation.md
+- docs/getting-started/quick-start.md
+- docs/index.md
+- docs/usage/activemodel-integration.md
+- docs/usage/checker-class.md
+- docs/usage/module-methods.md
 - email_domain_checker.gemspec
 - lib/email_domain_checker.rb
 - lib/email_domain_checker/active_model_validator.rb
+- lib/email_domain_checker/cache.rb
+- lib/email_domain_checker/cache/base_adapter.rb
+- lib/email_domain_checker/cache/memory_adapter.rb
+- lib/email_domain_checker/cache/redis_adapter.rb
 - lib/email_domain_checker/checker.rb
 - lib/email_domain_checker/config.rb
 - lib/email_domain_checker/dns_resolver.rb
@@ -87,6 +102,8 @@ files:
 - lib/email_domain_checker/email_address_adapter.rb
 - lib/email_domain_checker/normalizer.rb
 - lib/email_domain_checker/version.rb
+- mkdocs.yml
+- requirements.txt
 homepage: https://github.com/tatematsu-k/email_domain_checker
 licenses:
 - MIT