sys-host 0.6.2-x86-mingw32

data/CHANGES

@@ -0,0 +1,126 @@
+== 0.6.2 - 20-Mar-2010
+* Changed license to Artistic 2.0.
+* The Host.host_id method has been modified to return a hex value on MS
+  Windows in order to be consistent with other platforms.
+* Some internal directory layout changes and corresponding changes to the
+  Rakefile.
+* Additional Rakefile tasks that remove the need for some code that was
+  previously inlined into the gemspec directly.
+* Updated the gemspec, including an updated description, the addition of a
+  license, and changing test-unit to a development dependency.
+
+== 0.6.1 - 18-Nov-2008
+* Added the host_id method for Windows, which just returns the MAC address.
+* Fixed an issue in the Host.ip_addr method for MS Windows where multiple ip
+  addresses might not be handled properly. Thanks go to Murmansk Manny for the
+  spot and patch.
+* Updated the gemspec to include all .c and .h files now so that it should
+  successfully build and install on all Unix platforms.
+* Rakefile fix for MS Windows for the install task.
+* The test file is now "test_sys_host.rb".
+
+== 0.6.0 - 8-Jun-2007
+* Now supports OS X!
+* Added the Host.host_id class method.
+* Bug/warning fix for OS X.
+* HostError is now Host::Error.
+* Added a Rakefile, including tasks for installation and testing.
+* Fixed the gemspec (I hope).
+* Lots of internal reorganization, including the removal of the install.rb
+  file. That's handled by the Rakefile.
+
+== 0.5.2 - 27-Jun-2006
+* Added the Host.info method for Linux.
+
+== 0.5.1 - 3-Mar-2006
+* The Host.info method is now supported on Solaris.
+* Moved project to RubyForge.
+* Replaced INSTALL with README.
+* Made documentation rdoc friendly.
+ 
+== 0.5.0 - 3-Jul-2004
+* Replaced Windows C extension with pure Ruby version, using WMI + OLE.
+* Added an additional class method called 'info' that returns a HostInfo
+  struct.  Currently on Windows only.
+* Removed the block form of Host.ip_addr. It now simply returns an Array.
+* Renamed and revamped test suite.
+* Moved test.rb to doc/examples
+* Removed the host.html file.
+* Replaced previous exception classes with a single exception class,
+  HostError, and moved it under the Sys module namespace.
+
+== 0.4.0 - 15-Jun-2003
+* Added MS Windows support
+* Modified extconf.rb file - generic test script now in its own file
+  (test/test.rb) and the dynamic rd2 stuff was removed, in addition to proper
+  handling for MS Windows
+* rd2, txt and html docs now included by default
+* Removed VERSION() class method (use the constant instead)
+* Added a universal constants.h file to store VERSION info, etc, that
+  is common to all source files.
+* Added LICENSE info
+
+== 0.3.4 - 3-Apr-2003
+* Fixed a header include issue for solaris systems that don't
+  define inet_ntop().
+
+== 0.3.3 * 24-Mar-2003
+* If inet_ntop() is not defined, now falls back to inet_ntoa().
+
+== 0.3.2 - 14-Mar-2003
+* Added a VERSION constant
+* Modified extconf.rb script, including a bugfix for solaris
+* Added a test suite (for those with testunit installed)
+* Removed the sys-uname requirement
+* Changelog and Manifest are now CHANGES and MANIFEST, respectively
+* Minor internal layout changes
+* rd2 documentation removed from C source files and put into 'doc'
+  directory
+
+== 0.3.1 - 6-Jan-2003
+* Fix to make code C89 compliant so that older compilers don't choke.
+* Added a VERSION class method
+* Added a copyright notice
+* Moved README into doc/host.txt
+* Minor doc changes
+* Fixed extconf.rb file to include socket lib for Solaris.  This was
+  in 0.2.0 and was mistakenly left out of 0.3.0.
+
+== 0.3.0 - 28-Oct-2002
+* Reentrant (thread-safe) support added for ip_addr() method (for Linux,
+  FreeBSD and Solaris currently).
+* The file layout changed so that each platform has its own source file.
+  This was done because different platforms have different implementations
+  of gethostbyname_r(), if they have them at all.  Some platforms (e.g.
+  FreeBSD) use a different function altogether.
+* The file generic.c is used to create the source if the platform is not
+  currently supported, or if gethostbyname_r() isn't found.
+* The FreeBSD implementation uses getipnodebyname() instead of
+  gethostbyname(), if possible.  According to the man page, it's thread
+  safe.
+* Modifications to the extconf.rb file based on the above changes.
+* Added a default value of 16 for INET_ADDRSTRLEN.
+* Added a README file.
+
+== 0.2.0 - 1-Sep-2002
+* Added HostException and HostAddressException classes.  These are raised
+  in the event the gethostname or gethostbyname call fails, respectively.
+* Removed some unnecessary (and warning-causing) free calls.
+* Added an INSTALL file (installation instructions removed from core doc).
+
+== 0.1.2 - 9-Aug-2002
+* Got the BSD support working properly this time.  Thanks to Sean
+  Chittenden for providing BSD access.
+
+== 0.1.1 - 21-Jun-2002
+* Fixed a bug that would cause the ip_addr to segfault on some
+  operating systems.  Apparently ,trying to free memory on a 
+  null pointer is a bad thing.  Hey, Solaris didn't complain!
+  Thanks go to Han Holl for the spot.
+* On *BSD systems the 'netinet/in.h' file is now included (via
+  the makefile).  Thanks go to Magnus Stahre for the spot and
+  the fix.
+* Changed the version number to be more "ruby compliant"
+
+== 0.01 * 11-Jun-2002
+* First release!

