net-dns 0.5.3 → 0.6.0

data/.gitignore

@@ -0,0 +1,6 @@
+.DS_Store
+nbproject
+.idea
+pkg
+doc
+coverage

data/AUTHORS.rdoc

@@ -0,0 +1,7 @@
+= Authors
+
+Net::DNS core development:
+  Marco Ceresa <ceresa@ieee.org>
+  Simone Carletti <weppos@weppos.net>
+
+Beta testing:

data/CHANGELOG.rdoc

@@ -0,0 +1,34 @@
+= Changelog
+
+== Release 0.6.0
+
+*WARNING:* If you are upgrading from a previous minor release, check out the Compatibility issue list below.
+
+* FIXED: Added missing #to_s method to Net::DNS::Question.
+
+* FIXED: Compatibility with Ruby 1.9
+
+* FIXED: Types regexp order issue
+
+* CHANGED: Refactoring unit test to follow most used Ruby conventions
+
+* CHANGED: default timeout is now 5 seconds for both UDP and TCP
+
+* CHANGED: Moved main dns.rb file to lib/net folder as default for GEMs. In this way it can be autoloaded when the gem is required.
+
+=== Compatibility issues
+
+* CHANGED: RR#set_stype scope is now private to prevent invalid usage.
+
+* CHANGED: DnsTimeout#timeout now raises LocalJumpError instead of DnsTimeoutArgumentError when block is missing.
+
+* CHANGED: Renamed Net::DNS::RR::Types::Types to Net::DNS::RR::Types::TYPES to follow Ruby coding standards.
+
+
+== Release 0.4
+
+* many bug fixes (thanks guys!)
+* a whole new class Net::DNS::Header::RCode
+* new methods in Net::DNS::Resolver class to do AXFR queries
+* a new SRV resource record written by Dan Janowski
+* more documentation written and corrected

data/README.rdoc

@@ -2,34 +2,46 @@
 
 Net::DNS is a DNS library written in pure Ruby. It started as a port of Perl Net::DNS module, but it evolved in time into a full Ruby library.  
 
-Features:
 
-- Complete OO interface
-- Clean and intuitive API
-- Modular and flexible
+== Features
+
+* Complete OO interface
+* Clean and intuitive API
+* Modular and flexible
+
+
+== Requirements
+
+* Ruby >= 1.8.6 (not tested with previous versions)
+
+As of release TODO, Net::DNS is compatible with Ruby 1.9.1.
+
 
 == Install
 
-Just use Rubygems:
-     
-     $ sudo gem install net-dns
+Just use RubyGems:
+  
+  $ gem install net-dns
 
 If you want to install from source, you can use Rake:
-   
-   $ rake install
 
-Or directly from install.rb
+  $ rake install
+
+Or directly from setup.rb
+
+  $ ruby setup.rb
 
-   $ sudo ruby install.rb
 
 == API Documentation
 
 Visit the page http://marcoceresa.com/net-dns
 
+
 == Trivial resolver
 
 The simplest way to use the library is to invoke the Resolver() method:
 
+    require 'rubygems' 
     require 'net/dns/resolver'
     p Resolver("www.google.com")
 
@@ -74,7 +86,7 @@ Same for Net::DNS::Resolver.start():
     Net::DNS::Resolver.start("google.com").answer.size
       #=> 5
 
-As optionals parameters, +TYPE+ and +CLASS+ can be specified.
+As optional parameters, +TYPE+ and +CLASS+ can be specified.
 
    p Net::DNS::Resolver.start("google.com", Net::DNS::MX)
 
@@ -144,7 +156,7 @@ Gives:
 
 Net::DNS is distributed under the same license Ruby is.
 
+
 == Author
 
-(c) Marco Ceresa 2006   
-      
+(c) Marco Ceresa 2006-2009

data/Rakefile

@@ -1,25 +1,21 @@
 require 'rubygems'
 require 'rake'
