node-os-utils 1.3.7 → 2.0.1-beta.2

package/dist/test/utils/test-base.js

@@ -0,0 +1,316 @@
+"use strict";
+/**
+ * 测试基础工具类
+ * 提供跨平台的测试工具函数和平台检测功能
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PerformanceMonitor = exports.TestAssertions = exports.skipOnPlatform = exports.platformTest = exports.longTest = exports.asyncTest = exports.TestConfig = exports.TestValidators = exports.PlatformUtils = void 0;
+const os = __importStar(require("os"));
+const chai_1 = require("chai");
+/**
+ * 平台检测工具类
+ */
+class PlatformUtils {
+    /**
+     * 检查是否为Linux系统
+     */
+    static isLinux() {
+        return os.platform() === 'linux';
+    }
+    /**
+     * 检查是否为macOS系统
+     */
+    static isMacOS() {
+        return os.platform() === 'darwin';
+    }
+    /**
+     * 检查是否为Windows系统
+     */
+    static isWindows() {
+        return os.platform() === 'win32';
+    }
+    /**
+     * 获取当前平台
+     */
+    static getCurrentPlatform() {
+        return os.platform();
+    }
+    /**
+     * 获取平台友好名称
+     */
+    static getPlatformName() {
+        const platform = os.platform();
+        switch (platform) {
+            case 'linux': return 'Linux';
+            case 'darwin': return 'macOS';
+            case 'win32': return 'Windows';
+            default: return platform;
+        }
+    }
+}
+exports.PlatformUtils = PlatformUtils;
+/**
+ * 测试验证工具类
+ */
+class TestValidators {
+    /**
+     * 检查是否为有效的数字
+     */
+    static isValidNumber(num) {
+        return typeof num === 'number' && !isNaN(num) && isFinite(num);
+    }
+    /**
+     * 检查是否为有效的百分比 (0-100)
+     */
+    static isValidPercentage(num) {
+        return this.isValidNumber(num) && num >= 0 && num <= 100;
+    }
+    /**
+     * 检查是否为正数
+     */
+    static isPositiveNumber(num) {
+        return this.isValidNumber(num) && num >= 0;
+    }
+    /**
+     * 检查是否为非空字符串
+     */
+    static isNonEmptyString(str) {
+        return typeof str === 'string' && str.length > 0;
+    }
+    /**
+     * 检查是否为有效的数组
+     */
+    static isValidArray(arr) {
+        return Array.isArray(arr);
+    }
+    /**
+     * 检查是否为有效的对象
+     */
+    static isValidObject(obj) {
+        return typeof obj === 'object' && obj !== null && !Array.isArray(obj);
+    }
+}
+exports.TestValidators = TestValidators;
+/**
+ * 测试配置类
+ */
+class TestConfig {
+}
+exports.TestConfig = TestConfig;
+/**
+ * 默认超时时间
+ */
+TestConfig.DEFAULT_TIMEOUT = 10000;
+/**
+ * 长时间运行测试的超时时间
+ */
+TestConfig.LONG_TIMEOUT = 30000;
+/**
+ * 性能测试的最大执行时间
+ */
+TestConfig.PERF_MAX_DURATION = 5000;
+/**
+ * 内存测试的最大内存增长(MB)
+ */
+TestConfig.MAX_MEMORY_INCREASE_MB = 10;
+/**
+ * 异步测试装饰器
+ */
+function asyncTest(testFn) {
+    return async function () {
+        this.timeout(TestConfig.DEFAULT_TIMEOUT);
+        await testFn.call(this);
+    };
+}
+exports.asyncTest = asyncTest;
+/**
+ * 长时间测试装饰器
+ */
+function longTest(testFn) {
+    return async function () {
+        this.timeout(TestConfig.LONG_TIMEOUT);
+        await testFn.call(this);
+    };
+}
+exports.longTest = longTest;
+/**
+ * 平台条件测试装饰器
+ */
+function platformTest(platforms, testFn) {
+    return function () {
+        const currentPlatform = os.platform();
+        if (!platforms.includes(currentPlatform)) {
+            this.skip();
+            return;
+        }
+        return testFn.call(this);
+    };
+}
+exports.platformTest = platformTest;
+/**
+ * 跳过特定平台的测试装饰器
+ */
+function skipOnPlatform(platforms, testFn) {
+    return function () {
+        const currentPlatform = os.platform();
+        if (platforms.includes(currentPlatform)) {
+            this.skip();
+            return;
+        }
+        return testFn.call(this);
+    };
+}
+exports.skipOnPlatform = skipOnPlatform;
+/**
+ * 测试数据验证助手
+ */
+class TestAssertions {
+    /**
+     * 断言系统信息对象的有效性
+     */
+    static assertSystemInfo(info, requiredFields) {
+        (0, chai_1.expect)(info).to.be.an('object');
+        for (const field of requiredFields) {
+            // 检查属性是否存在
+            (0, chai_1.expect)(info).to.have.property(field);
+            // 检查字段值是否为有效数字字符串或数字
+            const value = info[field];
+            if (typeof value === 'string') {
+                (0, chai_1.expect)(TestValidators.isValidNumber(parseFloat(value))).to.be.true;
+                (0, chai_1.expect)(parseFloat(value)).to.be.at.least(0, `${field} should be non-negative`);
+            }
+            else if (typeof value === 'number') {
+                (0, chai_1.expect)(TestValidators.isValidNumber(value)).to.be.true;
+                (0, chai_1.expect)(value).to.be.at.least(0, `${field} should be non-negative`);
+            }
+            else {
+                chai_1.expect.fail(`${field} should be a number or numeric string, got ${typeof value}: ${value}`);
+            }
+        }
+    }
+    /**
+     * 断言百分比字段的有效性
+     */
+    static assertPercentageFields(info, percentageFields) {
+        for (const field of percentageFields) {
+            const value = parseFloat(info[field]);
+            (0, chai_1.expect)(TestValidators.isValidPercentage(value)).to.be.true;
+        }
+    }
+    /**
+     * 断言内存信息的一致性
+     */
+    static assertMemoryConsistency(info) {
+        const used = parseFloat(info.usedMemMb || info.usedGb);
+        const free = parseFloat(info.freeMemMb || info.freeGb);
+        const total = parseFloat(info.totalMemMb || info.totalGb);
+        const usedPercentage = parseFloat(info.usedMemPercentage || info.usedPercentage);
+        const freePercentage = parseFloat(info.freeMemPercentage || info.freePercentage);
+        // 验证总和关系 - 增加容差以处理浮点数精度问题
+        (0, chai_1.expect)(Math.abs((used + free) - total)).to.be.lessThan(2, 'Used + Free should approximately equal Total');
+        (0, chai_1.expect)(Math.abs((usedPercentage + freePercentage) - 100)).to.be.lessThan(2, 'Percentages should sum to approximately 100');
+    }
+    /**
+     * 断言网络统计信息的有效性
+     */
+    static assertNetworkStats(stats) {
+        (0, chai_1.expect)(stats).to.be.an('array');
+        for (const stat of stats) {
+            (0, chai_1.expect)(stat).to.have.property('interface');
+            (0, chai_1.expect)(stat).to.have.property('inputBytes');
+            (0, chai_1.expect)(stat).to.have.property('outputBytes');
+            (0, chai_1.expect)(TestValidators.isNonEmptyString(stat.interface)).to.be.true;
+            (0, chai_1.expect)(TestValidators.isValidNumber(parseInt(stat.inputBytes))).to.be.true;
+            (0, chai_1.expect)(TestValidators.isValidNumber(parseInt(stat.outputBytes))).to.be.true;
+            (0, chai_1.expect)(parseInt(stat.inputBytes)).to.be.at.least(0);
+            (0, chai_1.expect)(parseInt(stat.outputBytes)).to.be.at.least(0);
+        }
+    }
+}
+exports.TestAssertions = TestAssertions;
+/**
+ * 性能监控工具
+ */
+class PerformanceMonitor {
+    constructor() {
+        this.timings = {};
+        this.startTime = Date.now();
+        this.startMemory = process.memoryUsage().heapUsed;
+    }
+    /**
+     * 获取执行时间(毫秒)
+     */
+    getExecutionTime() {
+        return Date.now() - this.startTime;
+    }
+    /**
+     * 获取内存使用增长(字节)
+     */
+    getMemoryIncrease() {
+        return process.memoryUsage().heapUsed - this.startMemory;
+    }
+    /**
+     * 验证性能是否在可接受范围内
+     */
+    assertPerformance(maxTimeMs = TestConfig.PERF_MAX_DURATION) {
+        const executionTime = this.getExecutionTime();
+        (0, chai_1.expect)(executionTime).to.be.lessThan(maxTimeMs, `Execution time ${executionTime}ms exceeded maximum ${maxTimeMs}ms`);
+    }
+    /**
+     * 验证内存使用是否在可接受范围内
+     */
+    assertMemoryUsage(maxIncreaseMB = TestConfig.MAX_MEMORY_INCREASE_MB) {
+        const memoryIncrease = this.getMemoryIncrease();
+        const memoryIncreaseMB = memoryIncrease / (1024 * 1024);
+        (0, chai_1.expect)(memoryIncreaseMB).to.be.lessThan(maxIncreaseMB, `Memory increase ${memoryIncreaseMB.toFixed(2)}MB exceeded maximum ${maxIncreaseMB}MB`);
+    }
+    /**
+     * 计时方法 - 执行函数并记录执行时间
+     */
+    async time(label, fn) {
+        const start = Date.now();
+        const result = await fn();
+        const end = Date.now();
+        this.timings[label] = end - start;
+        return result;
+    }
+    /**
+     * 获取所有计时报告
+     */
+    getReport() {
+        return { ...this.timings };
+    }
+    /**
+     * 重置所有计时记录
+     */
+    reset() {
+        this.timings = {};
+        this.startTime = Date.now();
+        this.startMemory = process.memoryUsage().heapUsed;
+    }
+}
+exports.PerformanceMonitor = PerformanceMonitor;
+//# sourceMappingURL=test-base.js.map

