net-tnsping 1.3.1 → 1.3.2

data/CHANGES

@@ -1,3 +1,17 @@
+== 1.3.2 - 1-Mar-2011
+* Case is now ignored for the database name when searching through the
+  tnsnames.ora file.
+* Removed explicit timeout accessor. It's already inherited.
+* Fixed the driver accessor. It was not being set in the constructor.
+* Removed a useless call to tns_admin in the constructor.
+* Flip-flopped the db and database accessor and alias.
+* Refactored tests to use declarative syntax, added some tests, and
+  did some general refactoring. Also, the default database name is
+  set to "XE" (Express Edition). Change as needed.
+* Updated the Rakefile, removing the non-gem installation task, and
+  adding a clean task.
+* Updated the gemspec. The gem build is now handled by a rake task.
+
 == 1.3.1 - 8-Aug-2009
 * Switched test-unit from a runtime dependency to a development dependency.
 * Minor documentation updates.

data/README

@@ -1,27 +1,19 @@
 == Description
-   This package emulates the Oracle tnsping utility.
+   The net-tnsping library emulates the Oracle tnsping utility. It pings
+   both the listener and the datasource.
 
 == Prerequisites
-   Ruby 1.8.0 or later
-   dbi
-   net-ping 1.0.0 or later
-   Any of the Oracle database drivers (oracle, oci8, ruby9i, etc)
+   * dbi
+   * net-ping
+   * Any of the Oracle database drivers (oracle, oci8, ruby9i, etc)
    
 == Installation
+   gem install net-tnsping
 
-=== Manual Installation
-   rake test (optional)
-   rake install
-   
-=== Gem Installation
-   rake test (optional)
-   ruby net-tnsping.gemspec
-   gem install net-tnsping-<version>.gem
-	
 === Test Note
    You may want to manually tweak one instance variable (@@database) in the
    test suite in order to get a more robust set of test results. Set it to
-   a known database name.
+   a known database name. By default it uses "XE" (Express Edition).
 
 == Synopsis
    require "net/tnsping"
@@ -30,14 +22,14 @@
    t = Ping::TNS.new("my_db")
 
    if t.ping?
-      puts "Database appears to be up and running"
+     puts "Database appears to be up and running"
    else
-      puts "There was a problem: " + t.exception
+     puts "There was a problem: " + t.exception
    end
 
 == Constants
 VERSION
-   The version number of this package, returned as a String.
+   The version number of this library, returned as a String.
 
 == Class Methods
 Ping::TNS.new(db, driver="OCI8", host=nil, port=1521, timeout=5)   
@@ -165,7 +157,7 @@ Ping::TNS#tns_file=(path)
    more reliable solution.
 
 == Known Bugs
-   None that I'm aware of.  Please log any bug reports on the project page
+   None that I'm aware of. Please log any bug reports on the project page
    at http://www.rubyforge.org/projects/shards
 
 == Acknowledgements
@@ -173,7 +165,7 @@ Ping::TNS#tns_file=(path)
    with some questions I had.
 
 == Copyright
-   (C) 2003-2009 Daniel J. Berger
+   (C) 2003-2011 Daniel J. Berger
    All rights reserved.
 	
 == Warranty
@@ -186,5 +178,3 @@ Ping::TNS#tns_file=(path)
 
 == Author
    Daniel J. Berger
-   djberg96 at nospam at gmail dot com
-   imperator on IRC (irc.freenode.net)

data/Rakefile

@@ -1,24 +1,31 @@
-require 'rake'
-require 'rake/testtask'
-
-desc "Install the net-tnsping library (non-gem)"
-task :install do
-   dest = File.join(Config::CONFIG['sitelibdir'], 'net')
-   Dir.mkdir(dest) unless File.exists? dest
-   cp 'lib/net/tnsping.rb', dest, :verbose => true
-end
-
-desc "Install the net-tnsping library as a gem"
-task :install_gem do
-   ruby 'net-tnsping.gemspec'
-   file = Dir["*.gem"].first
-   sh "gem install #{file}"
-end
-
-desc "Run the example program"
-task :example do |dsn|
-   ruby "-Ilib examples/example_tnsping.rb #{dsn}"
-
-Rake::TestTask.new do |t|
-   t.warning = true
-end
+require 'rake'
+require 'rake/clean'
+require 'rake/testtask'
+
+CLEAN.include("**/*.gem", "**/*.rbc", "**/*.log")
+
+namespace :gem do
+  desc "Create the net-tnsping gem"
+  task :create => [:clean] do
+    spec = eval(IO.read('net-tnsping.gemspec'))
+    Gem::Builder.new(spec).build
+  end
+
+  desc "Install the net-tnsping gem"
+  task :install => [:create] do
+    file = Dir['*.gem'].first
+    sh "gem install #{file}"
+  end
+end
+
+desc "Run the example program"
+task :example do |dsn|
+  ruby "-Ilib examples/example_tnsping.rb #{dsn}"
+end
+
+Rake::TestTask.new do |t|
+  t.warning = true
+  t.verbose = true
+end
+
+task :default => :test

