whois-parser 0.0.1 → 1.0.0.pre.beta1

data/lib/whois/parsers/base_shared1.rb

@@ -0,0 +1,108 @@
+#--
+# Ruby Whois
+#
+# An intelligent pure Ruby WHOIS client and parser.
+#
+# Copyright (c) 2009-2015 Simone Carletti <weppos@weppos.net>
+#++
+
+
+require_relative 'base'
+require 'whois/scanners/base_shared1'
+
+
+module Whois
+  class Parsers
+
+    # Shared parser 1.
+    #
+    # @abstract
+    class BaseShared1 < Base
+      include Scanners::Scannable
+
+      self.scanner = Scanners::BaseShared1
+
+
+      property_not_supported :disclaimer
+
+
+      property_supported :domain do
+        node('Domain Name')
+      end
+
+      property_not_supported :domain_id
+
+
+      property_supported :status do
+        if respond_to?(:reserved?) && reserved?
+          :reserved
+        else
+          Array.wrap(node("Status"))
+        end
+      end
+
+      property_supported :available? do
+        !(respond_to?(:reserved?) && reserved?) && !!node('status:available')
+      end
+
+      property_supported :registered? do
+        !(respond_to?(:reserved?) && reserved?) && !available?
+      end
+
+
+      property_not_supported :created_on
+
+      property_not_supported :updated_on
+
+      property_not_supported :expires_on
+
+
+      property_supported :registrar do
+        node('Registrar Name') do |name|
+          Parser::Registrar.new(
+              :id           => node('Registrar ID'),
+              :name         => node('Registrar Name'),
+              :organization => node('Registrar Name')
+          )
+        end
+      end
+
+
+      property_supported :registrant_contacts do
+        build_contact('Registrant', Parser::Contact::TYPE_REGISTRANT)
+      end
+
+      property_not_supported :admin_contacts
+
+      property_supported :technical_contacts do
+        build_contact('Tech', Parser::Contact::TYPE_TECHNICAL)
+      end
+
+
+      property_supported :nameservers do
+        node('Name Server') do |value|
+          ipv4s = node('Name Server IP') || Array.new(value.size)
+          value.zip(ipv4s).map do |name, ipv4|
+            Parser::Nameserver.new(:name => name, :ipv4 => ipv4)
+          end
+        end
+      end
+
+
+      private
+
+      def build_contact(element, type)
+        node("#{element} Contact ID") do
+          Parser::Contact.new(
+              :type         => type,
+              :id           => node("#{element} Contact ID"),
+              :name         => node("#{element} Contact Name"),
+              :email        => node("#{element} Contact Email")
+          )
+        end
+      end
+
+    end
+
+  end
+end

data/lib/whois/parsers/base_shared2.rb

@@ -0,0 +1,127 @@
+#--
+# Ruby Whois
+#
+# An intelligent pure Ruby WHOIS client and parser.
+#
+# Copyright (c) 2009-2015 Simone Carletti <weppos@weppos.net>
+#++
+
+
+require_relative 'base'
+require 'whois/scanners/base_shared2'
+
+
+module Whois
+  class Parsers
+
+    # Shared parser 2.
+    #
+    # @abstract
+    class BaseShared2 < Base
+      include Scanners::Scannable
+
+      self.scanner = Scanners::BaseShared2
+
+
+      # Actually the :disclaimer is supported,
+      # but extracting it with the current scanner
+      # would require too much effort.
+      # property_supported :disclaimer
+
+
+      property_supported :domain do
+        node("Domain Name", &:downcase)
+      end
+
+      property_supported :domain_id do
+        node("Domain ID")
+      end
+
+
+      property_supported :status do
+        node("Domain Status") { |value| Array.wrap(value) }
+      end
+
+      property_supported :available? do
+        !!node("status:available")
+      end
+
+      property_supported :registered? do
+        !available?
+      end
+
+
+      property_supported :created_on do
+        node("Domain Registration Date") { |value| parse_time(value) }
+      end
+
+      property_supported :updated_on do
+        node("Domain Last Updated Date") { |value| parse_time(value) }
+      end
+
+      property_supported :expires_on do
+        node("Domain Expiration Date") { |value| parse_time(value) }
+      end
+
+
+      property_supported :registrar do
+        node("Sponsoring Registrar") do |str|
+          Parser::Registrar.new(
+            :id           => node("Sponsoring Registrar IANA ID"),
+            :name         => node("Sponsoring Registrar")
+          )
+        end
+      end
+
+
+      property_supported :registrant_contacts do
+        build_contact("Registrant", Parser::Contact::TYPE_REGISTRANT)
+      end
+
+      property_supported :admin_contacts do
+        build_contact("Administrative Contact", Parser::Contact::TYPE_ADMINISTRATIVE)
+      end
+
+      property_supported :technical_contacts do
+        build_contact("Technical Contact", Parser::Contact::TYPE_TECHNICAL)
+      end
+
+
+      property_supported :nameservers do
+        Array.wrap(node("Name Server")).map do |name|
+          Parser::Nameserver.new(:name => name.downcase)
+        end
+      end
+
+
+      private
+
+      def build_contact(element, type)
+        node("#{element} ID") do |str|
+          address = (1..3).
+              map { |i| node("#{element} Address#{i}") }.
+              delete_if(&:nil?).
+              join("\n")
+
+          Parser::Contact.new(
+            :type         => type,
+            :id           => node("#{element} ID"),
+            :name         => node("#{element} Name"),
+            :organization => node("#{element} Organization"),
+            :address      => address,
+            :city         => node("#{element} City"),
+            :zip          => node("#{element} Postal Code"),
+            :state        => node("#{element} State/Province"),
+            :country      => node("#{element} Country"),
+            :country_code => node("#{element} Country Code"),
+            :phone        => node("#{element} Phone Number"),
+            :fax          => node("#{element} Facsimile Number"),
+            :email        => node("#{element} Email")
+          )
+        end
+      end
+
+    end
+
+  end
+end