package/dist/test/utils/test-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-base.js","sourceRoot":"","sources":["../../../test/utils/test-base.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,10 +1,50 @@
 {
   "name": "node-os-utils",
-  "version": "1.3.7",
-  "description": "An operating system utility library.",
-  "main": "index.js",
+  "version": "2.0.1-beta.2",
+  "description": "Advanced cross-platform operating system monitoring utilities with TypeScript support",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/src/index.js",
+      "import": "./dist/src/index.js",
+      "types": "./dist/src/index.d.ts"
+    }
+  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
   "scripts": {
-    "test": "node_modules/.bin/mocha test/test.js"
+    "clean": "rimraf dist",
+    "build": "npm run clean && tsc",
+    "build:watch": "tsc --watch",
+    "dev": "tsc --watch",
+    "test": "npm run build && mocha 'dist/**/*.test.js'",
+    "test:unit": "mocha 'dist/test/unit/**/*.test.js'",
+    "test:integration": "mocha 'dist/test/integration/**/*.test.js'",
+    "test:platform": "npm run build && mocha 'dist/test/platform/**/*.test.js'",
+    "test:linux": "npm run build && mocha 'dist/test/platform/linux.test.js'",
+    "test:macos": "npm run build && mocha 'dist/test/platform/macos.test.js'",
+    "test:windows": "npm run build && mocha 'dist/test/platform/windows.test.js'",
+    "test:current-platform": "npm run build && node -e \"const os=require('os'); const platform=os.platform(); const map={linux:'test:linux',darwin:'test:macos',win32:'test:windows'}; const script=map[platform] || 'test'; console.log('Running tests for platform:', platform, '->', script); require('child_process').execSync('npm run ' + script, {stdio:'inherit'});\"",
+    "test:all-platforms": "npm run test:linux && npm run test:macos && npm run test:windows",
+    "test:coverage": "nyc npm test",
+    "test:coverage-platform": "nyc npm run test:platform",
+    "test:node18": "node --version && npm test",
+    "test:node20": "node --version && npm test",
+    "test:node22": "node --version && npm test",
+    "lint": "eslint src --ext .ts --fix",
+    "lint:check": "eslint src --ext .ts",
+    "docs": "typedoc src --out docs",
+    "publish:beta": "npm publish --tag beta",
+    "version:beta": "npm version prerelease --preid=beta",
+    "prepublishOnly": "npm run clean && npm run build && npm test"
   },
   "repository": {
     "type": "git",
@@ -14,26 +54,46 @@
     "name": "SunilWang",
     "email": "ahwangshu@qq.com"
   },