data/lib/net/tnsping.rb

@@ -4,243 +4,251 @@ require 'net/ping'
 # The Net module serves as a namespace only.
 module Net
 
-   # The Ping::TNS class encapsulates the information and behavior of tns ping.
-   class Ping::TNS < Ping::TCP
-
-      # The error class typically raised if any of the Ping::TNS methods fail.
-      class Error < StandardError; end
-
-      # The version of the net-tnsping library.
-      VERSION = '1.3.1'
-
-      # Database name.
-      attr_accessor :db
-
-      # Database source name.
-      attr_accessor :dsn
-
-      # The full path to the tnsnames.ora file.
-      attr_accessor :tns_file
-
-      # The name of the host the database sits on.
-      attr_accessor :host
-
-      # The toplevel tns admin path.
-      attr_accessor :tns_admin
-
-      # The value of your ORACLE_HOME or ORA_HOME environment variable.
-      attr_accessor :ora_home
-
-      # The name of the oracle driver to use for connections. Defaults to OCI8.
-      attr_accessor :driver
-
-      # The timeout value for connection attempts. The default is 5 seconds.
-      attr_accessor :timeout
-
-      # A list of hosts for the given database name.
-      attr_reader :hosts
-
-      # A list of ports for the given database name
-      attr_reader :ports
-
-      # The port used when attempting a connection. The default is 1521.
-      attr_reader :port
-
-      # Creates and returns a new Ping::TNS object. If the db specified cannot
-      # be found in the tnsnames.ora file, then a Ping::TNS::Error is raised.
-      #
-      def initialize(db, driver='OCI8', host=nil, port=1521, timeout=5)
-         @db        = db
-         @dsn       = "dbi:#{driver}:" << db
-         @host      = host
-         @timeout   = timeout
-         @port      = port
-         @tns_admin = tns_admin
-         @ports     = []  # There can be more than one host/port
-         @hosts     = []  # for each dsn.  Try them in order.
-         @sid       = nil
-
-         @tns_admin = ENV['TNS_ADMIN']
-         @ora_home  = ENV['ORACLE_HOME'] || ENV['ORA_HOME']
-
-         if @tns_admin
-            @tns_file = File.join(@tns_admin, 'tnsnames.ora')
-         elsif @ora_home
-            @tns_file = File.join(@ora_home, 'network', 'admin', 'tnsnames.ora')
-         else
-            @tns_file = File.join((ENV['HOME'] || ENV['USERPROFILE']), 'tnsnames.ora')
-         end
-
-         yield self if block_given?
-
-         # If the host is not specified, look for it in the tnsnames.ora file
-         if host.nil?
-            err_msg = "tnsnames.ora file could not be found"
-            raise Error, err_msg unless File.exists?(@tns_file)
-            parse_tns_file
-         else
-            @hosts.push(host)
-            @ports.push(port)
-         end
-      end
+  # The Ping::TNS class encapsulates the information and behavior of tns ping.
+  class Ping::TNS < Ping::TCP
+
+    # The error class typically raised if any of the Ping::TNS methods fail.
+    class Error < StandardError; end
+
+    # The version of the net-tnsping library.
+    VERSION = '1.3.2'
+
+    # Database name.
+    attr_accessor :database
+
+    # Database source name.
+    attr_accessor :dsn
+
+    # The full path to the tnsnames.ora file.
+    attr_accessor :tns_file
+
+    # The name of the host the database sits on.
+    attr_accessor :host
+
+    # The toplevel tns admin path.
+    attr_accessor :tns_admin
+
+    # The value of your ORACLE_HOME or ORA_HOME environment variable.
+    attr_accessor :ora_home
 
