sys-uptime 0.4.5-mswin32

data/CHANGES

@@ -0,0 +1,109 @@
+== 0.4.5 - 19-Nov-2006
+* Internal layout changes, minor doc updates and gemspec improvements.
+* No code changes.
+
+== 0.4.4 - 30-Jun-2006
+* Added inline rdoc documentation to the source files.
+* Added a gemspec.
+
+== 0.4.3 - 18-Dec-2005
+* Changed the Linux version to pure Ruby.  The current method of determining
+  uptime in unix.c does not work in Linux kernel 2.6+.  So, from now on it
+  reads out of /proc/uptime.
+
+== 0.4.2 - 6-May-2005
+* Fixed a potential boot_time bug.
+* Removed the version.h file.  It's no longer needed since the Windows
+  version is pure Ruby.
+* NetBSD 2.x and FreeBSD 5.x now supported.
+* Removed the INSTALL file.  Installation instructions are now in
+  the README file.
+* Removed the uptime.rd file.  You can generate html documentation by
+  running rdoc over the uptime.txt file.
+* Made most documents rdoc friendly.
+* Moved project to RubyForge.
+
+== 0.4.1 - 14-Dec-2004
+* Moved freebsd code into unix.c file.
+* Should now work past 249 days (2**31) on systems that have utmpx.h.
+* Fixed a bug with regards to boot_time, where it was possible that it would
+  simply be empty.
+
+== 0.4.0 - 8-Jul-2004
+* Removed all reference to the CLK_TCK constant, as per documentation from
+  Richard Stevens that it is deprecated and that sysconf() should be used
+  instead (well, I knew about this, but ignored it until now).
+* Scrapped the C version for Windows in favor of a pure Ruby version that
+  uses win32ole + WMI.
+* Added a boot_time method for Unix systems (Windows already had this).
+* Added an UptimeError class on Unix systems (and replaced UptimeException
+  on Windows).
+* Modified an internal function to raise an UptimeError if the times()
+  function fails.  Also, it now returns an unsigned long instead of a plain
+  long.
+* Replaced the two different test suites with a single, unified test suite.
+* Cleaned up the extconf.rb script.  I now assume that TestUnit is installed.
+* Removed the load_avg method (which was never advertised and which I hope
+  you weren't using).  You can find a load_avg method in the sys-cpu package.
+* Changed uptime.rd2 to uptime.rd to be consistent with my other packages.
+* Removed the uptime.html file - you may generate that on your own.
+* Added warranty and license info.
+
+== 0.3.2 - 30-Dec-2003
+* Cleaned up some warnings that showed up with -Wall on some unix platforms
+  (int vs long format, explicit include)
+* Minor test suite and extconf.rb changes
+
+== 0.3.1 - 25-Jun-2003
+* Modified test files to handle HP-UX extensions
+* Minor doc updates
+* Added the dhms() method.  Actually, this was in the 0.3.0
+  release, I just forgot to mention it in this file :)
+
+== 0.3.0 - 22-Jun-2003
+* Added OS X support - thanks go to Mike Hall for the patch
+* Fixed incorrect values in FreeBSD (again Mike Hall)
+* Modified tc_unix.rb test suite to handle OS X, along with a bit
+* of minor cleanup
+* Removed VERSION class method.  Use the constant instead
+* Separated FreeBSD/OS X source into its own file (freebsd.c).
+  The #ifdefs were starting to get too ugly for me
+
+== 0.2.1 - 13-May-2003
+* Fixed bug in extconf.rb file, and made some major changes
+* Modified test.rb for those without TestUnit
+* Modified TestUnit tests - some bogus tests were removed
+* Added a README file with some additional info
+* Created a version.h file, so that I can keep the VERSION number
+  in one place
+* Docs automatically included in doc directory (i.e. no more interactive
+  document creation)
+
+== 0.2.0 - 13-Mar-2003
+* Added MS Windows support
+* Added a VERSION constant
+* Added a test suite (for those with TestUnit installed)
+* Internal directory layout change
+* uptime.c is now split into unix.c and windows.c (and linked appropriately)
+* Changelog and Manifest are now CHANGES and MANIFEST, respectively
+* Many changes to extconf.rb
+
+== 0.1.3 - 6-Jan-2003
+* Added a VERSION class method
+* Added a copyright notice
+* Fixed up the docs a bit and moved them to the doc directory
+* Changed the tarball name to match the RAA package name
+* Modified test.rb script to make it better
+* Changed install instructions slightly
+
+== 0.1.2 - 25-Aug-2002
+* Slight change to preprocessor commands to avoid redefining CLK_TCK on
+  those systems that define it in time.h
+* Added an INSTALL file
+
+== 0.1.1 - 21-Jun-2002
+* The CLK_TCK constant wasn't necessarily being set correctly, which could
+  lead to some odd results.  This has been fixed.
+
+== 0.1.0 - 17-Jun-2002
+* Initial release

