whois-parser-next 0.1.0

data/lib/whois/parsers/base_verisign.rb

@@ -0,0 +1,106 @@
+#--
+# Ruby Whois
+#
+# An intelligent pure Ruby WHOIS client and parser.
+#
+# Copyright (c) 2009-2022 Simone Carletti <weppos@weppos.net>
+#++
+
+
+require_relative 'base'
+require 'whois/scanners/verisign'
+
+
+module Whois
+  class Parsers
+
+    class BaseVerisign < Base
+      include Scanners::Scannable
+
+      self.scanner = Scanners::Verisign
+
+
+      property_supported :disclaimer do
+        node("Disclaimer")
+      end
+
+
+      property_supported :domain do
+        node("Domain Name", &:downcase)
+      end
+
+      property_supported :domain_id do
+        node("Registry Domain ID")
+      end
+
+
+      property_supported :status do
+        # node("Status")
+        if available?
+          :available
+        else
+          :registered
+        end
+      end
+
+      property_supported :available? do
+        !!(content_for_scanner =~ /^No match for/)
+      end
+
+      property_supported :registered? do
+        !available?
+      end
+
+
+      property_supported :created_on do
+        node("Creation Date") { |value| parse_time(value) }
+      end
+
+      property_supported :updated_on do
+        node("Updated Date") { |value| parse_time(value) }
+      end
+
+      property_supported :expires_on do
+        node("Registry Expiry Date") { |value| parse_time(value) }
+      end
+
+
+      property_supported :registrar do
+        node("Registrar") do |value|
+          Parser::Registrar.new(
+              id:           last_useful_item(node("Registrar IANA ID")),
+              name:         last_useful_item(value),
+              url:          referral_url
+          )
+        end
+      end
+
+
+      property_supported :nameservers do
+        Array.wrap(node("Name Server")).reject { |value| value =~ /no nameserver/i }.map do |name|
+          Parser::Nameserver.new(name: name.downcase)
+        end
+      end
+
+
+      def referral_whois
+        node("Registrar WHOIS Server")
+      end
+
+      def referral_url
+        last_useful_item(node("Registrar URL"))
+      end
+
+
+      private
+
+      # In case of "SPAM Response", the response contains more than one item
+      # for the same value and the value becomes an Array.
+      def last_useful_item(values)
+        values.is_a?(Array) ? values.last : values
+      end
+
+    end
+
+  end
+end

data/lib/whois/parsers/base_whoisd.rb

@@ -0,0 +1,150 @@
+#--
+# Ruby Whois
+#
+# An intelligent pure Ruby WHOIS client and parser.
+#
+# Copyright (c) 2009-2022 Simone Carletti <weppos@weppos.net>
+#++
+
+
+require_relative 'base'
+require_relative 'registry_response_safety'
+require 'whois/scanners/base_whoisd'
+
+
+module Whois
+  class Parsers
+
+    # Base parser for Whoisd servers.
+    #
+    # @abstract
+    class BaseWhoisd < Base
+      include RegistryResponseSafety
+      include Scanners::Scannable
+
+      class_attribute :status_mapping
+
+      self.status_mapping = {
+        "paid and in zone" => :registered,
+        "expired" => :expired,
+      }
+      self.scanner = Scanners::BaseWhoisd
+
+
+      property_supported :domain do
+        node('domain')
+      end
+
+      property_not_supported :domain_id
+
+
+      property_supported :status do
+        if available?
+          :available
+        elsif node('status')
+          values = Array.wrap(node('status'))
+          mapped_status = values.filter_map { |value| self.class.status_mapping[value.downcase] }.first
+          mapped_status || Whois::Parser.bug!(ParserError, "Unknown status `#{values.join(', ')}'.")
+        elsif node('domain') && [node('registered'), node('registrar'), node('expire')].any?(&:present?)
+          :registered
+        else
+          :unknown
+        end
+      end
+
+      property_supported :available? do
+        !!node('status:available')
+      end
+
+      property_supported :registered? do
+        [:registered, :expired].include?(status)
+      end
+
+
+      property_supported :created_on do
+        node('registered') { |string| parse_time(string) }
+      end
+
+      property_supported :updated_on do
+        node('changed') { |string| parse_time(string) }
+      end
+
+      property_supported :expires_on do
+        node('expire') { |string| parse_time(string) }
+      end
+
+
+      property_supported :registrar do
+        node('registrar') do |string|
+          Parser::Registrar.new(
+              :id           => string,
+              :name         => string
+          )
+        end
+      end
+
+      property_supported :registrant_contacts do
+        node('registrant') do |value|
+          build_contact(value, Parser::Contact::TYPE_REGISTRANT)
+        end
+      end
+
+      property_supported :admin_contacts do
+        node('admin-c') do |value|
+          build_contact(value, Parser::Contact::TYPE_ADMINISTRATIVE)
+        end
+      end
+
+      property_supported :technical_contacts do
+        id = node_nsset['tech-c'] rescue nil
+        if id
+          build_contact(id, Parser::Contact::TYPE_TECHNICAL)
+        end
+      end
+
+
+      property_supported :nameservers do
+        lines = node_nsset['nserver'] rescue nil
+        Array.wrap(lines).map do |line|
+          if line =~ /(.+) \((.+)\)/
+            name = ::Regexp.last_match(1)
+            ipv4, ipv6 = ::Regexp.last_match(2).split(', ')
+            Parser::Nameserver.new(:name => name, :ipv4 => ipv4, :ipv6 => ipv6)
+          else
+            Parser::Nameserver.new(:name => line.strip)
+          end
+        end
+      end
+
+
+      private
+
+      def node_nsset
+        node("node:nsset/#{node('nsset')}")
+      end
+
+      def build_contact(element, type)
+        node("node:contact/#{element}") do |hash|
+          address = hash['street'] || hash['address']
+          address = address.join("\n") if address.respond_to?(:join)
+
+          Parser::Contact.new(
+              :type           => type,
+              :id             => element,
+              :name           => hash['name'],
+              :organization   => hash['org'],
+              :address        => address,
+              :city           => hash['city'],
+              :zip            => hash['postal code'],
+              :country_code   => hash['country'],
+              :phone          => hash['phone'],
+              :email          => hash['e-mail'],
+              :created_on     => parse_time(hash['created'])
+          )
+        end
+      end
+
+    end
+
+  end
+end

