hotwired 0.0.1

data/lib/hotwired/cli.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+module Hotwired
+  class CLI
+    require "slop"
+    require_relative "../hotwired"
+
+    class NoConfig < HotwiredError; end
+
+    MAX_DELETE = 1
+
+    # 脚本调度函数入口
+    def run
+      # 检查 CLI 是否携带相关参数
+      if @opts[:poll]
+        Log.debug "Start hotwired with specify #{@opts[:poll]}"
+        Hotwired.new(cidr: @opts[:poll]).run
+      elsif @opts[:remove]
+        Log.debug "Start hotwired remove job"
+        remove_records @opts[:remove]
+      elsif @opts["purge-old"]
+        Log.debug "Start hotwired purge-old job"
+        remove_old @opts["purge-old"]
+      else
+        # 缺省的执行方式
+        Log.debug "Start hotwired with default params!"
+        Hotwired.new.run
+      end
+    end
+
+    # 类对象实例化入口函数
+    def initialize
+      args, @opts = opts_parse
+      @arg        = args.shift
+      CFG.debug   = true if @opts[:debug]
+      raise NoConfig, "edit ~/.config/hotwired/config" if CONFIG.create
+    end
+
+    # 解析命令行脚本接收参数
+    def opts_parse
+      opts = Slop.parse do |o|
+        # banner "Usage: hotwired [options] [argument]"
+        o.on "-h", "--help", "show usage" do
+          puts o
+          exit
+        end
+        o.bool "-d", "--debug", "Debugging on"
+        o.string "-p", "--poll", "Poll CIDR [argument]"
+        o.bool "-r", "--remove", "Remove [argument] from DB"
+        o.string "-m", "--max-delete", "Maximum number to delete, default #{MAX_DELETE}"
+        o.bool "-o", "--purge-old", "Remove records order than [argument] days"
+        o.bool "-s", "--simulate", "Simulate, do not change DB"
+      end
+      [opts.arguments, opts]
+    end
+
+    # 删除表记录
+    def remove_records(name)
+      Log.warn "Remove record #{name}"
+      DB.new
+      delete_records DB::Device.filter(Sequel.like(:ptr, "%#{name}%")).all
+    end
+
+    # 删除历史数据 【 N*天之前 】
+    def remove_old(days)
+      Log.warn "Remove #{days} days ago data"
+      old = (Time.now.utc - days.to_i * 24 * 60 * 60)
+      DB.new
+      delete_records DB::Device.filter { :last_seen < old }.all
+    end
+
+    # 删除某些主机数据：接收数组对象
+    def delete_records(devs)
+      Log.debug "delete_records #{devs.size}"
+      max_del = @opts["max-delete"] ? @opts["max-delete"] : MAX_DELETE
+      # 判断当前表已有数据条目和期望删除条目是否匹配
+      if devs.size > max_del.to_i
+        puts "Too many matching devices:"
+        devs.each do |dev|
+          puts "  %s (%s)" % [dev.ptr, dev.ip]
+        end
+        puts "Be more specific"
+      else
+        puts "Deleting records:"
+        devs.each do |dev|
+          puts "  %s (%s)" % [dev.ptr, dev.ip]
+          dev.delete unless @opts[:simulate]
+        end
+      end
+    end
+  end
+end

data/lib/hotwired/config.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Hotwired
+  require "strada"
+  require "fileutils"
+
+  class Config
+    ROOT  = File.join ENV["HOME"], ".config", "hotwired"
+    CRASH = File.join ROOT, "crash"
+  end
+
+  FileUtils.mkdir_p Config::ROOT
+  CONFIG = Strada.new name: "hotwired", load: "false", key_to_s: true
+
+  CONFIG.default.community = "cisco"
+  CONFIG.default.db        = File.join Config::ROOT, "hotwired.db"
+  CONFIG.default.poll      = %w( 192.168.8.0/24 )
+  CONFIG.default.ignore    = %w( 192.168.8.100 )
+  CONFIG.default.mgmt      = %w( lo0.0 loopback0 vlan2 )
+  CONFIG.default.threads   = 50
+  CONFIG.default.timeout   = 0.25
+  CONFIG.default.retries   = 2
+  CONFIG.default.log       = File.join Config::ROOT, "log"
+  CONFIG.default.debug     = true
+
+  # 加载初始化配置
+  CONFIG.load
+  CFG       = CONFIG.cfg
+
+  # 初始化项目日志参数
+  Log.file  = CFG.log if CFG.log
+  Log.level = CFG.debug ? Logger::INFO : Logger::DEBUG
+end

