dmarcator 0.10.0 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a1bd93bc4b534e2b9613241e920dd4a71c41e564c92c10ab8abaf6be7294feb8
-  data.tar.gz: fb95401f394f53189a0db431f7d31bc4ffe8c25c87ce87f825f18a99962dadba
+  metadata.gz: 689cd037f395f7803f4157fd148305f1d9d6c3dbb19fd42b61311b8e37d57124
+  data.tar.gz: 80518a23a140cb7102cb4d20a5fa896852ca8b104a3047939bcf4ba018e89699
 SHA512:
-  metadata.gz: c94318c4ac8a5f7089276f5d6bf91ae90ab8cf576f6367acf418e86adba5fe4bb5e28f7df4a478f8783d134b82bd9390555b3af48c713ca869fd276be4cfe08b
-  data.tar.gz: 6b10b30dfc64acd1cdef7427c4a475d7d9fa90b4c9d387cbc1e2293e8b693e66d3fa4bc23d80d254d92a5a4137ab65b1fe98adfc0e28e573bafc8342274e7995
+  metadata.gz: c3b5f59702e05d0ffeeec17c9c3e7f8c1bd078448ba029fd4cf6bc8e6cbd8107dbda2e3633c228d1706f09832023a8a64b9806d6ee843b1fe13d449b19379e0c
+  data.tar.gz: de98c5111a0eb8023fa10807c7227d18bead12e17f2f43d084d8c5e3d27a2b1a4e86212c0c075fa2e75a97e5710e738de2baad45b833c31249d54a1abec80bb2

data/ChangeLog.md

@@ -1,3 +1,9 @@
+### 0.11.0 / 2026-10-29
+
+* Add `DMARCator.configure` for process-wide defaults, so a resolver can be set from code instead of only through the `DMARCATOR_DNS` environment variables. A configured resolver takes precedence over the environment, and `DMARCator.reset_configuration!` discards it.
+* A configured resolver may be a callable, in which case it is invoked for each lookup. This lets threaded applications use one resolver per lookup instead of sharing a `Resolv::DNS`, which does not serialise concurrent lookups.
+* Run CI on macOS 15 as well as Ubuntu 24.04, covering the Socket/OpenSSL and Net::HTTP paths used by the DoT and DoH transports.
+
 ### 0.10.0 / 2026-10-29
 
 Breaking changes, taken before 1.0 so the release does not carry them:

data/README.md

@@ -193,6 +193,31 @@ helper returning "the" record would hide exactly those conditions. DKIM is also
 per-selector and selectors cannot be enumerated, so any convenience method would
 have to take a selector and would only build the name above.
 
+## Configuration
+
+Process-wide defaults can be set from code, and take precedence over the
+`DMARCATOR_DNS` environment variables:
+
+```ruby
+DMARCator.configure do |config|
+  config.resolver = DMARCator::Resolver::DoH.new(url: "https://dns.example/dns-query")
+end
+```
+
+A resolver object is shared by every thread, and `Resolv::DNS` does not
+serialise concurrent lookups, so threaded applications should configure a
+factory instead:
+
+```ruby
+DMARCator.configure do |config|
+  config.resolver = -> { Resolv::DNS.new }
+end
+```
+
+`DMARCator.reset_configuration!` discards configured values, which is useful in
+tests. Passing `resolver:` to a lookup still overrides both the configured
+default and the environment.
+
 ## Strict parsing
 
 By default, unknown tags and tags with invalid values are ignored. Pass

data/lib/dmarcator/config.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module DMARCator
+  #
+  # Process-wide defaults.
+  #
+  # @since 0.11.0
+  #
+  class Config
+    #
+    # The default resolver used when a lookup is not given one.
+    #
+    # Either a resolver ({Resolv::DNS}, {Resolver::DoH}, {Resolver::DoT}) or a
+    # callable returning one. Prefer a callable in threaded applications: a
+    # resolver object is shared by every thread, and `Resolv::DNS` does not
+    # serialise concurrent lookups.
+    #
+    # @return [Object, #call, nil]
+    #
+    attr_accessor :resolver
+  end
+
+  #
+  # The process-wide configuration.
+  #
+  # @return [Config]
+  #
+  # @since 0.11.0
+  #
+  def self.config
+    @config ||= Config.new
+  end
+
+  #
+  # Configures process-wide defaults.
+  #
+  #   DMARCator.configure do |config|
+  #     config.resolver = -> { Resolv::DNS.new }
+  #   end
+  #
+  # When set, a configured resolver takes precedence over `DMARCATOR_DNS` and
+  # is used by {txt}, {txt_records}, {dmarc} and {Record.lookup} whenever no
+  # resolver is passed explicitly.
+  #
+  # @yieldparam [Config] config
+  #
+  # @return [Config]
+  #
+  # @since 0.11.0
+  #
+  def self.configure
+    yield config if block_given?
+    config
+  end
+
+  #
+  # Discards any configured defaults.
+  #
+  # @return [Config]
+  #
+  # @since 0.11.0
+  #
+  def self.reset_configuration!
+    @config = Config.new
+  end
+end

data/lib/dmarcator/query.rb

@@ -3,6 +3,7 @@
 require 'resolv'
 require 'rubygems'
 
+require_relative 'config'
 require_relative 'resolver'
 
 module DMARCator
@@ -125,7 +126,11 @@ module DMARCator
   end
 
   #
-  # Builds the resolver configured by the environment.
+  # The default resolver: a {configure}d one, or one built from the
+  # environment.
+  #
+  # A configured resolver may be an object or a callable; a callable is called
+  # for each lookup, which is what threaded applications should use.
   #
   # @return [Resolv::DNS, Resolver::DoH, Resolver::DoT]
   #
@@ -135,7 +140,11 @@ module DMARCator
   # @since 0.6.0
   #
   def self.default_resolver
-    Resolver.build
+    configured = config.resolver
+
+    return configured.call if configured.respond_to?(:call)
+
+    configured || Resolver.build
   end
 
   #

data/lib/dmarcator/version.rb

@@ -2,5 +2,5 @@
 
 module DMARCator
   # dmarcator version
-  VERSION = '0.10.0'
+  VERSION = '0.11.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dmarcator
 version: !ruby/object:Gem::Version
-  version: 0.10.0
+  version: 0.11.0
 platform: ruby
 authors:
 - Noah Berman
@@ -69,6 +69,7 @@ files:
 - LICENSE.txt
 - README.md
 - lib/dmarcator.rb
+- lib/dmarcator/config.rb
 - lib/dmarcator/exceptions.rb
 - lib/dmarcator/parser.rb
 - lib/dmarcator/query.rb