snmp4em 0.2.1 → 0.3

metadata

@@ -1,87 +1,113 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: snmp4em
-version: !ruby/object:Gem::Version 
-  hash: 21
-  prerelease: false
-  segments: 
-  - 0
-  - 2
-  - 1
-  version: 0.2.1
+version: !ruby/object:Gem::Version
+  version: '0.3'
+  prerelease: 
 platform: ruby
-authors: 
+authors:
 - Norman Elton
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2010-05-17 00:00:00 -04:00
-default_executable: 
-dependencies: []
-
-description: A high-performance SNMP engine built on EventMachine and Ruby-SNMP, supporting SNMPv1 and SNMPv2 operations
+date: 2012-02-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: snmp
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.0.2
+- !ruby/object:Gem::Dependency
+  name: eventmachine
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+description: A high-performance SNMP engine built on EventMachine and Ruby-SNMP
 email: normelton@gmail.com
 executables: []
-
 extensions: []
-
-extra_rdoc_files: 
-- README
-files: 
+extra_rdoc_files:
+- README.rdoc
+files:
+- Gemfile
+- README.rdoc
+- Rakefile
 - lib/snmp4em.rb
-- lib/snmp4em/common.rb
+- lib/snmp4em/common_requests.rb
+- lib/snmp4em/extensions.rb
+- lib/snmp4em/extensions/snmp/integer.rb
+- lib/snmp4em/extensions/snmp/ip_address.rb
+- lib/snmp4em/extensions/snmp/null.rb
+- lib/snmp4em/extensions/snmp/object_id.rb
+- lib/snmp4em/extensions/snmp/octet_string.rb
+- lib/snmp4em/extensions/snmp/response_error.rb
 - lib/snmp4em/handler.rb
+- lib/snmp4em/manager.rb
 - lib/snmp4em/requests/snmp_get_request.rb
 - lib/snmp4em/requests/snmp_getbulk_request.rb
 - lib/snmp4em/requests/snmp_getnext_request.rb
 - lib/snmp4em/requests/snmp_set_request.rb
 - lib/snmp4em/requests/snmp_walk_request.rb
 - lib/snmp4em/snmp_request.rb
-- lib/snmp4em/snmp_connection.rb
-- lib/snmp4em/snmp_v1.rb
-- lib/snmp4em/snmp_v2.rb
+- lib/snmp4em/snmp_v2c_requests.rb
 - snmp4em.gemspec
+- spec/models/test_message.rb
+- spec/models/test_request.rb
+- spec/models/test_response.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+- spec/unit/handler_spec.rb
+- spec/unit/manager_spec.rb
 - Manifest
-- README
-has_rdoc: true
 homepage: http://github.com/normelton/snmp4em
 licenses: []
-
 post_install_message: 
-rdoc_options: 
+rdoc_options:
 - --line-numbers
 - --inline-source
 - --title
 - Snmp4em
 - --main
-- README
-require_paths: 
+- README.rdoc
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 11
-      segments: 
-      - 1
-      - 2
-      version: "1.2"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '1.2'
 requirements: []
-
 rubyforge_project: snmp4em
-rubygems_version: 1.3.7
+rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
 summary: A high-performance SNMP engine built on EventMachine and Ruby-SNMP
 test_files: []
-

data/lib/snmp4em/common.rb

@@ -1,39 +0,0 @@
-module SNMP #:nodoc:
-  class Null #:nodoc:
-    class << self
-      def rubify
-        nil
-      end
-    end
-  end
-  
-  class OctetString #:nodoc:
-    alias :rubify :to_s
-  end
-  
-  class Integer #:nodoc:
-    alias :rubify :to_i
-  end
-  
-  class ObjectId #:nodoc:
-    alias :rubify :to_s
-  end
-  
-  class IpAddress #:nodoc:
-    alias :rubify :to_s
-  end
-  
-  class ResponseError
-    attr_reader :error_status
-    alias :rubify :error_status #:nodoc:
-    
-    def initialize(error_status) #:nodoc:
-      @error_status = error_status
-    end
-    
-    # String representation of this error
-    def to_s
-      @error_status.to_s
-    end
-  end
-end

data/lib/snmp4em/snmp_connection.rb