data/lib/hotwired/core.rb

@@ -0,0 +1,237 @@
+# frozen_string_literal: true
+
+# 加载项目依赖
+require_relative "log"
+require_relative "config"
+require_relative "snmp"
+require_relative "db/db"
+require_relative "model"
+
+# 加载外部依赖
+require "ipaddr"
+require "resolv"
+
+module Hotwired
+  # 类方法属性
+  class << self
+    # 实例化 Core 对象
+    def new(opts = {})
+      Core.new opts
+    end
+
+    # 轮询 host 数据
+    def poll(opts = {})
+      host = opts.delete :host
+      raise HotwiredError, "'host' not given" unless host
+      hotwire = new(opts)
+      result  = hotwire.poll Resolv.getaddress(host)
+      # 数据转储
+      hotwire.make_record result if result
+    end
+  end
+
+  # 类对象方法属性
+  class Core
+    # 类对象初始化函数入口
+    def initialize(opts = {})
+      @opts      = opts
+      @community = opts.delete(:community) || CFG.community
+    end
+
+    # 类对象外部调用函数入口
+    def run
+      # 解析变量
+      cidr = @opts.delete :cidr
+      # @output = @opts.delete :output
+
+      # 设置缺省 logger 输出
+      # unless @output
+      #   @output           = Logger.new $stdout
+      #   @output.formatter = proc { |_, _, _, msg| "#{msg}\n" }
+      # end
+
+      # 初始化变量及遍历 CIDR
+      poll, ignores = resolve_networks cidr
+      # 实例化线程和数据库联结
+      @mutex  = Mutex.new
+      @db     = DB.new
+      threads = []
+      # 线程遇到异常及时终止
+      Thread.abort_on_exception = true
+
+      # 遍历待轮询的 IPAddr
+      poll.each do |net|
+        net.to_range.each do |ip|
+          # 检查当前地址是否需要被忽略
+          next if ignores.any? { |ignore| ignore.include? ip }
+          # 清除空闲线程
+          while threads.size >= CFG.threads
+            threads.delete_if { |thread| not thread.alive? }
+            sleep 0.01
+          end
+          # 线程不够则主动添加线程
+          threads << Thread.new do
+            result = poll ip
+            @mutex.synchronize { process result } if result
+          end
+        end
+      end
+      # 激活线程，开始干活
+      threads.each { |thread| thread.join }
+    end
+
+    # 轮询单个 IP 设备信息
+    def poll(ip)
+      result = nil
+      # 实例化 SNMP 对象，批量获取相关监控数据
+      snmp = SNMP.new(ip.to_s, @community)
+      oids = snmp.dbget
+
+      if oids
+        # 早期异常拦截
+        Log.debug "SNMP::NoSuchObject #{ip}" if oids[:sysDescr] == ::SNMP::NoSuchObject
+        return nil if oids[:sysDescr] == ::SNMP::NoSuchObject
+        # 初始化变量，并尝试刷新接口描述信息
+        result = { oids: oids, ip: ip, int: "n/a" }
+        # 联机查询数据
+        index = snmp.ip2index(ip.to_s)
+        int   = snmp.ifdescr(index)
+        # 逻辑处理
+        if index
+          if int
+            result[:int] = int.downcase
+          else
+            Log.debug "no ifDescr for #{index} at #{ip}"
+          end
+        else
+          Log.debug "no ifIndex for #{ip}"
+        end
+      end
+      # 关闭 SNMP 会话并返回结果
+      snmp.close
+      result
+    end
+
+    # 新增表记录
+    def make_record(opt)
+      {
+        ip:              opt[:ip].to_s,
+        ptr:             ip2name(opt[:ip].to_s),
+        model:           Model.map(opt[:oids][:sysDescr], opt[:oids][:sysObjectID]),
+        oid_ifDescr:     opt[:int],
+        oid_sysName:     opt[:oids][:sysName],
+        oid_sysLocation: opt[:oids][:sysLocation],
+        oid_sysDescr:    opt[:oids][:sysDescr],
+        oid_sysObjectID: opt[:oids][:sysObjectID].join("."),
+      }
+    end
+
+    private
+      def process(opt)
+        opt    = normalize_opt opt
+        record = make_record opt
+        # 查询表中已有数据
+        old_by_ip, old_by_sysname = @db.old(record[:ip], record[:oid_sysName])
+
+        # unique box having non-unique sysname
+        # old_by_sysname = false if record[:oid_sysDescr].match 'Application Control Engine'
+
+        # 查无记录则需要新增
+        if (not old_by_sysname) && (not old_by_ip)
+          # all new device
+          @output.info "ptr [%s] sysName [%s] ip [%s]" % [record[:ptr], record[:oid_sysName], record[:ip]]
+          Log.info "#{record[:ip]} added"
+          @db.add record
+          # 根据 IP 可以查询到数据，但设备名称发生变化
+        elsif (not old_by_sysname) && old_by_ip
+          # IP seen, name not, device got renamed?
+          Log.info "#{record[:ip]} got renamed"
+          @db.update record, [:ip, old_by_ip[:ip]]
+          # 根据设备名称可以查询到数据，但 IP 地址发生变化
+        elsif old_by_sysname && (not old_by_ip)
+          # name exists, but IP is new, figure out if we wan to use old or new IP
+          decide_old_new record, old_by_sysname
+          # 已有记录刷新即可
+        elsif old_by_sysname && old_by_ip
+          both_seen record, old_by_sysname, old_by_ip
+        end
+      end
+
+      # 根据 IP 和设备名称均可检索到数据，需要进一步判断查询出来的记录是否完全一致
+      def both_seen(record, old_by_sysname, old_by_ip)
+        if old_by_sysname == old_by_ip
+          # no changes, updating same record
+          Log.debug "#{record[:ip]} refreshed, no channges"
+          @db.update record, [:oid_sysName, old_by_sysname[:oid_sysName]]
+        else
+          # same name seen and same IP seen, but records were not same (device got renumbered to existing node + existing node got delete?)
+          Log.warn "#{record[:ip]}, unique entries for IP and sysName in DB, updating by IP"
+          @db.update record, [:ip, old_by_ip[:ip]]
+        end
+      end
+
+      # 设备新旧记录优先级校验
+      # 新数据比旧数据优先级更高，可以理解更新可信？
+      def decide_old_new(record, old_by_sysname)
+        new_int_pref = (CFG.mgmt.index(record[:oid_ifDescr]) or 100)
+        old_int_pref = (CFG.mgmt.index(old_by_sysname[:oid_ifDescr]) or 99)
+
+        if new_int_pref < old_int_pref
+          # 原有数据优先级更高
+          # new int is more preferable than old
+          Log.info "#{record[:ip]} is replacing inferior #{old_by_sysname[:ip]}"
+          @db.update record, [:oid_sysName, old_by_sysname[:oid_sysName]]
+        elsif (new_int_pref == 100) && (old_int_pref == 99)
+          # 新老数据接口均未标注为管理口
+          # neither old or new interface is known good MGMT interface
+          if SNMP.new(old_by_sysname[:ip], @community).sysdescr
+            # 如果老IP可以检索数据，则无需更新
+            # if old IP works, don't update
+            Log.debug "#{record[:ip]} not updating, previously seen as #{old_by_sysname[:ip]}"
+          else
+            Log.info "#{record[:ip]} updating, old #{old_by_sysname[:ip]} is dead"
+            @db.update record, [:oid_sysName, old_by_sysname[:oid_sysName]]
+          end
+        elsif new_int_pref >= old_int_pref
+          # 新数据优先级高于老数据，则无需进一步处理
+          # nothing to do, we have better entry
+          Log.debug "#{record[:ip]} already seen as superior via #{old_by_sysname[:ip]}"
+        else
+          Log.error "not updating, new: #{record[:ip]}, old: #{old_by_sysname[:ip]}"
+        end
+      end
+
+      # 序列化 opt 参数
+      def normalize_opt(opt)
+        opt[:oids][:sysName].sub!(/-re[1-9]\./, "-re0.")
+        opt
+      end
+
+      # 解析 IP 关联的主机名
+      def ip2name(ip)
+        Resolv.getname ip rescue ip
+      end
+
+      # 解析 cidr
+      def resolve_networks(cidr)
+        # 如未接收外部变量则使用缺省值
+        cidr = cidr ? [cidr].flatten : CFG.poll
+
+        # 从 CIDR 中剔除排除清单
+        # 支持数组以及文本形式，数据返回包含2个数组对象的数组
+        [cidr, CFG.ignore].map do |nets|
+          if nets.respond_to? :each
+            nets.map { |net| IPAddr.new net }
+          else
+            out = []
+            File.read(nets).each_line do |net|
+              # 模糊的 IP 地址正则表达式
+              net = net.match(/^([\d.\/]+)$/)
+              out << IPAddr.new(net[1]) if net
+            end
+            out
+          end
+        end
+      end
+  end
+end