data/MANIFEST

@@ -0,0 +1,17 @@
+* CHANGES
+* MANIFEST
+* README
+* Rakefile
+* sys-host.gemspec
+* doc/host.txt
+* examples/example_sys_host.rb
+* ext/bsd/extconf.rb
+* ext/bsd/sys/host.c
+* ext/generic/extconf.rb
+* ext/generic/sys/host.c
+* ext/linux/extconf.rb
+* ext/linux/sys/host.c
+* ext/sunos/extconf.rb
+* ext/sunos/sys/host.c
+* lib/windows/sys/host.rb
+* test/test_sys_host.rb

data/README

@@ -0,0 +1,26 @@
+= Prerequisites
+   Ruby 1.8.0 or later.
+   Ruby 1.8.2 or later preferred on Windows.
+   
+= Synopsis
+   require 'sys/host'
+   include Sys
+
+   p Host.hostname
+   p Host.ip_addr
+
+   Host.info{ |h|
+      p h
+   }
+
+= Installation
+== Standard (non-gem) installation
+   rake test (optional)
+   rake install
+
+== Gem Installation
+   rake test (optional)
+   rake install_gem
+
+= Documentation
+   See the doc/host.txt file for more information.

data/Rakefile

@@ -0,0 +1,169 @@
+require 'rake'
+require 'rake/testtask'
+require 'rbconfig'
+include Config
+
+desc "Clean the build files for the sys-host source for UNIX systems"
+task :clean do
+  rm_rf('.test-result') if File.exists?('.test-result')
+  rm_rf 'conftest.dSYM' if File.exists?('conftest.dSYM') # OS X
+
+  Dir['*.gem'].each{ |f| File.delete(f) }
+   
+  case Config::CONFIG['host_os']
+    when /bsd|darwin/i
+      dir = 'ext/bsd'
+    when /sunos|solaris/i
+      dir = 'ext/sunos'
+    when /linux/i
+      dir = 'ext/linux'
+    else
+      dir = 'ext/generic'
+  end
+
+  unless Config::CONFIG['host_os'] =~ /win32|mswin|dos|cygwin|mingw/i
+     Dir.chdir(dir) do
+      if Dir['*.o'].length > 0
+        sh 'make distclean'
+        Dir['sys/host.*'].each{ |f| rm(f) if File.extname(f) != '.c' }
+      end
+    end
+  end
+end
+
+desc "Build the sys-host library on UNIX systems (but don't install it)"
+task :build => [:clean] do
+  case Config::CONFIG['host_os']
+    when /bsd|darwin/i
+      dir = 'ext/bsd'
+    when /sunos|solaris/i
+      dir = 'ext/sunos'
+    when /linux/i
+      dir = 'ext/linux'
+    else
+      dir = 'ext/generic'
+  end
+
+  unless Config::CONFIG['host_os'] =~ /win32|mswin|dos|cygwin|mingw/i
+    Dir.chdir(dir) do
+      ruby 'extconf.rb'
+      sh 'make'
+      cp 'host.' + Config::CONFIG['DLEXT'], 'sys'
+    end
+  end
+end
+
+desc 'Install the sys-host library'
+task :install => [:build] do
+  file = nil
+  dir  = File.join(Config::CONFIG['sitelibdir'], 'sys')
+
+  Dir.mkdir(dir) unless File.exists?(dir)
+
+  case Config::CONFIG['host_os']
+    when /mswin|win32|msdos|cygwin|mingw/i
+      file = 'lib/windows/sys/host.rb'
+    when /bsd|darwin/i
+      Dir.chdir('ext/bsd'){ sh 'make install' }
+    when /sunos|solaris/i
+      Dir.chdir('ext/sunos'){ sh 'make install' }
+    when /linux/i
+      Dir.chdir('ext/linux'){ sh 'make install' }
+    else
+      Dir.chdir('ext/generic'){ sh 'make install' }
+  end
+
+  cp(file, dir, :verbose => true) if file
+end
+
+desc 'Uninstall the sys-host library'
+task :uninstall do
+  case Config::CONFIG['host_os']
+    when /win32|mswin|dos|cygwin|mingw/i
+      dir  = File.join(Config::CONFIG['sitelibdir'], 'sys')
+      file = File.join(dir, 'host.rb')
+    else
+      dir  = File.join(Config::CONFIG['sitearchdir'], 'sys')
+      file = File.join(dir, 'host.' + Config::CONFIG['DLEXT'])
+  end
+
+  rm(file) 
+end
+
+desc "Run the example sys-host program"
+task :example => [:build] do
+   Dir.mkdir('sys') unless File.exists?('sys')
+   if CONFIG['host_os'].match('mswin')
+      ruby '-Ilib/windows examples/example_sys_host.rb'
+   else
+      case Config::CONFIG['host_os']
+        when /bsd|darwin/i
+          dir = 'ext/bsd'
+        when /sunos|solaris/i
+          dir = 'ext/sunos'
+        when /linux/i
+          dir = 'ext/linux'
+        else
+          dir = 'ext/generic'
+      end
+      ruby "-I#{dir} examples/example_sys_host.rb"
+   end
+end
+
+desc 'Run the test suite'
+Rake::TestTask.new do |t|
+  task :test => :build
+  t.libs << 'test'
+  t.test_files = FileList['test/test_sys_host.rb'] 
+   
+  case Config::CONFIG['host_os']
+    when /mswin|msdos|cygwin|mingw/i
+      t.libs << 'lib/windows'
+    when /linux/i
+      t.libs << 'ext/linux'
+    when /sunos|solaris/i
+      t.libs << 'ext/sunos'
+    when /bsd|darwin/i
+      t.libs << 'ext/bsd'
+    else
+      t.libs << 'ext/generic'
+  end
+end
+
+namespace 'gem' do
+  desc 'Create the sys-host gem file'
+  task :create => [:clean] do
+    spec = eval(IO.read('sys-host.gemspec'))
+
+    case Config::CONFIG['host_os']
+      when /bsd|darwin/i
+         spec.files << 'ext/bsd/sys/host.c'
+         spec.extra_rdoc_files << 'ext/bsd/sys/host.c'
+         spec.extensions = ['ext/bsd/extconf.rb']
+      when /linux/i
+         spec.files << 'ext/linux/sys/host.c'
+         spec.extra_rdoc_files << 'ext/linux/sys/host.c'
+         spec.extensions = ['ext/linux/extconf.rb']
+      when /sunos|solaris/i
+         spec.files << 'ext/sunos/sys/host.c'
+         spec.extra_rdoc_files << 'ext/sunos/sys/host.c'
+         spec.extensions = ['ext/sunos/extconf.rb']
+      when /mswin|win32|dos|cygwin|mingw/i
+         spec.platform = Gem::Platform::CURRENT
+         spec.require_paths = ['lib', 'lib/windows']
+         spec.files += ['lib/windows/sys/host.rb']
+      else
+         spec.files << 'ext/generic/sys/host.c'
+         spec.extra_rdoc_files << 'ext/generic/sys/host.c'
+         spec.extensions = ['ext/generic/extconf.rb']
+    end
+
+    Gem::Builder.new(spec).build 
+  end
+
+  desc 'Install the sys-host gem'
+  task :install => [:create] do
+    file = Dir["*.gem"].first
+    sh "gem install #{file}"
+  end
+end

