dcheckdev 0.1.0__tar.gz → 0.2.0__tar.gz

dcheckdev-0.2.0/PKG-INFO

@@ -0,0 +1,99 @@
+Metadata-Version: 2.4
+Name: dcheckdev
+Version: 0.2.0
+Summary: One-command local dev environment checker: tool versions, PATH, key configs and port usage
+Author: dongzhongcen
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/dongzhongcen
+Keywords: cli,devtools,environment,path,windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Environment :: Console
+Classifier: Topic :: Software Development
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rich
+Requires-Dist: psutil
+Dynamic: license-file
+
+# dcheckdev
+
+一键检查本地开发环境的命令行工具。 / A one-command local dev environment checker.
+
+## 简介
+
+`dcheckdev` 会用彩色表格列出：
+
+1. **工具版本**：对照内置「常见工具目录」，用 `PATH`（`shutil.which`）自动探测已安装项，并显示版本号与可执行文件位置；未命中的目录项会跳过，不会扫描整条 PATH
+2. **PATH 检查**：重复、失效、变量无法展开、误把文件写进 PATH 的条目
+3. **关键配置**：仅为已检测到的工具展示配置探针（如 Go 环境、pip/npm 镜像、Git 用户信息、Docker Compose 插件等）；环境变量（如 JAVA_HOME）在已设置或关联工具已安装时显示
+4. **端口占用**：8000、8080、5173、3306、5672、6379 是否被占用，以及占用的程序
+
+目录示例（节选）：python / python3、go、node、npm、git、java / javac、wails、docker、docker-compose、kubectl、rustc / cargo、gcc / clang、make / cmake、mvn / gradle、code、curl / wget / ssh、mysql / redis-cli / psql、pip / pip3、yarn / pnpm / bun / deno、php、ruby、dotnet、terraform、aws、gh 等。
+
+从 **0.2.0** 起：交互式终端中运行 `devcheck` 会先播放简短开场动画，再进入编号菜单；工具列表改为目录 + PATH 自动探测；选择「各工具路径与关键配置」时，二级菜单只列出当前有内容可看的分组（并保留「全部配置」）。
+
+若 stdin 或 stdout 不是 TTY（例如 CI、管道重定向），则自动退回：一次跑完全部检查，不进入菜单、不挂起等待输入。
+
+### 安装
+
+```bash
+python -m pip install dcheckdev
+```
+
+### 使用
+
+```bash
+devcheck
+```
+
+交互菜单（TTY）：
+
+```
+1. 工具版本
+2. PATH 检查
+3. 各工具路径与关键配置
+4. 端口占用
+5. 全部跑一遍
+0. 退出
+```
+
+非交互（管道 / CI）：
+
+```bash
+devcheck </dev/null
+# 或
+python checkdev.py </dev/null
+```
+
+建议在 PowerShell、Windows Terminal 等真正的终端里运行，颜色显示最完整。
+
+---
+
+## Overview
+
+`dcheckdev` prints colored tables showing:
+
+1. **Tool versions**: auto-detects installed tools from a built-in common catalog via `PATH` (`shutil.which`); shows version and executable path; skips missing catalog entries (does not scan every PATH executable)
+2. **PATH check**: duplicate, missing, unexpanded-variable and file-instead-of-directory entries
+3. **Key configs**: probes only for detected tools (Go env, pip/npm registry, Git identity, Docker Compose plugin, etc.); env vars such as `JAVA_HOME` appear when set or when a related tool is installed
+4. **Port usage**: whether ports 8000, 8080, 5173, 3306, 5672 and 6379 are in use, and by which process
+
+From **0.2.0**, in an interactive TTY `devcheck` shows a short opening animation and a numbered menu. Option 3 only lists config subgroups that have something to show (plus "all configs"). When stdin or stdout is not a TTY (CI, pipes), it falls back to running all checks once without prompting.
+
+### Install
+
+```bash
+python -m pip install dcheckdev
+```
+
+### Usage
+
+```bash
+devcheck
+```
+
+## License
+
+MIT

dcheckdev-0.2.0/README.md