data/lib/hotwired/db/db.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Hotwired
+  class DB
+    require "sequel"
+    require "sqlite3"
+
+    # 类对象初始化函数入口
+    def initialize
+      Log.debug "Initialize Hotwired object ... "
+      @db = Sequel.sqlite(CFG.db, max_connections: 1, pool_timeout: 60)
+      create_table # unless @db.table_exists?(:devices)
+      require_relative "model"
+    end
+
+    # 新建数据库记录
+    def add(record)
+      # 添加时间戳属性
+      record[:first_seen] = record[:last_seen] = Time.now.utc
+      record[:active]     = true
+      Log.debug "adding: #{record}"
+      Device.new(record).save
+    end
+
+    # 更新数据
+    def update(record, where)
+      # 更新数据入库时间
+      record[:last_seen] = Time.now.utc
+      record[:active]    = true
+      Log.debug "updating (where: #{where}): #{record}"
+      Device[where.first.to_sym => where.last].update(record)
+    end
+
+    # 查询数据表记录信息
+    def old(ip, oid_sysname)
+      ip      = Device[ip: ip]
+      sysname = Device[oid_sysName: oid_sysname]
+      [ip, sysname]
+    end
+
+    private
+      def create_table
+        # 检查是否存在数据表结构，不存在则新建
+        @db.create_table? :devices do
+          primary_key :id
+          String :ip
+          String :ptr
+          String :model
+          String :oid_ifDescr
+          Boolean :active
+          Time :first_seen
+          Time :last_seen
+          String :oid_sysName
+          String :oid_sysLocation
+          String :oid_sysDescr
+          String :oid_sysObjectID
+        end
+        Log.debug "Creating SQLITE DB"
+      end
+  end
+end