-      # Sets the port that the Ping::TNS#ping_listener? method will use.  If
-      # this is set, then a ping will only be attempted on this port,
-      # regardless of what is in the tnsnames.ora file.
-      #
-      def port=(num)
-         @port = num
-         @ports = [num]
+    # The name of the oracle driver to use for connections. Defaults to OCI8.
+    attr_accessor :driver
+
+    # A list of hosts for the given database name.
+    attr_reader :hosts
+
+    # A list of ports for the given database name
+    attr_reader :ports
+
+    # The port used when attempting a connection. The default is 1521.
+    attr_reader :port
+
+    # Creates and returns a new Ping::TNS object. If the db specified cannot
+    # be found in the tnsnames.ora file, then a Ping::TNS::Error is raised.
+    #
+    def initialize(database, driver='OCI8', host=nil, port=1521, timeout=5)
+      @database  = database
+      @dsn       = "dbi:#{driver}:" << database
+      @host      = host
+      @timeout   = timeout
+      @port      = port
+      @driver    = driver
+      @ports     = []  # There can be more than one host/port
+      @hosts     = []  # for each dsn.  Try them in order.
+      @sid       = nil
+
+      @tns_admin = ENV['TNS_ADMIN']
+      @ora_home  = ENV['ORACLE_HOME'] || ENV['ORA_HOME']
+
+      if @tns_admin
+        @tns_file = File.join(@tns_admin, 'tnsnames.ora')
+      elsif @ora_home
+        @tns_file = File.join(@ora_home, 'network', 'admin', 'tnsnames.ora')
+      else
+        home = ENV['HOME'] || ENV['USERPROFILE']
+        @tns_file = File.join(home, 'tnsnames.ora')
       end
 
-      # Performs a TCP ping on the listener. The host and port are determined from
-      # your tnsnames.ora file. If more than one host and/or port are found in the
-      # tnsnames.ora file, then each will be tried.  So long as at least one of
-      # them connects successfully, true is returned. 
-      #
-      # If you specify a host and port in the constructor, then the attempt will
-      # only be made against that host on the given port.
-      #--
-      # Try each host/port listed for a given entry.  Return a true result if
-      # any one of them succeeds and break out of the loop.
-      #
-      def ping?
-         if @hosts.empty?
-            raise Error, "No hosts found"
-         end
-
-         # Use 1521 if no ports were found in the tnsnames.ora file.
-         if @ports.empty?
-            @ports.push(@port)
-         end
-
-         # If the host is provided, only ping that host
-         if @host
-            0.upto(@ports.length-1){ |n|
-               @port = @ports[n]
-               return super
-            }
-         else
-            0.upto(@ports.length-1){ |n|
-               @port = @ports[n]
-               @host = @hosts[n]
-               return super
-            }
-         end
+      yield self if block_given?
+
+      # If the host is not specified, look for it in the tnsnames.ora file
+      if host.nil?
+        err_msg = "tnsnames.ora file could not be found"
+        raise Error, err_msg unless File.exists?(@tns_file)
+        parse_tns_file
+      else
+        @hosts.push(host)
+        @ports.push(port)
+      end
+    end
+
+    # Sets the port that the Ping::TNS#ping_listener? method will use. If
+    # this is set, then a ping will only be attempted on this port
+    # regardless of what is in the tnsnames.ora file.
+    #
+    def port=(num)
+      @port = num
+      @ports = [num]
+    end
+
+    # Performs a TCP ping on the listener. The host and port are determined from
+    # your tnsnames.ora file. If more than one host and/or port are found in the
+    # tnsnames.ora file, then each will be tried.  So long as at least one of
+    # them connects successfully, true is returned.
+    #
+    # If you specify a host and port in the constructor, then the attempt will
+    # only be made against that host on the given port.
+    #
+    # Remember, this only pings the listener. If you want to ping the listener
+    # and the database, use the ping_all? method.
+    #--
+    # Try each host/port listed for a given entry.  Return a true result if
+    # any one of them succeeds and break out of the loop.
+    #
+    def ping?
+      if @hosts.empty?
+        raise Error, "No hosts found"
       end
 
-      # Attempts to make a connection using a bogus login and password via the
-      # DBI class.  If an ORA-01017 Oracle error is returned, that means the
-      # database is up and running and true is returned.
-      #
-      # Note that each of the arguments for this method use the defaults
-      # passed to the constructor (or have a default otherwise set).  You
-      # generally should not pass any arguments to this method.
-      # In the event that this method fails, false is returned and the error
-      # can be viewed via Ping::TNS#exception.
-      #--
-      # I have intentionally set the user and password to something random in
-      # order to avoid the possibility of accidentally guessing them.  In
-      # case of cosmic coincidence, set them yourself.
-      #
-      def ping_database?(dsn=@dsn, timeout=@timeout, user=@sid, passwd=Time.now.to_s)
-         re   = /ORA-01017/
-         dbh  = nil
-         user ||= Time.now.to_s
-         rv = false
-         begin
-            Timeout.timeout(timeout){
-               dbh = DBI.connect(dsn,user,passwd)
-            }
-         rescue DBI::DatabaseError => e
-            if re.match(e.to_s)
-               rv = true
-            else
-               @exception = e
-            end
-         rescue Timeout::Error, StandardError => e
-            @exception = e
-         ensure
-            if dbh
-               dbh.disconnect if dbh.connected?
-            end
-         end
-         rv
+      # Use 1521 if no ports were found in the tnsnames.ora file.
+      if @ports.empty?
+        @ports.push(@port)
       end
 