data/MANIFEST

@@ -0,0 +1,17 @@
+CHANGES
+MANIFEST
+README
+install.rb
+sys-uptime.gemspec
+
+doc/uptime.txt
+
+examples/test.rb
+
+ext/extconf.rb
+ext/uptime.c
+
+lib/sys/linux.rb
+lib/sys/windows.rb
+
+test/tc_uptime.rb

data/README

@@ -0,0 +1,20 @@
+= Description
+   A Ruby interface for getting system uptime information.
+
+= Prerequisites
+   Ruby 1.8.0 or later.
+   Ruby 1.8.2 or later is recommended on MS Windows.
+
+= Installation
+=== Unix:
+   ruby extconf.rb
+   make
+   ruby test/tc_uptime.rb (optional)
+   make install
+
+=== Windows and Linux:
+   ruby test\tc_uptime.rb (optional)
+   ruby install.rb
+
+== Notes
+   For additional documentation see doc/uptime.txt.

data/doc/uptime.txt

@@ -0,0 +1,97 @@
+== Synopsis
+   require 'sys/uptime'
+   include Sys
+
+   p Uptime.days
+   p Uptime.hours
+   p Uptime.minutes
+   p Uptime.seconds
+   p Uptime.dhms.join(', ')
+   p Uptime.uptime
+   p Uptime.boot_time
+
+== Description
+   This package provides uptime and boot time information, similar to the
+   'uptime' Unix command.
+    
+== Constants
+VERSION
+   Returns the current version number of this package (as a string).
+    
+== Class Methods
+Uptime.boot_time
+   Returns the boot time as a Time object.
+    
+Uptime.days
+   Returns the total number of days the system has been up.
+    
+Uptime.hours
+   Returns the total number of hours the system has been up.
+    
+Uptime.minutes
+   Returns the total number of minutes the system has been up.
+    
+Uptime.seconds
+   Returns the total number of seconds the system has been up.
+    
+Uptime.dhms
+   Calculates and returns the number of days, hours, minutes and
+   seconds the system has been running as a four-element Array.
+    
+Uptime.uptime
+   Calculates and returns the number of days, hours, minutes and
+   seconds the system has been running as a colon-separated string.
+    
+== Exceptions
+UptimeError
+   Raised if something goes wrong.  On Unix, this would likely mean a
+   failure of the times() function.  On Windows, it probably means you
+   failed to connect to WMI properly.
+    
+== Notes
+   On MS Windows each of the class methods optionally takes a host name as
+   a single argument. The default is localhost (or whatever the result of
+   Socket.gethostname returns).
+
+   The current time, users and load average are NOT included in this
+   module, even though you may be used to seeing them with the command
+   line version of 'uptime'.  This is because these things have
+   _absolutely nothing_ to do with uptime (at least, not as I
+   logically think of uptime).
+    
+   This package was tested successfully on a Solaris system with over 1600
+   days of uptime.
+    
+== Known Bugs
+   None that I am aware of.  Please log any bugs you find on the project
+   website at http://www.rubyforge.org/projects/sysutils.
+
+== Questions
+   "Doesn't Struct::Tms do this?" - No.
+    
+== License
+   Ruby's
+    
+== Copyright
+   Copyright 2002-2006, Daniel J. Berger
+
+   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 package 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.
+
+== Acknowledgements
+   Mike Hall for help with the BSD side of things.
+   Ola Eriksson, whose source code I shamelessly plagiarized to get a better
+   implementation for systems that have the utmpx.h header file.
+
+== Author
+   Daniel J. Berger
+   djberg96 at gmail dot com
+   imperator on IRC (Freenode)
+    
+== See Also
+   uptime