-  "keywords": [
-    "os",
-    "operating system",
-    "server",
-    "netstat",
-    "memory",
-    "cpu",
-    "monitor",
-    "stats",
-    "processes",
-    "openfiles",
-    "harddrive"
-  ],
   "license": "MIT",
   "bugs": {
     "url": "https://github.com/SunilWang/node-os-utils/issues"
   },
   "homepage": "https://github.com/SunilWang/node-os-utils#readme",
+  "keywords": [
+    "os",
+    "system-monitor",
+    "monitoring",
+    "cpu",
+    "memory",
+    "disk",
+    "network",
+    "process-monitor",
+    "server-monitoring",
+    "typescript",
+    "cross-platform",
+    "linux",
+    "macos",
+    "windows",
+    "performance",
+    "metrics",
+    "realtime",
+    "observability",
+    "netstat",
+    "processes"
+  ],
   "devDependencies": {
-    "mocha": "^6.2.3"
+    "typescript": "~5.4.0",
+    "@types/node": "~18.0.0",
+    "@types/mocha": "~10.0.0",
+    "@types/chai": "~4.3.0",
+    "mocha": "~10.0.0",
+    "chai": "~4.3.0",
+    "nyc": "~15.1.0",
+    "eslint": "~8.0.0",
+    "@typescript-eslint/eslint-plugin": "~6.0.0",
+    "@typescript-eslint/parser": "~6.0.0",
+    "typedoc": "~0.25.0",
+    "rimraf": "~5.0.0"
   },
   "dependencies": {}
 }

