whois 2.4.0 → 2.5.0

data/lib/whois/record/parser/whois.domainregistry.ie.rb

@@ -8,39 +8,51 @@
 
 
 require 'whois/record/parser/base'
+require 'whois/record/scanners/whois.domainregistry.ie.rb'
 
 
 module Whois
   class Record
     class Parser
 
-      #
-      # = whois.domainregistry.ie parser
-      #
       # Parser for the whois.domainregistry.ie 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 WhoisNicIt parser for an explanation of all available methods
-      # and examples.
+      # 
+      # @see Whois::Record::Parser::Example
+      #   The Example parser for the list of all available methods.
       #
       class WhoisDomainregistryIe < Base
+        include Scanners::Ast
+
+        property_supported :disclaimer do
+          node("field:disclaimer")
+        end
+
+
+        property_supported :domain do
+          node("domain")
+        end
+
+        property_not_supported :domain_id
+
+
+        property_not_supported :referral_whois
+
+        property_not_supported :referral_url
+
 
         property_supported :status do
-          if content_for_scanner =~ /status:\s+(.+)\n/
-            case $1.downcase
-              when "active" then :registered
-              else
-                Whois.bug!(ParserError, "Unknown status `#{$1}'.")
-            end
-          else
+          case node("status", &:downcase)
+          when nil
             :available
+          when "active"
+            :registered
+          else
+            Whois.bug!(ParserError, "Unknown status `#{node("status")}'.")
           end
         end
 
         property_supported :available? do
-          !!(content_for_scanner =~ /Not Registered - The domain you have requested is not a registered .ie domain name/)
+          !!node("status:available")
         end
 
         property_supported :registered? do
@@ -53,16 +65,60 @@ module Whois
         property_not_supported :updated_on
 
         property_supported :expires_on do
-          if content_for_scanner =~ /renewal:\s+(.*)\n/
-            Time.parse($1)
+          node("renewal") { |value| Time.parse(value) }
+        end
+
+
+        property_not_supported :registrar
+
+
+        property_supported :registrant_contacts do
+          node("descr") do |array|
+            Record::Contact.new(
+              :type         => Whois::Record::Contact::TYPE_REGISTRANT,
+              :id           => nil,
+              :name         => array[0]
+            )
           end
         end
 
+        property_supported :admin_contacts do
+          build_contact("admin-c", Whois::Record::Contact::TYPE_ADMIN)
+        end
+
+        property_supported :technical_contacts do
+          build_contact("tech-c", Whois::Record::Contact::TYPE_TECHNICAL)
+        end
+
 
         property_supported :nameservers do
-          content_for_scanner.scan(/nserver:\s+(.+)\n/).flatten.map do |line|
+          Array.wrap(node("nserver")).map do |line|
             name, ipv4 = line.split(/\s+/)
-            Record::Nameserver.new(name, ipv4)
+            Record::Nameserver.new(:name => name, :ipv4 => ipv4)
+          end
+        end
+
+
+        # Initializes a new {Scanners::WhoisDomainregistryIe} instance
+        # passing the {#content_for_scanner}
+        # and calls +parse+ on it.
+        #
+        # @return [Hash]
+        def parse
+          Scanners::WhoisDomainregistryIe.new(content_for_scanner).parse
+        end
+
+
+      private
+
+        def build_contact(element, type)
+          node(element) do |id|
+            contact = node("field:#{id}")
+            Record::Contact.new(
+              :type         => type,
+              :id           => id,
+              :name         => contact["person"]
+            )
           end
         end
 

data/lib/whois/record/parser/whois.domainregistry.my.rb

@@ -14,17 +14,14 @@ module Whois
   class Record
     class Parser
 
-      #
-      # = whois.domainregistry.my parser
-      #
       # Parser for the whois.domainregistry.my 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 WhoisNicIt parser for an explanation of all available methods
-      # and examples.
+      # @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::Record::Parser::Example
+      #   The Example parser for the list of all available methods.
       class WhoisDomainregistryMy < Base
 
         property_supported :status do

data/lib/whois/record/parser/whois.dreamhost.com.rb

@@ -19,7 +19,7 @@ module Whois
       # @see Whois::Record::Parser::Example
       #   The Example parser for the list of all available methods.
       #
-      # @since RELEASE
+      # @since 2.4.0
       class WhoisDreamhostCom < Base
 
         property_not_supported :status

data/lib/whois/record/parser/whois.enom.com.rb

