Metadata-Version: 2.4
Name: pss-cli
Version: 0.1.1
Summary: Cross-platform process finder with port/argument filtering
Requires-Python: >=3.12
Requires-Dist: psutil
Requires-Dist: rich
Description-Content-Type: text/markdown

# pss - 跨平台进程查找工具

快速按 **端口号 / 命令行参数 / 进程名** 模糊查找进程，彩色表格输出，支持一键 kill。

## 安装

需要 Python >= 3.12。

```bash
# 通过 uv 安装（推荐）
uv tool install pss-cli

# 或通过 pip 安装
pip install pss-cli
```

安装后全局可用 `pss` 命令。

## 使用

```bash
# 按端口查找（纯数字默认精确匹配端口）
pss 8000

# 纯数字 + --all：同时匹配端口、命令行、进程名
pss 8000 --all

# 按命令行参数过滤（比如找包含 main.py 的进程）
pss main.py

# 按进程名过滤
pss python

# 查找后 kill（逐个确认）
pss 8000 --kill

# 查找后直接全部 kill（跳过确认）
pss 8000 --kill -y
```

## 输出示例

```
                          Matching Processes
+------------------------------------------------------------+
|   PID | Name       | Ports | Command Line                   |
|-------+------------+-------+--------------------------------|
|  1234 | python.exe | 8000  | python -m http.server 8000     |
|  5678 | node.exe   | 8000  | node server.js --port 8000     |
+------------------------------------------------------------+

Total: 2 process(es)
```

## 匹配规则

- 大小写不敏感
- **纯数字关键词**：默认精确匹配端口号，加 `--all` / `-a` 切换为全匹配模式
- **非数字关键词**：同时匹配端口号、完整命令行、进程名，任一命中即展示

## 平台支持

- Windows (Git Bash / PowerShell / CMD)
- Linux
- macOS

> Windows 上获取所有进程的端口信息可能需要管理员权限，非管理员模式下仅能查看当前用户的连接。

## 开发

```bash
# 克隆仓库
git clone https://github.com/user/fast-process.git
cd fast-process

# 本地运行（无需全局安装）
uv run pss python

# 从源码安装全局命令
uv tool install . --force
```