package/.travis.yml

@@ -1,7 +0,0 @@
-language: node_js
-node_js:
-  - "8.15.1"
-  - "12.18.0"
-  - "14.16.0"
-script:
-  - "npm run test"

package/index.js

@@ -1,17 +0,0 @@
-/**
- * author       : Sunil Wang
- * createTime   : 2017/7/9 18:29
- * description  :
- */
-
-require('./lib/cpu')
-require('./lib/drive')
-require('./lib/mem')
-require('./lib/netstat')
-require('./lib/openfiles')
-require('./lib/osCmd')
-require('./lib/os')
-require('./lib/proc')
-require('./lib/users')
-
-module.exports = require('./lib/bucket')

package/lib/bucket.js

@@ -1,14 +0,0 @@
-/**
- * author       : Sunil Wang
- * createTime   : 2017/7/9 19:24
- * description  :
- */
-module.exports = {
-  options: {
-    NOT_SUPPORTED_VALUE: 'not supported',
-    INTERVAL: 1000
-  },
-  isNotSupported(res){
-    return res === this.options.NOT_SUPPORTED_VALUE
-  }
-}

package/lib/cpu.js

@@ -1,94 +0,0 @@
-/**
- * author       : Sunil Wang
- * createTime   : 2017/7/9 19:39
- * description  :
- */
-var bucket = require('./bucket')
-var os = require('os')
-
-bucket.cpu = {
-  average: function () {
-    var totalIdle = 0
-    var totalTick = 0
-    var cpus = os.cpus()
-
-    for (var i = 0, len = cpus.length; i < len; i++) {
-      var cpu = cpus[i]
-      for (var type in cpu.times) {
-        totalTick += cpu.times[type]
-      }
-      totalIdle += cpu.times.idle
-    }
-
-    return {
-      totalIdle: totalIdle,
-      totalTick: totalTick,
-      avgIdle: (totalIdle / cpus.length),
-      avgTotal: (totalTick / cpus.length)
-    }
-  },
-  usage: function (interval) {
-    var self = this
-
-    if (!interval) {
-      interval = bucket.options.INTERVAL
-    }
-
-    return new Promise(function (resolve) {
-      if (typeof interval !== 'number') {
-        throw new TypeError('interval must be a number!')
-      }
-
-      var startMeasure = self.average()
-
-      setTimeout(function () {
-        var endMeasure = self.average()
-        var idleDifference = endMeasure.avgIdle - startMeasure.avgIdle
-        var totalDifference = endMeasure.avgTotal - startMeasure.avgTotal
-        var cpuPercentage = (10000 - Math.round(10000 * idleDifference / totalDifference)) / 100
-
-        return resolve(cpuPercentage)
-      }, interval)
-    })
-  },
-  free: function (interval) {
-    var self = this
-
-    if (!interval) {
-      interval = bucket.options.INTERVAL
-    }
-
-    return new Promise(function (resolve) {
-      if (typeof interval !== 'number') {
-        throw new TypeError('interval must be a number!')
-      }
-
-      self.usage(interval)
-        .then(function (cpuPercentage) {
-          return resolve(100 - cpuPercentage)
-        })
-    })
-  },
-  count: function () {
-    return os.cpus().length
-  },
-  model: function () {
-    return os.cpus()[0].model
-  },
-  loadavg: function () {
-    return os.loadavg()
-  },
-  loadavgTime: function (time) {
-    time = parseInt(time, 10)
-
-    var loads = os.loadavg()
-
-    switch (time) {
-      case 5:
-        return loads[1]
-      case 15:
-        return loads[2]
-      default: return loads[0]
-    }
-  }
-}