@@ -1,43 +0,0 @@
-# The SNMP4EM library 
-
-module SNMP4EM
-  class SnmpConnection
-    @pending_requests = []
-    @socket = nil
-    
-    class << self
-      attr_reader :pending_requests
-      attr_reader :socket
-      
-      def init_socket #:nodoc:
-        if @socket.nil?
-          @socket = EM::open_datagram_socket("0.0.0.0", 0, Handler)
-        end
-      end
-    end
-    
-    attr_reader :host, :port, :timeout, :retries
-    
-    # Creates a new object to communicate with SNMPv1 agents. Optionally pass in the following parameters:
-    # *  _host_ - IP/hostname of remote agent (default: 127.0.0.1)
-    # *  _port_ - UDP port on remote agent (default: 161)
-    # *  _community_ - Community string to use (default: public)
-    # *  _community_ro_ - Read-only community string to use for get/getnext/walk operations (default: public)
-    # *  _community_rw_ - Read-write community string to use for set operations (default: public)
-    # *  _timeout_ - Number of seconds to wait before a request times out (default: 1)
-    # *  _retries_ - Number of retries before failing (default: 3)
-    
-    def initialize(args = {})
-      @host         = args[:host]         || "127.0.0.1"
-      @port         = args[:port]         || 161
-      @timeout      = args[:timeout]      || 1
-      @retries      = args[:retries]      || 3
-      
-      self.class.init_socket
-    end
-    
-    def send(message) #:nodoc:
-      self.class.socket.send_datagram message.encode, @host, @port
-    end
-  end
-end

data/lib/snmp4em/snmp_v2.rb