data/lib/sys/uptime.rb

@@ -0,0 +1,97 @@
+require 'win32ole'
+require 'socket'
+require 'parsedate'
+
+module Sys
+   class UptimeError < StandardError; end
+   class Uptime
+      VERSION = '0.4.5'
+
+      # Returns the boot time as a Time object.
+      #
+      def self.boot_time(host=Socket.gethostname)
+         cs = "winmgmts://#{host}/root/cimv2"
+         begin
+            wmi = WIN32OLE.connect(cs)
+         rescue WIN32OLERuntimeError => e
+            raise UptimeError, e
+         else
+            query = "select LastBootupTime from Win32_OperatingSystem"
+            results = wmi.ExecQuery(query)
+            results.each{ |ole|
+               time_array = ParseDate.parsedate(ole.LastBootupTime)
+               return Time.mktime(*time_array)
+            }
+         end
+      end
+      
+      # Calculates and returns the number of days, hours, minutes and
+      # seconds the system has been running as a colon-separated string.
+      #
+      def self.uptime(host=Socket.gethostname)
+         arr = self.get_dhms(host)
+         return arr.join(":")
+      end
+      
+      # Calculates and returns the number of days, hours, minutes and
+      # seconds the system has been running as a four-element Array.
+      #
+      def self.dhms(host=Socket.gethostname)
+         return self.get_dhms(host)
+      end
+      
+      # Returns the total number of days the system has been up.
+      #
+      def self.days(host=Socket.gethostname)
+         return self.get_dhms(host).first
+      end
+      
+      # Returns the total number of hours the system has been up.
+      #
+      def self.hours(host=Socket.gethostname)
+         return self.get_dhms(host)[1]
+      end
+      
+      # Returns the total number of minutes the system has been up.
+      #
+      def self.minutes(host=Socket.gethostname)
+         return self.get_dhms(host)[2]
+      end
+      
+      # Returns the total number of seconds the system has been up.
+      #
+      def self.seconds(host=Socket.gethostname)
+         return self.get_dhms(host).last
+      end
+      
+      private
+      
+      def self.get_dhms(host)
+         cs = "winmgmts://#{host}/root/cimv2"
+         begin
+            wmi = WIN32OLE.connect(cs)
+         rescue WIN32OLERuntimeError => e
+            raise UptimeError, e
+         else
+            query = "select LastBootupTime from Win32_OperatingSystem"
+            results = wmi.ExecQuery(query)
+            now = Time.now
+            
+            results.each{ |ole|
+               time_array = ParseDate.parsedate(ole.LastBootupTime)
+               boot_time = Time.mktime(*time_array)
+               break
+            }
+            
+            seconds = (now - boot_time).to_i
+            days = (seconds / 86400).to_i
+            seconds -= days * 86400
+            hours = seconds / 3600
+            seconds -= hours * 3600
+            minutes = seconds / 60
+            seconds -= minutes * 60
+            return [days,hours,minutes,seconds]
+         end
+      end
+   end
+end

data/test/tc_uptime.rb