data/lib/whois/parsers/blank.rb

@@ -0,0 +1,35 @@
+#--
+# Ruby Whois
+#
+# An intelligent pure Ruby WHOIS client and parser.
+#
+# Copyright (c) 2009-2022 Simone Carletti <weppos@weppos.net>
+#++
+
+
+require_relative 'base'
+
+
+module Whois
+  class Parsers
+
+    # The Blank parser isn't a real parser. It's just a fake parser
+    # that acts as a parser but doesn't provide any special capability.
+    #
+    # It doesn't register itself in the parser_registry,
+    # it doesn't scan any string, it only exists to be initialized
+    # in case a record needs to create a parser for a WHOIS server
+    # not yet supported.
+    #
+    class Blank < Base
+
+      Parser::PROPERTIES.each do |method|
+        define_method(method) do
+          raise ParserNotFound, "Unable to find a parser for the server `#{part.host}'"
+        end
+      end
+
+    end
+
+  end
+end

data/lib/whois/parsers/capetown-whois.registry.net.za.rb

@@ -0,0 +1,25 @@
+#--
+# Ruby Whois
+#
+# An intelligent pure Ruby WHOIS client and parser.
+#
+# Copyright (c) 2009-2022 Simone Carletti <weppos@weppos.net>
+#++
+
+
+require_relative 'za_central_registry'
+
+
+module Whois
+  class Parsers
+
+    # Parser for the capetown-whois.registry.net.za server.
+    #
+    # @see Whois::Parsers::Example
+    #   The Example parser for the list of all available methods.
+    #
+    class CapetownWhoisRegistryNetZa < ZaCentralRegistry
+    end
+
+  end
+end

data/lib/whois/parsers/ccwhois.ksregistry.net.rb

@@ -0,0 +1,25 @@
+#--
+# Ruby Whois
+#
+# An intelligent pure Ruby WHOIS client and parser.
+#
+# Copyright (c) 2009-2022 Simone Carletti <weppos@weppos.net>
+#++
+
+
+require_relative 'base_shared3'
+
+
+module Whois
+  class Parsers
+
+    # Parser for the ccwhois.ksregistry.net server.
+    #
+    # @see Whois::Parsers::Example
+    #   The Example parser for the list of all available methods.
+    #
+    class CcwhoisKsregistryNet < BaseShared3
+    end
+
+  end
+end

data/lib/whois/parsers/ccwhois.verisign-grs.com.rb

@@ -0,0 +1,25 @@
+#--
+# Ruby Whois
+#
+# An intelligent pure Ruby WHOIS client and parser.
+#
+# Copyright (c) 2009-2022 Simone Carletti <weppos@weppos.net>
+#++
+
+
+require_relative 'base_verisign'
+
+
+module Whois
+  class Parsers
+
+    # Parser for the ccwhois.verisign-grs.com server.
+    #
+    # @see Whois::Parsers::Example
+    #   The Example parser for the list of all available methods.
+    #
+    class CcwhoisVerisignGrsCom < BaseVerisign
+    end
+
+  end
+end