data/doc/host.txt

@@ -0,0 +1,88 @@
+== Description
+  Provides hostname and ip address information for a given host.
+    
+== Synopsis
+  require 'sys/host'
+  include Sys
+
+  p Host.hostname
+  p Host.ip_addr
+    
+  # Some platforms
+  Host.info{ |h|
+    p h
+  }
+
+== Constants
+VERSION
+  Returns the current version number of this library (as a string)
+    
+== Class Methods
+Host.hostname
+  Returns the hostname of the current host.  This may or not return
+  the FQDN, depending on your system.
+    
+Host.ip_addr
+  Returns a list of IP addresses for the current host (yes, it is
+  possible to have more than one).
+    
+Host.info(host=localhost)
+Host.info(host=localhost){ |h| ... }
+  Yields a HostInfo struct for each network adapter on 'host', or an array
+  of HostInfo struct's in non-block form.  The exact members of this struct
+  vary depending on your platform.
+
+Host.host_id
+  Returns the unique hexadecimal identifier for the current host.
+    
+== Exception Classes
+Host::Error < StandardError
+  Raised in the event of a failure for any of the class methods provided
+  with this library.  Generally speaking, it means there was a failure in
+  the underlying gethostname() or gethostbyname() calls.
+    
+== Future Plans
+  Add support for IPV6.  This will be difficult unless I have access to a
+  system on an IPV6 network.  Any help on this front appreciated.
+    
+== Notes
+  The Windows version of this library uses OLE + WMI.  The Host.info method
+  returns considerably more information than the *nix versions of this
+  library.
+   
+== Comments and Questions
+  Please direct all comments and/or questions to one of the Forums on the
+  project home page at http://www.rubyforge.org/projects/sysutils.
+	
+== Known Bugs
+  None that I'm aware of.
+
+  Please log any bugs on the project home page at
+  http://www.rubyforge.org/projects/sysutils
+    
+== Acknowledgements
+  Thanks go to Mike Hall, Guy Decoux, and Matz for their help with
+  C extensions in general.
+
+  Thanks also go to Richard Stevens for his excellent Unix programming books.
+    
+== License
+  Artistic 2.0
+    
+== Copyright
+  Copyright 2002-2010, Daniel J. Berger, djberg96 at gmail dot com
+
+  All Rights Reserved. This module is free software. It may be used,
+  redistributed and/or modified under the same terms as Ruby itself.
+    
+== Warranty
+  This library is provided "as is" and without any express or
+  implied warranties, including, without limitation, the implied
+  warranties of merchantability and fitness for a particular purpose.
+	
+== Author
+  Daniel J. Berger
+    
+== See Also
+  gethostbyname, gethostbyname_r, gethostname, hostname (Unix)
+  WMI, OLE (Windows)