@@ -0,0 +1,80 @@
+#################################
+# tc_uptime.rb
+#
+# Test suite for sys-uptime.
+#################################
+base = File.basename(Dir.pwd)
+if base == 'test' || base =~ /sys-uptime.*/
+   require 'fileutils'
+   Dir.chdir('..') if base == 'test'
+   Dir.mkdir('sys') unless File.exists?('sys')
+
+   if RUBY_PLATFORM.match('mswin')
+      FileUtils.cp('lib/sys/windows.rb', 'sys/uptime.rb') rescue nil
+   elsif RUBY_PLATFORM.match('linux')
+      FileUtils.cp('lib/sys/linux.rb', 'sys/uptime.rb') rescue nil
+   else
+      require 'rbconfig'
+      file = 'ext/uptime.' + Config::CONFIG['DLEXT']
+      FileUtils.cp(file, 'sys')
+   end
+
+   $LOAD_PATH.unshift(Dir.pwd)
+   $LOAD_PATH.unshift(Dir.pwd + '/lib')
+end
+
+require 'sys/uptime'
+require 'test/unit'
+include Sys
+
+class TC_Uptime < Test::Unit::TestCase
+   def test_version
+      assert_equal('0.4.5', Uptime::VERSION)
+   end
+
+   def test_seconds
+      assert_respond_to(Uptime, :seconds)
+      assert_nothing_raised{ Uptime.seconds }
+      assert_kind_of(Fixnum, Uptime.seconds)
+      assert_equal(true, Uptime.seconds > 0)
+   end
+
+   def test_minutes
+      assert_respond_to(Uptime, :minutes)
+      assert_nothing_raised{ Uptime.minutes }
+      assert_kind_of(Fixnum, Uptime.minutes)
+   end
+
+   def test_hours
+      assert_respond_to(Uptime, :hours)
+      assert_nothing_raised{ Uptime.hours }
+      assert_kind_of(Fixnum, Uptime.hours)
+   end
+
+   def test_days
+      assert_respond_to(Uptime,:days)
+      assert_nothing_raised{ Uptime.days }
+      assert_kind_of(Fixnum, Uptime.days)
+   end 
+
+   def test_uptime
+      assert_respond_to(Uptime,:uptime)
+      assert_nothing_raised{ Uptime.uptime }
+      assert_kind_of(String, Uptime.uptime)
+      assert_equal(false, Uptime.uptime.empty?)
+   end
+   
+   def test_dhms
+      assert_respond_to(Uptime,:dhms)
+      assert_nothing_raised{ Uptime.dhms }
+      assert_kind_of(Array, Uptime.dhms)
+      assert_equal(false, Uptime.dhms.empty?)
+      assert_equal(4, Uptime.dhms.length)
+   end
+   
+   def test_boot_time
+      assert_respond_to(Uptime,:boot_time)
+      assert_nothing_raised{ Uptime.boot_time }
+      assert_kind_of(Time, Uptime.boot_time)
+   end
+end

metadata

@@ -0,0 +1,54 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.9.0
+specification_version: 1
+name: sys-uptime
+version: !ruby/object:Gem::Version 
+  version: 0.4.5
+date: 2006-11-20 00:00:00 -07:00
+summary: A Ruby interface for getting system uptime information.
+require_paths: 
+- lib
+email: djberg96@gmail.com
+homepage: http://www.rubyforge.org/projects/sysutils
+rubyforge_project: sysutils
+description: A Ruby interface for getting system uptime information.
+autorequire: 
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: 1.8.2
+  version: 
+platform: mswin32
+signing_key: 
+cert_chain: 
+post_install_message: 
+authors: 
+- Daniel J. Berger
+files: 
+- doc/uptime.txt
+- test/tc_uptime.rb
+- CHANGES
+- README
+- MANIFEST
+- lib/sys/uptime.rb
+test_files: 
+- test/tc_uptime.rb
+rdoc_options: []
+
+extra_rdoc_files: 
+- CHANGES
+- README
+- MANIFEST
+- doc/uptime.txt
+executables: []
+
+extensions: []
+
+requirements: []
+
+dependencies: []
+