@@ -0,0 +1,80 @@
+# dcheckdev
+
+一键检查本地开发环境的命令行工具。 / A one-command local dev environment checker.
+
+## 简介
+
+`dcheckdev` 会用彩色表格列出：
+
+1. **工具版本**：对照内置「常见工具目录」，用 `PATH`（`shutil.which`）自动探测已安装项，并显示版本号与可执行文件位置；未命中的目录项会跳过，不会扫描整条 PATH
+2. **PATH 检查**：重复、失效、变量无法展开、误把文件写进 PATH 的条目
+3. **关键配置**：仅为已检测到的工具展示配置探针（如 Go 环境、pip/npm 镜像、Git 用户信息、Docker Compose 插件等）；环境变量（如 JAVA_HOME）在已设置或关联工具已安装时显示
+4. **端口占用**：8000、8080、5173、3306、5672、6379 是否被占用，以及占用的程序
+
+目录示例（节选）：python / python3、go、node、npm、git、java / javac、wails、docker、docker-compose、kubectl、rustc / cargo、gcc / clang、make / cmake、mvn / gradle、code、curl / wget / ssh、mysql / redis-cli / psql、pip / pip3、yarn / pnpm / bun / deno、php、ruby、dotnet、terraform、aws、gh 等。
+
+从 **0.2.0** 起：交互式终端中运行 `devcheck` 会先播放简短开场动画，再进入编号菜单；工具列表改为目录 + PATH 自动探测；选择「各工具路径与关键配置」时，二级菜单只列出当前有内容可看的分组（并保留「全部配置」）。
+
+若 stdin 或 stdout 不是 TTY（例如 CI、管道重定向），则自动退回：一次跑完全部检查，不进入菜单、不挂起等待输入。
+
+### 安装
+
+```bash
+python -m pip install dcheckdev
+```
+
+### 使用
+
+```bash
+devcheck
+```
+
+交互菜单（TTY）：
+
+```
+1. 工具版本
+2. PATH 检查
+3. 各工具路径与关键配置
+4. 端口占用
+5. 全部跑一遍
+0. 退出
+```
+
+非交互（管道 / CI）：
+
+```bash
+devcheck </dev/null
+# 或
+python checkdev.py </dev/null
+```
+
+建议在 PowerShell、Windows Terminal 等真正的终端里运行，颜色显示最完整。
+
+---
+
+## Overview
+
+`dcheckdev` prints colored tables showing:
+
+1. **Tool versions**: auto-detects installed tools from a built-in common catalog via `PATH` (`shutil.which`); shows version and executable path; skips missing catalog entries (does not scan every PATH executable)
+2. **PATH check**: duplicate, missing, unexpanded-variable and file-instead-of-directory entries
+3. **Key configs**: probes only for detected tools (Go env, pip/npm registry, Git identity, Docker Compose plugin, etc.); env vars such as `JAVA_HOME` appear when set or when a related tool is installed
+4. **Port usage**: whether ports 8000, 8080, 5173, 3306, 5672 and 6379 are in use, and by which process
+
+From **0.2.0**, in an interactive TTY `devcheck` shows a short opening animation and a numbered menu. Option 3 only lists config subgroups that have something to show (plus "all configs"). When stdin or stdout is not a TTY (CI, pipes), it falls back to running all checks once without prompting.
+
+### Install
+
+```bash
+python -m pip install dcheckdev
+```
+
+### Usage
+
+```bash
+devcheck
+```
+
+## License
+
+MIT

dcheckdev-0.2.0/checkdev.py

