netsnmp 0.6.0 → 0.6.3

data/sig/pdu.rbs

@@ -3,43 +3,42 @@ module NETSNMP
 
   class PDU
 
-    # type pdu_options = {
-    #   headers: [snmp_version?, String?],
-    #   ?request_id: String,
-    #   ?error_status: Integer,
-    #   ?error_index: Integer,
-    #   ?varbinds: Array[varbind_options]
-    # }
+    MAXREQUESTID: Integer
 
     attr_reader varbinds: Array[Varbind]
     attr_reader type: Integer
-    attr_reader version: snmp_version
-    attr_reader community: String
+    attr_reader version: Integer
+    attr_reader community: String?
     attr_reader request_id: Integer
 
-    def self.decode: (String der) -> PDU
-                   | (OpenSSL::ASN1::ASN1Data der) -> PDU
+    @error_index: Integer
+    @error_status: Integer
 
-    def self.build: (pdu_type, **untyped) -> PDU
+    def self.decode: (String | OpenSSL::ASN1::ASN1Data der, **untyped vars) -> instance
+
+    def self.build: (pdu_type, **untyped) -> instance
 
 
     def to_asn: () -> OpenSSL::ASN1::ASN1Data
 
     def to_der: () -> String
 
-    def add_varbind: (oid: oid, **varbind_options) -> void
+    def to_hex: () -> String
+
+    def add_varbind: (oid: String, **untyped varbind_options) -> void
     alias << add_varbind
 
     private
 
     def initialize: (
       type: Integer,
-      headers: [snmp_version?, String?],
+      version: Integer,
+      community: String?,
       ?request_id: Integer,
       ?error_status: Integer,
       ?error_index: Integer,
       ?varbinds: Array[varbind_options]
-    ) -> untyped
+    ) -> void
 
     def encode_headers_asn: () -> [OpenSSL::ASN1::Integer, OpenSSL::ASN1::OctetString]
 

data/sig/scoped_pdu.rbs

@@ -1,14 +1,19 @@
 module NETSNMP
   class ScopedPDU < PDU
-    attr_reader engine_id: String
-    attr_reader auth_param: String?
-    attr_reader security_level: Integer?
+    attr_reader engine_id: String?
+    attr_reader auth_param: String
+    attr_reader security_level: Integer
+
+    @context: String?
 
     private
 
     def initialize: (
       type: Integer,
-      headers: [String?, String?],
+      ?auth_param: String,
+      ?security_level: Integer,
+      ?engine_id: String,
+      ?context: String,
       **untyped
     ) -> void
 

data/sig/security_parameters.rbs

@@ -1,29 +1,30 @@
 module NETSNMP
   class SecurityParameters
-    prepend Loggable
+    include Loggable
 
-    type security_level = :noauth | :auth_no_priv | :auth_priv | 0 | 1 | 3 | nil
+    type security_level = 0 | 1 | 3
 
-    type auth_protocol = :md5 | :sha | :sha256
-    type priv_protocol = :des | :aes
+    IPAD: String
+    OPAD: String
+    TIMELINESS_THRESHOLD: Integer
 
+    @auth_pass_key: String
+    @priv_pass_key: String
+    @priv_protocol: Symbol?
+    @digest: OpenSSL::Digest
+    @encryption: (Encryption::AES | Encryption::DES)?
+    @timeliness: Integer
 
-    @auth_password: String?
-    @priv_protocol: priv_protocol?
-    @priv_password: String?
-    @digest: _Authenticate?
-    @encryption: _Encrypt?
-
-    attr_reader security_level: security_level
+    attr_reader security_level: Integer
     attr_reader username: String
     attr_reader engine_id: String
-    attr_reader auth_protocol: auth_protocol?
+    attr_reader auth_protocol: Symbol?
 
     def engine_id=: (String id) -> void
 
-    def encode: (_ToAsn, salt: OpenSSL::ASN1::ASN1Data, engine_time: Integer, engine_boots: Integer) -> [OpenSSL::ASN1::ASN1Data, OpenSSL::ASN1::ASN1Data]
+    def encode: (PDU pdu, salt: OpenSSL::ASN1::ASN1Data, engine_time: Integer, engine_boots: Integer) -> [OpenSSL::ASN1::ASN1Data, OpenSSL::ASN1::ASN1Data]
 
-    def decode: (OpenSSL::ASN1::ASN1Data | String der, salt: OpenSSL::ASN1::ASN1Data | String, engine_time: Integer, engine_boots: Integer, ?security_level: Integer?) -> OpenSSL::ASN1::ASN1Data
+    def decode: (OpenSSL::ASN1::ASN1Data | String der, salt: String, engine_time: Integer, engine_boots: Integer, ?security_level: Integer) -> OpenSSL::ASN1::ASN1Data
 
     def sign: (String message) -> String?
 
