whois-parser-next 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 64090073c595bd3cbd6e1a52628cf6d3481de3933b791d9338bf1793922dc6a4
-  data.tar.gz: b15050ea47d7662aedb25a2f0e6e0e8997c7c825b2de70e149dce0f85fd7dd8c
+  metadata.gz: 54c1fc5d5bb3d8adda3cbe6b644a0f2982195267f46654c6025090b16b7f6643
+  data.tar.gz: 8b8e0ae4f21a313e6fa65c1d4868bf28326bbc57df15e3bbfa8256c4a38f3217
 SHA512:
-  metadata.gz: 8946d38a18bdb012fc79661fc31fcf67f4e63b7cdd728e14dacf48c77a72317322f145544d89b97725f292d4e1860a2aa9ba4842824378745541aea0e9408eee
-  data.tar.gz: 8d10ae4db2cfdf8aee03bc17d4867afd56e03dfa19ddcf4ca31610acbd4957bad49a34a3c6fbbbc2988c77ae42c7f86e1c4ae8e1f2a0bd1342ffe5febd68bbbe
+  metadata.gz: c1be7e51963fefa6a8571faa4577bbdab9ca95009bd1ccf8413b65a7816a7c53539d5f05d22f456154124ec12e8d79b1b86df9f1cc1633beb4d7532dbaaf273f
+  data.tar.gz: 4d07890e7c2e5bbf59a19f076820f276256453dd1bcdfb700df51d2a1c1581395125c12ab8c2a8d2c90864c960ca99bd9590932dca4c2fe71c04a85cda225203

data/CHANGELOG.md