@@ -0,0 +1,423 @@
+import os
+import shutil
+import subprocess
+import sys
+import time
+from dataclasses import dataclass
+
+import psutil
+from rich import box
+from rich.console import Console
+from rich.table import Table
+
+# 真正的终端能自动测出宽度；PyCharm 运行窗口测不出，就固定按 200 宽排版
+console = Console(width=None if sys.stdout.isatty() else 200)
+
+
+@dataclass(frozen=True)
+class Tool:
+    """常见开发工具目录项：显示名、版本检查 argv、可选配置探针。"""
+
+    name: str
+    cmd: list  # e.g. ["docker", "--version"]；用 cmd[0] 做 PATH 探测
+    configs: tuple = ()  # ((配置名, argv), ...)
+
+
+# 常见工具目录（不扫整条 PATH，只查这一批）
+COMMON_TOOLS = [
+    Tool("Python", ["python", "--version"], (
+        ("pip 镜像", ["python", "-m", "pip", "config", "get", "global.index-url"]),
+    )),
+    Tool("Python3", ["python3", "--version"], (
+        ("pip 镜像", ["python3", "-m", "pip", "config", "get", "global.index-url"]),
+    )),
+    Tool("pip", ["pip", "--version"]),
+    Tool("pip3", ["pip3", "--version"]),
+    Tool("Go", ["go", "version"], (
+        ("GOROOT", ["go", "env", "GOROOT"]),
+        ("GOPATH", ["go", "env", "GOPATH"]),
+        ("GOPROXY", ["go", "env", "GOPROXY"]),
+    )),
+    Tool("Node", ["node", "--version"]),
+    Tool("npm", ["npm", "--version"], (
+        ("npm 镜像", ["npm", "config", "get", "registry"]),
+        ("全局目录", ["npm", "config", "get", "prefix"]),
+    )),
+    Tool("yarn", ["yarn", "--version"]),
+    Tool("pnpm", ["pnpm", "--version"]),
+    Tool("bun", ["bun", "--version"]),
+    Tool("deno", ["deno", "--version"]),
+    Tool("Git", ["git", "--version"], (
+        ("user.name", ["git", "config", "--global", "user.name"]),
+        ("user.email", ["git", "config", "--global", "user.email"]),
+    )),
+    Tool("Java", ["java", "-version"]),
+    Tool("javac", ["javac", "-version"]),
+    Tool("Wails", ["wails", "version"]),
+    Tool("Docker", ["docker", "--version"], (
+        ("compose 插件", ["docker", "compose", "version"]),
+    )),
+    Tool("Docker Compose", ["docker-compose", "--version"]),
+    Tool("kubectl", ["kubectl", "version", "--client"]),
+    Tool("rustc", ["rustc", "--version"]),
+    Tool("cargo", ["cargo", "--version"]),
+    Tool("gcc", ["gcc", "--version"]),
+    Tool("clang", ["clang", "--version"]),
+    Tool("make", ["make", "--version"]),
+    Tool("cmake", ["cmake", "--version"]),
+    Tool("Maven", ["mvn", "--version"]),
+    Tool("Gradle", ["gradle", "--version"]),
+    Tool("VS Code", ["code", "--version"]),
+    Tool("curl", ["curl", "--version"]),
+    Tool("wget", ["wget", "--version"]),
+    Tool("ssh", ["ssh", "-V"]),
+    Tool("MySQL", ["mysql", "--version"]),
+    Tool("redis-cli", ["redis-cli", "--version"]),
+    Tool("psql", ["psql", "--version"]),
+    Tool("PHP", ["php", "--version"]),
+    Tool("Ruby", ["ruby", "--version"]),
+    Tool(".NET", ["dotnet", "--version"]),
+    Tool("Terraform", ["terraform", "version"]),
+    Tool("AWS CLI", ["aws", "--version"]),
+    Tool("GitHub CLI", ["gh", "--version"]),
+]
+
+# 环境变量：(变量名, 关联工具的 cmd[0] 列表；任一在 PATH 上或变量已设置则展示)
+ENV_VARS = [
+    ("JAVA_HOME", ("java", "javac")),
+]
+
+# 要检查的端口：端口号 -> 通常是谁在用
+PORTS = {
+    8000: "FastAPI / Django",
+    8080: "Spring Boot / Tomcat",
+    5173: "Vite 前端",
+    3306: "MySQL",
+    5672: "RabbitMQ",
+    6379: "Redis",
+}
+
+
+def resolve_installed_tools():
+    """从 COMMON_TOOLS 中筛出 PATH 上存在的工具（shutil.which）。"""
+    return [t for t in COMMON_TOOLS if shutil.which(t.cmd[0])]
+
+
+def make_table(title, *columns):
+    """创建统一样式的表格：没有竖线，每列都不折行，宽度按最长的文字"""
+    table = Table(title=title, box=box.SIMPLE_HEAD, title_justify="left")
+    for col in columns:
+        table.add_column(col, no_wrap=True)
+    return table
+
+
+def run(cmd):
+    """运行命令，返回 (返回码, 第一行输出)；没安装返回 None"""
+    exe = shutil.which(cmd[0])
+    if exe is None:
+        return None
+    try:
+        result = subprocess.run(
+            [exe] + cmd[1:],
+            capture_output=True,
+            text=True,
+            encoding="utf-8",
+            errors="replace",
+            timeout=10,
+        )
+    except subprocess.TimeoutExpired:
+        return -1, "超时"
+    except OSError:
+        return -1, "无法执行"
+
+    output = (result.stdout or result.stderr).strip()
+    first_line = output.splitlines()[0] if output else ""
+    return result.returncode, first_line
+
+
+def check_tools(installed=None):
+    if installed is None:
+        installed = resolve_installed_tools()
+
+    if not installed:
+        console.print("[yellow]1. 工具版本：未在 PATH 中检测到常见开发工具。[/yellow]")
+        console.print("[dim]（已对照内置目录探测，不会扫描整条 PATH。）[/dim]")
+        return
+
+    table = make_table("1. 工具版本（已检测到）", "工具", "状态", "版本", "位置")
+
+    for tool in installed:
+        location = shutil.which(tool.cmd[0]) or ""
+        res = run(tool.cmd)
+        # 已通过 which 命中；有输出或 exit 0 视为已安装（ssh -V 等常写 stderr 且非 0）
+        if res is None:
+            status, version = "[red]未安装[/red]", ""
+        elif res[1] or res[0] == 0:
+            status, version = "[green]已安装[/green]", res[1] or f"(exit {res[0]})"
+        else:
+            status, version = "[yellow]出错[/yellow]", res[1]
+        table.add_row(f"[bold]{tool.name}[/bold]", status, version, f"[dim]{location}[/dim]")
+
+    table.caption = f"目录共 {len(COMMON_TOOLS)} 项，PATH 命中 {len(installed)} 项"
+    console.print(table)
+
+
+def check_path():
+    table = make_table("2. PATH 检查", "问题", "路径")
+
+    paths = os.environ.get("PATH", "").split(os.pathsep)
+    seen = set()
+    for raw in paths:
+        raw = raw.strip()
+        if not raw:
+            continue
+        p = os.path.expandvars(raw)
+        key = os.path.normcase(os.path.normpath(p))
+        if key in seen:
+            table.add_row("[yellow]重复[/yellow]", raw)
+        elif "%" in p:
+            table.add_row("[red]变量无法展开[/red]", raw)
+        elif os.path.isfile(p):
+            table.add_row("[yellow]是文件不是目录[/yellow]", raw)
+        elif not os.path.isdir(p):
+            table.add_row("[red]失效[/red]", raw)
+        seen.add(key)
+
+    if table.row_count == 0:
+        console.print(f"[green]2. PATH 检查：共 {len(paths)} 项，没有问题[/green]")
+    else:
+        table.caption = f"PATH 共 {len(paths)} 项，发现 {table.row_count} 个问题"
+        console.print(table)
+
+
+def _env_vars_to_show(installed):
+    """环境变量：已设置，或关联工具已安装时展示。"""
+    installed_bins = {t.cmd[0] for t in installed}
+    rows = []
+    for name, related in ENV_VARS:
+        value = os.environ.get(name)
+        related_hit = any(b in installed_bins for b in related)
+        if value or related_hit:
+            rows.append((name, value or "[yellow]（未设置）[/yellow]"))
+    return rows
+
+
+def _tools_with_configs(installed):
+    """已安装且带有配置探针的工具。"""
+    return [t for t in installed if t.configs]
+
+
+def check_configs(group=None, installed=None):
+    """检查关键配置。
+
+    group:
+      None  — 全部（已安装工具的 configs + 可见 ENV_VARS）
+      "env" — 仅环境变量
+      工具名 — 仅该工具的 configs
+    """
+    if installed is None:
+        installed = resolve_installed_tools()
+
+    if group is None:
+        title = "3. 关键配置"
+    elif group == "env":
+        title = "3. 关键配置 · 环境变量"
+    else:
+        title = f"3. 关键配置 · {group}"
+
+    table = make_table(title, "工具", "配置", "值")
+
+    include_configs = group is None or (group != "env")
+    include_env = group is None or group == "env"
+
+    if include_configs:
+        tools = _tools_with_configs(installed)
+        if group is not None and group != "env":
+            tools = [t for t in tools if t.name == group]
+        for tool in tools:
+            for label, cmd in tool.configs:
+                res = run(cmd)
+                if res is None:
+                    table.add_row(tool.name, label, f"[dim]没找到 {cmd[0]}，跳过[/dim]")
+                    break
+                if res[0] == 0 and res[1]:
+                    value = res[1]
+                else:
+                    value = "[yellow]（未设置）[/yellow]"
+                table.add_row(f"[bold]{tool.name}[/bold]", label, value)
+
+    if include_env:
+        for name, value in _env_vars_to_show(installed):
+            table.add_row("[bold]环境变量[/bold]", name, value)
+
+    if table.row_count == 0:
+        console.print(f"[yellow]{title}：当前没有可展示的配置项。[/yellow]")
+    else:
+        console.print(table)
+
+
+def build_config_groups(installed=None):
+    """选项 3 二级菜单：只列出有内容可看的分组，并始终保留「全部配置」。"""
+    if installed is None:
+        installed = resolve_installed_tools()
+
+    groups = []
+    n = 1
+    for tool in _tools_with_configs(installed):
+        groups.append((str(n), tool.name, tool.name))
+        n += 1
+
+    if _env_vars_to_show(installed):
+        groups.append((str(n), "环境变量", "env"))
+        n += 1
+
+    groups.append((str(n), "全部配置", None))
+    return groups
+
+
+def find_listeners():
+    """返回 {端口: 进程 PID}，只看正在监听的 TCP 端口"""
+    listeners = {}
+    for conn in psutil.net_connections(kind="tcp"):
+        if conn.status == psutil.CONN_LISTEN and conn.laddr:
+            listeners.setdefault(conn.laddr.port, conn.pid)
+    return listeners
+
+
+def process_name(pid):
+    """根据 PID 查进程名，查不到返回问号"""
+    if not pid:
+        return "?"
+    try:
+        return psutil.Process(pid).name()
+    except (psutil.NoSuchProcess, psutil.AccessDenied):
+        return "?"
+
+
+def check_ports():
+    table = make_table("4. 端口占用", "端口", "用途", "状态", "占用程序")
+    table.columns[0].justify = "right"
+
+    listeners = find_listeners()
+    for port, usage in PORTS.items():
+        if port in listeners:
+            pid = listeners[port]
+            table.add_row(str(port), usage, "[yellow]占用[/yellow]",
+                          f"{process_name(pid)} (PID {pid})")
+        else:
+            table.add_row(str(port), usage, "[green]空闲[/green]", "")
+
+    console.print(table)
+
+
+def run_all():
+    """跑全部检查（非交互 / 菜单选项 5）"""
+    installed = resolve_installed_tools()
+    check_tools(installed)
+    check_path()
+    check_configs(installed=installed)
+    check_ports()
+
+
+def play_opening():
+    """短开场动画：纯终端 ASCII/Unicode，约 1–2 秒，无网络。"""
+    frames = [
+        "  ·  ·  ·",
+        "  ○  ·  ·",
+        "  ●  ○  ·",
+        "  ✓  ●  ○",
+        "  ✓  ✓  ●",
+        "  ✓  ✓  ✓",
+    ]
+    console.print()
+    console.print("[bold cyan]  dcheckdev[/bold cyan]  [dim]开发环境检查[/dim]")
+    for frame in frames:
+        console.print(f"\r  [cyan]{frame}[/cyan]  准备中…", end="")
+        time.sleep(0.22)
+    console.print()
+    time.sleep(0.15)
+
+
+def clear_screen():
+    console.clear()
+
+
+def show_menu():
+    console.print()
+    console.print("[bold]请选择检查项：[/bold]")
+    console.print("  [cyan]1[/cyan]. 工具版本")
+    console.print("  [cyan]2[/cyan]. PATH 检查")
+    console.print("  [cyan]3[/cyan]. 各工具路径与关键配置")
+    console.print("  [cyan]4[/cyan]. 端口占用")
+    console.print("  [cyan]5[/cyan]. 全部跑一遍")
+    console.print("  [cyan]0[/cyan]. 退出")
+    console.print()
+
+
+def prompt_config_group(installed=None):
+    """选项 3 的二级菜单：选配置分组。返回 filter 键或 None（全部）。取消返回 False。"""
+    groups = build_config_groups(installed)
+    console.print()
+    console.print("[bold]查询哪一组配置？[/bold]")
+    for key, label, _ in groups:
+        console.print(f"  [cyan]{key}[/cyan]. {label}")
+    console.print("  [cyan]0[/cyan]. 返回上级")
+    console.print()
+    choice = input("请输入编号: ").strip()
+    if choice == "0":
+        return False
+    for key, _label, group in groups:
+        if choice == key:
+            return group
+    console.print("[yellow]无效选项，请重试。[/yellow]")
+    return False
+
+
+def interactive_loop():
+    while True:
+        show_menu()
+        try:
+            choice = input("请输入编号: ").strip()
+        except EOFError:
+            console.print()
+            break
+
+        if choice == "0":
+            console.print("[dim]再见！[/dim]")
+            break
+        elif choice == "1":
+            console.print()
+            check_tools()
+        elif choice == "2":
+            console.print()
+            check_path()
+        elif choice == "3":
+            installed = resolve_installed_tools()
+            group = prompt_config_group(installed)
+            if group is False:
+                continue
+            console.print()
+            check_configs(group, installed=installed)
+        elif choice == "4":
+            console.print()
+            check_ports()
+        elif choice == "5":
+            console.print()
+            run_all()
+        else:
+            console.print("[yellow]无效选项，请输入 0–5。[/yellow]")
+
+
+def main():
+    # 非 TTY（CI / 管道）：保持旧行为，一次跑完全部，不挂起等输入
+    if not sys.stdin.isatty() or not sys.stdout.isatty():
+        run_all()
+        return
+
+    play_opening()
+    clear_screen()
+    interactive_loop()
+
+
+if __name__ == "__main__":
+    main()