-
-#
-# Gem specifications
-#
-SPEC = Gem::Specification.new do |s|
-  s.name              = "net-dns"
-  s.authors           = ["Marco Ceresa"]
-  s.email             = "ceresa@gmail.com"
-  s.homepage          = "http://github.com/bluemonk/net-dns"
-  s.platform          = Gem::Platform::RUBY
-  s.summary           = "Pure Ruby DNS library"
-  s.has_rdoc          = true
-  s.extra_rdoc_files  = ["README.rdoc","AUTHORS","INSTALL", "THANKS"]
-  s.description       = "Net::DNS is a pure Ruby DNS library, with a clean OO interface and an extensible API"
-  s.rubyforge_project = "net-dns"
-end
+require 'rake/clean'
 
 begin
   require 'jeweler'
-  Jeweler::Tasks.new(SPEC)
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name              = "net-dns"
+    gemspec.summary           = "Pure Ruby DNS library"
+    gemspec.description       = "Net::DNS is a pure Ruby DNS library, with a clean OO interface and an extensible API"
+    gemspec.authors           = ["Marco Ceresa", "Simone Carletti"]
+    gemspec.email             = ["ceresa@gmail.com", "weppos@weppos.net"]
+    gemspec.homepage          = "http://github.com/bluemonk/net-dns"
+    gemspec.extra_rdoc_files  = ["README.rdoc", "CHANGELOG.rdoc", "AUTHORS.rdoc", "THANKS.rdoc"]
+    gemspec.rubyforge_project = "net-dns"
+    
+    gemspec.add_development_dependency "rcov"
+  end
   Jeweler::RubyforgeTasks.new
 rescue LoadError
   puts "Jeweler not available."
@@ -27,8 +23,7 @@ end
 
 require 'rake/testtask'
 Rake::TestTask.new(:test) do |test|
- test.test_files = FileList.new('test/**/test_*.rb')
-  test.libs << 'lib' << 'test'
+  test.libs   << 'test'
   test.pattern = 'test/**/*_test.rb'
   test.verbose = true
 end
@@ -36,14 +31,12 @@ end
 begin
   require 'rcov/rcovtask'
   Rcov::RcovTask.new(:rcov) do |test|
-    test.libs << 'test'
+    test.libs   << 'test'
     test.pattern = 'test/**/*_test.rb'
     test.verbose = true
   end
 rescue LoadError
-  task :rcov do
-    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
-  end
+  task :rcov => :check_dependencies
 end
 
 task :default => :test
@@ -51,16 +44,16 @@ task :default => :test
 require 'rake/rdoctask'
 Rake::RDocTask.new do |rdoc|
   if File.exist?('VERSION.yml')
-    config = YAML.load(File.read('VERSION.yml'))
+    config  = YAML.load(File.read('VERSION.yml'))
     version = "#{config[:major]}.#{config[:minor]}.#{config[:patch]}"
   else
-    puts "Not found!"
+    puts "VERSION.yml not found!"
     version = ""
   end
 
   rdoc.rdoc_dir = 'rdoc'
   rdoc.title = "net-dns #{version}"
-  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('*.rdoc')
   rdoc.rdoc_files.include('lib/**/*.rb')
 end
 
@@ -109,7 +102,7 @@ task :todo do
   egrep /(FIXME|TODO|TBD)/
 end
 
-
-
-
-
+desc "Open an irb session preloaded with this library"
+task :console do
+  sh "irb -rubygems -I lib -r net/dns.rb"
+end

data/VERSION.yml

@@ -1,4 +1,5 @@
 --- 
 :major: 0
-:minor: 5
-:patch: 3
+:minor: 6
+:patch: 0
+:build: 

data/demo/check_soa.rb

@@ -1,11 +1,9 @@
 #!/usr/bin/env ruby 
 
-# 	$Id: check_soa.rb,v 1.7 2006/07/30 16:53:57 bluemonk Exp $	
-
-
 require 'rubygems' if "#{RUBY_VERSION}" < "1.9.0"
 require 'net/dns/resolver'
 
