whois 1.6.6 → 2.0.0

data/.rspec

@@ -0,0 +1 @@
+--colour

data/.yardopts

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

data/CHANGELOG.rdoc

@@ -1,5 +1,152 @@
 = Changelog
 
+== Release 2.0.0
+
+* SERVER: Added .AE.ORG, .AR.COM, .KR.COM TLD definitions (whois.centralnic.net).
+
+* SERVER: Removed invalid .WEB.COM TLD definition (whois.centralnic.net).
+
+* SERVER: Updated .EE TLD definition and corresponding parser (#64).
+
+* SERVER: Sync definitions with Debian whois 5.0.10:
+    * Added new IPv4 allocations.
+
+* SERVER: Added the following 12 new IDN TLD:
+    * .XN--WGBL6A (قطر, Qatar) (#63)
+    * .XN--3E0B707E (한국, Korea, Republic of)
+    * .XN--45BRJ9C (.ভারত, India)
+    * .XN--FPCRJ9C3D (భారత్, India)
+    * .XN--GECRJ9C (ભારત, India)
+    * .XN--H2BRJ9C (भारत, India)
+    * .XN--MGBBH1A71E (بھارت, India)
+    * .XN--OGBPF8FL (سورية, Syrian Arab Republic)
+    * .XN--S9BRJ9C (ਭਾਰਤ, India)
+    * .XN--XKC2DL3A5EE0H (இந்தியா, India)
+    * .XN--YFRO4I67O (新加坡, Singapore)
+    * .XN--CLCHC0EA0B2G2A9GCD (சிங்கப்பூர், Singapore)
+
+* SERVER: Changed .KR TLD definition to whois.kr.
+
+* NEW: Added simple AE.ORG, AR.COM, BR.COM, CN.COM, DE.COM, EU.COM,
+  GB.COM, GB.NET, HU.COM, JPN.COM, KR.COM, NO.COM, QC.COM, RU.COM,
+  SA.COM, SE.COM, SE.NET, UK.COM, UK.NET, US.COM, UY.COM, WEB.COM,
+  ZA.COM TLD parser (whois.centralnic.net).
+
+* NEW: Added ability to bind a WHOIS query to a specific local address and port (#40).
+
+* NEW: Added simple .SO TLD parser (whois.nic.so) (#57).
+
+* NEW: Property memoization (#18)
+
+* NEW: whois.ripn.net now supports #registrar and #admin_contact (#72).
+
+* NEW: Added support for $ gem test and Gem Testers
+  See http://www.engineyard.com/blog/2011/introducing-gem-testers/
+
+* NEW: Whois::Answer::Nameserver#to_s returns the #name for BC with string-based nameservers.
+
+* NEW: Added support for throttled response detection (#23, #54, #61)
+
+* NEW: whois.registry.in now supports #registrar (#78).
+
+* NEW: Added full whois.cnnic.cn parser (#77).
+
+* NEW: Added full whois.cnnic.biz parser.
+
+* NEW: Added full whois.afilias.info parser.
+
+* NEW: Extracted Whois::Answer::Parser::Features and Extracted Whois::Answer::Parser::Scanners::Base.
+
+* NEW: whois.nic.uk now supports #registrar (#81, #82).
+
+* NEW: Added simple whois.markmonitor.net parser (#83).
+
+* CHANGED: Renamed whois.centralnic.net to whois.centralnic.com (#28).
+
+* CHANGED: Switched from RDoc to YARDoc (#3).
+
+* CHANGED: Whois::Server::Adapter::Base#== now returns false if other is not the same instance of self.
+
+* CHANGED: Deprecated the comparison of Whois::Answer with String.
+
+* CHANGED: Removed official support for Ruby 1.9.1.
+
+* 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: Removed &block from method definition to avoid creating block objects when yield is used (#66)
+
+* CHANGED: Renamed Whois::Answer::Parser::Base.register_property to Whois::Answer::Parser::Base.property_register.
+
+* CHANGED: Whois::Answer::Parser creates a missing method the first time it is invoked to increase performance.
+
+* CHANGED: whois.nic.it parser raises on invalid #status.
+
+* 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: #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.
+
+* CHANGED: Renamed Whois::Answer to Whois::Record and deprecate Whois::Answer class.
+
+* FIXED: Converted #changed? and #unchanged? properties to methods
+  and normalized their behavior.
+
+* 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 which prevents a client to be created with nil timeout.
+
+* FIXED: The very first time a Whois::Answer method/property question method is invoked,
+  the corresponding method is called instead of the question one.
+
+* FIXED: whois.cat parser must support multiple statuses.
+
+* FIXED: whois.tld.ee parser must support :expired status.
+
+* FIXED: whois.nic.fr parser must support :registered status.
+
+* FIXED: whois.nic.cz parser must support :expired status.
+
+* FIXED: With some .tr domains, whois.nic.tr parser returns invalid values for nameservers.
+
+* FIXED: whois.isoc.org.il parser must support "transfer allowed" status.
+
+* FIXED: Whois::Answer#respond_to? and Whois::Answer::Parser#respond_to?
+  should keep METHODS and PROPERTIES into consideration.
+
+* FIXED: whois.nic.fr parser must support "redemption" status.
+
+* FIXED: whois.nic.it parser must support the following new statuses:
+    - ok / *
+    - client*
+    - pendingDelete
+    - GRACE-PERIOD
+
+* FIXED: whois.nic.it parser doesn't set address state.
+
+* FIXED: whois.cira.ca parser must support "to be released" status.
+
+* FIXED: whois.sk-nic.sk parser must support "DOM_HELD" status.
+
+=== BC
+
+* Whois::Server::Adapters::Base#append_to_buffer renamed to buffer_append.
+
+* 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.
+
+* Renamed Whois::Answer::Parser::Base.register_property to Whois::Answer::Parser::Base.property_register.
+
+
 == Release 1.6.6
 
 * NEW: Backported whois.centralnic.net support from version 2.0.
@@ -11,8 +158,6 @@
 
 == Release 1.6.5
 
-* FIXED: whois.nic.ve must support :suspended status.
-
 * FIXED: whois.dns.pt must support :reserved status.
 
 * FIXED: whois.cira.ca must support :redemption status as :registered.
@@ -22,7 +167,10 @@
 
 * FIXED: With some .pl domains, whois.dns.pl parser returns invalid values for nameservers.
 
-* FIXED: The whois.pnina.ps server injects a NODNS.NS string when a nameserver is not set. The parser should ignore it.
+* FIXED: The whois.pnina.ps server injects a NODNS.NS string when a nameserver is not set.
+  The parser should ignore it.
+
+* FIXED: whois.nic.ve must support :suspended status.
 
 
 == Release 1.6.3

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2009-2011 Simone Carletti <weppos@weppos.net>
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -41,9 +41,20 @@ This library is intended to be installed as a Gem.
 You might need administrator privileges on your system to install it.
 
 
+== Upgrade
+
+Install the newer version via RubyGems.
+
+  $ gem install whois
+
+Minor and bugfix releases normally won't break backwards-compatibility. You can read the CHANGELOG.rdoc file to learn about the changes in each release.
+
+Read the {Upgrading}[http://www.ruby-whois.org/manual/upgrading.html] documentation page for detailed information about incompatible changes and further instructions.
+
+
 == Getting Started
 
-Note. This section covers only the essentials for getting started with the Whois library. The {documentation}[http://www.ruby-whois.org/documentation.html] provides a more accurate explanation including tutorials, more examples and technical details about the client/server/answer/parser architecture.
+Note. This section covers only the essentials for getting started with the Whois library. The {documentation}[http://www.ruby-whois.org/documentation.html] provides a more accurate explanation including tutorials, more examples and technical details about the client/server/record/parser architecture.
 
 === Querying the Server
 
@@ -54,22 +65,22 @@ Check out the following examples:
   # Domain WHOIS
   w = Whois::Client.new
   w.query("google.com")
-  # => #<Whois::Answer>
+  # => #<Whois::Record>
 
   # TLD WHOIS
   w = Whois::Client.new
   w.query(".com")
-  # => #<Whois::Answer>
+  # => #<Whois::Record>
 
   # IPv4 WHOIS
   w = Whois::Client.new
   w.query("74.125.67.100")
-  # => #<Whois::Answer>
+  # => #<Whois::Record>
 
   # IPv6 WHOIS
   w = Whois::Client.new
   w.query("2001:db8::1428:57ab")
-  # => #<Whois::Answer>
+  # => #<Whois::Record>
 
 The query method is stateless. For this reason, you can safely re-use the same client instance for multiple queries.
 
@@ -83,7 +94,7 @@ The query method is stateless. For this reason, you can safely re-use the same c
 If you just need a WHOIS response and you don't care about a full control of the WHOIS Client, <tt>Whois</tt> comes with a simple method called whois. This is the simplest way to send a WHOIS request.
 
   Whois.whois("google.com")
-  # => #<Whois::Answer>
+  # => #<Whois::Record>
 
 Did I mention you can even use blocks?
 
@@ -96,35 +107,35 @@ Did I mention you can even use blocks?
   end
 
 
-=== Consuming the Answer
+=== Consuming the Record
 
-As of release 0.8, a WHOIS query no longer returns a simple string. Instead, you get a full <tt>Whois::Answer</tt> instance and this is just the beginning of the story.
+Any WHOIS query returns a <tt>Whois::Record</tt>. This object looks like a String, but it's way more powerful.
 
-<tt>Whois::Answer</tt> is a super powerful object. It encapsulates the full WHOIS answer and it provides you the ability to parse the WHOIS response with a full object oriented notation.
+<tt>Whois::Record</tt> encapsulates a WHOIS record and provides the ability to parse the WHOIS response programmatically, by using an object oriented syntax.
 
-  a = Whois.whois("google.it")
-  # => #<Whois::Answer>
+  r = Whois.whois("google.it")
+  # => #<Whois::Record>
   
-  a.available?
+  r.available?
   # => false
-  a.registered?
+  r.registered?
   # => true
   
-  a.created_on
+  r.created_on
   # => Fri Dec 10 00:00:00 +0100 1999
   
-  t = a.technical
-  # => #<Whois::Answer::Contact>
+  t = r.technical
+  # => #<Whois::Record::Contact>
   t.id
   # => "TS7016-ITNIC"
   t.name
   # => "Technical Services"
   
-  a.nameservers.each do |nameserver|
+  r.nameservers.each do |nameserver|
     puts nameserver
   end
 
-This feature is made possible by the <tt>Whois</tt> answer parsers. Unfortunately, due to the lack of a global standard, each WHOIS server requires a specific parser. For this reason, the library doesn't support all existing WHOIS servers.
+This feature is made possible by the <tt>Whois</tt> record parsers. Unfortunately, due to the lack of a global standard, each WHOIS server requires a specific parser. For this reason, the library doesn't support all existing WHOIS servers.
 
 If you create a new parser, please consider releasing it to the public so that it can be included in a next version.
 
@@ -175,7 +186,7 @@ Bug reports and Feature suggestions {are welcomed}[http://github.com/weppos/whoi
 
 == More
 
-* {Homepage}[http://www.ruby-whois.org]
+* {Homepage}[http://www.ruby-whois.org/]
 * {Repository}[http://github.com/weppos/whois]
 * {API Documentation}[http://www.ruby-whois.org/api/] (RDoc)
 * {Discussion Group}[http://groups.google.com/group/ruby-whois]
@@ -188,5 +199,7 @@ See the CHANGELOG.rdoc file for details.
 
 == License
 
-Copyright (c) 2009-2010 Simone Carletti, Whois is released under the MIT license.
+Copyright (c) 2009-2011 Simone Carletti.
+
+Whois is free software released under the MIT license.
 

data/Rakefile

@@ -0,0 +1,144 @@
+require 'rubygems'
+require 'rspec/core/rake_task'
+require 'rake/gempackagetask'
+require 'yard'
+require 'yard/rake/yardoc_task'
+
+$:.unshift(File.dirname(__FILE__) + '/lib')
+require 'whois'
+
+
+# Common package properties
+PKG_NAME    = ENV['PKG_NAME']    || Whois::GEM
+PKG_VERSION = ENV['PKG_VERSION'] || Whois::VERSION
+
+if ENV['SNAPSHOT'].to_i == 1
+  PKG_VERSION << "." << Time.now.utc.strftime("%Y%m%d%H%M%S")
+end
+
+
+# Run test by default.
+task :default => :rspec
+task :test => :rspec
+
+# This builds the actual gem. For details of what all these options
+# mean, and other ones you can add, check the documentation here:
+#
+#   http://rubygems.org/read/chapter/20
+#
+spec = Gem::Specification.new do |s|
+  s.name              = PKG_NAME
+  s.version           = PKG_VERSION
+  s.summary           = "An intelligent pure Ruby WHOIS client and parser."
+  s.description       = "Whois is an intelligent WHOIS client and parser written in pure Ruby. It can query registry data for IPv4, IPv6 and top level domains, parse and convert responses into easy-to-use Ruby objects."
+
+  s.required_ruby_version = ">= 1.8.7"
+
+  s.author            = "Simone Carletti"
+  s.email             = "weppos@weppos.net"
+  s.homepage          = "http://www.ruby-whois.org"
+  s.rubyforge_project = "whois"
+
+  s.files             = %w( Rakefile LICENSE .gemtest .rspec .yardopts ) +
+                        Dir.glob("*.{rdoc,gemspec}") +
+                        Dir.glob("{bin,lib,spec}/**/*")
+  s.executables       = ["ruby-whois"]
+  s.require_paths     = ["lib"]
+
+  # If you want to depend on other gems, add them here, along with any
+  # relevant versions
+  # s.add_dependency("some_other_gem", "~> 0.1.0")
+
+  # If your tests use any gems, include them here
+  s.add_development_dependency("rspec", "~> 2.5.0")
+  s.add_development_dependency("mocha")
+  s.add_development_dependency("yard")
+end
+
+# This task actually builds the gem.
+# We also regenerate a static .gemspec file.
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+end
+
+desc "Build the gemspec file #{spec.name}.gemspec"
+task :gemspec do
+  file = File.dirname(__FILE__) + "/#{spec.name}.gemspec"
+  File.open(file, "w") {|f| f << spec.to_ruby }
+end
+
+
+# Run all the specs in the /spec folder
+RSpec::Core::RakeTask.new(:rspec)
+
+
+namespace :multitest do
+  RUBIES = %w( ruby-1.8.7-p334 ruby-1.9.2-p180 jruby-1.6.0.RC2 ree-1.8.7-2011.03 )
+
+  desc "Run tests for all rubies"
+  task :all => :ensure_rvm do
+    sh "rvm #{RUBIES.join(",")} rake test"
+  end
+
+  task :ensure_rvm do
+    File.exist?(File.expand_path("~/.rvm/scripts/rvm")) || abort("RVM is not available")
+  end
+
+  RUBIES.each do |ruby|
+    desc "Run tests against Ruby #{ruby}"
+    task ruby => "test:ensure_rvm" do
+      sh "rvm #{ruby} rake test"
+    end
+  end
+
+  task :bundleize do
+    sh "rvm #{RUBIES.join(",")} gem install bundler"
+  end
+
+  task :setup do
+    sh "rvm #{RUBIES.join(",")} exec bundle install"
+  end
+end
+
+
+desc "Remove any temporary products, including gemspec"
+task :clean => [:clobber] do
+  rm "#{spec.name}.gemspec" if File.file?("#{spec.name}.gemspec")
+end
+
+desc "Remove any generated file"
+task :clobber => [:clobber_rcov, :clobber_package]
+
+desc "Package the library and generates the gemspec"
+task :package => [:gemspec]
+
+
+YARD::Rake::YardocTask.new(:yardoc) do |y|
+  y.options = ["--output-dir", "yardoc"]
+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
+end
+
+task :clobber => "yardoc:clobber"
+
+
+desc "Open an irb session preloaded with this library"
+task :console do
+  sh "irb -rubygems -I lib -r whois.rb"
+end
+
+
+Dir["tasks/**/*.rake"].each do |file|
+  load(file)
+end