dcheckdev-0.2.0/dcheckdev.egg-info/PKG-INFO

@@ -0,0 +1,99 @@
+Metadata-Version: 2.4
+Name: dcheckdev
+Version: 0.2.0
+Summary: One-command local dev environment checker: tool versions, PATH, key configs and port usage
+Author: dongzhongcen
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/dongzhongcen
+Keywords: cli,devtools,environment,path,windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Environment :: Console
+Classifier: Topic :: Software Development
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rich
+Requires-Dist: psutil
+Dynamic: license-file
+
+# dcheckdev
+
+一键检查本地开发环境的命令行工具。 / A one-command local dev environment checker.
+
+## 简介
+
+`dcheckdev` 会用彩色表格列出：
+
+1. **工具版本**：对照内置「常见工具目录」，用 `PATH`（`shutil.which`）自动探测已安装项，并显示版本号与可执行文件位置；未命中的目录项会跳过，不会扫描整条 PATH
+2. **PATH 检查**：重复、失效、变量无法展开、误把文件写进 PATH 的条目
+3. **关键配置**：仅为已检测到的工具展示配置探针（如 Go 环境、pip/npm 镜像、Git 用户信息、Docker Compose 插件等）；环境变量（如 JAVA_HOME）在已设置或关联工具已安装时显示
+4. **端口占用**：8000、8080、5173、3306、5672、6379 是否被占用，以及占用的程序
+
+目录示例（节选）：python / python3、go、node、npm、git、java / javac、wails、docker、docker-compose、kubectl、rustc / cargo、gcc / clang、make / cmake、mvn / gradle、code、curl / wget / ssh、mysql / redis-cli / psql、pip / pip3、yarn / pnpm / bun / deno、php、ruby、dotnet、terraform、aws、gh 等。
+
+从 **0.2.0** 起：交互式终端中运行 `devcheck` 会先播放简短开场动画，再进入编号菜单；工具列表改为目录 + PATH 自动探测；选择「各工具路径与关键配置」时，二级菜单只列出当前有内容可看的分组（并保留「全部配置」）。
+
+若 stdin 或 stdout 不是 TTY（例如 CI、管道重定向），则自动退回：一次跑完全部检查，不进入菜单、不挂起等待输入。
+
+### 安装
+
+```bash
+python -m pip install dcheckdev
+```
+
+### 使用
+
+```bash
+devcheck
+```
+
+交互菜单（TTY）：
+
+```
+1. 工具版本
+2. PATH 检查
+3. 各工具路径与关键配置
+4. 端口占用
+5. 全部跑一遍
+0. 退出
+```
+
+非交互（管道 / CI）：
+
+```bash
+devcheck </dev/null
+# 或
+python checkdev.py </dev/null
+```
+
+建议在 PowerShell、Windows Terminal 等真正的终端里运行，颜色显示最完整。
+
+---
+
+## Overview
+
+`dcheckdev` prints colored tables showing:
+
+1. **Tool versions**: auto-detects installed tools from a built-in common catalog via `PATH` (`shutil.which`); shows version and executable path; skips missing catalog entries (does not scan every PATH executable)
+2. **PATH check**: duplicate, missing, unexpanded-variable and file-instead-of-directory entries
+3. **Key configs**: probes only for detected tools (Go env, pip/npm registry, Git identity, Docker Compose plugin, etc.); env vars such as `JAVA_HOME` appear when set or when a related tool is installed
+4. **Port usage**: whether ports 8000, 8080, 5173, 3306, 5672 and 6379 are in use, and by which process
+
+From **0.2.0**, in an interactive TTY `devcheck` shows a short opening animation and a numbered menu. Option 3 only lists config subgroups that have something to show (plus "all configs"). When stdin or stdout is not a TTY (CI, pipes), it falls back to running all checks once without prompting.
+
+### Install
+
+```bash
+python -m pip install dcheckdev
+```
+
+### Usage
+
+```bash
+devcheck
+```
+
+## License
+
+MIT