-      # Simple wrapper for ping_listener? + ping_database?
-      #
-      def ping_all?
-         return false unless self.ping_listener?
-         return false unless self.ping_database?
-         true
+      # If the host is provided, only ping that host
+      if @host
+        0.upto(@ports.length-1){ |n|
+          @port = @ports[n]
+          return super
+        }
+      else
+        0.upto(@ports.length-1){ |n|
+          @port = @ports[n]
+          @host = @hosts[n]
+          return super
+        }
+      end
+    end
+
+    # Attempts to make a connection using a bogus login and password via the
+    # DBI class.  If an ORA-01017 Oracle error is returned, that means the
+    # database is up and running and true is returned.
+    #
+    # Note that each of the arguments for this method use the defaults
+    # passed to the constructor (or have a default otherwise set).  You
+    # generally should not pass any arguments to this method.
+    # In the event that this method fails, false is returned and the error
+    # can be viewed via Ping::TNS#exception.
+    #--
+    # I have intentionally set the user and password to something random in
+    # order to avoid the possibility of accidentally guessing them.  In
+    # case of cosmic coincidence, set them yourself.
+    #
+    def ping_database?(dsn=@dsn, timeout=@timeout, user=@sid, passwd=Time.now.to_s)
+      re   = /ORA-01017/
+      dbh  = nil
+      user ||= Time.now.to_s
+      rv = false
+
+      begin
+        Timeout.timeout(timeout){
+          dbh = DBI.connect(dsn,user,passwd)
+        }
+      rescue DBI::DatabaseError => e
+        if re.match(e.to_s)
+          rv = true
+        else
+          @exception = e
+        end
+      rescue Timeout::Error, StandardError => e
+        @exception = e
+      ensure
+        if dbh
+          dbh.disconnect if dbh.connected?
+        end
       end
 
-      private
-
-      # parse_tns_file
-      #
-      # Search for the dsn entry within the tnsnames.ora file and get the host
-      # and port information.  Private method.
-      #
-      def parse_tns_file(file=@tns_file, db=@db)
-         re_blank      = /^$/
-         re_comment    = /^#/
-         re_tns_sentry = /^#{db}.*?=/                 # specific entry
-         re_tns_gentry = /^\w.*?=/                    # generic entry
-         re_tns_pair   = /\w+\s*\=\s*[\w\.]+/         # used to parse key=val
-         re_keys       = /\bhost\b|\bport\b|\bsid\b/i 
-
-         data_string = ""
-         found       = false
-
-         IO.foreach(file){ |line|
-            next if re_blank.match(line)
-            next if re_comment.match(line)
-            line.chomp!
-
-            # Skip over lines until an entry for the db is found.
-            match = re_tns_sentry.match(line)
-            if match
-               found = true
-               data_string << match.post_match # slurp the rest of the line
-               next
-            end
-
-            # Once found, slurp the lines into a variable until the next
-            # db entry is encountered.
-            if found
-               break if re_tns_gentry.match(line)
-               line.strip!
-               data_string << line
-            end
-         }
-
-         unless found
-            raise Error, "unable to find '#{db}' in #{file}"
-         end
-
-         # Break each 'key = value' line into its parts
-         data_string.scan(re_tns_pair).each{ |pair|
-            key, value = pair.split("=")
-            key.strip!
-            value.strip!
-            next unless re_keys.match(key)
-            case key.downcase
-               when 'host'
-                  @hosts.push(value)
-               when 'port'
-                  @ports.push(value.to_i)
-               when 'sid'
-                  @sid = value
-            end
-         }
+      rv
+    end
+
+    # Simple wrapper for ping_listener? + ping_database?
+    #
+    def ping_all?
+      return false unless self.ping_listener?
+      return false unless self.ping_database?
+      true
+    end
+
+    private
+
+    # parse_tns_file
+    #
+    # Search for the dsn entry within the tnsnames.ora file and get the host
+    # and port information.  Private method.
+    #
+    def parse_tns_file(file=@tns_file, db=@database)
+      re_blank      = /^$/
+      re_comment    = /^#/
+      re_tns_sentry = /^#{db}.*?=/i                # specific entry
+      re_tns_gentry = /^\w.*?=/                    # generic entry
+      re_tns_pair   = /\w+\s*\=\s*[\w\.]+/         # used to parse key=val
+      re_keys       = /\bhost\b|\bport\b|\bsid\b/i
+
+      data_string = ""
+      found       = false
+
+      IO.foreach(file){ |line|
+        next if re_blank.match(line)
+        next if re_comment.match(line)
+        line.chomp!
+
+        # Skip over lines until an entry for the db is found.
+        match = re_tns_sentry.match(line)
+
+        if match
+          found = true
+          data_string << match.post_match # slurp the rest of the line
+          next
+        end
+
+        # Once found, slurp the lines into a variable until the next
+        # db entry is encountered.
+        if found
+          break if re_tns_gentry.match(line)
+          line.strip!
+          data_string << line
+        end
+      }
+
+      unless found
+        raise Error, "unable to find '#{db}' in #{file}"
       end
 
