@alanlee97/kill-port-process 1.0.0

package/README.md

@@ -0,0 +1,56 @@
+# @alanlee97/kill-port-process
+
+一个用于根据端口号杀掉对应进程的 CLI 工具，支持 Windows 和 macOS。
+
+## 安装
+
+```bash
+npm install -g @alanlee97/kill-port-process
+```
+
+## 使用方法
+
+```bash
+kpp <port>
+```
+
+### 示例
+
+```bash
+# 杀掉占用 3000 端口的进程
+kpp 3000
+
+# 杀掉占用 8080 端口的进程
+kpp 8080
+```
+
+## 命令选项
+
+```bash
+kpp --help      # 显示帮助信息
+kpp --version   # 显示版本号
+```
+
+## 跨平台支持
+
+- **Windows**: 使用 `netstat` 查找进程，`taskkill` 终止进程
+- **macOS**: 使用 `lsof` 查找进程，`kill` 终止进程
+- **Linux**: 使用 `lsof` 查找进程，`kill` 终止进程
+
+## 输出示例
+
+```bash
+$ kpp 3000
+Successfully killed process(es) on port 3000. PIDs: 12345
+
+$ kpp 8080
+No process found running on port 8080.
+```
+
+## 系统要求
+
+- Node.js >= 14.0.0
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+
+const { killPortProcess } = require('../index.js');
+
+function showHelp() {
+  console.log(`
+Usage: kpp <port>
+
+Kill process running on the specified port.
+
+Options:
+  -h, --help     Show help information
+  -v, --version  Show version number
+
+Examples:
+  kpp 3000       Kill process on port 3000
+  kpp 8080       Kill process on port 8080
+`);
+}
+
+function showVersion() {
+  const pkg = require('../package.json');
+  console.log(pkg.version);
+}
+
+function main() {
+  const args = process.argv.slice(2);
+
+  if (args.length === 0) {
+    console.error('Error: Please provide a port number.');
+    showHelp();
+    process.exit(1);
+  }
+
+  const arg = args[0];
+
+  if (arg === '-h' || arg === '--help') {
+    showHelp();
+    process.exit(0);
+  }
+
+  if (arg === '-v' || arg === '--version') {
+    showVersion();
+    process.exit(0);
+  }
+
+  const port = parseInt(arg, 10);
+
+  if (isNaN(port) || port <= 0 || port > 65535) {
+    console.error('Error: Please provide a valid port number (1-65535).');
+    process.exit(1);
+  }
+
+  const result = killPortProcess(port);
+
+  if (result.success) {
+    console.log(result.message);
+    process.exit(0);
+  } else {
+    console.error(result.message);
+    process.exit(1);
+  }
+}
+
+main();

package/index.js

@@ -0,0 +1,97 @@
+const { execSync } = require('child_process');
+const os = require('os');
+
+function getProcessIdByPort(port) {
+  const platform = os.platform();
+  let command;
+  let pidList = [];
+
+  try {
+    if (platform === 'win32') {
+      command = `netstat -ano | findstr :${port}`;
+      const output = execSync(command, { encoding: 'utf-8' });
+      const lines = output.trim().split('\n');
+
+      for (const line of lines) {
+        const parts = line.trim().split(/\s+/);
+        if (parts.length >= 5) {
+          const localAddress = parts[1];
+          const pid = parts[4];
+          if (localAddress.includes(`:${port}`) && pid !== '0') {
+            pidList.push(pid);
+          }
+        }
+      }
+    } else {
+      command = `lsof -ti :${port}`;
+      const output = execSync(command, { encoding: 'utf-8' });
+      pidList = output.trim().split('\n').filter(pid => pid);
+    }
+
+    return [...new Set(pidList)];
+  } catch (error) {
+    return [];
+  }
+}
+
+function killProcess(pid) {
+  const platform = os.platform();
+  let command;
+
+  try {
+    if (platform === 'win32') {
+      command = `taskkill /PID ${pid} /F`;
+    } else {
+      command = `kill -9 ${pid}`;
+    }
+
+    execSync(command, { encoding: 'utf-8' });
+    return true;
+  } catch (error) {
+    return false;
+  }
+}
+
+function killPortProcess(port) {
+  if (!port || isNaN(port)) {
+    return {
+      success: false,
+      message: 'Please provide a valid port number.'
+    };
+  }
+
+  const pidList = getProcessIdByPort(port);
+
+  if (pidList.length === 0) {
+    return {
+      success: false,
+      message: `No process found running on port ${port}.`
+    };
+  }
+
+  const results = [];
+  for (const pid of pidList) {
+    const killed = killProcess(pid);
+    results.push({ pid, killed });
+  }
+
+  const killedCount = results.filter(r => r.killed).length;
+
+  if (killedCount === pidList.length) {
+    return {
+      success: true,
+      message: `Successfully killed process(es) on port ${port}. PIDs: ${pidList.join(', ')}`
+    };
+  } else {
+    return {
+      success: false,
+      message: `Partially killed processes on port ${port}. Success: ${killedCount}/${pidList.length}`
+    };
+  }
+}
+
+module.exports = {
+  killPortProcess,
+  getProcessIdByPort,
+  killProcess
+};

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@alanlee97/kill-port-process",
+  "version": "1.0.0",
+  "description": "A CLI tool to kill processes by port number",
+  "main": "index.js",
+  "bin": {
+    "kpp": "./bin/cli.js"
+  },
+  "files": [
+    "index.js",
+    "bin/",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "kill",
+    "port",
+    "process",
+    "cli",
+    "tool"
+  ],
+  "author": "alanlee97",
+  "license": "MIT",
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "os": [
+    "win32",
+    "darwin",
+    "linux"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}