wireless-rb 0.1.0 → 0.2.0

data/lib/wireless/h3c/verbose_parser.rb

@@ -1,82 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "parser"
-
-module Wireless
-  module H3c
-    # 为 H3C 详细命令回显共享词元切分与类型化字段处理。
-    class VerboseParser < Parser
-      private
-
-      # 切分含引号的命令值，不将其作为 Ruby 代码解释。
-      def tokens(text, issues)
-        text.lines.each_with_index.each_with_object([]) do |(line, index), fields|
-          row = line.strip
-          next if row.empty? || /\A[-=]+\z/.match?(row)
-          if (match = /\A([^:]+?)\s*:\s*(.*)\z/.match(row))
-            label = match[1].downcase.gsub(/\s+/, " ")
-            next if /\A(?:total|number of aps|connected|remaining|maximum|current number|(?:local|server|sync) ap licenses|(?:current|max|bound) bss number)\b/.match?(label)
-            fields << [ label, Fields.value(match[2]), index + 1 ]
-          elsif (match = /\A:\s*(\S.*)\z/.match(row)) && fields.last&.first == "poe status"
-            fields.last[1] = [ fields.last[1], match[1] ].compact.join("\n")
-          elsif /\A(?:NSS\d+\s+[\d, ]+|TID \d+\s+(?:In|Out|Both)|[\d., ]+(?:Mbps)?)\z/.match?(row)
-            next
-          else
-            issues << { code: :unrecognized_line, line: index + 1 }
-          end
-        end
-      end
-
-      # 更新当前记录前，先应用字段专用转换。
-      def assign_field(record, mapping, label, raw, issues, line, details:)
-        if record && (field = mapping[label])
-          safely(issues, line) do
-            # 优先使用运行带宽；80+80MHz 等歧义值保持原义，不截断为单个数值。
-            if field == :channel_width
-              (record[:details] ||= {})[label.tr(" ", "_").to_sym] = raw
-              return if label == "channel bandwidth" && record[:details].key?(:operating_bandwidth)
-            end
-            record[field] = convert(field, raw)
-          end
-        elsif details
-          (details[:details] ||= {})[label.tr(" -", "__").to_sym] = label.end_with?("url") ? !raw.nil? && !raw.strip.empty? : raw
-        else
-          issues << { code: :unrecognized_field, line: line }
-        end
-      end
-
-      # 按声明的归一化规则转换已知字段。
-      def convert(field, raw)
-        case field
-        when :mac_address, :client_mac, :bssid then Fields.mac(raw)
-        when :management_ip, :client_ip, :client_ipv6, :ip_address, :ipv6_address then Fields.ip(raw)
-        when :ap_id, :radio_id then Fields.integer(raw)&.to_s
-        when :client_count, :online_seconds, :uptime_seconds
-          %i[online_seconds uptime_seconds].include?(field) ? Fields.duration(raw) : Fields.integer(raw)
-        when :vlan, :initial_vlan_id, :authorized_vlan_id then Fields.integer(raw, max: 4094)
-        when :channel then Fields.channel(raw)
-        when :channel_width then Fields.width(raw)
-        when :band then Fields.band(raw)
-        when :noise_dbm then Fields.number(raw, unit: "dBm")&.then { |number| number if number.negative? }
-        when :utilization
-          number = Fields.number(raw, unit: "%")
-          raise ArgumentError, "Invalid wireless utilization" if number && !(0..100).cover?(number)
-          number&.round
-        else raw
-        end
-      end
-
-      # 解析非负计数，同时保留未知值。
-      def count(text, noun)
-        /(?:Total(?: number of)?\s+(?:#{noun})|Total|Current BSS number)\s*:\s*(\d+)\s*$/i.match(text)&.[](1)&.to_i
-      end
-
-      # 隔离单个格式错误字段，同时保留无关记录数据。
-      def safely(issues, line)
-        yield
-      rescue ArgumentError, IPAddr::InvalidAddressError
-        issues << { code: :invalid_field, line: line }
-      end
-    end
-  end
-end

data/lib/wireless/h3c_runtime.rb

@@ -1,18 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "runtime_parser"
-
-module Wireless
-  # 保留 H3C 公共入口，具体 CLI 语法由独立命令类负责。
-  class H3cRuntime
-    # 绑定 H3C 运行解析器，并保留既有公共入口。
-    def initialize(model: nil)
-      @parser = RuntimeParser.new(model: model)
-    end
-
-    # 将单个 H3C 运行维度委派给共享无线解析入口。
-    def parse(name, text, complete:)
-      @parser.parse(name, text, platform: :h3c, complete: complete)
-    end
-  end
-end

data/lib/wireless/huawei_runtime.rb

@@ -1,65 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "fields"
-require_relative "observation"
-
-module Wireless
-  # 仅支持有证据的 Huawei 表格格式，区分不支持维度与空清单。
-  class HuaweiRuntime
-    # 解析支持的 Huawei AP 或客户端汇总，其余维度标记为不支持。
-    def parse(name, text, complete:)
-      unless %i[access_points clients].include?(name)
-        return Observation.new(name: name, status: :unsupported, issues: [ { code: :unsupported_platform_dimension } ])
-      end
-      records, issues = [], []
-      header = false
-      total = nil
-      text.lines.each_with_index do |line, index|
-        row = line.strip
-        next if row.empty? || /\A[-=]+\z/.match?(row)
-        if (match = /\ATotal\s*:\s*(\d+)\z/i.match(row))
-          total = match[1].to_i
-        elsif name == :access_points ? /\AID\s+MAC\s+Name\s+Group\s+IP\s+Type\s+State\s+STA\s+Uptime\b/i.match?(row) : /\ASTA MAC\s+AP ID\s+Ap name\s+Rf\/WLAN\b/i.match?(row)
-          header = true
-        elsif /\ATotal AP information:|\A(?:nor|fault|idle|stdby)\s*:/i.match?(row)
-          next
-        elsif !header
-          issues << { code: :missing_header, line: index + 1 }
-        else
-          begin
-            records << (name == :access_points ? ap(row.split) : client(row.split))
-          rescue ArgumentError, IPAddr::InvalidAddressError
-            issues << { code: :invalid_row, line: index + 1 }
-          end
-        end
-      end
-      issues << { code: :missing_header } unless header
-      result = Fields.result(records, issues: issues, complete: complete, total: total, identity: [ name == :access_points ? :name : :client_mac ])
-      Observation.new(name: name, **result.to_h)
-    end
-
-    private
-
-    # 归一化控制器报告的单条 AP 记录。
-    def ap(columns)
-      raise ArgumentError, "Invalid AP row" unless columns.size == 9
-      id, mac, name, group, ip, model, state, clients, uptime = columns
-      { ap_id: Fields.integer(id).to_s, mac_address: Fields.mac(mac), name: name, group_name: group,
-        management_ip: Fields.ip(Fields.value(ip)), model: model, operational_status: Fields.online_status(state),
-        client_count: Fields.integer(clients), uptime_seconds: Fields.duration(Fields.value(uptime)) }
-    end
-
-    # 归一化控制器报告的单条无线客户端记录。
-    def client(columns)
-      raise ArgumentError, "Invalid station row" unless columns.size == 15
-      mac, ap_id, ap_name, radio_wlan, band, protocol, rates, rssi, vlan, ip, ssid, state, ipv6, _ac_id, uptime = columns
-      raise ArgumentError, "Invalid station identity" unless /\A\d+\/\d+\z/.match?(radio_wlan)
-      rx, tx = Fields.rates(rates)
-      signal = Fields.number(Fields.value(rssi), unit: "dBm")
-      { client_mac: Fields.mac(mac), ap_id: Fields.integer(ap_id).to_s, ap_name: ap_name, radio_id: radio_wlan.split("/").first,
-        band: Fields.band(band), protocol: protocol, rx_rate_mbps: rx, tx_rate_mbps: tx, signal_dbm: signal == 0 ? nil : signal,
-        vlan: Fields.integer(vlan, max: 4094), client_ip: Fields.ip(Fields.value(ip)), ssid: ssid, operational_status: state,
-        client_ipv6: Fields.ip(Fields.value(ipv6)), uptime_seconds: Fields.duration(Fields.value(uptime)) }
-    end
-  end
-end