-      alias database db
-      alias database_source_name dsn
-      alias ping_listener? ping?
-      alias oracle_home ora_home
-      alias oracle_home= ora_home=
-   end
+      # Break each 'key = value' line into its parts
+      data_string.scan(re_tns_pair).each{ |pair|
+        key, value = pair.split("=")
+        key.strip!
+        value.strip!
+
+        next unless re_keys.match(key)
+
+        case key.downcase
+          when 'host'
+            @hosts.push(value)
+          when 'port'
+            @ports.push(value.to_i)
+          when 'sid'
+            @sid = value
+        end
+      }
+    end
+
+    # Aliases
+
+    alias db database
+    alias database_source_name dsn
+    alias ping_listener? ping?
+    alias oracle_home ora_home
+    alias oracle_home= ora_home=
+  end
 end

data/net-tnsping.gemspec

@@ -1,30 +1,27 @@
 require 'rubygems'
 
-spec = Gem::Specification.new do |gem|
-   gem.name      = 'net-tnsping'
-   gem.version   = '1.3.1'
-   gem.license   = 'Artistic 2.0'
-   gem.author    = 'Daniel J. Berger'
-   gem.email     = 'djberg96@gmail.com'
-   gem.homepage  = 'http://www.rubyforge.org/projects/shards'
-   gem.platform  = Gem::Platform::RUBY
-   gem.summary   = 'A library for pinging Oracle listeners and databases'
-   gem.test_file = 'test/test_net_tnsping.rb'
-   gem.has_rdoc  = true
-   gem.files     = Dir['**/*'].reject{ |f| f.include?('CVS') }
+Gem::Specification.new do |spec|
+  spec.name      = 'net-tnsping'
+  spec.version   = '1.3.2'
+  spec.license   = 'Artistic 2.0'
+  spec.author    = 'Daniel J. Berger'
+  spec.email     = 'djberg96@gmail.com'
+  spec.homepage  = 'http://www.rubyforge.org/projects/shards'
+  spec.summary   = 'A library for pinging Oracle listeners and databases'
+  spec.test_file = 'test/test_net_tnsping.rb'
+  spec.has_rdoc  = true
+  spec.files     = Dir['**/*'].reject{ |f| f.include?('git') }
 
-   gem.rubyforge_project = 'shards'
-   gem.extra_rdoc_files  = ['CHANGES', 'MANIFEST', 'README']
+  spec.rubyforge_project = 'shards'
+  spec.extra_rdoc_files  = ['CHANGES', 'MANIFEST', 'README']
 
-   gem.add_dependency('net-ping', '>= 1.0.0')
-   gem.add_development_dependency('test-unit', '>= 2.0.3')
+  spec.add_dependency('net-ping', '>= 1.4.0')
+  spec.add_development_dependency('test-unit', '>= 2.1.2')
 
-   gem.description = <<-EOF
-      The net-tnsping library provides a way to ping Oracle databases and
-      ensure that they're up and running. Unlike the tnsping command line
-      program, which only pings the listener, the net-tnsping library
-      pings both the listener and the database itself.
-   EOF
+  spec.description = <<-EOF
+    The net-tnsping library provides a way to ping Oracle databases and
+    ensure that they're up and running. Unlike the tnsping command line
+    program, which only pings the listener, the net-tnsping library
+    pings both the listener and the database itself.
+  EOF
 end
-
-Gem::Builder.new(spec).build

data/test/test_net_tnsping.rb

@@ -9,150 +9,205 @@ gem 'test-unit'
 
 require 'test/unit'
 require 'net/tnsping'
-include Net
 
 class TC_TNS_Ping < Test::Unit::TestCase