@@ -36,23 +37,28 @@ module NETSNMP
     def initialize: (
       username: String,
       ?engine_id: String,
-      ?security_level: security_level?,
-      ?auth_protocol: auth_protocol?,
-      ?auth_password: String?,
-      ?priv_protocol: priv_protocol?,
-      ?priv_password: String?,
-    ) -> untyped
-
+      ?security_level: Integer | :noauth | :auth_no_priv | :auth_priv | nil,
+      ?auth_protocol: Symbol | nil,
+      ?auth_password: String | nil,
+      ?priv_protocol: Symbol | nil,
+      ?priv_password: String | nil,
+      **untyped options
+    ) -> void
+
+    @auth_key: String
     def auth_key: () -> String
 
+    @priv_key: String
     def priv_key: () -> String
 
-    def check_parameters: () -> void
-
     def localize_key: (String key) -> String
 
     def passkey: (String password) -> String
 
+    def digest: () -> OpenSSL::Digest
+
+    def encryption: () -> (Encryption::AES | Encryption::DES)?
+
     def authorizable?: () -> bool
   end
 end

data/sig/session.rbs

@@ -1,8 +1,11 @@
 module NETSNMP
   class Session
-    prepend Loggable
+    include Loggable
+
+    TIMEOUT: Integer
 
     @transport: _Transport
+    @proxy: bool?
     @version: 0 | 1 | 3
     @community: String?
 
@@ -15,18 +18,30 @@ module NETSNMP
     private
 
     def initialize: (?version: snmp_version, ?community: String, **untyped) -> untyped
-   
+
     def validate: (?host: String?, ?port: Integer, ?proxy: _Transport, ?timeout: Integer, **untyped) -> void
 
     class Transport
-      def initialize: (String host, Integer port, timeout: Integer) -> untyped
+      MAXPDUSIZE: Integer
+
+      @socket: UDPSocket
+      @destaddr: String
+      @timeout: Integer
+
       def close: () -> void
-      def send: (String payload) -> String
-      def write: (String) -> void
-      def recv: () -> void
+
+      def send: (String pdu_der) -> String
+
+      def write: (String data) -> void
+
+      def recv: (?Integer size) -> String
 
       private
 
+      def initialize: (String host, Integer port, timeout: Integer) -> void
+
+      def perform_io: [U] { () -> U } -> U
+
       def wait: (:wait_readable | :wait_writable) -> void
     end
   end

data/sig/timeticks.rbs

@@ -2,6 +2,25 @@ module NETSNMP
   class Timetick < Numeric
     @ticks: Integer
 
+    def to_i: () -> Integer
+
     def to_asn: () -> OpenSSL::ASN1::ASN1Data
+
+    def coerce: (Integer ticks) -> [instance, instance]
+
+    def <=>: (_ToI other) -> Integer?
+    def +: (_ToI other) -> instance
+    def -: (_ToI other) -> instance
+    def *: (_ToI other) -> instance
+    def /: (_ToI other) -> instance
+
+    private
+
+    def initialize: (Integer ticks) -> untyped
+
+    def days_since: () -> Rational
+    def hours_since: (Rational days) -> Rational
+    def minutes_since: (Rational hours) -> Rational
+    def milliseconds_since: (Rational minutes) -> Rational
   end
 end

data/sig/v3_session.rbs

@@ -3,11 +3,12 @@ module NETSNMP
 
     def build_pdu: (pdu_type, *untyped) -> ScopedPDU
 
-    def send: (ScopedPDU pdu) -> ScopedPDU
-    		| (ScopedPDU pdu) -> [PDU, String, Integer, Integer]
+    def send: (ScopedPDU pdu) -> (PDU | [PDU, String, Integer, Integer])
 
     private
 
+    def validate: (**untyped options) -> void
+
     def encode: (ScopedPDU) -> String
 
     def initialize: (?context: String, **untyped) -> untyped

data/sig/varbind.rbs

@@ -1,5 +1,6 @@
 module NETSNMP
-  type varbind_options = untyped
+  type varbind_options = {oid: String, value: Varbind::varbind_value }
+                       | {oid: String, value: Varbind::varbind_value, type: oid_type}
 
   class Varbind
 
@@ -8,6 +9,8 @@ module NETSNMP
     attr_reader oid: String
     attr_reader value: oid_value
 
+    @type: oid_type?
+
     def to_asn: () -> OpenSSL::ASN1::Sequence
 
     def to_der: () -> String
@@ -15,7 +18,15 @@ module NETSNMP
     def convert_val: (varbind_value) -> oid_value
 
 