data/examples/example_sys_host.rb

@@ -0,0 +1,21 @@
+####################################################################
+# example_sys_host.rb
+#
+# Generic test script for general futzing. Use the 'rake example'
+# task to run this.
+#
+# Modify as you see fit.
+####################################################################
+require 'sys/host'
+include Sys
+
+puts "VERSION: " + Host::VERSION
+puts "Hostname: " + Host.hostname
+puts "IP Addresses : " + Host.ip_addr.join(',')
+puts "Host ID: " + Host.host_id.to_s
+
+puts "Info: "
+
+Host.info{ |i|
+   p i
+}

data/lib/windows/sys/host.rb

@@ -0,0 +1,285 @@
+require 'win32ole'
+require 'socket'
+require 'time'
+
+# The Sys module serves as a namespace only.
+module Sys
+  # The Host class encapsulates methods that return information about the local host.
+  class Host
+    # Error class typically raised if any of the Host methods fail.
+    class Error < StandardError; end
+      
+    # The version of the sys-host library.
+    VERSION = '0.6.2'
+
+    # :stopdoc:
+      
+    fields = %w[
+      arp_always_source_route?
+      arp_use_ether_snap?
+      caption
+      database_path
+      dead_gw_detect_enabled?
+      default_ip_gateway
+      default_tos
+      default_ttl
+      description
+      dhcp_enabled?
+      dhcp_lease_expires
+      dhcp_lease_obtained
+      dhcp_server
+      dns_domain
+      dns_domain_suffix_search_order
+      dns_enabled_for_wins_resolution?
+      dns_host_name
+      dns_server_search_order
+      domain_dns_registration_enabled?
+      forward_buffer_memory
+      full_dns_registration_enabled?
+      gateway_cost_metric
+      igmp_level
+      index
+      ip_address
+      ip_connection_metric
+      ip_enabled?
+      ip_filter_security_enabled?
+      ip_port_security_enabled?
+      ip_sec_permit_ip_protocols
+      ip_sec_permit_tcp_ports
+      ip_sec_permit_udp_ports
+      ip_subnet
+      ip_use_zero_broadcast
+      ipx_address
+      ipx_enabled?
+      ipx_frame_type
+      ipx_media_type
+      ipx_network_number
+      ipx_virtual_net_number
+      keep_alive_interval
+      keep_alive_time
+      mac_address
+      mtu
+      num_forward_packets
+      pmtubh_detect_enabled?
+      pmtu_discovery_enabled?
+      service_name
+      setting_id
+      tcpip_netbios_options
+      tcp_max_connect_retransmissions
+      tcp_max_data_retransmissions
+      tcp_num_connections
+      tcp_use_rfc1122_urgent_pointer?
+      tcp_window_size
+      wins_enable_lm_hosts_lookup?
+      wins_host_lookup_file
+      wins_primary_server
+      wins_scope_id
+      wins_secondary_server
+    ]
+      
+    HostInfo = Struct.new("HostInfo", *fields)
+
+    # :startdoc:
+      
+    # Yields a HostInfo struct for each network adapter on 'host', or an array
+    # of HostInfo struct's in non-block form.  The exact members of this struct
+    # vary depending on your platform.
+    # 
+    def self.info(host=Socket.gethostname)
+      array = [] unless block_given?
+      cs = "winmgmts://#{host}/root/cimv2"
+
+      begin
+        wmi = WIN32OLE.connect(cs)
+      rescue WIN32OLERuntimeError => err
+        raise Error, err
+      else
+        query = "
+          select * from Win32_NetworkAdapterConfiguration
+          where IPEnabled = True
+        "
+
+        wmi.ExecQuery(query).each{ |nic|
+          if nic.DHCPLeaseExpires
+            dhcp_expires = Time.parse(nic.DHCPLeaseExpires.split('.')[0])
+          else
+            dhcp_expires = nil
+          end
+               
+          if nic.DHCPLeaseObtained
+            dhcp_lease_obtained = Time.parse(nic.DHCPLeaseObtained.split('.')[0])
+          else
+            dhcp_lease_obtained = nil
+          end
+               
+          igmp_level = nil
+
+          case nic.IGMPLevel
+            when 0
+              igmp_level = "None"
+            when 1
+              igmp_level = "IP"
+            when 2
+              igmp_level = "IP & IGMP"
+          end
+                  
+          ipx_frame_type = nil
+          case nic.IPXFrameType
+            when 0
+              ipx_frame_type = "Ethernet II"
+            when 1
+              ipx_frame_type = "Ethernet 802.3"
+            when 2
+              ipx_frame_type = "Ethernet 802.2"
+            when 3
+              ipx_frame_type = "Ethernet SNAP"
+            when 255
+              ipx_frame_type = "AUTO"
+          end
+               
+          ipx_media_type = nil
+          case nic.IPXMediaType
+            when 0
+              ipx_media_type = "Ethernet"
+            when 1
+              ipx_media_type = "Token Ring"
+            when 2
+              ipx_media_type = "FDDI"
+            when 8
+              ipx_media_type = "ARCNET"
+          end
+               
+          tcpip_netbios_options = nil
+          case nic.TcpipNetbiosOptions
+            when 0
+              tcpip_netbios_options = "EnableNetbiosViaDhcp"
+            when 1
+              tcpip_netbios_options = "EnableNetbios"
+            when 2
+              tcpip_netbios_options = "DisableNetbios"
+          end
+               
+          struct = HostInfo.new(
+            nic.ArpAlwaysSourceRoute,
+            nic.ArpUseEtherSNAP,
+            nic.Caption,
+            nic.DatabasePath,
+            nic.DeadGWDetectEnabled,
+            nic.DefaultIPGateway,
+            nic.DefaultTOS,
+            nic.DefaultTTL,
+            nic.Description,
+            nic.DHCPEnabled,
+            dhcp_expires,
+            dhcp_lease_obtained,
+            nic.DHCPServer,
+            nic.DNSDomain,
+            nic.DNSDomainSuffixSearchOrder,
+            nic.DNSEnabledForWINSResolution,
+            nic.DNSHostName,
+            nic.DNSServerSearchOrder,
+            nic.DomainDNSRegistrationEnabled,
+            nic.ForwardBufferMemory,
+            nic.FullDNSRegistrationEnabled,
+            nic.GatewayCostMetric,
+            igmp_level,
+            nic.Index,
+            nic.IpAddress,
+            nic.IPConnectionMetric,
+            nic.IPEnabled,
+            nic.IPFilterSecurityEnabled,
+            nic.IPPortSecurityEnabled,
+            nic.IPSecPermitIPProtocols,
+            nic.IPSecPermitTCPPorts,
+            nic.IPSecPermitUDPPorts,
+            nic.IPSubnet,
+            nic.IPUseZeroBroadcast,
+            nic.IPXAddress,
+            nic.IPXEnabled,
+            ipx_frame_type,
+            ipx_media_type,
+            nic.IPXNetworkNumber,
+            nic.IPXVirtualNetNumber,
+            nic.KeepAliveInterval,
+            nic.KeepAliveTime,
+            nic.MacAddress,
+            nic.MTU,
+            nic.NumForwardPackets,
+            nic.PMTUBHDetectEnabled,
+            nic.PMTUDiscoveryEnabled,
+            nic.ServiceName,
+            nic.SettingID,
+            tcpip_netbios_options,
+            nic.TcpMaxConnectRetransmissions,
+            nic.TcpMaxDataRetransmissions,
+            nic.TcpNumConnections,
+            nic.TcpUseRFC1122UrgentPointer,
+            nic.TcpWindowSize,
+            nic.WINSEnableLMHostsLookup,
+            nic.WINSHostLookupFile,
+            nic.WINSPrimaryServer,
+            nic.WINSScopeID,
+            nic.WINSSecondaryServer
+          )
+
+          if block_given?
+            yield struct
+          else
+            array << struct
+          end
+        }
+      end
+
+      block_given? ? nil : array
+    end
+      
+    # Returns the hostname of the current host.  This may or not return
+    # the FQDN, depending on your system.
+    # 
+    def self.hostname
+      host = nil
+
+      begin
+        wmi = WIN32OLE.connect("winmgmts://")
+      rescue WIN32OLERuntimeError => err
+        raise Error, err
+      else
+        query = "
+          select * from Win32_NetworkAdapterConfiguration
+          where IPEnabled = True
+        "
+        wmi.ExecQuery(query).each{ |nic|
+          host = nic.DNSHostName
+          break
+        }
+      end
+
+      host
+    end
+      
+    # Returns a list of unique IP addresses for the current host.
+    #
+    def self.ip_addr
+      ip_addrs = []
+      begin
+        wmi = WIN32OLE.connect("winmgmts://")
+      rescue WIN32OLERuntimeError => err
+        raise Error, err
+      else
+        query = "
+          select * from Win32_NetworkAdapterConfiguration
+          where IPEnabled = True
+        "
+        wmi.ExecQuery(query).each{ |nic| ip_addrs << nic.IPAddress }
+      end
+
+      ip_addrs.flatten.uniq
+    end      
+
+    # Returns the host id (physical address) of the current host.
+    #
+    def self.host_id
+      info[0].mac_address.split(':').join.hex
+    end
+  end
+end