data/lib/whois/parsers/coza-whois.registry.net.za.rb

@@ -0,0 +1,25 @@
+#--
+# Ruby Whois
+#
+# An intelligent pure Ruby WHOIS client and parser.
+#
+# Copyright (c) 2009-2022 Simone Carletti <weppos@weppos.net>
+#++
+
+
+require_relative 'za_central_registry'
+
+
+module Whois
+  class Parsers
+
+    # Parser for the coza-whois.registry.za.net server.
+    #
+    # @see Whois::Parsers::Example
+    #   The Example parser for the list of all available methods.
+    #
+    class CozaWhoisRegistryNetZa < ZaCentralRegistry
+    end
+
+  end
+end

data/lib/whois/parsers/durban-whois.registry.net.za.rb

@@ -0,0 +1,25 @@
+#--
+# Ruby Whois
+#
+# An intelligent pure Ruby WHOIS client and parser.
+#
+# Copyright (c) 2009-2022 Simone Carletti <weppos@weppos.net>
+#++
+
+
+require_relative 'za_central_registry'
+
+
+module Whois
+  class Parsers
+
+    # Parser for the durban-whois.registry.net.za server.
+    #
+    # @see Whois::Parsers::Example
+    #   The Example parser for the list of all available methods.
+    #
+    class DurbanWhoisRegistryNetZa < ZaCentralRegistry
+    end
+
+  end
+end

data/lib/whois/parsers/example.rb

@@ -0,0 +1,163 @@
+#--
+# Ruby Whois
+#
+# An intelligent pure Ruby WHOIS client and parser.
+#
+# Copyright (c) 2009-2022 Simone Carletti <weppos@weppos.net>
+#++
+
+
+require_relative 'base'
+
+
+module Whois
+  class Parsers
+
+    # Parser for the whois.example.com server.
+    #
+    # In case you are not implementing all the methods,
+    # please add the following statement to the class docblock.
+    #
+    # @note This parser is just a stub and provides only a few basic methods
+    #   to check for domain availability and get domain status.
+    #   Please consider to contribute implementing missing methods.
+    class Example < Base
+
+      # Gets the registry disclaimer that comes with the record.
+      #
+      # Returns a String with the disclaimer if available,
+      # <tt>nil</tt> otherwise.
+      property_supported :disclaimer do
+        nil
+      end
+
+
+      # Gets the domain name as stored by the registry.
+      #
+      # Returns a String with the domain name if available,
+      # <tt>nil</tt> otherwise.
+      property_supported :domain do
+        nil
+      end
+
+      # Gets the unique domain ID as stored by the registry.
+      #
+      # Returns a String with the domain ID if available,
+      # <tt>nil</tt> otherwise.
+      property_supported :domain_id do
+        nil
+      end
+
+
+      # Gets the record status or statuses.
+      #
+      # Returns a String/Array with the record status if available,
+      # <tt>nil</tt> otherwise.
+      property_supported :status do
+        nil
+      end
+
+      # Checks whether this record is available.
+      #
+      # Returns true/false depending whether this record is available.
+      property_supported :available? do
+        nil
+      end
+
+      # Checks whether this record is registered.
+      #
+      # Returns true/false depending this record is available.
+      property_supported :registered? do
+        nil
+      end
+
+
+      # Gets the date the record was created,
+      # according to the registry record.
+      #
+      # Returns a Time object representing the date the record was created or
+      # <tt>nil</tt> otherwise.
+      property_supported :created_on do
+        nil
+      end
+
+      # Gets the date the record was last updated,
+      # according to the registry record.
+      #
+      # Returns a Time object representing the date the record was last updated or
+      # <tt>nil</tt> if not available.
+      property_supported :updated_on do
+        nil
+      end
+
+      # Gets the date the record is set to expire,
+      # according to the registry record.
+      #
+      # Returns a Time object representing the date the record is set to expire or
+      # <tt>nil</tt> if not available.
+      property_supported :expires_on do
+        nil
+      end
+
+
+      # Gets the registrar object containing the registrar details
+      # extracted from the registry record.
+      #
+      # Returns an instance of <tt>Parser::Registrar</tt> representing the registrar or
+      # <tt>nil</tt> if not available.
+      property_supported :registrar do
+        nil
+      end
+
+
+      # Gets the registrant contact object containing the details of the record owner
+      # extracted from the registry record.
+      #
+      # Returns an instance of <tt>Parser::Contact</tt> representing the registrant contact or
+      # <tt>nil</tt> if not available.
+      property_supported :registrant_contacts do
+        nil
+      end
+
+      # Gets the administrative contact object containing the details of the record administrator
+      # extracted from the registry record.
+      #
+      # Returns an instance of <tt>Parser::Contact</tt> representing the administrative contact or
+      # <tt>nil</tt> if not available.
+      property_supported :admin_contacts do
+        nil
+      end
+
+      # Gets the technical contact object containing the details of the technical representative
+      # extracted from the registry record.
+      #
+      # Returns an instance of <tt>Parser::Contact</tt> representing the technical contact or
+      # <tt>nil</tt> if not available.
+      property_supported :technical_contacts do
+        nil
+      end
+
+
+      # Gets the list of name server entries for this record,
+      # extracted from the registry record.
+      #
+      # @example
+      #   nameserver
+      #   # => []
+      #
+      # @example
+      #   nameserver
+      #   # => [
+      #   #     #<struct Parser::Nameserver name="ns1.google.com">,
+      #   #     #<struct Parser::Nameserver name="ns2.google.com">
+      #   #    ]
+      #
+      # @return [Array<Parser::Nameserver>]
+      property_supported :nameservers do
+        []
+      end
+
+    end
+
+  end
+end