{dcheckdev-0.1.0 → dcheckdev-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "dcheckdev"
-version = "0.1.0"
+version = "0.2.0"
 description = "One-command local dev environment checker: tool versions, PATH, key configs and port usage"
 readme = "README.md"
 requires-python = ">=3.9"

dcheckdev-0.1.0/PKG-INFO

@@ -1,72 +0,0 @@
-Metadata-Version: 2.4
-Name: dcheckdev
-Version: 0.1.0
-Summary: One-command local dev environment checker: tool versions, PATH, key configs and port usage
-Author: dongzhongcen
-License-Expression: MIT
-Project-URL: Homepage, https://github.com/dongzhongcen
-Keywords: cli,devtools,environment,path,windows
-Classifier: Programming Language :: Python :: 3
-Classifier: Operating System :: OS Independent
-Classifier: Environment :: Console
-Classifier: Topic :: Software Development
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: rich
-Requires-Dist: psutil
-Dynamic: license-file
-
-# dcheckdev
-
-一键检查本地开发环境的命令行工具。 / A one-command local dev environment checker.
-
-## 简介
-
-`dcheckdev` 会用彩色表格列出：
-
-1. **工具版本**：Python、Go、Node、Git、Java、Wails 是否安装、版本号和实际使用的位置
-2. **PATH 检查**：重复、失效、变量无法展开、误把文件写进 PATH 的条目
-3. **关键配置**：GOROOT / GOPATH / GOPROXY、pip 镜像、npm 镜像和全局目录、Git 用户名和邮箱、JAVA_HOME
-4. **端口占用**：8000、8080、5173、3306、5672、6379 是否被占用，以及占用的程序
-
-### 安装
-
-```bash
-python -m pip install dcheckdev
-```
-
-### 使用
-
-```bash
-devcheck
-```
-
-建议在 PowerShell、Windows Terminal 等真正的终端里运行，颜色显示最完整。
-
----
-
-## Overview
-
-`dcheckdev` prints colored tables showing:
-
-1. **Tool versions**: whether Python, Go, Node, Git, Java and Wails are installed, their versions and which executable is actually used
-2. **PATH check**: duplicate, missing, unexpanded-variable and file-instead-of-directory entries
-3. **Key configs**: GOROOT / GOPATH / GOPROXY, pip index, npm registry and global prefix, Git user name and email, JAVA_HOME
-4. **Port usage**: whether ports 8000, 8080, 5173, 3306, 5672 and 6379 are in use, and by which process
-
-### Install
-
-```bash
-python -m pip install dcheckdev
-```
-
-### Usage
-
-```bash
-devcheck
-```
-
-## License
-
-MIT

dcheckdev-0.1.0/README.md

@@ -1,53 +0,0 @@
-# dcheckdev
-
-一键检查本地开发环境的命令行工具。 / A one-command local dev environment checker.
-
-## 简介
-
-`dcheckdev` 会用彩色表格列出：
-
-1. **工具版本**：Python、Go、Node、Git、Java、Wails 是否安装、版本号和实际使用的位置
-2. **PATH 检查**：重复、失效、变量无法展开、误把文件写进 PATH 的条目
-3. **关键配置**：GOROOT / GOPATH / GOPROXY、pip 镜像、npm 镜像和全局目录、Git 用户名和邮箱、JAVA_HOME
-4. **端口占用**：8000、8080、5173、3306、5672、6379 是否被占用，以及占用的程序
-
-### 安装
-
-```bash
-python -m pip install dcheckdev
-```
-
-### 使用
-
-```bash
-devcheck
-```
-
-建议在 PowerShell、Windows Terminal 等真正的终端里运行，颜色显示最完整。
-
----
-
-## Overview
-
-`dcheckdev` prints colored tables showing:
-
-1. **Tool versions**: whether Python, Go, Node, Git, Java and Wails are installed, their versions and which executable is actually used
-2. **PATH check**: duplicate, missing, unexpanded-variable and file-instead-of-directory entries
-3. **Key configs**: GOROOT / GOPATH / GOPROXY, pip index, npm registry and global prefix, Git user name and email, JAVA_HOME
-4. **Port usage**: whether ports 8000, 8080, 5173, 3306, 5672 and 6379 are in use, and by which process
-
-### Install
-
-```bash
-python -m pip install dcheckdev
-```
-
-### Usage
-
-```bash
-devcheck
-```
-
-## License
-
-MIT

dcheckdev-0.1.0/checkdev.py

@@ -1,198 +0,0 @@
-import os
-import shutil
-import subprocess
-import sys
-
-import psutil
-from rich import box
-from rich.console import Console
-from rich.table import Table
-
-# 真正的终端能自动测出宽度；PyCharm 运行窗口测不出，就固定按 200 宽排版
-console = Console(width=None if sys.stdout.isatty() else 200)
-
-# 要检查的工具：(显示名, 命令)
-TOOLS = [
-    ("Python", ["python", "--version"]),
-    ("Go", ["go", "version"]),
-    ("Node", ["node", "--version"]),
-    ("Git", ["git", "--version"]),
-    ("Java", ["java", "-version"]),
-    ("Wails", ["wails", "version"]),
-]
-
-# 每个工具要查看的配置：工具名 -> [(配置名, 命令), ...]
-CONFIGS = {
-    "Go": [
-        ("GOROOT", ["go", "env", "GOROOT"]),
-        ("GOPATH", ["go", "env", "GOPATH"]),
-        ("GOPROXY", ["go", "env", "GOPROXY"]),
-    ],
-    "Python": [
-        ("pip 镜像", ["python", "-m", "pip", "config", "get", "global.index-url"]),
-    ],
-    "Node": [
-        ("npm 镜像", ["npm", "config", "get", "registry"]),
-        ("全局目录", ["npm", "config", "get", "prefix"]),
-    ],
-    "Git": [
-        ("user.name", ["git", "config", "--global", "user.name"]),
-        ("user.email", ["git", "config", "--global", "user.email"]),
-    ],
-}
-
-# 直接读取的环境变量
-ENV_VARS = ["JAVA_HOME"]
-
-# 要检查的端口：端口号 -> 通常是谁在用
-PORTS = {
-    8000: "FastAPI / Django",
-    8080: "Spring Boot / Tomcat",
-    5173: "Vite 前端",
-    3306: "MySQL",
-    5672: "RabbitMQ",
-    6379: "Redis",
-}
-
-
-def make_table(title, *columns):
-    """创建统一样式的表格：没有竖线，每列都不折行，宽度按最长的文字"""
-    table = Table(title=title, box=box.SIMPLE_HEAD, title_justify="left")
-    for col in columns:
-        table.add_column(col, no_wrap=True)
-    return table
-
-
-def run(cmd):
-    """运行命令，返回 (返回码, 第一行输出)；没安装返回 None"""
-    exe = shutil.which(cmd[0])
-    if exe is None:
-        return None
-    try:
-        result = subprocess.run(
-            [exe] + cmd[1:],
-            capture_output=True,
-            text=True,
-            encoding="utf-8",
-            errors="replace",
-            timeout=10,
-        )
-    except subprocess.TimeoutExpired:
-        return -1, "超时"
-
-    output = (result.stdout or result.stderr).strip()
-    first_line = output.splitlines()[0] if output else ""
-    return result.returncode, first_line
-
-
-def check_tools():
-    table = make_table("1. 工具版本", "工具", "状态", "版本", "位置")
-
-    for name, cmd in TOOLS:
-        location = shutil.which(cmd[0]) or ""
-        res = run(cmd)
-        if res is None:
-            status, version = "[red]未安装[/red]", ""
-        elif res[0] == 0:
-            status, version = "[green]已安装[/green]", res[1]
-        else:
-            status, version = "[yellow]出错[/yellow]", res[1]
-        table.add_row(f"[bold]{name}[/bold]", status, version, f"[dim]{location}[/dim]")
-
-    console.print(table)
-
-
-def check_path():
-    table = make_table("2. PATH 检查", "问题", "路径")
-
-    paths = os.environ.get("PATH", "").split(os.pathsep)
-    seen = set()
-    for raw in paths:
-        raw = raw.strip()
-        if not raw:
-            continue
-        p = os.path.expandvars(raw)
-        key = os.path.normcase(os.path.normpath(p))
-        if key in seen:
-            table.add_row("[yellow]重复[/yellow]", raw)
-        elif "%" in p:
-            table.add_row("[red]变量无法展开[/red]", raw)
-        elif os.path.isfile(p):
-            table.add_row("[yellow]是文件不是目录[/yellow]", raw)
-        elif not os.path.isdir(p):
-            table.add_row("[red]失效[/red]", raw)
-        seen.add(key)
-
-    if table.row_count == 0:
-        console.print(f"[green]2. PATH 检查：共 {len(paths)} 项，没有问题[/green]")
-    else:
-        table.caption = f"PATH 共 {len(paths)} 项，发现 {table.row_count} 个问题"
-        console.print(table)
-
-
-def check_configs():
-    table = make_table("3. 关键配置", "工具", "配置", "值")
-
-    for tool, items in CONFIGS.items():
-        for label, cmd in items:
-            res = run(cmd)
-            if res is None:
-                table.add_row(tool, label, f"[dim]没找到 {cmd[0]}，跳过[/dim]")
-                break
-            if res[0] == 0 and res[1]:
-                value = res[1]
-            else:
-                value = "[yellow]（未设置）[/yellow]"
-            table.add_row(f"[bold]{tool}[/bold]", label, value)
-
-    for name in ENV_VARS:
-        value = os.environ.get(name) or "[yellow]（未设置）[/yellow]"
-        table.add_row("[bold]环境变量[/bold]", name, value)
-
-    console.print(table)
-
-
-def find_listeners():
-    """返回 {端口: 进程 PID}，只看正在监听的 TCP 端口"""
-    listeners = {}
-    for conn in psutil.net_connections(kind="tcp"):
-        if conn.status == psutil.CONN_LISTEN and conn.laddr:
-            listeners.setdefault(conn.laddr.port, conn.pid)
-    return listeners
-
-
-def process_name(pid):
-    """根据 PID 查进程名，查不到返回问号"""
-    if not pid:
-        return "?"
-    try:
-        return psutil.Process(pid).name()
-    except (psutil.NoSuchProcess, psutil.AccessDenied):
-        return "?"
-
-
-def check_ports():
-    table = make_table("4. 端口占用", "端口", "用途", "状态", "占用程序")
-    table.columns[0].justify = "right"
-
-    listeners = find_listeners()
-    for port, usage in PORTS.items():
-        if port in listeners:
-            pid = listeners[port]
-            table.add_row(str(port), usage, "[yellow]占用[/yellow]",
-                          f"{process_name(pid)} (PID {pid})")
-        else:
-            table.add_row(str(port), usage, "[green]空闲[/green]", "")
-
-    console.print(table)
-
-
-def main():
-    check_tools()
-    check_path()
-    check_configs()
-    check_ports()
-
-
-if __name__ == "__main__":
-    main()

dcheckdev-0.1.0/dcheckdev.egg-info/PKG-INFO

@@ -1,72 +0,0 @@
-Metadata-Version: 2.4
-Name: dcheckdev
-Version: 0.1.0
-Summary: One-command local dev environment checker: tool versions, PATH, key configs and port usage
-Author: dongzhongcen
-License-Expression: MIT
-Project-URL: Homepage, https://github.com/dongzhongcen
-Keywords: cli,devtools,environment,path,windows
-Classifier: Programming Language :: Python :: 3
-Classifier: Operating System :: OS Independent
-Classifier: Environment :: Console
-Classifier: Topic :: Software Development
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: rich
-Requires-Dist: psutil
-Dynamic: license-file
-
-# dcheckdev
-
-一键检查本地开发环境的命令行工具。 / A one-command local dev environment checker.
-
-## 简介
-
-`dcheckdev` 会用彩色表格列出：
-
-1. **工具版本**：Python、Go、Node、Git、Java、Wails 是否安装、版本号和实际使用的位置
-2. **PATH 检查**：重复、失效、变量无法展开、误把文件写进 PATH 的条目
-3. **关键配置**：GOROOT / GOPATH / GOPROXY、pip 镜像、npm 镜像和全局目录、Git 用户名和邮箱、JAVA_HOME
-4. **端口占用**：8000、8080、5173、3306、5672、6379 是否被占用，以及占用的程序
-
-### 安装
-
-```bash
-python -m pip install dcheckdev
-```
-
-### 使用
-
-```bash
-devcheck
-```
-
-建议在 PowerShell、Windows Terminal 等真正的终端里运行，颜色显示最完整。
-
----
-
-## Overview
-
-`dcheckdev` prints colored tables showing:
-
-1. **Tool versions**: whether Python, Go, Node, Git, Java and Wails are installed, their versions and which executable is actually used
-2. **PATH check**: duplicate, missing, unexpanded-variable and file-instead-of-directory entries
-3. **Key configs**: GOROOT / GOPATH / GOPROXY, pip index, npm registry and global prefix, Git user name and email, JAVA_HOME
-4. **Port usage**: whether ports 8000, 8080, 5173, 3306, 5672 and 6379 are in use, and by which process
-
-### Install
-
-```bash
-python -m pip install dcheckdev
-```
-
-### Usage
-
-```bash
-devcheck
-```
-
-## License
-
-MIT