data/sys-host.gemspec

@@ -0,0 +1,40 @@
+require 'rubygems'
+require 'rbconfig'
+include Config
+
+# Some additional specification options are handled by the gem:create task.
+
+Gem::Specification.new do |spec|
+  spec.name        = 'sys-host'
+  spec.version     = '0.6.2'
+  spec.author      = 'Daniel J. Berger'
+  spec.license     = 'Artistic 2.0'
+  spec.email       = 'djberg96@gmail.com'
+  spec.homepage    = 'http://www.rubyforge.org/projects/sysutils'
+  spec.platform    = Gem::Platform::RUBY
+  spec.summary     = 'Provides hostname and ip address info for a given host'
+  spec.test_file   = 'test/test_sys_host.rb'
+  spec.has_rdoc    = true
+
+  spec.files = %w[
+    CHANGES
+    MANIFEST
+    README
+    Rakefile
+    sys-host.gemspec
+    doc/host.txt
+    examples/example_sys_host.rb
+    test/test_sys_host.rb
+  ] 
+
+  spec.extra_rdoc_files  = ['CHANGES', 'README', 'MANIFEST']
+  spec.rubyforge_project = 'sysutils'
+
+  spec.add_development_dependency('test-unit', '>= 2.0.7')
+
+  spec.description = <<-EOF
+    The sys-host library provides information about the current machine that
+    your program is running on. Specifically, it returns hostname, IP
+    address information, aliases and so on.
+  EOF
+end

