dcheckdev 0.1.0__py3-none-any.whl

checkdev.py

@@ -0,0 +1,198 @@
+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.dist-info/METADATA

@@ -0,0 +1,72 @@
+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.dist-info/RECORD

@@ -0,0 +1,7 @@
+checkdev.py,sha256=8YRpLHpYJ0dRNmebLGaYNtdPfhDIg2Mx68GMicZ1-Mw,5901
+dcheckdev-0.1.0.dist-info/licenses/LICENSE,sha256=MgRS43voHFNBfApVAUys1wwJL8aVk79str6vtQ1jacA,1069
+dcheckdev-0.1.0.dist-info/METADATA,sha256=WAvibpQRJ5OnTLlYB0T85xL3cPPxepWOVIVGeoTOunk,2041
+dcheckdev-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+dcheckdev-0.1.0.dist-info/entry_points.txt,sha256=V06FywvcuFON36OJpBP9u7k5j80tZ0-i4nrCnzksow8,43
+dcheckdev-0.1.0.dist-info/top_level.txt,sha256=FgCTAotE_eUOZ_gdLhg2YUfRrMXS46Vxodx3dv0Dkaw,9
+dcheckdev-0.1.0.dist-info/RECORD,,

dcheckdev-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

dcheckdev-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+devcheck = checkdev:main

dcheckdev-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dongzhongcen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

dcheckdev-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+checkdev