whois 2.0.7 → 2.1.0

data/CHANGELOG.rdoc

@@ -1,6 +1,68 @@
 = Changelog
 
 
+== Release 2.1.0
+
+* SERVER: Added .COM.DE, .GR.COM, .US.ORG TLD definitions.
+
+* SERVER: Updated .QA and .XN--WGBL6A TLD definitions.
+
+* SERVER: Updated .SU, .RU and .XN--P1AI TLD definitions (#87).
+
+* SERVER: Added the following new IDN TLDs:
+    * .XN--LGBBAT1AD8J (.الجزائر, Algeria) (#95)
+    * .XN--MGBC0A9AZCG (.المغرب, Morocco) (#96)
+
+* NEW: Ability to define inheritable parsers
+
+      class Whois::Record::Parser::Afilias < Whois::Record::Parser::Base
+      end
+
+      class Whois::Record::Parser::WhoisNicXxx < Whois::Record::Parser::Afilias
+      end
+
+  Parsers will inherits all the properties from their parents.
+
+* NEW: Added the following full parsers:
+    * whois.nic.asia
+    * whois.meregistry.net
+    * whois.dotmobiregistry.net
+    * whois.publicinternetregistry.net
+    * whois.registry.in
+    * whis.nic.ag
+    * whois.afilias-grs.info
+    * whois.aero
+    * whois.nic.xx
+    * whois.afilias.info
+    * whois.registry.qa (#114)
+    * whois.godaddy.com (#105)
+
+* CHANGED: use the first public .XXX domain to test the whois.nic.xx response format.
+
+* CHANGED: whois.sgnic.sg changed nameservers response format (again).
+
+* CHANGED: Extended core_ext section. Since all the extensions belong to ActiveSupport,
+  the library attempts to use ActiveSupport if loaded.
+
+* CHANGED: Renamed whois.ripn.net to whois.tcinet.ru (#87)
+
+* FIXED: In a very rare situation the Whois::Client raises a
+  `Errno::EINVAL: Invalid argument - bind(2)' error attempting to connect
+  to a WHOIS server (see #40).
+
+* FIXED: whois.nic.travel parser must support multiple statuses.
+
+* FIXED: whois.nic.name parser must support multiple statuses.
+
+* FIXED: whois.nic.af parser must support `Delegated' status.
+
+* REMOVED: Removed deprecated Whois::Answer class.
+
+* REMOVED: Removed deprecated Whois::Record#== behavior.
+
+* REMOVED: Removed deprecated Whois::Record::Parser::WhoisTonicTo#incomplete_response? method.
+
+
 == Release 2.0.7
 
 * CHANGED: whois.dns.pt changed nameservers response format.
@@ -35,7 +97,8 @@
 
 * NEW: Added base whois.nic.sm parser (#97).
 
-* FIXED: whois.meregistry.net parser raises `no time information in ""' when updated_at property is blank.
+* FIXED: whois.meregistry.net parser raises `no time information in ""'
+  when updated_at property is blank.
 
 * FIXED: whois.nic.it parser must support `NO-PROVIDER' status.
 
@@ -45,7 +108,7 @@
 
 * FIXED: whois.nic.cz parser must support `Update prohibited' status.
 
-* FIXED: The Verisign WHOIS adapter crashes in some rare circumstances 
+* FIXED: The Verisign WHOIS adapter crashes in some rare circumstances
   when the response from the Verisign database doesn't contain a
   referral (#103)
 
@@ -65,7 +128,8 @@
 
 * FIXED: whois.nic.it parser must support pendingUpdate and pendingTransfer statuses.
 
-* FIXED: whois.nic-se.se crashes in some cases where the modified: attribute is an invalid date.
+* FIXED: whois.nic-se.se crashes in some cases where the `modified:'
+  attribute is an invalid date.
 
 
 == Release 2.0.3
@@ -167,8 +231,9 @@
 
 * CHANGED: Renamed Whois::Server::Adapters::Base#append_to_buffer to buffer_append.
 
-* CHANGED: Whois::Answer::Parser::Base#response_throttled? and Whois::Answer::Parser::Base#invalid? are not defined by default.
-           Define the method in the implementation, and Whois::Answer::Parser will automatically use it.
+* CHANGED: Whois::Answer::Parser::Base#response_throttled? and Whois::Answer::Parser::Base#invalid?
+  are not defined by default. Define the method in the implementation, 
+  and Whois::Answer::Parser will automatically use it.
 
 * CHANGED: Removed &block from method definition to avoid creating block objects when yield is used (#66)
 
@@ -180,9 +245,12 @@
 
 * CHANGED: Change #nameservers property to return an Array of Nameserver (#76, see #71, see #64).
 
-* CHANGED: Whois#query no longer raises Errno or SocketError. The errors are now rescued and re-raised as Whois::ConnectionError.
+* CHANGED: Whois#query no longer raises Errno or SocketError.
+  The errors are now rescued and re-raised as Whois::ConnectionError.
 
-* CHANGED: #admin_contact, #technical_contact and #registrant_contact have been renamed to #admin_contacts, #technical_contacts and #registrant_contacts and they now returns an array of Contact, instead of a single Contact.
+* CHANGED: #admin_contact, #technical_contact and #registrant_contact
+  have been renamed to #admin_contacts, #technical_contacts and #registrant_contacts
+  and they now returns an array of Contact, instead of a single Contact.
 
 * CHANGED: Migrated all tests to RSpec.
 
@@ -193,7 +261,8 @@
 
 * FIXED: Make sure a warning is issued when #registered? or #available? returns nil.
 
-* FIXED: Fixed a bug with the whois.crsnic.net parser where the name server contains "no nameserver" instead of a valid host.
+* FIXED: Fixed a bug with the whois.crsnic.net parser where the name server
+  contains "no nameserver" instead of a valid host.
 
 * FIXED: Fixed a bug which prevents a client to be created with nil timeout.
 
@@ -236,9 +305,14 @@
 * Whois#query no longer raises Errno::ECONNRESET, Errno::EHOSTUNREACH, Errno::ECONNREFUSED, SocketError.
   The errors are now rescued and re-raised as Whois::ConnectionError.
 
-* #admin_contact, #technical_contact and #registrant_contact have been renamed to #admin_contacts, #technical_contacts and #registrant_contacts and they now returns an array of Contact, instead of a single Contact. #admin_contact, #technical_contact and #registrant_contact still exists in the Answer as a convenient shortcut.
+* #admin_contact, #technical_contact and #registrant_contact
+  have been renamed to #admin_contacts, #technical_contacts and #registrant_contacts
+  and they now returns an array of Contact, instead of a single Contact.
+  #admin_contact, #technical_contact and #registrant_contact still exists
+  in the Answer as a convenient shortcut.
 
-* Renamed Whois::Answer::Parser::Base.register_property to Whois::Answer::Parser::Base.property_register.
+* Renamed Whois::Answer::Parser::Base.register_property to
+  Whois::Answer::Parser::Base.property_register.
 
 
 == Release 1.6.6

data/Rakefile

@@ -118,13 +118,6 @@ YARD::Rake::YardocTask.new(:yardoc) do |y|
 end
 
 namespace :yardoc do
-  desc "Publish YARD documentation to the site"
-  task :publish => ["yardoc:clobber", "yardoc"] do
-    ENV["username"] || raise(ArgumentError, "Missing ssh username")
-    sh "rsync -avz --delete yardoc/ #{ENV["username"]}@alamak:/home/#{ENV["username"]}/ruby-whois.org/api"
-  end
-
-  desc "Remove YARD products"
   task :clobber do
     rm_r "yardoc" rescue nil
   end

data/lib/core_ext.rb

@@ -1,45 +1,9 @@
-require 'date'
-
-class DateTime
-
-  # Don't remove method if exists or it will conflict with ActiveRecord.
-  # See http://github.com/weppos/whois/issues#issue/24
-  unless method_defined?(:to_time)
-    # Attempts to convert self to a Ruby Time object; returns self if out of range of Ruby Time class
-    # If self has an offset other than 0, self will just be returned unaltered, since there's no clean way to map it to a Time.
-    #
-    # Extracted from ActiveSupport.
-    def to_time
-      self.offset == 0 ? ::Time.utc(year, month, day, hour, min, sec) : self
-    end
-  end
-
-end
-
-
-class Array
-
-  # Wraps its argument in an array unless it is already an array (or array-like).
-  #
-  # Specifically:
-  #
-  # * If the argument is +nil+ an empty list is returned.
-  # * Otherwise, if the argument responds to +to_ary+ it is invoked, and its result returned.
-  # * Otherwise, returns an array with the argument as its single element.
-  #
-  #   Array.wrap(nil)       # => []
-  #   Array.wrap([1, 2, 3]) # => [1, 2, 3]
-  #   Array.wrap(0)         # => [0]
-  #
-  # Extracted from ActiveSupport.
-  def self.wrap(object)
-    if object.nil?
-      []
-    elsif object.respond_to?(:to_ary)
-      object.to_ary
-    else
-      [object]
-    end
-  end unless respond_to?(:wrap)
-
-end
+if defined?(ActiveSupport) && ActiveSupport::VERSION::MAJOR == 3
+  require 'active_support/core_ext/array/wrap'
+  require 'active_support/core_ext/date_time/conversions'
+  require 'core_ext/class/attribute'
+else
+  require 'core_ext/array/wrap'
+  require 'core_ext/date_time/conversions'
+  require 'core_ext/class/attribute'
+end

data/lib/core_ext/array/extract_options.rb

@@ -0,0 +1,29 @@
+class Hash
+  # By default, only instances of Hash itself are extractable.
+  # Subclasses of Hash may implement this method and return
+  # true to declare themselves as extractable. If a Hash
+  # is extractable, Array#extract_options! pops it from
+  # the Array when it is the last element of the Array.
+  def extractable_options?
+    instance_of?(Hash)
+  end
+end
+
+class Array
+  # Extracts options from a set of arguments. Removes and returns the last
+  # element in the array if it's a hash, otherwise returns a blank hash.
+  #
+  #   def options(*args)
+  #     args.extract_options!
+  #   end
+  #
+  #   options(1, 2)           # => {}
+  #   options(1, 2, :a => :b) # => {:a=>:b}
+  def extract_options!
+    if last.is_a?(Hash) && last.extractable_options?
+      pop
+    else
+      {}
+    end
+  end
+end

data/lib/core_ext/array/wrap.rb

@@ -0,0 +1,48 @@
+class Array
+  # Wraps its argument in an array unless it is already an array (or array-like).
+  #
+  # Specifically:
+  #
+  # * If the argument is +nil+ an empty list is returned.
+  # * Otherwise, if the argument responds to +to_ary+ it is invoked, and its result returned.
+  # * Otherwise, returns an array with the argument as its single element.
+  #
+  #   Array.wrap(nil)       # => []
+  #   Array.wrap([1, 2, 3]) # => [1, 2, 3]
+  #   Array.wrap(0)         # => [0]
+  #
+  # This method is similar in purpose to <tt>Kernel#Array</tt>, but there are some differences:
+  #
+  # * If the argument responds to +to_ary+ the method is invoked. <tt>Kernel#Array</tt>
+  # moves on to try +to_a+ if the returned value is +nil+, but <tt>Array.wrap</tt> returns
+  # such a +nil+ right away.
+  # * If the returned value from +to_ary+ is neither +nil+ nor an +Array+ object, <tt>Kernel#Array</tt>
+  # raises an exception, while <tt>Array.wrap</tt> does not, it just returns the value.
+  # * It does not call +to_a+ on the argument, though special-cases +nil+ to return an empty array.
+  #
+  # The last point is particularly worth comparing for some enumerables:
+  #
+  #   Array(:foo => :bar)      # => [[:foo, :bar]]
+  #   Array.wrap(:foo => :bar) # => [{:foo => :bar}]
+  #
+  #   Array("foo\nbar")        # => ["foo\n", "bar"], in Ruby 1.8
+  #   Array.wrap("foo\nbar")   # => ["foo\nbar"]
+  #
+  # There's also a related idiom that uses the splat operator:
+  #
+  #   [*object]
+  #
+  # which returns <tt>[nil]</tt> for +nil+, and calls to <tt>Array(object)</tt> otherwise.
+  #
+  # Thus, in this case the behavior is different for +nil+, and the differences with
+  # <tt>Kernel#Array</tt> explained above apply to the rest of +object+s.
+  def self.wrap(object)
+    if object.nil?
+      []
+    elsif object.respond_to?(:to_ary)
+      object.to_ary || [object]
+    else
+      [object]
+    end
+  end
+end

data/lib/core_ext/class/attribute.rb

@@ -0,0 +1,115 @@
+require 'core_ext/kernel/singleton_class'
+require 'core_ext/module/remove_method'
+require 'core_ext/array/extract_options'
+
+class Class
+  # Declare a class-level attribute whose value is inheritable by subclasses.
+  # Subclasses can change their own value and it will not impact parent class.
+  #
+  #   class Base
+  #     class_attribute :setting
+  #   end
+  #
+  #   class Subclass < Base
+  #   end
+  #
+  #   Base.setting = true
+  #   Subclass.setting            # => true
+  #   Subclass.setting = false
+  #   Subclass.setting            # => false
+  #   Base.setting                # => true
+  #
+  # In the above case as long as Subclass does not assign a value to setting
+  # by performing <tt>Subclass.setting = _something_ </tt>, <tt>Subclass.setting</tt>
+  # would read value assigned to parent class. Once Subclass assigns a value then
+  # the value assigned by Subclass would be returned.
+  #
+  # This matches normal Ruby method inheritance: think of writing an attribute
+  # on a subclass as overriding the reader method. However, you need to be aware
+  # when using +class_attribute+ with mutable structures as +Array+ or +Hash+.
+  # In such cases, you don't want to do changes in places but use setters:
+  #
+  #   Base.setting = []
+  #   Base.setting                # => []
+  #   Subclass.setting            # => []
+  #
+  #   # Appending in child changes both parent and child because it is the same object:
+  #   Subclass.setting << :foo
+  #   Base.setting               # => [:foo]
+  #   Subclass.setting           # => [:foo]
+  #
+  #   # Use setters to not propagate changes:
+  #   Base.setting = []
+  #   Subclass.setting += [:foo]
+  #   Base.setting               # => []
+  #   Subclass.setting           # => [:foo]
+  #
+  # For convenience, a query method is defined as well:
+  #
+  #   Subclass.setting?       # => false
+  #
+  # Instances may overwrite the class value in the same way:
+  #
+  #   Base.setting = true
+  #   object = Base.new
+  #   object.setting          # => true
+  #   object.setting = false
+  #   object.setting          # => false
+  #   Base.setting            # => true
+  #
+  # To opt out of the instance reader method, pass :instance_reader => false.
+  #
+  #   object.setting          # => NoMethodError
+  #   object.setting?         # => NoMethodError
+  #
+  # To opt out of the instance writer method, pass :instance_writer => false.
+  #
+  #   object.setting = false  # => NoMethodError
+  def class_attribute(*attrs)
+    options = attrs.extract_options!
+    instance_reader = options.fetch(:instance_reader, true)
+    instance_writer = options.fetch(:instance_writer, true)
+
+    attrs.each do |name|
+      class_eval <<-RUBY, __FILE__, __LINE__ + 1
+        def self.#{name}() nil end
+        def self.#{name}?() !!#{name} end
+
+        def self.#{name}=(val)
+          singleton_class.class_eval do
+            remove_possible_method(:#{name})
+            define_method(:#{name}) { val }
+          end
+
+          if singleton_class?
+            class_eval do
+              remove_possible_method(:#{name})
+              def #{name}
+                defined?(@#{name}) ? @#{name} : singleton_class.#{name}
+              end
+            end
+          end
+          val
+        end
+
+        if instance_reader
+          remove_possible_method :#{name}
+          def #{name}
+            defined?(@#{name}) ? @#{name} : self.class.#{name}
+          end
+
+          def #{name}?
+            !!#{name}
+          end
+        end
+      RUBY
+
+      attr_writer name if instance_writer
+    end
+  end
+
+  private
+  def singleton_class?
+    !name || '' == name
+  end
+end

data/lib/core_ext/date_time/conversions.rb

@@ -0,0 +1,15 @@
+require 'date'
+
+
+class DateTime
+  # Ruby 1.9 has DateTime#to_time which internally relies on Time. We define our own #to_time which allows
+  # DateTimes outside the range of what can be created with Time.
+  remove_method :to_time if instance_methods.include?(:to_time)
+
+  # Attempts to convert self to a Ruby Time object; returns self if out of range of Ruby Time class.
+  # If self has an offset other than 0, self will just be returned unaltered, since there's no clean way to map it to a Time.
+  def to_time
+    self.offset == 0 ? ::Time.utc(year, month, day, hour, min, sec, sec_fraction * (RUBY_VERSION < '1.9' ? 86400000000 : 1000000)) : self
+  end
+
+end

data/lib/core_ext/kernel/singleton_class.rb

@@ -0,0 +1,13 @@
+module Kernel
+  # Returns the object's singleton class.
+  def singleton_class
+    class << self
+      self
+    end
+  end unless respond_to?(:singleton_class) # exists in 1.9.2
+
+  # class_eval on an object acts like singleton_class.class_eval.
+  def class_eval(*args, &block)
+    singleton_class.class_eval(*args, &block)
+  end
+end

data/lib/core_ext/module/remove_method.rb

@@ -0,0 +1,16 @@
+class Module
+  def remove_possible_method(method)
+    if method_defined?(method) || private_method_defined?(method)
+      remove_method(method)
+    end
+  rescue NameError
+    # If the requested method is defined on a superclass or included module,
+    # method_defined? returns true but remove_method throws a NameError.
+    # Ignore this.
+  end
+
+  def redefine_method(method, &block)
+    remove_possible_method(method)
+    define_method(method, &block)
+  end
+end