data/lib/whois/parsers/base_shared3.rb

@@ -0,0 +1,127 @@
+#--
+# Ruby Whois
+#
+# An intelligent pure Ruby WHOIS client and parser.
+#
+# Copyright (c) 2009-2015 Simone Carletti <weppos@weppos.net>
+#++
+
+
+require_relative 'base'
+require 'whois/scanners/base_shared3'
+
+
+module Whois
+  class Parsers
+
+    # Shared parser 3.
+    #
+    # @abstract
+    class BaseShared3 < Base
+      include Scanners::Scannable
+
+      self.scanner = Scanners::BaseShared3
+
+
+      property_supported :disclaimer do
+        node("field:disclaimer")
+      end
+
+
+      property_supported :domain do
+        node("domain name", &:downcase)
+      end
+
+      property_not_supported :domain_id
+
+
+      property_supported :status do
+        if respond_to?(:reserved?) && reserved?
+          :reserved
+        elsif available?
+          :available
+        else
+          :registered
+        end
+      end
+
+      property_supported :available? do
+        !(respond_to?(:reserved?) && reserved?) && !!node("status:available")
+      end
+
+      property_supported :registered? do
+        !(respond_to?(:reserved?) && reserved?) && !available?
+      end
+
+
+      property_supported :created_on do
+        node("created 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("expiration date") { |value| parse_time(value) }
+      end
+
+
+      property_supported :registrar do
+        node("registrar") do |raw|
+          Parser::Registrar.new(
+            :id           => nil,
+            :name         => node("registrar"),
+            :organization => nil,
+            :url          => node("url")
+          )
+        end
+      end
+
+      property_supported :registrant_contacts do
+        build_contact("owner", Parser::Contact::TYPE_REGISTRANT)
+      end
+
+      property_supported :admin_contacts do
+        build_contact("admin", Parser::Contact::TYPE_ADMINISTRATIVE)
+      end
+
+      property_supported :technical_contacts do
+        build_contact("tech", Parser::Contact::TYPE_TECHNICAL)
+      end
+
+
+      property_supported :nameservers do
+        node("nameserver") do |array|
+          array.map do |name|
+            Parser::Nameserver.new(:name => name)
+          end
+        end
+      end
+
+
+      private
+
+      def build_contact(element, type)
+        node("#{element}-contact") do |raw|
+          Parser::Contact.new(
+              :type         => type,
+              :id           => node("#{element}-contact"),
+              :name         => node("#{element}-name"),
+              :organization => node("#{element}-organization"),
+              :address      => node("#{element}-street"),
+              :city         => node("#{element}-city"),
+              :zip          => node("#{element}-zip"),
+              :state        => nil,
+              :country_code => node("#{element}-country"),
+              :phone        => node("#{element}-phone"),
+              :fax          => node("#{element}-fax"),
+              :email        => node("#{element}-email")
+          )
+        end
+      end
+
+    end
+
+  end
+end

data/lib/whois/parsers/base_verisign.rb

@@ -0,0 +1,106 @@
+#--
+# Ruby Whois
+#
+# An intelligent pure Ruby WHOIS client and parser.
+#
+# Copyright (c) 2009-2015 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("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("Sponsoring Registrar") do |value|
+          Parser::Registrar.new(
+              id:           last_useful_item(node("Sponsoring 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("Whois Server")
+      end
+
+      def referral_url
+        last_useful_item(node("Referral 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,145 @@
+#--
+# Ruby Whois
+#
+# An intelligent pure Ruby WHOIS client and parser.
+#
+# Copyright (c) 2009-2015 Simone Carletti <weppos@weppos.net>
+#++
+
+
+require_relative 'base'
+require 'whois/scanners/base_whoisd'
+
+
+module Whois
+  class Parsers
+
+    # Base parser for Whoisd servers.
+    #
+    # @abstract
+    class BaseWhoisd < Base
+      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
+        node('status') do |value|
+          values = Array.wrap(value)
+          status = values.each do |s|
+            v = self.class.status_mapping[s.downcase]
+            break v if v
+          end
+          status || Whois.bug!(ParserError, "Unknown status `#{string}'.")
+        end || :available
+      end
+
+      property_supported :available? do
+        !!node('status:available')
+      end
+
+      property_supported :registered? do
+        !available?
+      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 = $1
+            ipv4, ipv6 = $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-2015 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-2015 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-2015 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