+
 #------------------------------------------------------------------------------
 # Get the domain from the command line.
 #------------------------------------------------------------------------------
@@ -20,17 +18,14 @@ domain = ARGV[0]
 
 res = Net::DNS::Resolver.new(:defname => false, :retry => 2)
 
-#res.defname=false
-#res.retry=2
-
-
-ns_req = res.query(domain, Net::DNS::NS);
-raise ArgumentError, "No nameservers found for domain: " + res.errorstring + 
-  "\n"	unless ns_req and ns_req.header.anCount > 0
+ns_req = res.query(domain, Net::DNS::NS)
+unless ns_req and ns_req.header.anCount > 0
+  raise ArgumentError, "No nameservers found for domain: #{res.errorstring}"
+end
 
 
 # Send out non-recursive queries
-res.recurse=false
+res.recurse = false
 # Do not buffer standard out
 #| = 1;
 

data/lib/net/{dns/dns.rb → dns.rb}

@@ -1,16 +1,8 @@
-##
-#
-# dns.rb
-#
-# $id$
-#
-##
+require 'net/dns/core_ext'
+require 'net/dns/version'
 
 module Net # :nodoc:
   module DNS
-    
-    # Version of the library
-    VERSION = "0.4"
   
     # Packet size in bytes
     PACKETSZ = 512
@@ -30,6 +22,7 @@ module Net # :nodoc:
     # Size of a short int
     INT16SZ = 2
 
+
     module QueryTypes
     
       SIGZERO   = 0
@@ -113,5 +106,5 @@ module Net # :nodoc:
     include QueryTypes
     include QueryClasses
 
-  end # module DNS
-end # module Net
+  end
+end

data/lib/net/dns/core_ext.rb

@@ -0,0 +1,52 @@
+module Net # :nodoc:
+  module DNS
+
+    module HashKeys # :nodoc:
+
+      # Returns an hash with all the
+      # keys turned into downcase
+      #
+      #   hsh = {"Test" => 1, "FooBar" => 2}
+      #   hsh.downcase_keys!
+      #      #=> {"test"=>1,"foobar"=>2}
+      #
+      def downcase_keys!
+        hsh = Hash.new
+        self.each do |key,val|
+          hsh[key.downcase] = val
+        end
+        self.replace(hsh)
+      end
+      
+    end
+
+    module HashOperators # :nodoc:
+
+      # Performs a sort of group difference
+      # operation on hashes or arrays
+      #
+      #   a = {:a=>1,:b=>2,:c=>3}
+      #   b = {:a=>1,:b=>2}
+      #   c = [:a,:c]
+      #   a-b #=> {:c=>3}
+      #   a-c #=> {:b=>2}
+      #
+      def -(other)
+        case other
+          when Hash
+            delete_if { |k,v| other.has_key?(k) }
+          when Array
+            delete_if { |k,v| other.include?(k) }
+        end
+      end
+
+    end
+
+  end
+end
+
+
+class Hash # :nodoc:
+  include Net::DNS::HashKeys
+  include Net::DNS::HashOperators
+end

data/lib/net/dns/header.rb

@@ -1,8 +1,5 @@
-#---
-# $Id: Header.rb,v 1.5 2006/07/30 16:54:28 bluemonk Exp $
-#+++
+require 'net/dns'
 
-require 'net/dns/dns'
 
 module Net # :nodoc:
   module DNS 
@@ -57,11 +54,11 @@ module Net # :nodoc:
     # which are listed here to keep a light and browsable main documentation.
     # We have:
     #
-    # * HeaderArgumentError:  canonical argument error
-    # * HeaderWrongCount:     a wrong +count+ parameter has been passed
-    # * HeaderWrongRecursive: a wrong +recursive+ parameter has been passed
-    # * HeaderWrongOpcode:    a not valid +opCode+ has been specified
-    # * HeaderDuplicateID:    the requested ID is already in use
+    # ArgumentError::       Argument Error for class Net::DNS::Packet
+    # WrongCountError::     A wrong +count+ parameter has been passed
+    # WrongRecursiveError:: A wrong +recursive+ parameter has been passed
+    # WrongOpcodeError::    A not valid +opCode+ has been specified
+    # DuplicateIDError::    The requested ID is already in use
     #
     # =Copyright
     # 