-    def convert_to_asn: (oid_type, oid_value) -> OpenSSL::ASN1::ASN1Data
+    def convert_to_asn: (:ip_address, Integer) -> OpenSSL::ASN1::ASN1Data
+                      | (:counter32, Integer) -> OpenSSL::ASN1::ASN1Data
+                      | (:counter64, Integer) -> OpenSSL::ASN1::ASN1Data
+                      | (:uinteger, Integer) -> OpenSSL::ASN1::ASN1Data
+                      | (:gauge, Integer) -> OpenSSL::ASN1::ASN1Data
+                      | (:timetick, Integer) -> OpenSSL::ASN1::ASN1Data
+                      | (:opaque, Integer) -> OpenSSL::ASN1::ASN1Data
+                      | (:nsap, Integer) -> OpenSSL::ASN1::ASN1Data
+                      | (oid_type, oid_value) -> OpenSSL::ASN1::ASN1Data
 
     def convert_application_asn: (OpenSSL::ASN1::ASN1Data asn) -> oid_value
 

data/spec/client_spec.rb

@@ -56,14 +56,14 @@ RSpec.describe NETSNMP::Client do
       let(:next_result) { "San Francisco, California, United States" }
       let(:walk_result) do
         {
-          "1.3.6.1.2.1.1.1.0" =>  "Linux zeus 4.8.6.5-smp #2 SMP Sun Nov 13 14:58:11 CDT 2016 i686",
-          "1.3.6.1.2.1.1.2.0" =>  "1.3.6.1.4.1.8072.3.2.10",
-          "1.3.6.1.2.1.1.3.0" =>  /Timeticks: \(\d+\) \d+ days, \d+:\d+:\d+\.\d+/,
-          "1.3.6.1.2.1.1.4.0" =>  "SNMP Laboratories, info@snmplabs.com",
-          "1.3.6.1.2.1.1.5.0" =>  "zeus.snmplabs.com (you can change this!)",
-          "1.3.6.1.2.1.1.6.0" =>  "San Francisco, California, United States",
-          "1.3.6.1.2.1.1.7.0" =>  "72",
-          "1.3.6.1.2.1.1.8.0" =>  /Timeticks: \(\d+\) \d+ days, \d+:\d+:\d+\.\d+/
+          "1.3.6.1.2.1.1.1.0" => "Linux zeus 4.8.6.5-smp #2 SMP Sun Nov 13 14:58:11 CDT 2016 i686",
+          "1.3.6.1.2.1.1.2.0" => "1.3.6.1.4.1.8072.3.2.10",
+          "1.3.6.1.2.1.1.3.0" => /Timeticks: \(\d+\) \d+ days, \d+:\d+:\d+\.\d+/,
+          "1.3.6.1.2.1.1.4.0" => "SNMP Laboratories, info@snmplabs.com",
+          "1.3.6.1.2.1.1.5.0" => "zeus.snmplabs.com (you can change this!)",
+          "1.3.6.1.2.1.1.6.0" => "San Francisco, California, United States",
+          "1.3.6.1.2.1.1.7.0" => "72",
+          "1.3.6.1.2.1.1.8.0" => /Timeticks: \(\d+\) \d+ days, \d+:\d+:\d+\.\d+/
         }
       end
       let(:set_oid_result) { 43 }

data/spec/pdu_spec.rb

@@ -11,7 +11,8 @@ RSpec.describe NETSNMP::PDU do
 
   describe "#to_der" do
     let(:pdu_get) do
-      described_class.build(:get, headers: [0, "public"],
+      described_class.build(:get, version: 0,
+                                  community: "public",
                                   request_id: 16170)
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: netsnmp
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.6.3
 platform: ruby
 authors:
 - Tiago Cardoso
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-07-22 00:00:00.000000000 Z
+date: 2022-04-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: parslet
@@ -56,13 +56,16 @@ files:
 - lib/netsnmp/varbind.rb
 - lib/netsnmp/version.rb
 - sig/client.rbs
+- sig/encryption/aes.rbs
+- sig/encryption/des.rbs
+- sig/errors.rbs
+- sig/extensions.rbs
 - sig/loggable.rbs
 - sig/message.rbs
 - sig/mib.rbs
 - sig/mib/parser.rbs
 - sig/netsnmp.rbs
 - sig/oid.rbs
-- sig/openssl.rbs
 - sig/pdu.rbs
 - sig/scoped_pdu.rbs
 - sig/security_parameters.rbs
@@ -88,6 +91,7 @@ licenses:
 - Apache-2.0
 metadata:
   allowed_push_host: https://rubygems.org/
+  rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -104,7 +108,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements:
 - net-snmp
-rubygems_version: 3.2.15
+rubygems_version: 3.2.32
 signing_key:
 specification_version: 4
 summary: SNMP Client library

data/sig/openssl.rbs

@@ -1,20 +0,0 @@
-module OpenSSL
-  module ASN1
-    class ASN1Data
-    end
-    class ObjectId < ASN1Data
-    end
-    class Primitive < ASN1Data
-    end
-    class Integer < ASN1Data
-    end
-    class OctetString < ASN1Data
-    end
-    class Sequence < ASN1Data
-    end
-  end
-end
-
-interface _ToAsn
-  def to_asn: () -> OpenSSL::ASN1::ASN1Data
-end