whois 2.5.1 → 2.6.0

data/README.md

@@ -0,0 +1,212 @@
+# Whois
+
+*Whois* is an intelligent pure Ruby WHOIS client and parser.
+
+[![Build Status](https://secure.travis-ci.org/weppos/whois.png)](http://travis-ci.org/weppos/whois)
+
+*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.
+
+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.
+
+
+## Features
+
+* Ability to query registry data for [IPv4, IPv6, TLDs, and domain names](http://www.ruby-whois.org/manual/usage.html#usage-objects)
+* Ability to [parse WHOIS responses](http://www.ruby-whois.org/manual/parser.html)
+* Flexible and extensible interface (e.g. You can define [custom servers](http://www.ruby-whois.org/manual/server.html) on the fly)
+* Object oriented design, featuring 10 different design patterns
+* Pure Ruby library, without any external dependency other than Ruby itself
+* Compatible with [Ruby 1.8.7 and greater](http://www.ruby-whois.org/manual/installing.html#installation-requirements), including Ruby 1.9 branch
+* Successfully tested against several [Ruby implementations](http://www.ruby-whois.org/manual/interpreters.html)
+
+
+## Requirements
+
+* Ruby >= 1.8.7
+
+*Whois* >= 1.5 requires Ruby 1.8.7 or newer.
+For older versions of Ruby, see the CHANGELOG.rdoc file.
+
+In addition to the standard Ruby interpreter (MRI),
+Whois has been successfully tested against several
+[Ruby implementations](http://www.ruby-whois.org/manual/interpreters.html).
+
+
+## Installation
+
+The best way to install *Whois* is via [RubyGems](https://rubygems.org/).
+
+    $ gem install whois
+
+You might need administrator privileges on your system to install the gem.
+
+
+## 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.md 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/record/parser architecture.
+
+### Querying the Server
+
+Whois provides the ability to get WHOIS information for TLD, domain names, IPv4 and IPv6 addresses. The client is smart enough to guess the best WHOIS server according to given query, send the request and return the response.
+
+Check out the following examples:
+
+    # Domain WHOIS
+    w = Whois::Client.new
+    w.query("google.com")
+    # => #<Whois::Record>
+
+    # TLD WHOIS
+    w = Whois::Client.new
+    w.query(".com")
+    # => #<Whois::Record>
+
+    # IPv4 WHOIS
+    w = Whois::Client.new
+    w.query("74.125.67.100")
+    # => #<Whois::Record>
+
+    # IPv6 WHOIS
+    w = Whois::Client.new
+    w.query("2001:db8::1428:57ab")
+    # => #<Whois::Record>
+
+The query method is stateless. For this reason, you can safely re-use the same client instance for multiple queries.
+
+    w = Whois::Client.new
+    w.query("google.com")
+    w.query(".com")
+    w.query("74.125.67.100")
+    w.query("2001:db8::1428:57ab")
+    w.query("google.it")
+
+If you just need a WHOIS response and you don't care about a full control of the WHOIS client, the {Whois} module provides an all-in-one method called {Whois.whois}. This is the simplest way to send a WHOIS request.
+
+    Whois.whois("google.com")
+    # => #<Whois::Record>
+
+Did I mention you can even use blocks?
+
+    Whois::Client.new do |w|
+      w.query("google.com")
+      w.query(".com")
+      w.query("74.125.67.100")
+      w.query("2001:db8::1428:57ab")
+      w.query("google.it")
+    end
+
+### Consuming the Record
+
+Any WHOIS query returns a `Whois::Record`. This object looks like a String, but it's way more powerful.
+
+`Whois::Record` encapsulates a WHOIS record and provides the ability to parse the WHOIS response programmatically, by using an object oriented syntax.
+
+    r = Whois.whois("google.it")
+    # => #<Whois::Record>
+  
+    r.available?
+    # => false
+    r.registered?
+    # => true
+  
+    r.created_on
+    # => Fri Dec 10 00:00:00 +0100 1999
+  
+    t = r.technical_contact
+    # => #<Whois::Record::Contact>
+    t.id
+    # => "TS7016-ITNIC"
+    t.name
+    # => "Technical Services"
+  
+    r.nameservers.each do |nameserver|
+      puts nameserver
+    end
+
+This feature is made possible by the *Whois* 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.
+
+### Timeout
+
+By default, each query run though the client has a timeout value of 5 seconds. If the execution exceeds timeout limit, the client raises a `Timeout::Error` exception.
+
+Off course, you can customize the timeout value setting a different value. If timeout is `nil`, the client will until the response is sent back from the server or the process is killed. Don't disable the timeout unless you really know you are doing!
+
+    w = Whois::Client.new(:timeout => 10)
+    w.timeout # => 10
+    w.timeout = 5
+    w.timeout # => 5
+  
+    w.query("google.com")
+
+
+## Acknowledgments
+
+First of all, I would like to express my most sincere thanks to Cyril Mougel, the author of the first Ruby Whois gem that has been available since 2007. Cyril has been kind enough to yield me the privilege of using the RubyForge Whois project and the Whois package name to publish this library. To express all my gratitude, the release 0.5.0 and all sub sequential versions of the new Whois up to 0.9.x are 100% compatible with Cyril's Whois.
+
+Whois is largely inspired by other notable Whois projects, most of all the Debian Whois library written and maintained by Marco D'Itri. Other good ideas and design decisions come from the PERL `Net::DRI` package.
+
+I would lie if I say I'm completely unaware of the other Ruby Whois projects. Before starting this Ruby Whois library I deeply investigated the available resources and, despite none of them was a good candidate for a refactoring, some of them expose a really cool API.
+They didn't directly influence this library or any design decision, but they have been a really interesting code-reading.
+
+The parser architecture has been inspired by the [PHPWhois](http://phpwhois.sourceforge.net/) project. The authors puts lot of effort to create whois-specific parsers normalizing the different responses in a single tree-based structure. So far, this is the only one open source project that offers such this feature in all the programming language ecosystem.
+
+Despite I spent weeks reading source code from the available whois libraries, Ruby *Whois* has been built from scratch trying to focus on long-term maintainability and flexibility and cannot be considered a Ruby port of any of other existing Whois libraries.
+
+
+## Credits
+
+- [Simone Carletti](http://www.simonecarletti.com/) <weppos@weppos.net> - Author
+- [Contributors](https://github.com/weppos/whois/contributors)
+
+
+## Contribute
+
+Direct questions and discussions to the [mailing list](http://groups.google.com/group/ruby-whois).
+
+Pull requests are very welcome! Please include spec and/or feature coverage for every patch, and create a topic branch for every separate change you make.
+
+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/)
+- [Repository](https://github.com/weppos/whois)
+- [Documentation](http://www.ruby-whois.org/documentation.html) - The official documentation, see also the [API Documentation](http://www.ruby-whois.org/api).
+- [Discussion Group](http://groups.google.com/group/ruby-whois)
+
+
+## Changelog
+
+See the [CHANGELOG](CHANGELOG.md) file for details.
+
+
+## License
+
+Copyright (c) 2009-2012 Simone Carletti.
+
+This is Free Software distributed under the MIT license.

data/Rakefile

@@ -26,14 +26,14 @@ spec = Gem::Specification.new do |s|
   s.homepage          = "http://www.ruby-whois.org"
   s.rubyforge_project = "whois"
 
-  s.files             = %w( Rakefile LICENSE .gemtest .rspec .yardopts ) +
-                        Dir.glob("*.{rdoc,gemspec}") +
+  s.files             = %w( Rakefile LICENSE .gemtest .yardopts ) +
+                        Dir.glob("*.{md,gemspec}") +
                         Dir.glob("{bin,lib,spec}/**/*")
   s.executables       = %w( ruby-whois )
   s.require_paths     = %w( lib )
 
   s.add_development_dependency "rake",  "~> 0.9"
-  s.add_development_dependency "rspec", "~> 2.9.0"
+  s.add_development_dependency "rspec", "~> 2.10.0"
   s.add_development_dependency "mocha"
   s.add_development_dependency "yard"
 

data/lib/whois.rb

@@ -114,8 +114,9 @@ module Whois
     #
     # @api internal
     # @private
-    def deprecate(message = nil)
+    def deprecate(message = nil, callstack = caller)
       message ||= "You are using deprecated behavior which will be removed from the next major or minor release."
+      # warn("DEPRECATION WARNING: #{message} #{deprecation_caller_message(callstack)}")
       warn("DEPRECATION WARNING: #{message}")
     end
 
@@ -134,6 +135,30 @@ module Whois
         " http://github.com/weppos/whois/issues"
     end
 
+  private
+
+    def deprecation_caller_message(callstack)
+      file, line, method = extract_callstack(callstack)
+      if file
+        if line && method
+          "(called from #{method} at #{file}:#{line})"
+        else
+          "(called from #{file}:#{line})"
+        end
+      end
+    end
+
+    def extract_callstack(callstack)
+      gem_root = File.expand_path("../../../", __FILE__) + "/"
+      offending_line = callstack.find { |line| !line.start_with?(gem_root) } || callstack.first
+      if offending_line
+        if md = offending_line.match(/^(.+?):(\d+)(?::in `(.*?)')?/)
+          md.captures
+        else
+          offending_line
+        end
+      end
+    end
   end
 
 end

data/lib/whois/definitions/tlds.rb

@@ -232,7 +232,7 @@ Whois::Server.define :tld, ".np", nil, { :web => "http://register.mos.com.np/use
 Whois::Server.define :tld, ".nr", nil, { :web => "http://www.cenpac.net.nr/dns/whois.html", :adapter => Whois::Server::Adapters::Web }
 Whois::Server.define :tld, ".nu", "whois.nic.nu"
 Whois::Server.define :tld, ".nz", "whois.srs.net.nz"
-Whois::Server.define :tld, ".om", nil, { :web => "http://www.omnic.om/onlineUser/WHOISLookup.jsp", :adapter => Whois::Server::Adapters::Web }
+Whois::Server.define :tld, ".om", "whois.registry.om"
 Whois::Server.define :tld, ".pa", nil, { :web => "http://www.nic.pa/", :adapter => Whois::Server::Adapters::Web }
 Whois::Server.define :tld, ".pe", "kero.yachay.pe"
 Whois::Server.define :tld, ".pf", nil, { :adapter => Whois::Server::Adapters::None }
@@ -273,6 +273,7 @@ Whois::Server.define :tld, ".sr", nil, { :adapter => Whois::Server::Adapters::No
 Whois::Server.define :tld, ".st", "whois.nic.st"
 Whois::Server.define :tld, ".su", "whois.tcinet.ru"
 Whois::Server.define :tld, ".sv", nil, { :adapter => Whois::Server::Adapters::Web, :web => "http://www.uca.edu.sv/dns/" }
+Whois::Server.define :tld, ".sx", "whois.sx"
 Whois::Server.define :tld, ".sy", nil, { :adapter => Whois::Server::Adapters::None }
 Whois::Server.define :tld, ".sz", nil, { :adapter => Whois::Server::Adapters::None }
 Whois::Server.define :tld, ".tc", "whois.adamsnames.tc"
@@ -284,7 +285,7 @@ Whois::Server.define :tld, ".tj", nil, { :web => "http://www.nic.tj/whois.html",
 Whois::Server.define :tld, ".tk", "whois.dot.tk"
 Whois::Server.define :tld, ".tl", "whois.nic.tl"
 Whois::Server.define :tld, ".tm", "whois.nic.tm"
-Whois::Server.define :tld, ".tn", nil, { :web => "http://whois.ati.tn/", :adapter => Whois::Server::Adapters::Web }
+Whois::Server.define :tld, ".tn", "whois.ati.tn"
 Whois::Server.define :tld, ".to", "whois.tonic.to"
 Whois::Server.define :tld, ".tp", nil, { :adapter => Whois::Server::Adapters::None }
 Whois::Server.define :tld, ".tr", "whois.nic.tr"

data/lib/whois/record.rb

@@ -104,12 +104,12 @@ module Whois
     # and separates each response with a newline character.
     #
     # @example Record with one part
-    #   record = Whois::Record.new([Whois::Record::Part.new("First record.")])
+    #   record = Whois::Record.new([Whois::Record::Part.new(:body => "First record.")])
     #   record.content
     #   # => "First record."
     #
     # @example Record with multiple parts
-    #   record = Whois::Record.new([Whois::Record::Part.new("First record."), Whois::Record::Part.new("Second record.")])
+    #   record = Whois::Record.new([Whois::Record::Part.new(:body => "First record."), Whois::Record::Part.new(:body => "Second record.")])
     #   record.content
     #   # => "First record.\nSecond record."
     #

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

@@ -102,7 +102,7 @@ module Whois
 
         property_supported :nameservers do
           Array.wrap(node("Name Server")).reject(&:empty?).map do |name|
-            Nameserver.new(name.downcase)
+            Nameserver.new(:name => name.downcase)
           end
         end
 
@@ -117,7 +117,7 @@ module Whois
         end
 
 
-      private
+        private
 
         def build_contact(element, type)
           node("#{element} ID") do

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

@@ -70,10 +70,18 @@ module Whois
         end
 
 
+        property_supported :registrar do
+          Record::Registrar.new(
+            :name => content_for_scanner.slice(/Registrar Name: (.+)\n/, 1),
+            :url  => content_for_scanner.slice(/Registration URL: (.+)\n/, 1)
+          )
+        end
+
+
         property_supported :nameservers do
           if content_for_scanner =~ /Name Servers:\n((.+\n)+)\n/
             $1.split("\n").map do |name|
-              Record::Nameserver.new(name.strip)
+              Record::Nameserver.new(:name => name.strip)
             end
           end
         end

data/lib/whois/record/parser/jobswhois.verisign-grs.com.rb

@@ -70,14 +70,18 @@ module Whois
 
         property_supported :registrar do
           node("Registrar") do |raw|
-            Whois::Record::Registrar.new(:name => last_useful_item(raw), :organization => last_useful_item(raw), :url => referral_url)
+            Whois::Record::Registrar.new(
+                :name => last_useful_item(raw), 
+                :organization => last_useful_item(raw),
+                :url => referral_url
+            )
           end
         end
 
 
         property_supported :nameservers do
           Array.wrap(node("Name Server")).reject { |value| value =~ /no nameserver/i }.map do |name|
-            Nameserver.new(name.downcase)
+            Nameserver.new(:name => name.downcase)
           end
         end
 

data/lib/whois/record/parser/kero.yachay.pe.rb

@@ -63,7 +63,7 @@ module Whois
         property_supported :nameservers do
           if content_for_scanner =~ /Name Servers:\n((.+\n)+)\n/
             $1.split("\n").map do |name|
-              Record::Nameserver.new(name.strip)
+              Record::Nameserver.new(:name => name.strip)
             end
           end
         end

data/lib/whois/record/parser/whois.adamsnames.tc.rb

@@ -53,7 +53,7 @@ module Whois
 
         property_supported :nameservers do
           content_for_scanner.scan(/\s+ns\s+(.+?)\s+\n/).flatten.map do |name|
-            Record::Nameserver.new(name)
+            Record::Nameserver.new(:name => name)
           end
         end
 

data/lib/whois/record/parser/whois.aeda.net.ae.rb

@@ -57,7 +57,7 @@ module Whois
 
         property_supported :nameservers do
           content_for_scanner.scan(/Name Server:\s+(.+)\n/).flatten.map do |name|
-            Record::Nameserver.new(name)
+            Record::Nameserver.new(:name => name)
           end
         end
 

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

@@ -54,7 +54,7 @@ module Whois
         property_supported :nameservers do
           if content_for_scanner =~ /Nameservers\n((.+\n)+)\n/
             $1.split("\n").select { |e| e =~ /Server Hostname/ }.map do |line|
-              Record::Nameserver.new(line.split(":").last.strip)
+              Record::Nameserver.new(:name => line.split(":").last.strip)
             end
           end
         end

data/lib/whois/record/parser/whois.arnes.si.rb

@@ -65,7 +65,7 @@ module Whois
 
         property_supported :nameservers do
           content_for_scanner.scan(/nameserver:\s+(.+)\n/).flatten.map do |name|
-            Record::Nameserver.new(name)
+            Record::Nameserver.new(:name => name)
           end
         end
 

data/lib/whois/record/parser/whois.ati.tn.rb

@@ -0,0 +1,133 @@
+#--
+# Ruby Whois
+#
+# An intelligent pure Ruby WHOIS client and parser.
+#
+# Copyright (c) 2009-2012 Simone Carletti <weppos@weppos.net>
+#++
+
+
+require 'whois/record/parser/base'
+require 'whois/record/scanners/whois.ati.tn.rb'
+
+
+module Whois
+  class Record
+    class Parser
+
+      # Parser for the whois.ati.tn server.
+      # 
+      # @see Whois::Record::Parser::Example
+      #   The Example parser for the list of all available methods.
+      #
+      # @since RELEASE
+      class WhoisAtiTn < 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 available?
+            :available
+          else
+            :registered
+          end
+        end
+
+        property_supported :available? do
+          !!node("status:available")
+        end
+
+        property_supported :registered? do
+          !available?
+        end
+
+
+        property_supported :created_on do
+          node("Acivated") { |value| Time.parse(value) }
+        end
+
+        property_not_supported :updated_on
+
+        property_not_supported :expires_on
+
+
+        property_supported :registrar do
+          node("Registrar") do |str|
+            Record::Registrar.new(
+              :id           => nil,
+              :name         => node("Registrar")
+            )
+          end
+        end
+
+
+        property_supported :registrant_contacts do
+          build_contact("Owner", Whois::Record::Contact::TYPE_REGISTRANT)
+        end
+
+        property_supported :admin_contacts do
+          build_contact("Admin.", Whois::Record::Contact::TYPE_ADMIN)
+        end
+
+        property_supported :technical_contacts do
+          build_contact("Tech.", Whois::Record::Contact::TYPE_TECHNICAL)
+        end
+
+
+        property_supported :nameservers do
+          Array.wrap(node("NameServers")).map do |line|
+            name, ipv4 = line.match(/(.+)\. \[(.+)\]/)[1, 2]
+            Nameserver.new(:name => name, :ipv4 => ipv4)
+          end
+        end
+
+
+        # Initializes a new {Scanners::WhoisAtiTn} instance
+        # passing the {#content_for_scanner}
+        # and calls +parse+ on it.
+        #
+        # @return [Hash]
+        def parse
+          Scanners::WhoisAtiTn.new(content_for_scanner).parse
+        end
+
+
+      private
+
+        def build_contact(element, type)
+          node("#{element} Name") do
+            Record::Contact.new(
+              :type         => type,
+              :id           => nil,
+              :name         => node("#{element} Name"),
+              :address      => node("#{element} Address"),
+              :phone        => node("#{element} Tel"),
+              :fax          => node("#{element} Fax"),
+              :email        => node("#{element} Email"),
+              :created_on   => node("#{element} Created") { |value| Time.parse(value) },
+              :updated_on   => node("#{element} Updated") { |value| Time.parse(value) }
+            )
+          end
+        end
+
+      end
+
+    end
+  end
+end