@@ -71,9 +68,34 @@ module Net # :nodoc:
     # it and/or modify it under the same terms as Ruby itself.
     #
     class Header
-    
+      
+      # Argument Error for class Net::DNS::Header.
+      class ArgumentError < ArgumentError
+      end
+      
+      # A wrong +count+ parameter has been passed-
+      class WrongCountError < ArgumentError
+      end
+      
+      # A wrong +recursive+ parameter has been passed-
+      class WrongRecursiveError < ArgumentError
+      end
+      
+      # An invalid +opCode+ has been specified.
+      class WrongOpcodeError < ArgumentError
+      end
+      
+      # Base error class.
+      class Error < StandardError
+      end
+      
+      # The requested ID is already in use.
+      class DuplicateIDError < Error
+      end
+      
+
       #
-      # =Name
+      # = Name
       #
       # Net::DNS::Header::RCode - DNS Header RCode handling class
       #
@@ -100,7 +122,7 @@ module Net # :nodoc:
       #                   problem with the name server.
       # * 3               Name Error - Meaningful only for
       #                   responses from an authoritative name
-      #                   server, this code signifies that the
+      #                   server, this code means that the
       #                   domain name referenced in the query does
       #                   not exist.
       # * 4               Not Implemented - The name server does
@@ -166,7 +188,7 @@ module Net # :nodoc:
             @type         = RCodeType[code]
             @explanation  = RCodeErrorString[code] 
           else
-            raise HeaderArgumentError, "RCode #{code} out of range"
+            raise ArgumentError, "RCode `#{code}' out of range"
           end
         end
         
@@ -240,7 +262,7 @@ module Net # :nodoc:
         if arg.kind_of? Hash
           new_from_hash(arg)
         else
-          raise HeaderArgumentError, "Wrong argument class: #{arg.class}"
+          raise ArgumentError, "Wrong argument class `#{arg.class}'"
         end
       end
 
@@ -262,7 +284,7 @@ module Net # :nodoc:
           o.send(:new_from_binary, arg)
           o
         else
-          raise HeaderArgumentError, "Wrong argument class: #{arg.class}"
+          raise ArgumentError, "Wrong argument class `#{arg.class}'"
         end
       end
       
@@ -362,13 +384,13 @@ module Net # :nodoc:
       #
       def id=(val)
         if @@id_arr.include? val
-          raise HeaderDuplicateID, "ID #{val} already used"
+          raise DuplicateIDError, "ID `#{val}' already used"
         end
         if (1..65535).include? val
           @id = val
           @@id_arr.push val
         else
-          raise HeaderArgumentError, "ID #{val} out of range"
+          raise ArgumentError, "ID `#{val}' out of range"
         end
       end
       
@@ -393,7 +415,7 @@ module Net # :nodoc:
         when 0,1
           @qr = val
         else
-          raise HeaderArgumentError, ":qr must be true(or 1) or false(or 0)"
+          raise ArgumentError, ":qr must be true(or 1) or false(or 0)"
         end
       end
 
@@ -431,7 +453,7 @@ module Net # :nodoc:
         if (0..2).include? val
           @opCode = val
         else
-          raise HeaderWrongOpcode, "Wrong opCode value (#{val}), must be QUERY, IQUERY or STATUS"
+          raise WrongOpcodeError, "Wrong opCode value (#{val}), must be QUERY, IQUERY or STATUS"
         end
       end
 
@@ -465,7 +487,7 @@ module Net # :nodoc:
         when 0,1
           @aa = val
         else
-          raise HeaderArgumentError, ":aa must be true(or 1) or false(or 0)"
+          raise ArgumentError, ":aa must be true(or 1) or false(or 0)"
         end
       end
       