@@ -1,104 +0,0 @@
-# The SNMP4EM library 
-
-module SNMP4EM
-  class SNMPv2 < SnmpConnection
-    attr_reader :community_ro, :community_rw
-    
-    # Creates a new object to communicate with SNMPv1 agents. Optionally pass in the following parameters:
-    # *  _host_ - IP/hostname of remote agent (default: 127.0.0.1)
-    # *  _port_ - UDP port on remote agent (default: 161)
-    # *  _community_ - Community string to use (default: public)
-    # *  _community_ro_ - Read-only community string to use for get/getnext/walk operations (default: public)
-    # *  _community_rw_ - Read-write community string to use for set operations (default: public)
-    # *  _timeout_ - Number of seconds to wait before a request times out (default: 1)
-    # *  _retries_ - Number of retries before failing (default: 3)
-    
-    def initialize(args = {})
-      super(args)
-      
-      @community_ro = args[:community_ro] || args[:community] || "public"
-      @community_rw = args[:community_rw] || args[:community] || "public"
-    end
-    
-    # Sends an SNMP-GET request to the remote agent for all OIDs specified in the _oids_ array. Returns a SnmpGetRequest object,
-    # which implements EM::Deferrable. From there, implement a callback/errback to fetch the result. On success, the result will be
-    # a hash, mapping requested OID values to results.
-    # 
-    # Optional arguments can be passed into _args_, including:
-    # *  _return_raw_ - Return objects and errors as their raw SNMP types, such as SNMP::Integer instead of native Ruby integers, SNMP::OctetString instead of native Ruby strings, etc. (default: false)
- 
-    def get(oids, args = {})
-      request = SnmpGetRequest.new(self, oids, args.merge(:version => :SNMPv2c))
-      SnmpConnection.pending_requests << request
-      return request
-    end
-
-    # Sends an SNMP-GETNEXT request to the remote agent for all OIDs specified in the _oids_ array. Returns a SnmpGetRequest object,
-    # which implements EM::Deferrable. From there, implement a callback/errback to fetch the result. On success, the result will be
-    # a hash, mapping requested OID values to two-element arrays consisting of [_next_oid_ , _next_value_]. Any values that produced an
-    # error will map to a symbol representing the error.
-    # 
-    # Optional arguments can be passed into _args_, including:
-    # *  _return_raw_ - Return objects and errors as their raw SNMP types, such as SNMP::Integer instead of native Ruby integers, SNMP::OctetString instead of native Ruby strings, etc. (default: false)
-
-    def getnext(oids, args = {})
-      request = SnmpGetNextRequest.new(self, oids, args.merge(:version => :SNMPv2c))
-      SnmpConnection.pending_requests << request
-      return request
-    end
-
-    # Sends an SNMP-SET request to the remote agent for all OIDs specified in the _oids_ hash. The hash must map OID values to requested
-    # values. Values can either be specified as Ruby native strings/integers, or as SNMP-specific classes (SNMP::IpAddress, etc).
-    # Returns a SnmpSetRequest object, which implements EM::Deferrable. From there, implement a callback/errback to fetch the result.
-    # On success, the result will be a hash, mapping requested OID values to the returned value from the agent. Any values that were stored
-    # successfully will map to _true_, otherwise, the value will map to a symbol representing the error.
-    # 
-    # Optional arguments can be passed into _args_, including:
-    # *  _return_raw_ - Return error objects as SNMP::ResponseError instead of a symbol
-
-    def set(oids, args = {})
-      request = SnmpSetRequest.new(self, oids, args.merge(:version => :SNMPv2c))
-      SnmpConnection.pending_requests << request
-      return request
-    end
-
-    # Sends a series of SNMP-GETNEXT requests to simulate an SNMP "walk" operation. Given an OID prefix, the library will keep requesting the
-    # next OID until that returned OID does not begin with the requested prefix. This gives the ability to retrieve entire portions of the
-    # SNMP tree in one "operation". Multiple OID prefixes can be passed into the _oids_ array, and will be fetched in parallel. The function returns
-    # a SnmpWalkRequest object, which implements EM::Deferrable. From there, implement a callback/errback to fetch the result. On success, the
-    # result will be a hash, mapping requested OID prefixes to the returned value. Successful walks will be mapped to an array of two-element arrays,
-    # each of which consists of [_oid_ , _value_]. Unsuccessful walks will be mapped to a symbol representing the error.
-
-    # Optional arguments can be passed into _args_, including:
-    # *  _return_raw_ - Return objects and errors as their raw SNMP types, such as SNMP::Integer instead of native Ruby integers, SNMP::OctetString instead of native Ruby strings, etc. (default: false)
-    # *  _max_results_ - Maximum number of results to be returned for any single OID prefix (default: nil = unlimited)
-
-    def walk(oids, args = {})
-      request = SnmpWalkRequest.new(self, oids, args.merge(:version => :SNMPv2c))
-      SnmpConnection.pending_requests << request
-      return request
-    end
-    
-    # Sends an SNMPv2 GET-BULK request to fetch multiple OID-value pairings simultaneously. This produces similar results to an SNMP-WALK using a single
-    # request/response transaction (SNMP-WALK is actually an inefficient series of GET-NEXTs). Multiple OIDs can be passed into the _oids_ array. Two
-    # additional parameters control how this list is processed. Setting the parameter _nonrepeaters_ to value _N_ indicates that the first _N_ OIDs will
-    # fetch a single value. This is identical to running a single GET-NEXT for the OID. Any remaining OIDs will fetch multiple values. The number of values
-    # fetched is controlled by the parameter _maxrepetitions_. The function returns a SnmpGetBulkRequest object, which implements EM::Deferrable. From there,
-    # implement a callback/errback to fetch the result. On success, the result will be a hash, mapping requested OID prefixes to the returned value.
-    # Successful fetches will be mapped to an array of two-element arrays, each of which consists of [_oid_ , _value_]. Unsuccessful fetches will be mapped to a
-    # symbol representing the error.
-    
-    # For more information, see http://tools.ietf.org/html/rfc1905#section-4.2.3
-    
-    # Optional arguments can be passed into _args_, including:
-    # *  _return_raw_ - Return objects and errors as their raw SNMP types, such as SNMP::Integer instead of native Ruby integers, SNMP::OctetString instead of native Ruby strings, etc. (default: false)
-    # *  _nonrepeaters_ - Number of OIDs passed to which exactly one result will be returned (default is 0)
-    # *  _maxrepetitions_ - Number of OID-value pairs to be returned for each OID (default is 10)
-
-    def getbulk(oids, args = {})
-      request = SnmpGetBulkRequest.new(self, oids, args.merge(:version => :SNMPv2c))
-      SnmpConnection.pending_requests << request
-      return request
-    end
-  end
-end