data/lib/whois/parsers/joburg-whois.registry.net.za.rb

@@ -0,0 +1,25 @@
+#--
+# Ruby Whois
+#
+# An intelligent pure Ruby WHOIS client and parser.
+#
+# Copyright (c) 2009-2022 Simone Carletti <weppos@weppos.net>
+#++
+
+
+require_relative 'za_central_registry'
+
+
+module Whois
+  class Parsers
+
+    # Parser for the joburg-whois.registry.net.za server.
+    #
+    # @see Whois::Parsers::Example
+    #   The Example parser for the list of all available methods.
+    #
+    class JoburgWhoisRegistryNetZa < ZaCentralRegistry
+    end
+
+  end
+end

data/lib/whois/parsers/kero.yachay.pe.rb

@@ -0,0 +1,97 @@
+#--
+# Ruby Whois
+#
+# An intelligent pure Ruby WHOIS client and parser.
+#
+# Copyright (c) 2009-2022 Simone Carletti <weppos@weppos.net>
+#++
+
+
+require_relative 'base'
+
+
+module Whois
+  class Parsers
+
+    # Parser for the kero.yachay.pe server.
+    #
+    # @note This parser is just a stub and provides only a few basic methods
+    #   to check for domain availability and get domain status.
+    #   Please consider to contribute implementing missing methods.
+    #
+    # @see Whois::Parsers::Example
+    #   The Example parser for the list of all available methods.
+    #
+    class KeroYachayPe < Base
+
+      property_supported :status do
+        if content_for_scanner =~ /Status:\s+(.+?)\n/
+          case ::Regexp.last_match(1).strip.downcase
+          when "active"
+            :registered
+          # NEWSTATUS suspended (https://github.com/weppos/whois/issues/5)
+          when "suspended"
+            :registered
+          when "not registered"
+            :available
+          when "no object found"
+            :available
+          when "inactive"
+            :inactive
+          else
+            current_statuses = %w[clientdeleteprohibited clienttransferprohibited clientupdateprohibited]
+            if current_statuses.include?(::Regexp.last_match(1).strip.downcase)
+              :registered
+            else
+              Whois::Parser.bug!(ParserError, "Unknown status `#{::Regexp.last_match(1)}'.")
+            end
+          end
+        elsif content_for_scanner =~ /^Domain Status:\s+No Object Found\s*$/i
+          :available
+        elsif content_for_scanner.match?(/^Domain Status:\s+/i)
+          :registered
+        else
+          Whois::Parser.bug!(ParserError, "Unable to parse status.")
+        end
+      end
+
+      property_supported :available? do
+        status == :available
+      end
+
+      property_supported :registered? do
+        !available?
+      end
+
+
+      property_not_supported :created_on
+
+      property_not_supported :updated_on
+
+      property_not_supported :expires_on
+
+
+      property_supported :nameservers do
+        if content_for_scanner =~ /Name Servers:\n((.+\n)+)\n/
+          ::Regexp.last_match(1).split("\n").map do |name|
+            Parser::Nameserver.new(:name => name.strip)
+          end
+        end
+      end
+
+
+      # Checks whether the response has been throttled.
+      #
+      # @return [Boolean]
+      #
+      # @example
+      #   Looup quota exceeded.
+      #
+      def response_throttled?
+        !content_for_scanner.match(/Looup quota exceeded./).nil?
+      end
+
+    end
+
+  end
+end