-   def self.startup
-      @@database = 'change_me' # Change to a valid host name
-      @@hostname = Socket.gethostname
-   end
-
-   def setup
-      if @@database == 'change_me'
-         @tnsp = Ping::TNS.new(@@database, 'OCI8', @@hostname)
-      else
-         @tnsp = Ping::TNS.new(@@database)
-      end
-   end
-   
-   def test_version
-      assert_equal('1.3.1', Ping::TNS::VERSION)
-   end
-
-   def test_db_get
-      assert_respond_to(@tnsp, :db)
-      assert_nothing_raised{ @tnsp.db }
-      assert_equal(@@database, @tnsp.db)
-   end
-
-   def test_db_set
-      assert_respond_to(@tnsp, :db=)
-      assert_nothing_raised{ @tnsp.db = 'fubar' }
-      assert_equal('fubar', @tnsp.db)
-   end
-
-   def test_dsn_get
-      assert_respond_to(@tnsp, :dsn)
-      assert_nothing_raised{ @tnsp.dsn }
-      assert_equal("dbi:OCI8:#{@@database}", @tnsp.dsn)
-   end
-
-   def test_dsn_set
-      assert_respond_to(@tnsp, :dsn=)
-      assert_nothing_raised{ @tnsp.dsn = 'dbi:OCI8:fubar' }
-      assert_equal('dbi:OCI8:fubar', @tnsp.dsn)
-   end
-
-   def test_port_get
-      assert_respond_to(@tnsp, :port)
-      assert_equal(1521, @tnsp.port)
-   end
-
-   def test_port_set
-      assert_respond_to(@tnsp, :port=)
-      assert_nothing_raised{ @tnsp.port = 1555 }
-      assert_equal(1555, @tnsp.port)
-   end
-
-   def test_ports
-      assert_respond_to(@tnsp, :ports)
-      assert_kind_of(Array, @tnsp.ports)
-      assert(@tnsp.ports.length > 0)
-   end
-
-   def test_host_get
-      assert_respond_to(@tnsp, :host)
-      assert_equal(@@hostname, @tnsp.host)
-   end
-
-   def test_host_set
-      assert_respond_to(@tnsp, :host=)
-      assert_nothing_raised{ @tnsp.host = 'fubar' }
-      assert_equal('fubar', @tnsp.host)
-   end
-
-   def tests_hosts
-      assert_respond_to(@tnsp, :hosts)
-      assert_kind_of(Array, @tnsp.hosts)
-      assert(@tnsp.hosts.length > 0)
-   end
-
-   def test_tns_file_get
-      assert_respond_to(@tnsp, :tns_file)
-      omit_if(@@database == 'change_me', 'tns_file test skipped without real database')
-      assert_true(File.exist?(@tnsp.tns_file))
-   end
-
-   def test_tns_file_set
-      assert_respond_to(@tnsp, :tns_file=)
-      assert_nothing_raised{ @tnsp.tns_file = 'fu_tnsnames.ora' }
-      assert_equal('fu_tnsnames.ora', @tnsp.tns_file)
-   end
-
-   def test_oracle_home_get
-      assert_respond_to(@tnsp, :oracle_home)
-      assert_kind_of([String, NilClass], @tnsp.oracle_home)
-   end
-
-   def test_oracle_home_set
-      assert_respond_to(@tnsp, :oracle_home=)
-      assert_nothing_raised{ @tnsp.oracle_home = ENV['HOME'] }
-      assert_equal(ENV['HOME'], @tnsp.oracle_home)
-   end
-
-   def test_tns_admin_get
-      assert_respond_to(@tnsp, :tns_admin)
-      assert_kind_of([String, NilClass], @tnsp.tns_admin)
-   end
-
-   def test_tns_admin_set
-      assert_respond_to(@tnsp, :tns_admin=)
-      assert_nothing_raised{ @tnsp.tns_admin = ENV['HOME'] }
-      assert_equal(ENV['HOME'], @tnsp.tns_admin)
-   end
-
-   def test_ping_listener
-      assert_respond_to(@tnsp, :ping?)
-      assert_nothing_raised{ @tnsp.ping? }
-      omit_if(@@database == 'change_me', 'ping listener test skipped without real database')
-      assert_equal(true, @tnsp.ping?)
-   end
-
-   def test_ping_database
-      assert_respond_to(@tnsp, :ping_database?)
-      assert_nothing_raised{ @tnsp.ping_database? }
-      omit_if(@@database == 'change_me', 'ping database test skipped without real database')
-      assert_equal(true, @tnsp.ping_database?)
-   end
-
-   def test_ping_all
-      assert_respond_to(@tnsp, :ping_all?)
-      assert_nothing_raised{ @tnsp.ping_all? }
-      omit_if(@@database == 'change_me', 'ping all test skipped without real database')
-      assert_equal(true, @tnsp.ping_all?)
-   end
-
-   def test_bad_db
-      assert_raises(Ping::TNS::Error){ Ping::TNS.new('bogus_db') }
-      @tnsp.port = 9999
-      assert_equal(false, @tnsp.ping_listener?)
-   end
-
-   def teardown
-      @tnsp = nil
-   end
-
-   def self.shutdown
-      @@database = nil
-   end
+  def self.startup
+    @@database = 'xe'
+    @@username = 'hr'
+    @@password = 'hr'
+    @@hostname = Socket.gethostname
+  end
+
+  def setup
+    @tnsp = Net::Ping::TNS.new(@@database)
+  end
+
+  test "version number is expected value" do
+    assert_equal('1.3.2', Net::Ping::TNS::VERSION)
+  end
+
+  test "database reader basic functionality" do
+    assert_respond_to(@tnsp, :database)
+    assert_nothing_raised{ @tnsp.database }
+    assert_equal(@@database, @tnsp.database)
+  end
+
+  test "db is an alias for database" do
+    assert_respond_to(@tnsp, :db)
+    assert_alias_method(@tnsp, :db, :database)
+  end
+
+  test "database writer basic functionality" do
+    assert_respond_to(@tnsp, :database=)
+    assert_nothing_raised{ @tnsp.database = 'fubar' }
+    assert_equal('fubar', @tnsp.database)
+  end
+
+  test "dsn reader basic functionality" do
+    assert_respond_to(@tnsp, :dsn)
+    assert_nothing_raised{ @tnsp.dsn }
+    assert_equal("dbi:OCI8:#{@@database}", @tnsp.dsn)
+  end
+
+  test "database_source_name is an alias for dsn" do
+    assert_respond_to(@tnsp, :database_source_name)
+    assert_alias_method(@tnsp, :database_source_name, :dsn)
+  end
+
+  test "dsn writer basic functionality" do
+    assert_respond_to(@tnsp, :dsn=)
+    assert_nothing_raised{ @tnsp.dsn = 'dbi:OCI8:fubar' }
+    assert_equal('dbi:OCI8:fubar', @tnsp.dsn)
+  end
+
+  test "port reader basic functionality" do
+    assert_respond_to(@tnsp, :port)
+    assert_equal(1521, @tnsp.port)
+  end
+
+  test "port writer basic functionality" do
+    assert_respond_to(@tnsp, :port=)
+    assert_nothing_raised{ @tnsp.port = 1555 }
+    assert_equal(1555, @tnsp.port)
+  end
+
+  test "ports reader basic functionality" do
+    assert_respond_to(@tnsp, :ports)
+    assert_kind_of(Array, @tnsp.ports)
+    assert(@tnsp.ports.length > 0)
+  end
+
+  test "host reader basic functionality" do
+    assert_respond_to(@tnsp, :host)
+    assert_nil(@tnsp.host)
+  end
+
+  test "host writer basic functionality" do
+    assert_respond_to(@tnsp, :host=)
+    assert_nothing_raised{ @tnsp.host = 'fubar' }
+    assert_equal('fubar', @tnsp.host)
+  end
+
+  test "hosts reader basic functionality" do
+    assert_respond_to(@tnsp, :hosts)
+    assert_kind_of(Array, @tnsp.hosts)
+    assert(@tnsp.hosts.length > 0)
+  end
+
+  test "there is no hosts writer method" do
+    assert_raise(NoMethodError){ @tnsp.hosts = %w[foo bar] }
+  end
+
+  test "tns_file reader basic functionality" do
+    assert_respond_to(@tnsp, :tns_file)
+    assert_kind_of(String, @tnsp.tns_file)
+    assert_true(File.exist?(@tnsp.tns_file))
+  end
+
+  test "tns_file writer basic functionality" do
+    assert_respond_to(@tnsp, :tns_file=)
+    assert_nothing_raised{ @tnsp.tns_file = 'fu_tnsnames.ora' }
+    assert_equal('fu_tnsnames.ora', @tnsp.tns_file)
+  end
+
+  test "oracle_home reader basic functionality" do
+    assert_respond_to(@tnsp, :oracle_home)
+    assert_kind_of([String, NilClass], @tnsp.oracle_home)
+  end
+
+  test "ora_home is an alias for oracle_home" do
+    assert_respond_to(@tnsp, :ora_home)
+    assert_alias_method(@tnsp, :ora_home, :oracle_home)
+  end
+
+  test "oracle_home writer basic functionality" do
+    assert_respond_to(@tnsp, :oracle_home=)
+    assert_nothing_raised{ @tnsp.oracle_home = ENV['HOME'] }
+    assert_equal(ENV['HOME'], @tnsp.oracle_home)
+  end
+
+  test "ora_home= is an alias for oracle_home=" do
+    assert_respond_to(@tnsp, :ora_home=)
+    assert_alias_method(@tnsp, :ora_home=, :oracle_home=)
+  end
+
+  test "tns_admin reader basic functionality" do
+    assert_respond_to(@tnsp, :tns_admin)
+    assert_kind_of([String, NilClass], @tnsp.tns_admin)
+  end
+
+  test "tns_admin writer basic functionality" do
+    assert_respond_to(@tnsp, :tns_admin=)
+    assert_nothing_raised{ @tnsp.tns_admin = ENV['HOME'] }
+    assert_equal(ENV['HOME'], @tnsp.tns_admin)
+  end
+
+  test "timeout reader basic functionality" do
+    assert_respond_to(@tnsp, :timeout)
+    assert_kind_of(Fixnum, @tnsp.timeout)
+  end
+
+  test "timeout writer basic functionality" do
+    assert_respond_to(@tnsp, :timeout=)
+    assert_nothing_raised{ @tnsp.timeout = 10 }
+    assert_equal(10, @tnsp.timeout)
+  end
+
+  test "driver reader basic functionality" do
+    assert_respond_to(@tnsp, :driver)
+    assert_kind_of(String, @tnsp.driver)
+  end
+
+  test "driver writer basic functionality" do
+    assert_respond_to(@tnsp, :driver=)
+    assert_nothing_raised{ @tnsp.driver = "oracle" }
+    assert_equal("oracle", @tnsp.driver)
+  end
+
+  test "ping_listener? basic functionality" do
+    assert_respond_to(@tnsp, :ping_listener?)
+    assert_nothing_raised{ @tnsp.ping_listener? }
+  end
+
+  test "ping_listener? returns a boolean value" do
+    assert_boolean(@tnsp.ping_listener?)
+  end
+
+  test "ping? is an alias for ping_listener?" do
+  end
+
+  test "ping_database? basic functionality" do
+    assert_respond_to(@tnsp, :ping_database?)
+    assert_nothing_raised{ @tnsp.ping_database? }
+  end
+
+  test "ping_database? returns a boolean value" do
+    assert_boolean(@tnsp.ping_database?)
+  end
+
+  test "ping_all? basic functionality" do
+    assert_respond_to(@tnsp, :ping_all?)
+    assert_nothing_raised{ @tnsp.ping_all? }
+  end
+
+  test "ping_all? returns a boolean value" do
+    assert_boolean(@tnsp.ping_all?)
+  end
+
+  test "ping fails against a bogus database" do
+    assert_raises(Net::Ping::TNS::Error){ Net::Ping::TNS.new('bogus_db') }
+    @tnsp.port = 9999
+    assert_false(@tnsp.ping_listener?)
+  end
+
+  def teardown
+    @tnsp = nil
+  end
+
+  def self.shutdown
+    @@username = nil
+    @@password = nil
+    @@database = nil
+    @@hostname = nil
+  end
 end