data/lib/hotwired/db/model.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Hotwired
+  class DB
+    class Device < Sequel::Model
+    end
+  end
+end

data/lib/hotwired/log.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Hotwired
+  require "logger"
+
+  class Logger < Logger
+    def initialize(target = STDOUT)
+      super target
+      self.level = Logger::DEBUG
+    end
+
+    def file=(target)
+      @log_device = LogDevice.new target
+    end
+  end
+
+  Log = Logger.new
+end

data/lib/hotwired/model.rb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+module Hotwired
+  class Model
+    def self.map(sysDescr, sysObjectID)
+      case sysDescr
+      when /Cisco Catalyst Operating System/i
+        "catos"
+      when /Cisco Controller/
+        "aireos"
+      when /IOS XR/
+        "iosxr"
+      when /NX-OS/
+        "nxos"
+      when /JUNOS/
+        "junos"
+      when /Arista Networks EOS/
+        "eos"
+      when /IronWare/
+        "ironware"
+      when /TiMOS/
+        "timos"
+      when /ExtremeXOS/
+        "xos"
+      when /Cisco Adaptive Security Appliance/
+        "asa"
+      when /Brocade Fibre Channel Switch/
+        "fabricos"
+      when /Brocade VDX/
+        "nos"
+      when /cisco/i, /Application Control Engine/i
+        "ios"
+      when /Force10 OS/
+        "ftos"
+      when /Versatile Routing Platform/
+        "vrp"
+      when /^NetScreen/, /^SSG-\d+/
+        "screenos"
+      when /^Summit/
+        "xos"
+      when /^Alcatel-Lucent \S+ [789]\./ # aos <7 is vxworks, >=7 is linux
+        "aos7"
+      when /^AOS-W/
+        "aosw"
+      when /^Alcatel-Lucent/
+        "aos"
+      when /\s+ACOS\s+/
+        "acos"
+      when /ProCurve/ # ProCurve OS does not seem to have name?
+        "procurve"
+      when /ASAM/
+        "isam"
+      when /^\d+[A-Z]\sEthernet Switch$/
+        "powerconnect"
+      when /Ericsson IPOS/
+        "ssr"
+      when /Huawei Integrated Access Software/
+        "hias"
+      else
+        case sysObjectID
+        when Regexp.new("^" + Regexp.quote("1.3.6.1.4.1.12356."))
+          "fortios" # 1.3.6.1.4.1.12356.101.1.10004
+        when Regexp.new("^" + Regexp.quote("1.3.6.1.4.1.6486."))
+          "aos" # 1.3.6.1.4.1.6486.800.1.1.2.1.11.2.2
+        when Regexp.new("^" + Regexp.quote("1.3.6.1.4.1.6027."))
+          "ftos" # 1.3.6.1.4.1.6027.1.3.4
+        when Regexp.new("^" + Regexp.quote("1.3.6.1.4.1.1588."))
+          "fabricos " # 1.3.6.1.4.1.1588.2.1.1.1
+        when Regexp.new("^" + Regexp.quote("1.3.6.1.4.1.3224."))
+          "screenos" # 1.3.6.1.4.1.3224.1.51 (SSG) 1.16 (Netscreen 2k)
+        when Regexp.new("^" + Regexp.quote("1.3.6.1.4.1.674."))
+          "powerconnect" # 1.3.6.1.4.1.674.10895.3031
+        when Regexp.new("^" + Regexp.quote("1.3.6.1.4.1.22610."))
+          "acos" # 1.3.6.1.4.1.22610.1.3.14
+        when Regexp.new("^" + Regexp.quote(".1.3.6.1.4.1.637."))
+          "isam" # 1.3.6.1.4.1.637.61.1
+        when Regexp.new("^" + Regexp.quote(".1.3.6.1.4.1.2011."))
+          "vrp" # 1.3.6.1.4.1.2011.2.224.67 (AR1220F)
+        when Regexp.new("^" + Regexp.quote(".1.3.6.1.4.1.1588."))
+          "nos" # 1.3.6.1.4.1.1588.2.2.1.1.1.5 (VDX)
+        when Regexp.new("^" + Regexp.quote(".1.3.6.1.4.1.1916."))
+          "xos" # 1.3.6.1.4.1.1916.2.76 (X450a-48t)
+        when Regexp.new("^" + Regexp.quote("1.3.6.1.4.1.9.1.745"))
+          "asa" # 1.3.6.1.4.1.9.1.745
+        when Regexp.new("^" + Regexp.quote("1.3.6.1.4.1.20858.2.600"))
+          "casa" # 1.3.6.1.4.1.20858.2.600
+        when Regexp.new("^" + Regexp.quote("1.3.6.1.4.1.2011.2.169"))
+          "hias" # 1.3.6.1.4.1.2011.2.169
+        when Regexp.new("^" + Regexp.quote("1.3.6.1.4.1.2011.2.300"))
+          "hias" # 1.3.6.1.4.1.2011.2.300 (MA5800 OLT)
+        when Regexp.new("^" + Regexp.quote("1.3.6.1.4.1.2352.1"))
+          "ssr" # 1.3.6.1.4.1.2352.1.17 and .18
+        when Regexp.new("^" + Regexp.quote("1.3.6.1.4.1.193.218.1"))
+          "ssr" # 1.3.6.1.4.1.193.218.1.17 and .18
+        when Regexp.new("^" + Regexp.quote("1.3.6.1.4.1.11.2.3.7.11"))
+          "procurve" # Aruba switches are really HP Procurve
+        else
+          "unsupported"
+        end
+      end
+    end
+  end
+end

