mailresolver 0.5.1 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 12a1881f2f511ee3179b481e2b0edfd43f79bfed4fdc9f7d96ce94a4fb511650
-  data.tar.gz: a1f1aadf2ecfbe335cba1c5ddd33daeba467760ad7b0d1ec070905f9622d4120
+  metadata.gz: 694ac605361e95bb9ab69d00ea9e01ea3b06ca7d510f3bc8b4dfc776902abf4d
+  data.tar.gz: 38ba126c1aac2766dffe47b453371121896c3e0f262690d01c74a0c908266a75
 SHA512:
-  metadata.gz: 9ee55c2b9fefb4afd0d576e7469804e9c969c653a4b285f1beb77b80efad56dbe77f12397568dba54c17bea7e37c20fa34326c988407fd3a4e3d7d8cc659a847
-  data.tar.gz: 3a6ef2bbe9788425d1e65c8ac21364218eac4d67a0db34bdafc2918030bcf7f5557625410b9497a7095b272e55d5043b9f60a74e15b994409ab62a64e15f47db
+  metadata.gz: 3b659fde78f316410de238debb7241e564fa4fc545badafb41207e8964386fad11706b662e4f68e2d93ca83b092d129ff126f206b9f1dda215d97cf04db722d6
+  data.tar.gz: 673b4bed0f68ae4243c3ddafdcf1205f4a57a7ec84f4b4adaba502acecc604fda80ce9201af5436697c461241b0c849d64f8e7d8979f710ec56b32b65141f882

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.6.0
+
+- `ns` lookup, on the resolver and the fake.
+
 ## 0.5.1
 
 - Re-release: 0.5.0

data/README.md

@@ -2,20 +2,20 @@
 
 🔍 DNS resolution for mail, in Ruby.
 
-**mailresolver** is a small, injectable DNS client for mail libraries — TXT, A/AAAA, MX, PTR, and CNAME lookups.
+**mailresolver** is a small, injectable DNS client for mail libraries — TXT, A/AAAA, MX, PTR, CNAME, and NS lookups.
 
 For mail libraries and the apps that use them: SPF/DKIM/DMARC/MTA-STS checks that need a missing record told apart from a server that couldn't answer, apps running several mail libraries that want one shared resolver instead of one apiece, test suites that want to fake DNS without touching a network.
 
 **mailresolver** handles:
 
-- TXT, A, AAAA, MX, PTR, and CNAME lookups, plus a merged `addresses` for A+AAAA
+- TXT, A, AAAA, MX, PTR, CNAME, and NS lookups, plus a merged `addresses` for A+AAAA
 - a three-way error taxonomy — `NotFound`, `ServerFailure`, `Timeout` — instead of collapsing every failure into an empty answer
 - one shared resolver across every mail library in your app, multiplexed over dnsruby's single I/O thread
 - configurable retry/timeout schedule
 - DNSSEC validation and answer caching off, unconditionally, for callers that have no way to act on either
 - test doubles — a hash-backed fake and a real loopback nameserver — so a suite never needs the network
 
-> Not a general-purpose DNS client — five record types and three errors, built for what mail authentication needs.
+> Not a general-purpose DNS client — six record types and three errors, built for what mail authentication needs.
 
 ## Contents
 
@@ -57,6 +57,7 @@ resolver.addresses("example.com")     # => ["203.0.113.10", "2001:db8::1"]
 resolver.mx("example.com")            # => ["mx1.example.com", "mx2.example.com"], sorted by preference
 resolver.ptr("203.0.113.10")          # => ["mail.example.com"]
 resolver.cname("www.example.com")     # => ["example.com"]
+resolver.ns("example.com")            # => ["ns1.example.net", "ns2.example.net"]
 ```
 
 `addresses` merges A and AAAA. A family the name doesn't publish contributes nothing to it rather than ending the lookup — but a name that doesn't exist at all raises `NoSuchName`, and a nameserver that couldn't answer still raises, same as every other method here.
@@ -106,7 +107,7 @@ DNSSEC validation and dnsruby's answer cache are both off, unconditionally. DNSS
 
 ## Custom Resolvers
 
-Anything that responds to `txt`, `a`, `aaaa`, `addresses`, `mx`, `ptr`, and `cname` — raising the three errors above — is a drop-in replacement. You don't have to write one: see [Test Doubles](#test-doubles).
+Anything that responds to `txt`, `a`, `aaaa`, `addresses`, `mx`, `ptr`, `cname`, and `ns` — raising the three errors above — is a drop-in replacement. You don't have to write one: see [Test Doubles](#test-doubles).
 
 ## Test Doubles
 

data/lib/mailresolver/resolver.rb

@@ -57,6 +57,10 @@ module MailResolver
       records("CNAME", name).map { |record| record.domainname.to_s }
     end
 
+    def ns(name)
+      records("NS", name).map { |record| record.domainname.to_s }
+    end
+
     private
       def family(type, name)
         records(type, name).map { |record| record.address.to_s.downcase }

data/lib/mailresolver/testing.rb

@@ -47,6 +47,10 @@ module MailResolver
         lookup(name, :cname)
       end
 
+      def ns(name)
+        lookup(name, :ns)
+      end
+
       private
         def family(type, name)
           lookup(name, type)

data/lib/mailresolver/version.rb

@@ -1,3 +1,3 @@
 module MailResolver
-  VERSION = "0.5.1"
+  VERSION = "0.6.0"
 end

data/mailresolver.gemspec

@@ -8,7 +8,7 @@ Gem::Specification.new do |spec|
   spec.authors = [ "Simon Lev" ]
 
   spec.summary = "DNS resolution for mail, in Ruby."
-  spec.description = "DNS resolution for mail, in Ruby. **mailresolver** is a small, injectable DNS client for mail libraries — TXT, A/AAAA, MX, PTR, and CNAME lookups."
+  spec.description = "DNS resolution for mail, in Ruby. **mailresolver** is a small, injectable DNS client for mail libraries — TXT, A/AAAA, MX, PTR, CNAME, and NS lookups."
 
   spec.homepage = "https://github.com/mailpiece/mailresolver"
   spec.license = "MIT"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mailresolver
 version: !ruby/object:Gem::Version
-  version: 0.5.1
+  version: 0.6.0
 platform: ruby
 authors:
 - Simon Lev
@@ -24,7 +24,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '1.74'
 description: DNS resolution for mail, in Ruby. **mailresolver** is a small, injectable
-  DNS client for mail libraries — TXT, A/AAAA, MX, PTR, and CNAME lookups.
+  DNS client for mail libraries — TXT, A/AAAA, MX, PTR, CNAME, and NS lookups.
 executables: []
 extensions: []
 extra_rdoc_files: []