snmp 0.6.1 → 1.0.0

data/README

@@ -9,13 +9,13 @@ that Ruby can run.
 
 See snmplib.rubyforge.org[http://snmplib.rubyforge.org/] for more info.
 
-Version 0.6.0 of this software supports the following:
+Version 1.0.0 of this software supports the following:
 
 * The GetRequest, GetNextRequest, GetBulkRequest, SetRequest, Response
   SNMPv1_Trap, SNMPv2_Trap, and Inform PDUs
 * All of the ASN.1 data types defined by SNMPv1 and SNMPv2c
 * Sending informs and v1 and v2 traps
-* Trap handling for v1 and v2 traps
+* Trap handling for informs and v1 and v2 traps
 * Symbolic OID values (ie. "ifTable" instead of "1.3.6.1.2.1.2.2") as   
   parameters to the SNMP.Manager API
 * Includes symbol data files for all current IETF MIBs 
@@ -25,11 +25,18 @@ examples below for more details.
 
 == Changes
 
-Changes for version 0.6.1:
-
-* Made decoding of unsigned integers more liberal, so that they are interpreted as positive integers even if the high bit is set.
-* Added support for receiving InformRequest PDUs from the TrapListener class.
-
+Changes for version 1.0.0:
+
+* Added to_s method to TimeTicks.  Displays time in human-readable form
+  instead of just a number.  The to_i method can still be used to get the
+  number of ticks.
+
+Changes for version 0.6.1:
+
+* Made decoding of unsigned integers more liberal, so that they are  
+  interpreted as positive integers even if the high bit is set.
+* Added support for receiving InformRequest PDUs from the TrapListener class.
+
 Changes for version 0.6.0:
 
 * Added support for sending informs and traps for SNMPv2c and traps for
@@ -102,19 +109,19 @@ formats.
 From the .gem file you can install using
 RubyGems[http://rubyforge.org/projects/rubygems].
 
-  gem install snmp-0.6.0.gem
+  gem install snmp-1.0.0.gem
 
 From the .tgz or .zip file you can install using
 setup.rb[http://i.loveruby.net/en/prog/setup.html].  Uncompress the archive
 and then run setup.
 
-  cd snmp-0.6.0
+  cd snmp-1.0.0
   ruby setup.rb (may require root privilege)  
 
 == Testing
 
 This library has received limited testing:
-* The unit tests have been executed with Ruby 1.8.3 on Mac OS X 10.4.
+* The unit tests have been executed with Ruby 1.8.4 on Mac OS X 10.4.
 * Basic interoperability testing has been done with the
   net-snmp[http://www.net-snmp.org/] tools.
 

data/Rakefile

@@ -9,7 +9,7 @@ Rake::TestTask.new do |test|
 end
 
 # package target
-PKG_VERSION = '0.6.1'
+PKG_VERSION = '1.0.0'
 PKG_FILES = FileList[
     'Rakefile',
     'README',

data/lib/snmp/varbind.rb

@@ -355,6 +355,24 @@ class TimeTicks < UnsignedInteger
     def encode
         encode_tagged_integer(TimeTicks_TAG, @value)
     end
+    
+    def to_s
+        days, remainder = @value.divmod(8640000)
+        hours, remainder = remainder.divmod(360000)
+        minutes, remainder = remainder.divmod(6000)
+        seconds, hundredths = remainder.divmod(100)
+        case
+            when days < 1
+                sprintf('%02d:%02d:%02d.%02d',
+                        hours, minutes, seconds, hundredths)
+            when days == 1
+                sprintf('1 day, %02d:%02d:%02d.%02d',
+                        hours, minutes, seconds, hundredths)
+            when days > 1
+                sprintf('%d days, %02d:%02d:%02d.%02d',
+                        days, hours, minutes, seconds, hundredths)
+        end
+    end
 end
 
 class Opaque < OctetString

data/test/test_varbind.rb

@@ -319,5 +319,24 @@ class TestVarBind < Test::Unit::TestCase
             assert_equal(type.asn1_type, type.to_s)
         end
     end
-    
+
+    def test_timeticks
+        assert_equal("00:00:00.00", TimeTicks.new(0).to_s)
+        assert_equal("00:00:00.01", TimeTicks.new(1).to_s)
+        assert_equal("00:00:01.00", TimeTicks.new(100).to_s)
+        assert_equal("00:01:00.00", TimeTicks.new(60 * 100).to_s)
+        assert_equal("01:00:00.00", TimeTicks.new(60 * 60 * 100).to_s)
+        assert_equal("23:59:59.99", TimeTicks.new(24 * 60 * 60 * 100 - 1).to_s)
+        assert_equal("1 day, 00:00:00.00", TimeTicks.new(24 * 60 * 60 * 100).to_s)
+        assert_equal("1 day, 23:59:59.99", TimeTicks.new(48 * 60 * 60 * 100 - 1).to_s)
+        assert_equal("2 days, 00:00:00.00", TimeTicks.new(48 * 60 * 60 * 100).to_s)
+        assert_equal("497 days, 02:27:52.95", TimeTicks.new(4294967295).to_s)
+        assert_equal(4294967295, TimeTicks.new(4294967295).to_i)
+        assert_raise(ArgumentError) {
+            TimeTicks.new(4294967296)
+        }
+        assert_raise(ArgumentError) {
+            TimeTicks.new(-1)
+        }
+    end
 end

metadata

@@ -3,8 +3,8 @@ rubygems_version: 0.8.11
 specification_version: 1
 name: snmp
 version: !ruby/object:Gem::Version 
-  version: 0.6.1
-date: 2006-02-15 00:00:00 -05:00
+  version: 1.0.0
+date: 2006-03-02 00:00:00 -05:00
 summary: A Ruby implementation of SNMP (the Simple Network Management Protocol).
 require_paths: 
 - lib