@@ -0,0 +1,124 @@
+#--
+# Ruby Whois
+#
+# An intelligent pure Ruby WHOIS client and parser.
+#
+# Copyright (c) 2009-2012 Simone Carletti <weppos@weppos.net>
+#++
+
+
+require 'whois/record/parser/base'
+
+
+module Whois
+  class Record
+    class Parser
+
+      # Parser for the whois.enom.com 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::Record::Parser::Example
+      #   The Example parser for the list of all available methods.
+      #
+      # @since 2.5.0
+      class WhoisEnomCom < Base
+
+        property_not_supported :status
+
+        # The server is contacted only in case of a registered domain.
+        property_supported :available? do
+          false
+        end
+
+        property_supported :registered? do
+          true
+        end
+
+
+        property_supported :created_on do
+          if content_for_scanner =~ /Creation date: (.+)\n/
+            Time.parse($1)
+          end
+        end
+
+        property_not_supported :updated_on
+
+        property_supported :expires_on do
+          if content_for_scanner =~ /Expiration date: (.+)\n/
+            Time.parse($1)
+          end
+        end
+
+
+        property_supported :registrar do
+          Record::Registrar.new(
+            :name => "eNom Inc.",
+            :url  => "http://www.enom.com/"
+          )
+        end
+
+        property_supported :registrant_contacts do
+          build_contact("Registrant Contact", Record::Contact::TYPE_REGISTRANT)
+        end
+
+        property_supported :admin_contacts do
+          build_contact("Administrative Contact", Record::Contact::TYPE_ADMIN)
+        end
+
+        property_supported :technical_contacts do
+          build_contact("Technical Contact", Record::Contact::TYPE_TECHNICAL)
+        end
+
+
+        property_supported :nameservers do
+         if content_for_scanner =~ /Name Servers:\n((\s+[^\s]+\n)+)/
+            $1.split("\n").map do |line|
+              Record::Nameserver.new(:name => line.strip)
+            end
+          end
+        end
+
+
+      private
+
+        def build_contact(element, type)
+          match = content_for_scanner.slice(/#{element}:\n((.+\n)+)/, 1)
+          return unless match
+
+          # 0 AdBrite, Inc.
+          # 1 Host Master (hostmaster@adbrite.com)
+          # 2 4159750916
+          # 3 Fax: 
+          # 4 731 Market Street, Suite 500
+          # 5 San Francisco, CA 94103
+          # 6 US
+
+          lines = match.split("\n").map(&:lstrip)
+          name, email = lines[1].match(/(.+) \((.*)\)/)[1..2].map(&:strip)
+          fax = lines[3].match(/Fax: (.*)/)[1]
+          city, state, zip = lines[-2].match(/(.*),(.+?)(\d*)$/)[1..3].map(&:strip)
+
+          Record::Contact.new(
+            :type         => type,
+            :id           => nil,
+            :name         => name,
+            :organization => lines[0],
+            :address      => lines[4..-3].join("\n"),
+            :city         => city,
+            :zip          => zip,
+            :state        => state,
+            :country_code => lines[-1],
+            :phone        => lines[2],
+            :fax          => fax,
+            :email        => email
+          )
+        end
+
+      end
+
+    end
+  end
+end

data/lib/whois/record/parser/whois.fi.rb

@@ -23,7 +23,7 @@ module Whois
       # @see Whois::Record::Parser::Example
       #   The Example parser for the list of all available methods.
       #
-      # @since RELEASE
+      # @since 2.4.0
       class WhoisFi < Base
 
         property_supported :status do

data/lib/whois/record/parser/whois.iana.org.rb

@@ -8,7 +8,7 @@
 
 
 require 'whois/record/parser/base'
-require 'whois/record/parser/scanners/iana'
+require 'whois/record/scanners/iana'
 
 
 module Whois

data/lib/whois/record/parser/whois.nc.rb

@@ -8,7 +8,7 @@
 
 
 require 'whois/record/parser/base'
-require 'whois/record/parser/scanners/whois.nc.rb'
+require 'whois/record/scanners/whois.nc.rb'
 
 
 module Whois
@@ -20,7 +20,7 @@ module Whois
       # @see Whois::Record::Parser::Example
       #   The Example parser for the list of all available methods.
       #
-      # @since RELEASE
+      # @since 2.4.0
       class WhoisNc < Base
         include Scanners::Ast
 

data/lib/whois/record/parser/whois.nic.cc.rb

@@ -8,7 +8,7 @@
 
 
 require 'whois/record/parser/base'
-require 'whois/record/parser/scanners/verisign'
+require 'whois/record/scanners/verisign'
 
 
 module Whois

data/lib/whois/record/parser/whois.nic.hu.rb

@@ -8,7 +8,7 @@
 
 
 require 'whois/record/parser/base'
-require 'whois/record/parser/scanners/whois.nic.hu.rb'
+require 'whois/record/scanners/whois.nic.hu.rb'
 
 
 module Whois

data/lib/whois/record/parser/whois.nic.it.rb

@@ -8,7 +8,7 @@
 
 
 require 'whois/record/parser/base'
-require 'whois/record/parser/scanners/whois.nic.it.rb'
+require 'whois/record/scanners/whois.nic.it.rb'
 
 
 module Whois

data/lib/whois/record/parser/whois.nic.lk.rb

@@ -19,7 +19,7 @@ module Whois
       # @see Whois::Record::Parser::Example
       #   The Example parser for the list of all available methods.
       #
-      # @since RELEASE
+      # @since 2.4.0
       class WhoisNicLk < Base
 
         property_not_supported :disclaimer

data/lib/whois/record/parser/whois.nic.tv.rb

@@ -8,7 +8,7 @@
 
 
 require 'whois/record/parser/base'
-require 'whois/record/parser/scanners/verisign'
+require 'whois/record/scanners/verisign'
 
 
 module Whois

data/lib/whois/record/parser/whois.registry.qa.rb

@@ -8,7 +8,7 @@
 
 
 require 'whois/record/parser/base'
-require 'whois/record/parser/scanners/whois.registry.qa.rb'
+require 'whois/record/scanners/whois.registry.qa.rb'
 
 
 module Whois

data/lib/whois/record/parser/whois.rnids.rs.rb

@@ -8,7 +8,7 @@
 
 
 require 'whois/record/parser/base'
-require 'whois/record/parser/scanners/whois.rnids.rs.rb'
+require 'whois/record/scanners/whois.rnids.rs.rb'
 
 
 module Whois
@@ -20,7 +20,7 @@ module Whois
       # @see Whois::Record::Parser::Example
       #   The Example parser for the list of all available methods.
       #
-      # @since RELEASE
+      # @since 2.4.0
       class WhoisRnidsRs < Base
         include Scanners::Ast
 
@@ -40,13 +40,13 @@ module Whois
 
 
         property_supported :status do
-          case s = node("Domain status") { |str| str.downcase }
+          case node("Domain status", &:downcase)
           when nil
             :available
           when "active"
             :registered
           else
-            Whois.bug!(ParserError, "Unknown status `#{s}'.")
+            Whois.bug!(ParserError, "Unknown status `#{node("Domain status")}'.")
           end
         end
 

data/lib/whois/record/parser/whois.smallregistry.net.rb

@@ -8,7 +8,7 @@
 
 
 require 'whois/record/parser/base'
-require 'whois/record/parser/scanners/whois.smallregistry.net.rb'
+require 'whois/record/scanners/whois.smallregistry.net.rb'
 
 
 module Whois

data/lib/whois/record/parser/whois.tld.ee.rb

@@ -8,7 +8,7 @@
 
 
 require 'whois/record/parser/base'
-require 'whois/record/parser/scanners/whois.tld.ee.rb'
+require 'whois/record/scanners/whois.tld.ee.rb'
 
 
 module Whois

data/lib/whois/record/parser/whois.ua.rb

@@ -20,7 +20,7 @@ module Whois
       #   to check for domain availability and get domain status.
       #   Please consider to contribute implementing missing methods.
       #
-      # @since RELEASE
+      # @since 2.4.0
       class WhoisUa < Base
 
         property_supported :status do

data/lib/whois/record/scanners/afilias.rb

@@ -0,0 +1,60 @@
+#--
+# Ruby Whois
+#
+# An intelligent pure Ruby WHOIS client and parser.
+#
+# Copyright (c) 2009-2012 Simone Carletti <weppos@weppos.net>
+#++
+
+
+require 'whois/record/scanners/base'
+
+
+module Whois
+  class Record
+    module Scanners
+
+      # Scanner for the Afilias record.
+      class Afilias < Base
+
+        self.tokenizers += [
+            :skip_empty_line,
+            :scan_available,
+            :scan_reserved,
+            :scan_throttled,
+            :scan_disclaimer,
+            :scan_keyvalue,
+        ]
+
+
+        tokenizer :scan_available do
+          if @input.scan(/^NOT FOUND\n/)
+            @ast["status:available"] = true
+          end
+        end
+
+        # .XXX
+        tokenizer :scan_reserved do
+          if @input.scan(/^Reserved by ICM Registry\n/)
+            @ast["status:reserved"] = true
+          end
+        end
+
+        # .ORG
+        tokenizer :scan_throttled do
+          if @input.match?(/^WHOIS LIMIT EXCEEDED/)
+            @ast["response:throttled"] = true
+            @input.skip(/^.+\n/)
+          end
+        end
+
+        tokenizer :scan_disclaimer do
+          if @input.pos == 0 && @input.match?(/^(.+\n){3,}\n/)
+            @ast["field:disclaimer"] = _scan_lines_to_array(/^(.+)\n/).join(" ")
+          end
+        end
+      end
+
+    end
+  end
+end

data/lib/whois/record/scanners/ast.rb

@@ -0,0 +1,67 @@
+#--
+# Ruby Whois
+#
+# An intelligent pure Ruby WHOIS client and parser.
+#
+# Copyright (c) 2009-2012 Simone Carletti <weppos@weppos.net>
+#++
+
+
+require 'strscan'
+
+
+module Whois
+  class Record
+    module Scanners
+
+      # The Ast module tries to emulate a super-simple Abstract Syntax Tree structure
+      # including method for accessing ast nodes.
+      #
+      # == Usage
+      #
+      # Include the Ast module and provide a <tt>parse</tt> instance method.
+      # <tt>parse</tt> should returns a Hash representing the AST.
+      #
+      #   def parse
+      #     Scanner.new.parse
+      #   end
+      #   # => { "created_on" => "2009-12-12", ... }
+      #
+      # Now you can access the AST using the <tt>node</tt> method.
+      #
+      #   node "created_on"
+      #   # => "2009-12-12"
+      #
+      #   node? "created_on"
+      #   # => true
+      #
+      #   node? "created_at"
+      #   # => false
+      #
+      module Ast
+
+        def node(key)
+          if block_given?
+            value = ast[key]
+            value = yield(value) unless value.nil?
+            value
+          else
+            ast[key]
+          end
+        end
+
+        def node?(key)
+          !ast[key].nil?
+        end
+
+      private
+
+        def ast
+          @ast ||= parse
+        end
+
+      end
+
+    end
+  end
+end

data/lib/whois/record/scanners/base.rb

@@ -0,0 +1,102 @@
+#--
+# Ruby Whois
+#
+# An intelligent pure Ruby WHOIS client and parser.
+#
+# Copyright (c) 2009-2012 Simone Carletti <weppos@weppos.net>
+#++
+
+
+module Whois
+  class Record
+    module Scanners
+
+      class Base
+
+        class_attribute :tokenizers
+        self.tokenizers = []
+
+        def self.tokenizer(name, &block)
+          define_method(name, &block)
+        end
+
+
+        def initialize(content)
+          @input = StringScanner.new(content)
+        end
+
+        def parse
+          # The temporary store.
+          # Scanners may use this to store pointers, states or other flags.
+          @tmp = {}
+
+          # A super-simple AST store.
+          @ast = {}
+
+          tokenize until @input.eos?
+
+          @ast
+        end
+
+
+        tokenizer :skip_empty_line do
+          @input.skip(/^\n/)
+        end
+
+        tokenizer :skip_newline do
+          @input.skip(/\n/)
+        end
+
+        tokenizer :scan_keyvalue do
+          if @input.scan(/(.+?):(.*?)\n/)
+            key, value = @input[1].strip, @input[2].strip
+            if @ast[key].nil?
+              @ast[key] = value
+            else
+              @ast[key] = Array.wrap(@ast[key])
+              @ast[key] << value
+            end
+          end
+        end
+
+      protected
+
+        def _scan_lines_to_array(pattern)
+          lines = []
+          while @input.scan(pattern)
+            @input[1].strip
+            lines << @input[1].strip
+          end
+          lines
+        end
+
+        def _scan_lines_to_hash(pattern)
+          lines = {}
+          while @input.scan(pattern)
+            lines.merge! @input[1].strip => @input[2].strip
+          end
+          lines
+        end
+
+      private
+
+        def tokenize
+          tokenizers.each do |tokenizer|
+            return if send(tokenizer)
+          end
+          unexpected_token
+        end
+
+        def unexpected_token
+          error!("Unexpected token")
+        end
+
+        def error!(message)
+          raise ParserError, "#{message}: #{@input.peek(@input.string.length)}"
+        end
+
+      end
+
+    end
+  end
+end