package/lib/drive.js

@@ -1,113 +0,0 @@
-/**
- * author       : Sunil Wang
- * createTime   : 2017/7/9 20:17
- * description  :
- */
-var bucket = require('./bucket')
-var exec = require('./exec')
-var DISK_PATTERN = /^(\S+)\n?\s+(\S+)\s+(\S+)\s+(\S+)\s+(\S+)\s+(.+?)\n/mg
-
-function createDiskInfo (headlineArgs, args) {
-  var info = {}
-
-  headlineArgs.forEach(function (h, i) {
-    info[h] = args[i]
-  })
-
-  return info
-}
-
-function parseDfStdout (stdout) {
-  var dfInfo = []
-  var headline
-
-  stdout.replace(DISK_PATTERN, function () {
-    var args = Array.prototype.slice.call(arguments, 1, 7)
-
-    if (arguments[7] === 0) {
-      headline = args
-      return
-    }
-    dfInfo.push(createDiskInfo(headline, args))
-  })
-
-  return dfInfo
-}
-
-bucket.drive = {
-  info: function (diskName) {
-    if (!diskName) {
-      diskName = '/'
-    }
-
-    return exec('df -kP').then(function (out) {
-      var diskInfo = null
-      var main = null
-      var lines = parseDfStdout(out)
-
-      for (var i = 0; i < lines.length; i++) {
-        if (lines[i]['Mounted on'] === diskName) {
-          diskInfo = lines[i]
-          continue
-        }
-
-        if (lines[i]['Mounted on'] === '/') {
-          main = lines[i]
-          continue
-        }
-      }
-
-      if (diskInfo === null) {
-        if (main === null) {
-          throw new Error('disk name invalid and / not found')
-        }
-
-        console.info('disk name invalid, using / as default')
-        diskInfo = main
-      }
-
-      var used = Math.ceil(diskInfo.Used * 1024 / Math.pow(1024, 2))
-      var free = Math.ceil((diskInfo.Available || diskInfo.Avail) * 1024 / Math.pow(1024, 2))
-      var total = used + free;
-
-      var totalGb = (total / 1024).toFixed(1)
-      var usedGb = (used / 1024).toFixed(1)
-      var freeGb = (free / 1024).toFixed(1)
-
-      var usedPercentage = (100 * used / total).toFixed(1)
-      var freePercentage = (100 * free / total).toFixed(1)
-
-      return Promise.resolve({
-        totalGb: totalGb,
-        usedGb: usedGb,
-        freeGb: freeGb,
-        usedPercentage: usedPercentage,
-        freePercentage: freePercentage
-      })
-    })
-  },
-  free: function (diskName) {
-    var self = this
-
-    return self.info(diskName)
-      .then(function (res) {
-        return Promise.resolve({
-          totalGb: res.totalGb,
-          freeGb: res.freeGb,
-          freePercentage: res.freePercentage
-        })
-      })
-  },
-  used: function (diskName) {
-    var self = this
-
-    return self.info(diskName)
-      .then(function (res) {
-        return Promise.resolve({
-          totalGb: res.totalGb,
-          usedGb: res.usedGb,
-          usedPercentage: res.usedPercentage
-        })
-      })
-  }
-}