sys-uptime 0.5.2-x86-linux

data/CHANGES

@@ -0,0 +1,135 @@
+== 0.5.2 - 13-Dec-2008
+* Fixed a date/time issue in the Windows version caused by Ruby itself.
+* Fixed the Uptime.seconds, Uptime.minutes and Uptime.hours methods on MS
+  Windows.
+* Renamed the test file to 'test_sys_uptime.rb'.
+* Some minor updates to the Rakefile.
+
+== 0.5.1 - 26-Jul-2007
+* Fixed bug in the MS Windows version caused by incorrect parsing of an
+  MS specific date format (caused by a bug in Ruby 1.8.6). Thanks go to
+  Robert H. for the spot.
+* Inlined the Rake installation tasks, so the install.rb file has been
+  removed.
+* Added an 'install_gem' Rake task, and updated the README installation
+  instructions.
+
+== 0.5.0 - 30-Mar-2007
+* For platforms that use C code, the code now always uses the sysctl()
+  function if supported by your system. This replaces the platform specific
+  checks I was doing for the various BSD flavors.
+* Fix for OS X - the Uptime.boot_time method now works.
+* UptimeError is now Uptime::Error.
+* Improved RDoc in the uptime.c source code.
+* Added a Rakefile - users should now use the 'test' and 'install' rake tasks.
+* Updates to the MANIFEST, README and uptime.txt files.
+
+== 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,13 @@
+* CHANGES
+* MANIFEST
+* Rakefile
+* README
+* install.rb
+* sys-uptime.gemspec
+* doc/uptime.txt
+* examples/test.rb
+* ext/extconf.rb
+* ext/sys/uptime.c
+* lib/sys/linux.rb
+* lib/sys/windows.rb
+* test/test_sys_uptime.rb

data/README

@@ -0,0 +1,14 @@
+= 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.
+   A C compiler, except for MS Windows.
+
+= Installation
+   rake test (optional)
+   rake install (non-gem) or rake install_gem (gem).
+
+== Notes
+   For additional documentation see doc/uptime.txt.

data/doc/uptime.txt

@@ -0,0 +1,99 @@
+== 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
+Uptime::Error
+   Raised if something goes wrong. On Unix, this would likely mean a
+   failure of the times() function. That would be highly unusual.
+   
+   On Windows, it probably means you failed to connect to WMI properly. The
+   mostly likely reason would be that the WMI service wasn't running.
+    
+== 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-2008, 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 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.
+
+== 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 nospam at gmail dot com
+   imperator on IRC (Freenode)
+    
+== See Also
+   uptime

data/lib/sys/uptime.rb

@@ -0,0 +1,100 @@
+# The Sys module serves as a namespace only.
+module Sys
+   
+   # The Uptime class encapsulates various bits of information regarding your
+   # system's uptime, including boot time.
+   class Uptime
+      
+      # Error typically raised in one of the Uptime methods should fail.
+      class Error < StandardError; end
+
+      # The version of this library.
+      VERSION = '0.5.2'
+
+      @@file = '/proc/uptime'
+
+      # Returns the total number of seconds of uptime.
+      #
+      # Example:
+      #
+      #    Sys::Uptime.seconds # => 118800
+      #
+      def self.seconds
+         begin
+            IO.readlines(@@file).to_s.split.first.to_i
+         rescue Exception => err
+            raise Error, err
+         end
+      end
+
+      # Returns the total number of minutes of uptime.
+      #
+      # Example:
+      #
+      #    Sys::Uptime.minutes # => 678
+      #
+      def self.minutes
+         self.seconds / 60
+      end
+
+      # Returns the total number of hours of uptime.
+      #
+      # Example:
+      #
+      #    Sys::Uptime.hours # => 31
+      #
+      def self.hours
+         self.minutes / 60
+      end
+
+      # Returns the total number of days of uptime.
+      #
+      # Example:
+      #
+      #    Sys::Uptime.days # => 2
+      #
+      def self.days
+         self.hours / 24
+      end
+
+      # Returns the uptime as a colon separated string, including days,
+      # hours, minutes and seconds.
+      #
+      # Example:
+      #
+      #    Sys::Uptime.uptime # => "1:9:24:57"
+      #
+      def self.uptime
+         seconds = self.seconds
+         days    = seconds / 86400
+         seconds -= days * 86400
+         hours   = seconds / 3600
+         seconds -= hours * 3600
+         minutes = seconds / 60
+         seconds -= minutes * 60
+
+         "#{days}:#{hours}:#{minutes}:#{seconds}"
+      end
+
+      # Returns the uptime as a four element array, including days, hours,
+      # minutes and seconds.
+      #
+      # Example:
+      #
+      #    Sys::Uptime.dhms # => [1,9,24,57]
+      #
+      def self.dhms
+         self.uptime.split(":")
+      end
+
+      # Returns the time the system was booted as a Time object.
+      #
+      # Example:
+      #
+      #    Sys::Uptime.boot_time
+      #
+      def self.boot_time
+         Time.now - self.seconds
+      end
+   end
+end

data/test/test_sys_uptime.rb

@@ -0,0 +1,65 @@
+#####################################################################
+# tc_uptime.rb
+#
+# Test suite for sys-uptime. This should generally be run via the
+# 'rake test' task, since it handles the pre-setup code for you.
+#####################################################################
+require 'sys/uptime'
+require 'test/unit'
+include Sys
+
+class TC_Uptime < Test::Unit::TestCase
+   def test_version
+      assert_equal('0.5.2', 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
+
+   def test_uptime_error
+      assert_kind_of(StandardError, Uptime::Error.new)
+   end
+end

metadata

@@ -0,0 +1,61 @@
+--- !ruby/object:Gem::Specification 
+name: sys-uptime
+version: !ruby/object:Gem::Version 
+  version: 0.5.2
+platform: x86-linux
+authors: 
+- Daniel J. Berger
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-12-13 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: A Ruby interface for getting system uptime information.
+email: djberg96@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- CHANGES
+- README
+- MANIFEST
+- doc/uptime.txt
+files: 
+- doc/uptime.txt
+- test/test_sys_uptime.rb
+- CHANGES
+- README
+- MANIFEST
+- lib/sys/uptime.rb
+has_rdoc: true
+homepage: http://www.rubyforge.org/projects/sysutils
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: 1.8.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.1
+signing_key: 
+specification_version: 2
+summary: A Ruby interface for getting system uptime information.
+test_files: 
+- test/test_sys_uptime.rb