whois 2.6.2 → 2.6.3

data/.yardopts

@@ -1,2 +1,2 @@
---readme README.rdoc
+--readme README.md
 --title 'Whois API Documentation'

data/CHANGELOG.md

@@ -1,6 +1,19 @@
 # Changelog
 
 
+## Release 2.6.3
+
+* NEW: whois.registrypro.pro is now a full parser.
+
+* FIXED: In some cases the parser class is not correctly detected from hostname (GH-173). [Thanks @JustinCampbell]
+
+* FIXED: whois.ua parser raises ArgumentError when the created_on object invalid data.
+
+* FIXED: Whois::Server may occasionally raise an error trying to resolve an IPv6 matching query object (GH-174). [Thanks @aeden].
+
+* CHANGED: Updated whois.registrypro.pro parser to the new response format.
+
+
 ## Release 2.6.2
 
 * SERVER: Added .SX TLD server (GH-170).

data/README.md

@@ -6,11 +6,20 @@
 
 *Whois* is a OS-independent library and doesn't require any external binaries or C libraries: it is a 100% Ruby software.
 
-This library was developed to power [RoboDomain](https://www.robodomain.com) and, since July 2009, it ran more than thousands requests.
+This library was developed to power [RoboDomain](https://www.robodomain.com/) and [RoboWhois](http://www.robowhois.com/). It has been performing queries in production since July 2009.
 
 An extensive test suite is available to verify the library correctness but you must be aware that registrant might change WHOIS interfaces without notice and at any time causing queries to specific hosts to stop working.
 
 
+## Donations
+
+[Support Whois at Pledgie](http://www.pledgie.com/campaigns/11383).
+
+<a href='http://www.pledgie.com/campaigns/11383'><img alt='Click here to lend your support to: whois and make a donation at www.pledgie.com !' src='http://www.pledgie.com/campaigns/11383.png?skin_name=chrome' border='0' /></a>
+
+*Whois* is free software, but it costs money to write, test, and distribute it. You can support the development by sending a donation. **Any amount, even $5, is greatly appreciated**.
+
+
 ## Features
 
 * Ability to query registry data for [IPv4, IPv6, TLDs, and domain names](http://www.ruby-whois.org/manual/usage.html#usage-objects)
@@ -183,15 +192,6 @@ Pull requests are very welcome! Please include spec and/or feature coverage for
 Report issues or feature requests to [GitHub Issues](https://github.com/weppos/whois/issues).
 
 
-## Donations
-
-[Support Whois at Pledgie](http://www.pledgie.com/campaigns/11383).
-
-<a href='http://www.pledgie.com/campaigns/11383'><img alt='Click here to lend your support to: whois and make a donation at www.pledgie.com !' src='http://www.pledgie.com/campaigns/11383.png?skin_name=chrome' border='0' /></a>
-
-Whois is free software, but it costs money to write, test, and distribute it. You can support the development by sending a donation. **Any amount, even $5, is greatly appreciated**.
-
-
 ## More
 
 - [Homepage](http://www.ruby-whois.org/)
@@ -207,6 +207,4 @@ See the [CHANGELOG](CHANGELOG.md) file for details.
 
 ## License
 
-Copyright (c) 2009-2012 Simone Carletti.
-
-This is Free Software distributed under the MIT license.
+Copyright (c) 2009-2012 Simone Carletti. This is Free Software distributed under the MIT license.

data/lib/whois.rb

@@ -112,7 +112,7 @@ module Whois
     # @param  [String] message The message to display.
     # @return [void]
     #
-    # @api internal
+    # @api private
     # @private
     def deprecate(message = nil, callstack = caller)
       message ||= "You are using deprecated behavior which will be removed from the next major or minor release."
@@ -127,7 +127,7 @@ module Whois
     # @param  [String] message
     # @return [void]
     #
-    # @api internal
+    # @api private
     # @private
     def bug!(error, message)
       raise error, message.dup        <<

data/lib/whois/errors.rb

@@ -132,7 +132,7 @@ module Whois
 
   # Raised when attempting to access a property when the response is unavailable.
   #
-  # @since 2.0.3
+  # @since  2.0.3
   # @see Whois::Record::Parser::Base#response_unavailable?
   class ResponseIsUnavailable < ResponseError
   end

data/lib/whois/record.rb

@@ -39,6 +39,7 @@ module Whois
     # for {Parser::PROPERTIES} and {Parser::METHODS}.
     #
     # @return [Boolean]
+    #
     def respond_to?(symbol, include_private = false)
       super || Parser::PROPERTIES.include?(symbol) || Parser::METHODS.include?(symbol)
     end
@@ -46,6 +47,7 @@ module Whois
     # Returns a String representation of this record.
     #
     # @return [String] The record content.
+    #
     def to_s
       content.to_s
     end
@@ -53,6 +55,7 @@ module Whois
     # Returns a human-readable representation of this record.
     #
     # @return [String] The result of {#inspect} on content.
+    #
     def inspect
       content.inspect
     end
@@ -62,6 +65,7 @@ module Whois
     #
     # @param  [Whois::Record] other The record to compare.
     # @return [Boolean]
+    #
     def ==(other)
       if equal?(other)
         true
@@ -78,7 +82,7 @@ module Whois
     # Invokes {#match} on record {#content}
     # and returns the match as <tt>MatchData</tt> or <tt>nil</tt>.
     #
-    # @param  [Regexp, String] match
+    # @param  [Regexp, String] pattern The regex pattern to match.
     # @return [MatchData] If pattern matches #content
     # @return [nil] If pattern doesn't match #content
     #
@@ -91,7 +95,7 @@ module Whois
     # Invokes {#match} and returns <tt>true</tt> if <tt>pattern</tt>
     # matches {#content}, <tt>false</tt> otherwise.
     #
-    # @param  [Regexp, String] match
+    # @param  [Regexp, String] pattern The regex pattern to match.
     # @return [Boolean]
     #
     # @see #match
@@ -122,6 +126,7 @@ module Whois
     # Lazy-loads and returns the parser proxy for current record.
     #
     # @return [Whois::Record::Parser]
+    #
     def parser
       @parser ||= Parser.new(self)
     end
@@ -145,6 +150,7 @@ module Whois
     # along with corresponding values.
     #
     # @return [{ Symbol => Object }]
+    #
     def properties
       hash = {}
       Parser::PROPERTIES.each { |property| hash[property] = send(property) }
@@ -288,54 +294,54 @@ module Whois
     # @endgroup
 
 
-    private
+  private
 
-      # @api internal
-      def self.define_property_method(method)
-        class_eval <<-RUBY, __FILE__, __LINE__ + 1
-          def #{method}(*args, &block)
-            if property_supported?(:#{method})
-              parser.#{method}(*args, &block)
-            end
+    # @api private
+    def self.define_property_method(method)
+      class_eval <<-RUBY, __FILE__, __LINE__ + 1
+        def #{method}(*args, &block)
+          if property_supported?(:#{method})
+            parser.#{method}(*args, &block)
           end
-        RUBY
-      end
-
-      # @api internal
-      def self.define_method_method(method)
-        class_eval <<-RUBY, __FILE__, __LINE__ + 1
-          def #{method}(*args, &block)
-            if parser.respond_to?(:#{method})
-              parser.#{method}(*args, &block)
-            end
-          end
-        RUBY
-      end
+        end
+      RUBY
+    end
 
-      # @api internal
-      def self.define_question_method(method)
-        class_eval <<-RUBY, __FILE__, __LINE__ + 1
-          def #{method}?
-            !#{method}.nil?
+    # @api private
+    def self.define_method_method(method)
+      class_eval <<-RUBY, __FILE__, __LINE__ + 1
+        def #{method}(*args, &block)
+          if parser.respond_to?(:#{method})
+            parser.#{method}(*args, &block)
           end
-        RUBY
-      end
+        end
+      RUBY
+    end
 
-      # Delegates all method calls to the internal parser.
-      def method_missing(method, *args, &block)
-        if Parser::PROPERTIES.include?(method)
-          self.class.define_property_method(method)
-          send(method, *args, &block)
-        elsif Parser::METHODS.include?(method)
-          self.class.define_method_method(method)
-          send(method, *args, &block)
-        elsif method.to_s =~ /([a-z_]+)\?/ and (Parser::PROPERTIES + Parser::METHODS).include?($1.to_sym)
-          self.class.define_question_method($1)
-          send(method)
-        else
-          super
+    # @api private
+    def self.define_question_method(method)
+      class_eval <<-RUBY, __FILE__, __LINE__ + 1
+        def #{method}?
+          !#{method}.nil?
         end
+      RUBY
+    end
+
+    # Delegates all method calls to the internal parser.
+    def method_missing(method, *args, &block)
+      if Parser::PROPERTIES.include?(method)
+        self.class.define_property_method(method)
+        send(method, *args, &block)
+      elsif Parser::METHODS.include?(method)
+        self.class.define_method_method(method)
+        send(method, *args, &block)
+      elsif method.to_s =~ /([a-z_]+)\?/ and (Parser::PROPERTIES + Parser::METHODS).include?($1.to_sym)
+        self.class.define_question_method($1)
+        send(method)
+      else
+        super
       end
+    end
 
   end
 

data/lib/whois/record/parser.rb

@@ -114,7 +114,7 @@ module Whois
       #   # => "WhoisNicInfoIt"
       #
       def self.host_to_parser(host)
-        host.to_s.
+        host.to_s.downcase.
           gsub(/[.-]/, '_').
           gsub(/(?:^|_)(.)/)  { $1.upcase }
       end
@@ -136,7 +136,7 @@ module Whois
 
       # Initializes and return a new parser from +record+.
       #
-      # @param  [Whois::Record]
+      # @param  [Whois::Record] record
       #
       def initialize(record)
         @record = record
@@ -262,119 +262,119 @@ module Whois
       # @endgroup
 
 
-      private
+    private
 
-        # @api internal
-        def self.define_missing_method(method)
-          class_eval <<-RUBY, __FILE__, __LINE__ + 1
-            def #{method}(*args, &block)
-              delegate_to_parsers(:#{method}, *args, &block)
-            end
-          RUBY
-        end
-
-        def method_missing(method, *args, &block)
-          if PROPERTIES.include?(method)
-            self.class.define_missing_method(method)
-            send(method, *args, &block)
-          elsif METHODS.include?(method)
-            self.class.define_missing_method(method)
-            send(method, *args, &block)
-          else
-            super
+      # @api private
+      def self.define_missing_method(method)
+        class_eval <<-RUBY, __FILE__, __LINE__ + 1
+          def #{method}(*args, &block)
+            delegate_to_parsers(:#{method}, *args, &block)
           end
-        end
+        RUBY
+      end
 
-        def delegate_to_parsers(method, *args, &block)
-          # Raise an error without any parser
-          if parsers.empty?
-            raise ParserError, "Unable to select a parser because the record is empty"
-
-          # Select a parser where the property is supported
-          # and call the method.
-          elsif parser = select_parser(method, :supported)
-            parser.send(method, *args, &block)
-
-          # Select a parser where the property is defined but not supported
-          # and call the method.
-          # The call is expected to raise an exception.
-          elsif parser = select_parser(method, :not_supported)
-            parser.send(method, *args, &block)
-
-          # The property is not supported nor defined.
-          else
-            raise PropertyNotAvailable, "Unable to find a parser for `#{method}'"
-          end
+      def method_missing(method, *args, &block)
+        if PROPERTIES.include?(method)
+          self.class.define_missing_method(method)
+          send(method, *args, &block)
+        elsif METHODS.include?(method)
+          self.class.define_missing_method(method)
+          send(method, *args, &block)
+        else
+          super
         end
+      end
 
-        # Loops through all record parts, for each part
-        # tries to guess the appropriate parser object whenever available,
-        # and returns the final array of server-specific parsers.
-        #
-        # Parsers are initialized in reverse order for performance reason.
-        #
-        # @return [Array<Class>] An array of Class,
-        #         where each item is the parts reverse-N specific parser {Class}.
-        #         Each {Class} is expected to be a child of {Whois::Record::Parser::Base}.
-        #
-        # @example
-        #
-        #   parser.parts
-        #   # => [whois.foo.com, whois.bar.com]
-        #
-        #   parser.parsers
-        #   # => [Whois::Record::Parser::WhoisBarCom, Whois::Record::Parser::WhoisFooCom]
-        #
-        # @see Whois::Record::Parser#select_parser
-        #
-        def init_parsers
-          record.parts.reverse.map { |part| self.class.parser_for(part) }
+      def delegate_to_parsers(method, *args, &block)
+        # Raise an error without any parser
+        if parsers.empty?
+          raise ParserError, "Unable to select a parser because the record is empty"
+
+        # Select a parser where the property is supported
+        # and call the method.
+        elsif parser = select_parser(method, :supported)
+          parser.send(method, *args, &block)
+
+        # Select a parser where the property is defined but not supported
+        # and call the method.
+        # The call is expected to raise an exception.
+        elsif parser = select_parser(method, :not_supported)
+          parser.send(method, *args, &block)
+
+        # The property is not supported nor defined.
+        else
+          raise PropertyNotAvailable, "Unable to find a parser for `#{method}'"
         end
+      end
 
-        # Selects the first parser in {#parsers}
-        # where given property matches <tt>status</tt>.
-        #
-        # @param  [Symbol] property The property to search for.
-        # @param  [Symbol] status The status value.
-        #
-        # @return [Whois::Record::Parser::Base]
-        #         The parser which satisfies given requirement.
-        # @return [nil]
-        #         If the parser wasn't found.
-        #
-        # @example
-        #
-        #   select_parser(:nameservers)
-        #   # => #<Whois::Record::Parser::WhoisExampleCom>
-        #
-        #   select_parser(:nameservers, :supported)
-        #   # => nil
-        #
-        def select_parser(property, status = :any)
-          parsers.each do |parser|
-            return parser if parser.class.property_registered?(property, status)
-          end
-          nil
+      # Loops through all record parts, for each part
+      # tries to guess the appropriate parser object whenever available,
+      # and returns the final array of server-specific parsers.
+      #
+      # Parsers are initialized in reverse order for performance reason.
+      #
+      # @return [Array<Class>] An array of Class,
+      #         where each item is the parts reverse-N specific parser {Class}.
+      #         Each {Class} is expected to be a child of {Whois::Record::Parser::Base}.
+      #
+      # @example
+      #
+      #   parser.parts
+      #   # => [whois.foo.com, whois.bar.com]
+      #
+      #   parser.parsers
+      #   # => [Whois::Record::Parser::WhoisBarCom, Whois::Record::Parser::WhoisFooCom]
+      #
+      # @see Whois::Record::Parser#select_parser
+      #
+      def init_parsers
+        record.parts.reverse.map { |part| self.class.parser_for(part) }
+      end
+
+      # Selects the first parser in {#parsers}
+      # where given property matches <tt>status</tt>.
+      #
+      # @param  [Symbol] property The property to search for.
+      # @param  [Symbol] status The status value.
+      #
+      # @return [Whois::Record::Parser::Base]
+      #         The parser which satisfies given requirement.
+      # @return [nil]
+      #         If the parser wasn't found.
+      #
+      # @example
+      #
+      #   select_parser(:nameservers)
+      #   # => #<Whois::Record::Parser::WhoisExampleCom>
+      #
+      #   select_parser(:nameservers, :supported)
+      #   # => nil
+      #
+      def select_parser(property, status = :any)
+        parsers.each do |parser|
+          return parser if parser.class.property_registered?(property, status)
         end
+        nil
+      end
 
-        # @api internal
-        def all_in_parallel?(*args)
-          count = args.first.size
-          index = 0
+      # @api private
+      def all_in_parallel?(*args)
+        count = args.first.size
+        index = 0
 
-          while index < count
-            return false unless yield(*args.map { |arg| arg[index] })
-            index += 1
-          end
-          true
+        while index < count
+          return false unless yield(*args.map { |arg| arg[index] })
+          index += 1
         end
+        true
+      end
 
-        # @api internal
-        def any_is?(collection, symbol)
-          collection.any? { |item| item.is(symbol) }
-        end
+      # @api private
+      def any_is?(collection, symbol)
+        collection.any? { |item| item.is(symbol) }
+      end
 
     end
 
   end
-end
+end