data/lib/hotwired/snmp.rb

@@ -0,0 +1,119 @@
+# frozen_string_literal: true
+
+module Hotwired
+  class SNMP
+    require "snmp"
+
+    class InvalidResponse < StandardError; end
+
+    # 需要遍历 oid 写入数据库的相关属性
+    DB_OID = {
+      sysDescr: "1.3.6.1.2.1.1.1.0", # 运行系统描述
+      sysObjectID: "1.3.6.1.2.1.1.2.0", # 厂商识别
+      sysName: "1.3.6.1.2.1.1.5.0", # 系统名称
+      sysLocation: "1.3.6.1.2.1.1.6.0", # 系统位置
+    }
+
+    OID      = {
+      ifDescr: "1.3.6.1.2.1.2.2.1.2", # 接口描述
+      ipCidrRouteIfIndex: "1.3.6.1.2.1.4.24.4.1.5", # addr.255.255.255.255.0.0.0.0.0
+      ipAdEntIfIndex: "1.3.6.1.2.1.4.20.1.2", # addr | 旧格式
+      ipAddressIfIndex: "1.3.6.1.2.1.4.34.1.3", # 1,2 (uni,any) . 4,16 (size) . addr | 新格式
+    }
+    UNICAST  = 1
+    IPV4     = 4
+    BULK_MAX = 30
+
+    # 类对象初始化函数入口
+    def initialize(host, community = CFG.community)
+      @snmp = ::SNMP::Manager.new(Host: host, Community: community, Timeout: CFG.timeout, Retries: CFG.retries, MibModules: [])
+    end
+
+    # 关闭会话
+    def close
+      @snmp.close
+    end
+
+    # 查询 oid 监控数据
+    # 支持多个片段拼接成一个完整的 OID 字串
+    def get(*oid)
+      oid = [oid].flatten.join(".")
+      begin
+        @snmp.get(oid).each_varbind { |vb| return vb }
+      rescue ::SNMP::RequestTimeout, Errno::EACCES
+        false
+      end
+    end
+
+    # 批量查询 oid，入参为 HASH 数据结构
+    def mget(oids = DB_OID)
+      result = {}
+      begin
+        res = @snmp.get(oids.map { |_, oid| oid })
+        # 抛出异常
+        raise InvalidResponse, "#{res.error_status} from #{@snmp.config[:host]}" unless res.error_status == :noError
+        res.each_varbind do |vb|
+          oids.each do |key, oid|
+            if vb.name.to_str == oid
+              result[key] = vb.value
+              # 找到即跳出当前循环体
+              next
+            end
+          end
+        end
+      rescue ::SNMP::RequestTimeout, Errno::EACCES
+        return false
+      rescue InvalidResponse
+        return false
+      end
+      result
+    end
+
+    # 方法别名
+    alias dbget mget
+
+    # 遍历根节点检索数据
+    def bulkwalk(root)
+      # 初始化遍历
+      last, oid, vbs = false, root, []
+      # 轮询 root oid 主体逻辑
+      until last
+        r = @snmp.get_bulk 0, BULK_MAX, oid
+        r.varbind_list.each do |vb|
+          oid = vb.name.to_str
+          # 跳出循环条件
+          (last = true; break) unless oid.match?(/^#{Regexp.quote root}/)
+          vbs << vb
+        end
+      end
+      vbs
+    end
+
+    # 查询设备描述
+    def sysdescr
+      get DB_OID[:sysDescr]
+    end
+
+    # IP 转索引
+    def ip2index(ip)
+      # 根据 IP 查询其路由及接口IP索引序号
+      oids = mget(route: [OID[:ipCidrRouteIfIndex], ip, "255.255.255.255.0.0.0.0.0"].join("."),
+                  new:   [OID[:ipAddressIfIndex], UNICAST, IPV4, ip].join("."),
+                  old:   [OID[:ipAdEntIfIndex], ip].join("."))
+      return false unless oids
+      # 优先使用 route 命中，如查询不到则进一步尝试使用其他属性
+      index = oids[:route]
+      index = oids[:new] if (not index.class == ::SNMP::Integer) || (index.to_s == "0")
+      index = oids[:old] if (not index.class == ::SNMP::Integer) || (index.to_s == "0")
+      return false unless index.class == ::SNMP::Integer
+      index.to_s
+    end
+
+    # 查询接口描述
+    def ifdescr(index)
+      descr = get OID[:ifDescr], index
+      return false unless descr && (descr.value.class == ::SNMP::OctetString)
+      descr.value.to_s
+    end
+  end
+end

data/lib/hotwired/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Hotwired
+  VERSION = "0.0.1"
+end

data/lib/hotwired.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Hotwired
+  class HotwiredError < StandardError; end
+
+  require_relative "hotwired/core"
+end

data/sig/hotwired.rbs

@@ -0,0 +1,4 @@
+module Hotwired
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end