metadata

@@ -1,7 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: net-tnsping
 version: !ruby/object:Gem::Version 
-  version: 1.3.1
+  hash: 31
+  prerelease: false
+  segments: 
+  - 1
+  - 3
+  - 2
+  version: 1.3.2
 platform: ruby
 authors: 
 - Daniel J. Berger
@@ -9,30 +15,42 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-08-08 00:00:00 -06:00
+date: 2011-03-01 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: net-ping
-  type: :runtime
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 1.0.0
-    version: 
+        hash: 7
+        segments: 
+        - 1
+        - 4
+        - 0
+        version: 1.4.0
+  type: :runtime
+  version_requirements: *id001
 - !ruby/object:Gem::Dependency 
   name: test-unit
-  type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 2.0.3
-    version: 
-description: "      The net-tnsping library provides a way to ping Oracle databases and\n      ensure that they're up and running. Unlike the tnsping command line\n      program, which only pings the listener, the net-tnsping library\n      pings both the listener and the database itself.\n"
+        hash: 15
+        segments: 
+        - 2
+        - 1
+        - 2
+        version: 2.1.2
+  type: :development
+  version_requirements: *id002
+description: "    The net-tnsping library provides a way to ping Oracle databases and\n    ensure that they're up and running. Unlike the tnsping command line\n    program, which only pings the listener, the net-tnsping library\n    pings both the listener and the database itself.\n"
 email: djberg96@gmail.com
 executables: []
 
@@ -43,14 +61,14 @@ extra_rdoc_files:
 - MANIFEST
 - README
 files: 
-- CHANGES
-- examples/example_tnsping.rb
-- lib/net/tnsping.rb
-- MANIFEST
-- net-tnsping.gemspec
 - Rakefile
 - README
+- net-tnsping.gemspec
+- lib/net/tnsping.rb
+- CHANGES
+- examples/example_tnsping.rb
 - test/test_net_tnsping.rb
+- MANIFEST
 has_rdoc: true
 homepage: http://www.rubyforge.org/projects/shards
 licenses: 
@@ -61,21 +79,27 @@ rdoc_options: []
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
       version: "0"
-  version: 
 required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
       version: "0"
-  version: 
 requirements: []
 
 rubyforge_project: shards
-rubygems_version: 1.3.5
+rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
 summary: A library for pinging Oracle listeners and databases