@@ -3,7 +3,21 @@
 This project uses [Semantic Versioning 2.0.0](http://semver.org/).
 
 
-#### Unreleased 0.1.0
+#### Release 0.2.0 (2026-09-25)
+
+- ADDED: Extended the usage-ranked audit and parser work through 1,000 ICANN
+  DNS Magnitude TLD strings from the 2026-09-12 snapshot.
+- CLARIFIED: The 1,000 rows are observed TLD strings, not 1,000 guaranteed
+  working registries or domain-availability results. The audit keeps verified
+  parser evidence, explicit unavailable or unsupported responses,
+  unknown or unresolved endpoints, and classification-only rows distinct.
+- ADDED: Preserved the source manifest, verification evidence, planning
+  inventory, and five implementation-package reports for ranks 301-1000.
+- TESTED: The combined parser and audit suite passes 6,768 examples with 0
+  failures on Ruby 3.2.2 and 3.4.5.
+
+
+#### Release 0.1.0 (2026-09-19)
 
 - CHANGED: Continued the project as `whois-parser-next`, with the original MIT
   license, attribution, and Git history preserved.

data/README.md

@@ -38,8 +38,7 @@ of current WHOIS responses, explicit unknown states, registry-specific
 fixtures, and safe handling of malformed, rate-limited, retired, or changed
 server responses.
 
-The current development gem name is `whois-parser-next`. It has not yet been
-published to RubyGems.
+The latest published RubyGems release is `0.2.0`.
 
 ## Compatibility
 
@@ -83,12 +82,21 @@ bundle exec rspec
 
 ## Coverage evidence
 
-The 2026-09-19 live audit covers the ICANN DNS Magnitude ordering through rank
-300. Start with the [Top 20 review](docs/audits/top-20-tlds-2026-09-19.md) and
-[Top 100 audit](docs/audits/top-100-tlds-2026-09-19.md); the same directory
-contains the contiguous 25-TLD reports for ranks 101 through 300. Each report
-separates verified parsing from unavailable, retired, restricted, web-only,
-and unresolved WHOIS paths.
+The 2026-09-19 integrated audit covers 1,000 observed TLD strings from the
+ICANN DNS Magnitude snapshot dated 2026-09-12. These strings are not 1,000
+guaranteed working WHOIS registries or domain-availability results. The audit
+keeps verified parser evidence, explicit unavailable or unsupported
+responses, unknown or unresolved endpoints, and classification-only rows
+distinct.
+
+Start with the [source verification report](docs/audits/top-1000-source-verification-2026-09-19.md),
+the [Top 20 review](docs/audits/top-20-tlds-2026-09-19.md), and the [Top 100
+audit](docs/audits/top-100-tlds-2026-09-19.md). The same directory contains
+the contiguous reports for ranks 101 through 300, the [301-1000 work-package
+plan](docs/audits/whois-parser-top1000-work-packages-2026-09-19.md), and the
+five package audit reports. Each report preserves the evidence boundary and
+does not turn unavailable, unsupported, unresolved, or classification-only
+rows into availability claims.
 
 ## Join the work
 

data/RELEASING.md

@@ -21,8 +21,8 @@ RubyGems API key to the repository or its Actions secrets.
 Create and push the annotated release tag only after the checks above pass:
 
 ```shell
-git tag -a v0.1.0 -m "whois-parser-next 0.1.0"
-git push origin v0.1.0
+git tag -a v0.2.0 -m "whois-parser-next 0.2.0"
+git push origin v0.2.0
 ```
 
 The release workflow repeats the full suite and package smoke test before it

data/lib/whois/parser/version.rb

@@ -1,6 +1,6 @@
 module Whois
   class Parser
     # The current library version.
-    VERSION = "0.1.0".freeze
+    VERSION = "0.2.0".freeze
   end
 end

data/lib/whois/parsers/base_centralnic_icann.rb

@@ -0,0 +1,12 @@
+require_relative 'base_icann_compliant'
+
+module Whois
+  class Parsers
+    # CentralNic registries that expose the ICANN key/value record shape.
+    class BaseCentralnicIcann < BaseIcannCompliant
+      self.scanner = Scanners::BaseIcannCompliant, {
+        pattern_available: /^The queried object does not exist:\s+DOMAIN NOT FOUND\s*$/i,
+      }
+    end
+  end
+end

data/lib/whois/parsers/base_cira_registry.rb

@@ -0,0 +1,19 @@
+require_relative 'whois.cira.ca'
+require_relative 'registry_response_safety'
+
+module Whois
+  class Parsers
+    # CIRA-shaped registries use the same record scanner, but an unexpected
+    # non-record response must remain unknown rather than becoming a parser
+    # error that callers might accidentally treat as registration.
+    class BaseCiraRegistry < WhoisCiraCa
+      include RegistryResponseSafety
+
+      property_supported :status do
+        super()
+      rescue ParserError
+        :unknown
+      end
+    end
+  end
+end

data/lib/whois/parsers/base_icann_compliant.rb

@@ -54,7 +54,7 @@ module Whois
       end
 
       property_supported :registered? do
-        [:registered, :reserved].include?(status)
+        status == :registered
       end
 
 

data/lib/whois/parsers/base_identity_digital.rb

@@ -0,0 +1,12 @@
+require_relative 'base_icann_compliant'
+
+module Whois
+  class Parsers
+    # Shared ICANN key/value parser for Identity Digital registries.
+    #
+    # Individual registries differ only in the authoritative absence marker;
+    # host-specific subclasses keep those markers explicit.
+    class BaseIdentityDigital < BaseIcannCompliant
+    end
+  end
+end

data/lib/whois/parsers/base_jwhois.rb

@@ -0,0 +1,48 @@
+require_relative 'base'
+require_relative 'registry_response_safety'
+
+module Whois
+  class Parsers
+    # Minimal parser contract for JWhoisServer responses used by the French
+    # overseas registries.  Registration is reported only from a domain line;
+    # the registry's explicit NO OBJECT FOUND marker is the sole absence proof.
+    class BaseJwhois < Base
+      include RegistryResponseSafety
+
+      property_supported :domain do
+        content_for_scanner[/^domain:\s*(\S+)\s*$/i, 1]&.downcase
+      end
+
+      property_supported :status do
+        if available?
+          :available
+        elsif registered_evidence?
+          :registered
+        else
+          :unknown
+        end
+      end
+
+      property_supported :available? do
+        content_for_scanner.match?(/^NO OBJECT FOUND!\s*$/i)
+      end
+
+      property_supported :registered? do
+        status == :registered
+      end
+
+      property_supported :nameservers do
+        content_for_scanner.scan(/^nameserver:\s*(\S+)\s*$/i).flatten.map do |name|
+          Parser::Nameserver.new(name: name.downcase)
+        end
+      end
+
+      private
+
+      def registered_evidence?
+        content_for_scanner.match?(/^domain:\s*\S+/i) &&
+          content_for_scanner.match?(/^(?:changed|nameserver):\s*\S+/i)
+      end
+    end
+  end
+end

data/lib/whois/parsers/base_nic_reserved_available.rb

@@ -0,0 +1,17 @@
+require_relative 'base_icann_compliant'
+
+module Whois
+  class Parsers
+    # Shared parser for registries that use the ICANN response layout and
+    # report an exact `Available` line for an absent object.
+    class BaseNicReservedAvailable < BaseIcannCompliant
+      self.scanner = Scanners::BaseIcannCompliant, {
+        pattern_available: /^Available\s*$/i,
+      }
+
+      def reserved?
+        content_for_scanner.match?(/^Reserved:\s*/i)
+      end
+    end
+  end
+end

data/lib/whois/parsers/base_reserved_registry.rb

@@ -0,0 +1,27 @@
+require_relative 'base'
+
+module Whois
+  class Parsers
+    # A registry response that explicitly reserves or prohibits the queried
+    # name. It is not evidence of either registration or availability.
+    class BaseReservedRegistry < Base
+      property_supported :status do
+        :unknown
+      end
+
+      property_supported :available? do
+        false
+      end
+
+      property_supported :registered? do
+        false
+      end
+
+      def response_unavailable?
+        content_for_scanner.match?(
+          /\A(?:Reserved Domain Name|This name is reserved by the Registry\b|The queried object does not exist:.*reserved list)/i
+        )
+      end
+    end
+  end
+end

data/lib/whois/parsers/base_top1000_icann.rb

@@ -0,0 +1,39 @@
+require_relative 'base_icann_compliant'
+
+module Whois
+  class Parsers
+    # Conservative ICANN-style parser shared by the package-3 registries.
+    # The absence markers are complete lines observed in current port-43
+    # responses. Empty, denied, and throttled responses remain unavailable via
+    # RegistryResponseSafety inherited from BaseIcannCompliant.
+    class BaseTop1000Icann < BaseIcannCompliant
+      AVAILABLE_MARKERS = [
+        /^No Data Found\s*$/i,
+        /^The queried object does not exist:\s*(?:DOMAIN NOT FOUND|no matching objects found)\s*$/i,
+        /^>>> Domain \S+ is available for registration\s*$/i,
+        /^Domain not found\s*$/i,
+        /^%% NOT FOUND\s*$/i,
+      ].freeze
+
+      RESERVED_MARKERS = [
+        /^Reserved Domain Name\s*$/i,
+        /^This name is reserved by the Registry\.\s*$/i,
+      ].freeze
+
+      property_supported :available? do
+        AVAILABLE_MARKERS.any? { |marker| content_for_scanner.match?(marker) }
+      end
+
+      property_supported :reserved? do
+        RESERVED_MARKERS.any? { |marker| content_for_scanner.match?(marker) }
+      end
+
+      # `reserved?` is intentionally a parser predicate rather than a public
+      # record property. BaseIcannCompliant consults it while determining the
+      # status of a reserved registry response.
+      def reserved?
+        RESERVED_MARKERS.any? { |marker| content_for_scanner.match?(marker) }
+      end
+    end
+  end
+end

data/lib/whois/parsers/base_top1000_retired.rb

@@ -0,0 +1,26 @@
+require_relative 'base'
+
+module Whois
+  class Parsers
+    # WHOIS endpoints that have retired port-43 service in favour of RDAP.
+    class BaseTop1000Retired < Base
+      property_supported :status do
+        :unknown
+      end
+
+      property_supported :available? do
+        false
+      end
+
+      property_supported :registered? do
+        false
+      end
+
+      def response_unavailable?
+        content_for_scanner.match?(
+          /^Notice: Effective May 1, 2026, the WHOIS service has been retired\b/i
+        )
+      end
+    end
+  end
+end

data/lib/whois/parsers/base_unsupported_registry.rb

@@ -21,7 +21,7 @@ module Whois
 
       def response_unavailable?
         content_for_scanner.match?(
-          /^(?:TLD is not supported\.|No Data Found)\s*$/i
+          /\A(?:TLD is not supported\.|No Data Found)[ \t]*(?:\n|\z)/i
         )
       end
     end

data/lib/whois/parsers/cwhois.cnnic.cn.rb

@@ -0,0 +1,10 @@
+require_relative 'whois.cnnic.cn'
+
+module Whois
+  class Parsers
+    # The registry publishes both `cwhois.cnnic.cn` and the historical
+    # `whois.cnnic.cn` service name.  Keep both names on the same parser.
+    class CwhoisCnnicCn < WhoisCnnicCn
+    end
+  end
+end

data/lib/whois/parsers/registry_response_safety.rb

@@ -22,6 +22,8 @@ module Whois
       def response_unavailable?
         response_incomplete? || content_for_scanner.match?(
           /^(?:\s*(?:%|#)\s*)?(?:requests of this client are not permitted|access to the whois service is denied|whois service is unavailable)\b/i
+        ) || content_for_scanner.match?(
+          /\ATLD is not supported\.[ \t]*(?:\n|\z)/i
         )
       end
     end

data/lib/whois/parsers/whois.ax.rb

@@ -8,6 +8,7 @@
 
 
 require_relative 'base'
+require_relative 'registry_response_safety'
 
 
 module Whois
@@ -23,21 +24,25 @@ module Whois
     #   The Example parser for the list of all available methods.
     #
     class WhoisAx < Base
+      include RegistryResponseSafety
 
       property_supported :status do
         if available?
           :available
-        else
+        elsif registered_evidence?
           :registered
+        else
+          :unknown
         end
       end
 
       property_supported :available? do
-        !!(content_for_scanner =~ /^No records matching .+ found/)
+        !!(content_for_scanner =~ /^No records matching \S+ found\.\s*$/i ||
+           content_for_scanner =~ /^Domain not found\s*$/i)
       end
 
       property_supported :registered? do
-        !available?
+        status == :registered
       end
 
 
@@ -58,6 +63,13 @@ module Whois
         end
       end
 
+      private
+
+      def registered_evidence?
+        content_for_scanner.match?(/^Domain Name:\s+\S+/i) &&
+          content_for_scanner.match?(/^(?:Created|Name Server \d):\s+\S+/i)
+      end
+
     end
 
   end

data/lib/whois/parsers/whois.cnnic.cn.rb

@@ -8,6 +8,7 @@
 
 
 require_relative 'base'
+require_relative 'registry_response_safety'
 require 'whois/scanners/whois.cnnic.cn.rb'
 
 
@@ -16,10 +17,13 @@ module Whois
 
     # Parser for the whois.cnnic.cn server.
     class WhoisCnnicCn < Base
+      include RegistryResponseSafety
       include Scanners::Scannable
 
       self.scanner = Scanners::WhoisCnnicCn
 
+      RESPONSE_MARKER = /(?:^No matching record\.?\s*$|^The domain you requested is prohibited\.?\s*$|^Sorry, The domain you requested is in the reserved list\.?\s*$|^Domain Name:\s*\S+)/i
+
 
       property_not_supported :disclaimer
 
@@ -34,15 +38,26 @@ module Whois
 
 
       property_supported :status do
-        Array.wrap node("Domain Status")
+        return [] if available? || reserved?
+        return :unknown unless recognized_response?
+
+        statuses = Array.wrap node("Domain Status")
+        if statuses.empty?
+          :unknown
+        else
+          statuses
+        end
       end
 
       property_supported :available? do
+        return true if content_for_scanner.match?(/^No matching record\.?\s*$/i)
+        return false unless recognized_response?
+
         !!node("status:available")
       end
 
       property_supported :registered? do
-        !reserved? && !available?
+        status.is_a?(Array) && !status.empty? && registered_evidence?
       end
 
 
@@ -86,12 +101,25 @@ module Whois
 
       # NEWPROPERTY
       def reserved?
+        return true if content_for_scanner.match?(/^The domain you requested is prohibited\.?\s*$/i)
+        return true if content_for_scanner.match?(/^Sorry, The domain you requested is in the reserved list\.?\s*$/i)
+        return false unless recognized_response?
+
         !!node("status:reserved")
       end
 
-
       private
 
+      def registered_evidence?
+        !node("Domain Name").to_s.strip.empty? &&
+          !Array.wrap(node("Domain Status")).empty?
+      end
+
+      def recognized_response?
+        content_for_scanner.match?(RESPONSE_MARKER)
+      end
+
+
       def build_contact(element, type)
         node("#{element}") do |value|
           Parser::Contact.new(

data/lib/whois/parsers/whois.dominio.gq.rb

@@ -0,0 +1,11 @@
+require_relative 'base_unsupported_registry'
+
+module Whois
+  class Parsers
+    class WhoisDominioGq < BaseUnsupportedRegistry
+      def response_unavailable?
+        super || content_for_scanner.match?(/\AThe domain you requested is not known in Freenoms database\.\n\nThis TLD has no whois server\./i)
+      end
+    end
+  end
+end

data/lib/whois/parsers/whois.dotukr.com.rb

@@ -0,0 +1,23 @@
+require_relative 'base'
+require_relative 'registry_response_safety'
+
+module Whois
+  class Parsers
+    # The .укр registry uses an exact "No match for domain" response.
+    class WhoisDotukrCom < Base
+      include RegistryResponseSafety
+
+      property_supported :status do
+        available? ? :available : :unknown
+      end
+
+      property_supported :available? do
+        !!(content_for_scanner =~ /^No match for domain\s+\S+\.?\s*$/i)
+      end
+
+      property_supported :registered? do
+        false
+      end
+    end
+  end
+end

data/lib/whois/parsers/whois.gtld.knet.cn.rb

@@ -0,0 +1,10 @@
+require_relative 'base_identity_digital'
+module Whois
+  class Parsers
+    class WhoisGtldKnetCn < BaseIdentityDigital
+      self.scanner = Scanners::BaseIcannCompliant, {
+        pattern_available: /^The queried object does not exist:\s+[A-Za-z0-9](?:[A-Za-z0-9-]*[A-Za-z0-9])?(?:\.[A-Za-z0-9](?:[A-Za-z0-9-]*[A-Za-z0-9])?)+\s*$/i,
+      }
+    end
+  end
+end

data/lib/whois/parsers/whois.kyregistry.ky.rb

@@ -0,0 +1,10 @@
+require_relative 'whois.nic.store'
+
+module Whois
+  class Parsers
+    # The .ky registry uses the ICANN layout and Radix's exact availability
+    # sentence.
+    class WhoisKyregistryKy < WhoisNicStore
+    end
+  end
+end

data/lib/whois/parsers/whois.madrid.rs.corenic.net.rb

@@ -0,0 +1,8 @@
+require_relative 'base_identity_digital'
+module Whois
+  class Parsers
+    class WhoisMadridRsCorenicNet < BaseIdentityDigital
+      self.scanner = Scanners::BaseIcannCompliant, { pattern_available: /^The queried object does not exist: no matching objects found\s*$/i }
+    end
+  end
+end

data/lib/whois/parsers/whois.mediaserv.net.rb

@@ -0,0 +1,9 @@
+require_relative 'base_jwhois'
+
+module Whois
+  class Parsers
+    # Parser for the JWhoisServer shared by .gf and .mq.
+    class WhoisMediaservNet < BaseJwhois
+    end
+  end
+end

data/lib/whois/parsers/whois.ngtld.cn.rb

@@ -0,0 +1,8 @@
+require_relative 'base_reserved_registry'
+
+module Whois
+  class Parsers
+    class WhoisNgtldCn < BaseReservedRegistry
+    end
+  end
+end

data/lib/whois/parsers/whois.nic.academy.rb

@@ -0,0 +1,8 @@
+require_relative 'base_unsupported_registry'
+
+module Whois
+  class Parsers
+    class WhoisNicAcademy < BaseUnsupportedRegistry
+    end
+  end
+end

data/lib/whois/parsers/whois.nic.accountant.rb

@@ -0,0 +1,8 @@
+require_relative 'base_reserved_registry'
+
+module Whois
+  class Parsers
+    class WhoisNicAccountant < BaseReservedRegistry
+    end
+  end
+end

data/lib/whois/parsers/whois.nic.actor.rb

@@ -0,0 +1,8 @@
+require_relative 'base_unsupported_registry'
+
+module Whois
+  class Parsers
+    class WhoisNicActor < BaseUnsupportedRegistry
+    end
+  end
+end

data/lib/whois/parsers/whois.nic.agency.rb

@@ -0,0 +1,8 @@
+require_relative 'base_unsupported_registry'
+
+module Whois
+  class Parsers
+    class WhoisNicAgency < BaseUnsupportedRegistry
+    end
+  end
+end

data/lib/whois/parsers/whois.nic.airforce.rb

@@ -0,0 +1,8 @@
+require_relative 'base_unsupported_registry'
+
+module Whois
+  class Parsers
+    class WhoisNicAirforce < BaseUnsupportedRegistry
+    end
+  end
+end

data/lib/whois/parsers/whois.nic.amsterdam.rb

@@ -0,0 +1,8 @@
+require_relative 'base_identity_digital'
+module Whois
+  class Parsers
+    class WhoisNicAmsterdam < BaseIdentityDigital
+      self.scanner = Scanners::BaseIcannCompliant, { pattern_available: /^Domain Status:\s*free\s*$/i }
+    end
+  end
+end

data/lib/whois/parsers/whois.nic.apartments.rb

@@ -0,0 +1,8 @@
+require_relative 'base_unsupported_registry'
+
+module Whois
+  class Parsers
+    class WhoisNicApartments < BaseUnsupportedRegistry
+    end
+  end
+end

data/lib/whois/parsers/whois.nic.army.rb

@@ -0,0 +1,8 @@
+require_relative 'base_unsupported_registry'
+
+module Whois
+  class Parsers
+    class WhoisNicArmy < BaseUnsupportedRegistry
+    end
+  end
+end

data/lib/whois/parsers/whois.nic.associates.rb

@@ -0,0 +1,8 @@
+require_relative 'base_unsupported_registry'
+
+module Whois
+  class Parsers
+    class WhoisNicAssociates < BaseUnsupportedRegistry
+    end
+  end
+end

data/lib/whois/parsers/whois.nic.auction.rb

@@ -0,0 +1,8 @@
+require_relative 'base_unsupported_registry'
+
+module Whois
+  class Parsers
+    class WhoisNicAuction < BaseUnsupportedRegistry
+    end
+  end
+end