data/test/test_sys_host.rb

@@ -0,0 +1,129 @@
+###########################################################################
+# test_sys_host.rb
+#
+# Test suite for sys-host, all platforms. You should run these tests via
+# the 'rake test' task.
+###########################################################################
+require 'rubygems'
+gem 'test-unit'
+
+require 'sys/host'
+require 'test/unit'
+require 'rbconfig'
+include Config
+include Sys
+
+class TC_Sys_Host < Test::Unit::TestCase
+  def self.startup
+    if CONFIG['host_os'] =~ /mswin|solaris|linux|bsd|mach|darwin|osx/i
+      @@info_supported = true
+    else
+      @@info_supported = false
+    end
+
+    @@windows = CONFIG['host_os'].match('mswin')
+  end
+
+  def test_version
+    assert_equal('0.6.2', Host::VERSION)
+  end
+
+  def test_hostname_basic
+    assert_respond_to(Host, :hostname)
+    assert_nothing_raised{ Host.hostname }
+  end
+
+  def test_hostname
+    assert_kind_of(String, Host.hostname)
+    assert_equal(`hostname`.chomp, Host.hostname) # sanity check
+  end
+
+  def test_hostname_expected_errors
+    assert_raise(ArgumentError){ Host.hostname(true) }
+  end
+
+  def test_ip_addr_basic
+    assert_respond_to(Host, :ip_addr)
+    assert_nothing_raised{ Host.ip_addr }
+  end
+
+  def test_ip_addr
+    assert_kind_of(Array, Host.ip_addr)
+    assert_kind_of(String, Host.ip_addr.first)
+  end
+
+  def test_ip_addr_expected_errors
+    assert_raise(ArgumentError){ Host.ip_addr(true) }
+  end
+
+  def test_host_id_basic
+    assert_respond_to(Host, :host_id)
+    assert_nothing_raised{ Host.host_id }
+  end
+
+  def test_host_id
+    type = @@windows ? String : Integer
+    assert_kind_of(type, Host.host_id)
+  end
+
+  def test_host_id_expected_errors
+    assert_raise(ArgumentError){ Host.host_id(true) }
+  end
+
+  def test_info_basic
+    omit_unless(@@info_supported, 'info test skipped on this platform')
+    assert_respond_to(Host, :info)
+    assert_nothing_raised{ Host.info }
+  end
+
+  def test_info
+    omit_unless(@@info_supported, 'info test skipped on this platform')
+    assert_kind_of(Array, Host.info)
+    assert_kind_of(Struct::HostInfo, Host.info.first)
+    assert_nil(Host.info{ })
+  end
+
+  def test_info_name_member
+    omit_unless(@@info_supported, 'info test skipped on this platform')
+    assert_true(Host.info.first.members.map{ |e| e.to_s }.include?('name'))
+    assert_kind_of(String, Host.info.first.name)
+    assert_true(Host.info.first.name.size > 0)
+  end
+
+  def test_info_addr_type_member
+    omit_unless(@@info_supported, 'info test skipped on this platform')
+    assert_true(Host.info.first.members.map{ |e| e.to_s }.include?('addr_type'))
+    assert_kind_of(Fixnum, Host.info.first.addr_type)
+    assert_true(Host.info.first.addr_type >= 0)
+  end
+
+  def test_info_aliases_member
+    omit_unless(@@info_supported, 'info test skipped on this platform')
+    assert_true(Host.info.first.members.map{ |e| e.to_s }.include?('aliases'))
+    assert_kind_of(Array, Host.info.first.aliases)
+  end
+
+  def test_info_length_member
+    omit_unless(@@info_supported, 'info test skipped on this platform')
+    assert_true(Host.info.first.members.map{ |e| e.to_s }.include?('length'))
+    assert_kind_of(Fixnum, Host.info.first.length)
+    assert_true(Host.info.first.length >= 4)
+  end
+
+  def test_info_addr_list_member
+    omit_unless(@@info_supported, 'info test skipped on this platform')
+    assert_true(Host.info.first.members.map{ |e| e.to_s }.include?('addr_list'))
+    assert_kind_of(Array, Host.info.first.addr_list)
+    assert_true(Host.info.first.addr_list.first.length > 0)
+  end
+
+  def test_info_high_iteration
+    omit_unless(@@info_supported, 'info test skipped on this platform')
+    assert_nothing_raised{ 100.times{ Host.info } }
+  end
+
+  def self.shutdown
+    @@info_supported = nil
+    @@windows = nil
+  end
+end

metadata

@@ -0,0 +1,75 @@
+--- !ruby/object:Gem::Specification 
+name: sys-host
+version: !ruby/object:Gem::Version 
+  version: 0.6.2
+platform: x86-mingw32
+authors: 
+- Daniel J. Berger
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-03-20 00:00:00 -06:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: test-unit
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.0.7
+    version: 
+description: "    The sys-host library provides information about the current machine that\n    your program is running on. Specifically, it returns hostname, IP\n    address information, aliases and so on.\n"
+email: djberg96@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- CHANGES
+- README
+- MANIFEST
+files: 
+- CHANGES
+- MANIFEST
+- README
+- Rakefile
+- sys-host.gemspec
+- doc/host.txt
+- examples/example_sys_host.rb
+- test/test_sys_host.rb
+- lib/windows/sys/host.rb
+has_rdoc: true
+homepage: http://www.rubyforge.org/projects/sysutils
+licenses: 
+- Artistic 2.0
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+- lib/windows
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: sysutils
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Provides hostname and ip address info for a given host
+test_files: 
+- test/test_sys_host.rb