@@ -503,7 +525,7 @@ module Net # :nodoc:
         when 0,1
           @tc = val
         else
-          raise HeaderArgumentError, ":tc must be true(or 1) or false(or 0)"
+          raise ArgumentError, ":tc must be true(or 1) or false(or 0)"
         end
       end
       
@@ -535,7 +557,7 @@ module Net # :nodoc:
         when 0
           @rd = 0
         else
-          raise HeaderWrongRecursive, "Wrong value (#{val}), please specify true (1) or false (0)"
+          raise WrongRecursiveError, "Wrong value (#{val}), please specify true (1) or false (0)"
         end
       end
 
@@ -568,7 +590,7 @@ module Net # :nodoc:
         when 0,1
           @ra = val
         else
-          raise HeaderArgumentError, ":ra must be true(or 1) or false(or 0)"
+          raise ArgumentError, ":ra must be true(or 1) or false(or 0)"
         end
       end
 
@@ -592,7 +614,7 @@ module Net # :nodoc:
         when 0,1
           @cd = val
         else
-          raise HeaderArgumentError, ":cd must be true(or 1) or false(or 0)"
+          raise ArgumentError, ":cd must be true(or 1) or false(or 0)"
         end
       end
 
@@ -620,7 +642,7 @@ module Net # :nodoc:
         when 0,1
           @ad = val
         else
-          raise HeaderArgumentError, ":ad must be true(or 1) or false(or 0)"
+          raise ArgumentError, ":ad must be true(or 1) or false(or 0)"
         end
       end
       
@@ -659,7 +681,7 @@ module Net # :nodoc:
         if (0..65535).include? val
           @qdCount = val
         else
-          raise HeaderWrongCount, "Wrong number of count (#{val}), must be 0-65535"
+          raise WrongCountError, "Wrong number of count (#{val}), must be 0-65535"
         end
       end
 
@@ -669,7 +691,7 @@ module Net # :nodoc:
         if (0..65535).include? val
           @anCount = val
         else
-          raise HeaderWrongCount, "Wrong number of count (#{val}), must be 0-65535"
+          raise WrongCountError, "Wrong number of count (#{val}), must be 0-65535"
         end
       end
 
@@ -679,7 +701,7 @@ module Net # :nodoc:
         if (0..65535).include? val
           @nsCount = val
         else
-          raise HeaderWrongCount, "Wrong number of count (#{val}), must be 0-65535"
+          raise WrongCountError, "Wrong number of count (#{val}), must be 0-65535"
         end
       end
 
@@ -689,7 +711,7 @@ module Net # :nodoc:
         if (0..65535).include? val
           @arCount = val
         else
-          raise HeaderWrongCount, "Wrong number of count (#{val}), must be 0-65535"
+          raise WrongCountError, "Wrong number of count: `#{val}' must be 0-65535"
         end
       end
 
@@ -706,7 +728,7 @@ module Net # :nodoc:
       
       def new_from_binary(str)
         unless str.size == Net::DNS::HFIXEDSZ
-          raise HeaderArgumentError, "Header binary data has wrong size: #{str.size} bytes"
+          raise ArgumentError, "Header binary data has wrong size: `#{str.size}' bytes"
         end
         arr = str.unpack("n C2 n4")
         @id          =  arr[0]
@@ -739,23 +761,7 @@ module Net # :nodoc:
         q
       end
 
-    end # class Header
-
-  end # class DNS
-end # module Net
-
-
-class HeaderArgumentError < ArgumentError # :nodoc: all
-end
-
-class HeaderWrongCount < ArgumentError # :nodoc: all
-end
-
-class HeaderWrongRecursive < ArgumentError # :nodoc: all
-end
-
-class HeaderWrongOpcode < ArgumentError # :nodoc: all
-end
+    end
 
-class HeaderDuplicateID < ArgumentError # :nodoc: all
-end
+  end
+end