fcmd 0.2.0__tar.gz → 0.2.2__tar.gz

{fcmd-0.2.0 → fcmd-0.2.2}/.bumpversion.toml

@@ -1,5 +1,5 @@
 [tool.bumpversion]
-current_version = "0.2.0"
+current_version = "0.2.2"
 commit = true
 exclude = ["template/*"]
 message = "chore: 更新版本 {current_version} → {new_version}"

{fcmd-0.2.0 → fcmd-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: fcmd
-Version: 0.2.0
+Version: 0.2.2
 Summary: 极速 Python 工具集应用：DAG 任务调度 + 组合 CLI
 Author: fcmd
 License: MIT
@@ -182,7 +182,7 @@ fcmd completion --shell fish | source         # fish
 |------|------|------|
 | `txttool` | - | 文本处理（大小写/去重/排序/统计/截断） |
 | `asciitool` | - | ASCII 码表（char/code/table） |
-| `basetool` | - | 编码解码（Base64/URL/HTML/Hex） |
+| `codetool` | - | 编解码（Base64/URL/HTML/Hex/ROT13） |
 | `casetool` | - | 命名风格转换（camel/snake/kebab/pascal） |
 | `colortool` | - | 颜色换算（RGB/HEX/HSL/HSV） |
 | `convtool` | - | 单位换算（长度/重量/温度/面积等） |
@@ -218,7 +218,7 @@ fcmd completion --shell fish | source         # fish
 | 工具 | 别名 | 说明 |
 |------|------|------|
 | `sysinfo` | - | 系统信息收集（Python/平台/内存/磁盘/CPU） |
-| `portcheck` | - | 端口检查与扫描（纯 socket，跨平台） |
+| `portcheck` | - | 端口检查与扫描（socket 检测占用，lsof/netstat 查询占用进程，跨平台） |
 | `taskkill` | - | 按名称终止进程（Windows taskkill / Unix pkill） |
 | `which` | - | 查找可执行命令路径 |
 | `clr` | - | 跨平台清屏 |
@@ -237,7 +237,6 @@ fcmd completion --shell fish | source         # fish
 | `envdev` | - | 开发环境镜像源配置（Python/Conda/Rust，Linux 专用操作跳过） |
 | `setenv` | - | 设置当前进程环境变量（支持 `--default` 仅在未设置时写入） |
 | `sshcopyid` | - | SSH 公钥部署到远程服务器（依赖 sshpass） |
-| `codetool` | - | 代码统计（行数/字符数/空行/注释行） |
 
 查看任意工具的子命令与字段详情：
 

{fcmd-0.2.0 → fcmd-0.2.2}/README.md

@@ -119,7 +119,7 @@ fcmd completion --shell fish | source         # fish
 |------|------|------|
 | `txttool` | - | 文本处理（大小写/去重/排序/统计/截断） |
 | `asciitool` | - | ASCII 码表（char/code/table） |
-| `basetool` | - | 编码解码（Base64/URL/HTML/Hex） |
+| `codetool` | - | 编解码（Base64/URL/HTML/Hex/ROT13） |
 | `casetool` | - | 命名风格转换（camel/snake/kebab/pascal） |
 | `colortool` | - | 颜色换算（RGB/HEX/HSL/HSV） |
 | `convtool` | - | 单位换算（长度/重量/温度/面积等） |
@@ -155,7 +155,7 @@ fcmd completion --shell fish | source         # fish
 | 工具 | 别名 | 说明 |
 |------|------|------|
 | `sysinfo` | - | 系统信息收集（Python/平台/内存/磁盘/CPU） |
-| `portcheck` | - | 端口检查与扫描（纯 socket，跨平台） |
+| `portcheck` | - | 端口检查与扫描（socket 检测占用，lsof/netstat 查询占用进程，跨平台） |
 | `taskkill` | - | 按名称终止进程（Windows taskkill / Unix pkill） |
 | `which` | - | 查找可执行命令路径 |
 | `clr` | - | 跨平台清屏 |
@@ -174,7 +174,6 @@ fcmd completion --shell fish | source         # fish
 | `envdev` | - | 开发环境镜像源配置（Python/Conda/Rust，Linux 专用操作跳过） |
 | `setenv` | - | 设置当前进程环境变量（支持 `--default` 仅在未设置时写入） |
 | `sshcopyid` | - | SSH 公钥部署到远程服务器（依赖 sshpass） |
-| `codetool` | - | 代码统计（行数/字符数/空行/注释行） |
 
 查看任意工具的子命令与字段详情：
 

{fcmd-0.2.0 → fcmd-0.2.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "fcmd"
-version = "0.2.0"
+version = "0.2.2"
 description = "极速 Python 工具集应用：DAG 任务调度 + 组合 CLI"
 readme = "README.md"
 requires-python = ">=3.8"
@@ -27,7 +27,6 @@ fcmd = "fcmd.cli.main:main"
 archivex = "fcmd.cli.archivex:main"
 asciitool = "fcmd.cli.asciitool:main"
 autofmt = "fcmd.cli.autofmt:main"
-basetool = "fcmd.cli.basetool:main"
 bumpversion = "fcmd.cli.bumpversion:main"
 casetool = "fcmd.cli.casetool:main"
 clr = "fcmd.cli.clr:main"

{fcmd-0.2.0 → fcmd-0.2.2}/src/fcmd/__init__.py

@@ -22,7 +22,7 @@ from __future__ import annotations
 
 from typing import Any
 
-__version__ = "0.2.0"
+__version__ = "0.2.2"
 
 __all__ = [
     "Context",

fcmd-0.2.2/src/fcmd/__main__.py

@@ -0,0 +1,6 @@
+"""``python -m fcmd`` 入口。"""
+
+from fcmd.cli.main import main
+
+if __name__ == "__main__":  # pragma: no cover - 脚本入口，pytest 经 import 触发，不可达
+    main()

{fcmd-0.2.0 → fcmd-0.2.2}/src/fcmd/_compat.py

@@ -1,6 +1,6 @@
 import sys
 
-if sys.version_info >= (3, 13):
+if sys.version_info >= (3, 13):  # pragma: no cover - 测试环境单版本
     from typing import TypeVar
 else:
     from typing_extensions import TypeVar

{fcmd-0.2.0 → fcmd-0.2.2}/src/fcmd/apis/dag.py

@@ -362,9 +362,8 @@ class Graph:
     def subgraph_with_deps(self, names: Iterable[str]) -> Graph:
         """返回包含 ``names`` 及其所有传递依赖的新图。
 
-        与 :meth:`subgraph_by_names` 不同，本方法会沿 ``depends_on`` 和
-        ``soft_depends_on`` 向上遍历，确保被选中的任务所需的上游全部包含在内，
-        使子图可独立执行。
+        沿 ``depends_on`` 和 ``soft_depends_on`` 向上遍历，确保被选中
+        任务所需的上游全部包含在内，使子图可独立执行。
 
         参数
         ----

{fcmd-0.2.0 → fcmd-0.2.2}/src/fcmd/apis/task.py

@@ -64,7 +64,6 @@ __all__ = [
     "RunConfig",
     "TaskCmd",
     "TaskEvent",
-    "TaskFn",
     "TaskResult",
     "TaskSpec",
     "TaskStatus",

fcmd-0.2.2/src/fcmd/cli/_env_persist.py

@@ -0,0 +1,101 @@
+"""_env_persist - 跨平台环境变量持久化辅助（私有，不参与工具发现）。
+
+``os.environ[name] = value`` 仅修改当前进程的环境变量副本，进程退出即失效。
+本模块提供 :func:`persist_env`，将环境变量实质写入用户层面：
+
+- Windows：写入注册表 ``HKEY_CURRENT_USER\\Environment``（用户级环境变量），
+  并广播 ``WM_SETTINGCHANGE`` 通知已运行的进程刷新环境（如资源管理器、
+  新开的终端）。相比 ``setx`` 无 1024 字符长度截断限制，且不依赖外部命令。
+- Linux/macOS：在 shell 启动文件（默认 ``~/.profile``）中追加或更新
+  ``export NAME="value"`` 行，登录后新终端自动生效。
+
+无论平台，同时更新当前进程的 ``os.environ``，使本次会话内立即可用。
+"""
+
+from __future__ import annotations
+
+import os
+import re
+import sys
+from pathlib import Path
+
+__all__ = ["persist_env", "shell_profile_path"]
+
+# Windows 注册表用户环境变量键路径（HKEY_CURRENT_USER 下）。
+_WIN_ENV_KEY: str = "Environment"
+
+
+def shell_profile_path() -> Path:
+    """返回 Linux/macOS 上用于持久化环境变量的 shell 启动文件路径。
+
+    优先使用 ``~/.profile``（登录 shell 通用，bash/sh/zsh 均会读取）。
+    """
+    return Path.home() / ".profile"
+
+
+def _persist_env_windows(name: str, value: str) -> None:  # pragma: no cover - 仅 Windows 运行
+    """在 Windows 上将环境变量写入注册表 ``HKCU\\Environment`` 并广播刷新通知。"""
+    import ctypes
+    import winreg
+
+    with winreg.OpenKey(winreg.HKEY_CURRENT_USER, _WIN_ENV_KEY, 0, winreg.KEY_SET_VALUE) as key:
+        winreg.SetValueEx(key, name, 0, winreg.REG_EXPAND_SZ, value)
+
+    # 广播 WM_SETTINGCHANGE，通知已运行进程刷新环境块（否则新终端才生效）。
+    hwnd_broadcast = 0xFFFF  # HWND_BROADCAST
+    wm_settingchange = 0x001A
+    smto_abortifhung = 0x0002
+    ctypes.windll.user32.SendMessageTimeoutW(
+        hwnd_broadcast,
+        wm_settingchange,
+        0,
+        "Environment",
+        smto_abortifhung,
+        5000,
+        None,
+    )
+
+
+def _persist_env_unix(name: str, value: str) -> None:
+    """在 Linux/macOS 上将 ``export NAME="value"`` 追加或更新到 shell 启动文件。"""
+    profile = shell_profile_path()
+    profile.parent.mkdir(parents=True, exist_ok=True)
+
+    export_line = f'export {name}="{value}"'
+    try:
+        existing = profile.read_text(encoding="utf-8")
+    except (OSError, UnicodeDecodeError):
+        existing = ""
+
+    # 匹配同名变量的已有 export 行（行首可有空白），存在则替换，否则追加。
+    pattern = re.compile(rf"^\s*export\s+{re.escape(name)}=.*$", re.MULTILINE)
+    if pattern.search(existing):
+        updated = pattern.sub(export_line, existing)
+    else:
+        prefix = existing if existing.endswith("\n") or not existing else existing + "\n"
+        updated = f"{prefix}{export_line}\n"
+
+    profile.write_text(updated, encoding="utf-8")
+
+
+def persist_env(name: str, value: str) -> None:
+    """持久化设置环境变量（跨平台），并同步更新当前进程。
+
+    Parameters
+    ----------
+    name:
+        环境变量名。
+    value:
+        环境变量值。
+
+    Notes
+    -----
+    Windows 写入注册表用户环境变量并广播刷新；Linux/macOS 写入
+    ``~/.profile``。两种平台均更新 ``os.environ`` 使本进程立即可用。
+    持久化写入通常需重开终端或重新登录后对新进程生效。
+    """
+    os.environ[name] = value
+    if sys.platform == "win32":
+        _persist_env_windows(name, value)
+    else:
+        _persist_env_unix(name, value)

{fcmd-0.2.0 → fcmd-0.2.2}/src/fcmd/cli/_profiler_helpers.py

@@ -112,6 +112,7 @@ def output_profile(
     if export == "text":
         sys.stdout.write(profile.describe())
         sys.stdout.write("\n")
+        sys.stdout.flush()
         return
 
     # HTML 格式
@@ -129,4 +130,5 @@ def output_profile(
         try:
             webbrowser.open(f"file:///{out_path.resolve().as_posix()}")
         except Exception as e:
+            # webbrowser.open 可抛 OS 级或 webbrowser.Error，属非关键功能
             get_console().print(f"[yellow]警告:[/yellow] 无法打开浏览器: {e}")

{fcmd-0.2.0 → fcmd-0.2.2}/src/fcmd/cli/archivex.py

@@ -529,3 +529,7 @@ def archivex_create(source: Path, output: Path) -> None:
 @fcmd.main("archivex")
 def main() -> None:
     pass
+
+
+if __name__ == "__main__":
+    main()

{fcmd-0.2.0 → fcmd-0.2.2}/src/fcmd/cli/asciitool.py

@@ -182,3 +182,7 @@ def table_cmd(start: int = _PRINTABLE_START, end: int = _PRINTABLE_END) -> None:
 @fcmd.main("asciitool")
 def main() -> None:
     pass
+
+
+if __name__ == "__main__":
+    main()

{fcmd-0.2.0 → fcmd-0.2.2}/src/fcmd/cli/autofmt.py

@@ -59,4 +59,8 @@ def lint(target: str = ".", fix: bool = False) -> None:
 
 @fcmd.main("autofmt")
 def main() -> None:
-    pass
+    pass  # pragma: no cover - @fcmd.main 装饰器替换函数体，pass 永不执行
+
+
+if __name__ == "__main__":  # pragma: no cover
+    main()

{fcmd-0.2.0 → fcmd-0.2.2}/src/fcmd/cli/bumpversion.py

@@ -305,3 +305,7 @@ def bump_project_version(part: BumpVersionType = "patch", no_tag: bool = False)
 @fcmd.main("bumpversion")
 def main() -> None:
     pass
+
+
+if __name__ == "__main__":
+    main()

{fcmd-0.2.0 → fcmd-0.2.2}/src/fcmd/cli/casetool.py

@@ -193,3 +193,7 @@ def kebab_cmd(text: str) -> None:
 @fcmd.main("casetool")
 def main() -> None:
     pass
+
+
+if __name__ == "__main__":
+    main()

{fcmd-0.2.0 → fcmd-0.2.2}/src/fcmd/cli/clr.py

@@ -57,4 +57,8 @@ def clear_screen_run() -> None:
 
 @fcmd.main("clr")
 def main() -> None:
-    pass
+    pass  # pragma: no cover - @fcmd.main 装饰器替换函数体，pass 永不执行
+
+
+if __name__ == "__main__":  # pragma: no cover
+    main()

{fcmd-0.2.0 → fcmd-0.2.2}/src/fcmd/cli/codetool.py

@@ -306,3 +306,7 @@ def html_cmd(text: str, decode: bool = False) -> None:
 @fcmd.main("codetool")
 def main() -> None:
     pass
+
+
+if __name__ == "__main__":
+    main()

{fcmd-0.2.0 → fcmd-0.2.2}/src/fcmd/cli/colortool.py

@@ -273,3 +273,7 @@ def hsl2rgb_cmd(h: float, s: float, light: float) -> None:
 @fcmd.main("colortool")
 def main() -> None:
     pass
+
+
+if __name__ == "__main__":
+    main()

{fcmd-0.2.0 → fcmd-0.2.2}/src/fcmd/cli/convtool.py

@@ -308,3 +308,7 @@ def datasize_cmd(
 @fcmd.main("convtool")
 def main() -> None:
     pass
+
+
+if __name__ == "__main__":
+    main()

{fcmd-0.2.0 → fcmd-0.2.2}/src/fcmd/cli/cryptool.py

@@ -352,3 +352,7 @@ def decrypt_cmd(text: str, password: str = "", key: str = "", env: bool = False)
 @fcmd.main("cryptool")
 def main() -> None:
     pass
+
+
+if __name__ == "__main__":
+    main()

{fcmd-0.2.0 → fcmd-0.2.2}/src/fcmd/cli/csvtool.py

@@ -454,3 +454,7 @@ def csvtool_merge(files: list[Path], mode: str = "union", output: str = "") -> N
 @fcmd.main("csvtool")
 def main() -> None:
     pass
+
+
+if __name__ == "__main__":
+    main()

{fcmd-0.2.0 → fcmd-0.2.2}/src/fcmd/cli/dockercmd.py

@@ -46,4 +46,8 @@ def docker_login(username: str = "", registry: str = _DEFAULT_REGISTRY) -> None:
 
 @fcmd.main("dockercmd")
 def main() -> None:
-    pass
+    pass  # pragma: no cover - @fcmd.main 装饰器替换函数体，pass 永不执行
+
+
+if __name__ == "__main__":  # pragma: no cover
+    main()

{fcmd-0.2.0 → fcmd-0.2.2}/src/fcmd/cli/envdev.py

@@ -1,6 +1,6 @@
 """envdev - 开发环境镜像源配置工具。
 
-配置 Python / Conda / Rust 镜像源（Linux 还会安装 Qt 库、中文字体、Docker）。
+配置 Python / Conda / Rust / Bun 镜像源（Linux 还会安装 Qt 库、中文字体、Docker）。
 所有镜像源参数互不影响，可单独使用。Linux 专用操作（系统镜像/Qt/字体/Docker）
 在非 Linux 平台上由函数内部跳过。
 
@@ -9,32 +9,30 @@
     fcmd envdev setup-python                      # 配置 Python 镜像源（默认清华）
     fcmd envdev setup-python --mirror aliyun      # 配置阿里云镜像源
     fcmd envdev setup-conda --mirror ustc         # 配置 Conda 镜像源
-    fcmd envdev setup-rust --mirror tsinghua      # 配置 Rust 镜像源
-    fcmd envdev download-rustup                   # 下载 Rustup 安装脚本
-    fcmd envdev install-rust --version stable     # 安装 Rust 工具链
+    fcmd envdev rust --mirror tsinghua nightly    # 配置 Rust 环境（镜像源 + 下载 + 安装）
+    fcmd envdev js-bun                            # 配置 Bun 环境（镜像源 + 安装）
 """
 
 from __future__ import annotations
 
 import getpass
-import os
 import shutil
 import sys
 from pathlib import Path
 
 import fcmd
+from fcmd.cli._env_persist import persist_env
 from fcmd.models import run_command
 
 __all__ = [
-    "download_rustup_script",
     "install_linux_docker",
     "install_linux_fonts",
     "install_linux_qt_libs",
-    "install_rust_toolchain",
+    "setup_bun_env",
     "setup_conda_mirror",
     "setup_linux_system_mirror",
     "setup_python_mirror",
-    "setup_rust_mirror",
+    "setup_rust_env",
 ]
 
 # ============================================================================
@@ -163,6 +161,9 @@ _INSTALL_MIRROR_SCRIPT: str = "sudo bash /tmp/linuxmirrors.sh"
 _RUSTUP_DOWNLOAD_URL_LINUX: str = "https://mirrors.aliyun.com/repo/rust/rustup-init.sh"
 _RUSTUP_DOWNLOAD_URL_WINDOWS: str = "https://static.rust-lang.org/rustup/dist/x86_64-pc-windows-msvc/rustup-init.exe"
 
+_BUN_NPM_REGISTRY: str = "https://registry.npmmirror.com"
+_BUN_INSTALL_SCRIPT_URL: str = "https://bun.sh/install"
+
 
 # ============================================================================
 # 私有辅助
@@ -182,16 +183,17 @@ def _pip_config_path() -> Path:
 
 
 @fcmd.tool("envdev", subcommand="setup-python", help="配置 Python 镜像源")
-def setup_python_mirror(mirror: str = "tsinghua") -> None:
-    """配置 Python 镜像源（设置环境变量 + 写入 pip 配置文件）。
+def setup_python_mirror(mirror: str = "aliyun") -> None:
+    """配置 Python 镜像源（持久化环境变量 + 写入 pip 配置文件）。
 
-    设置 ``PIP_INDEX_URL`` / ``PIP_TRUSTED_HOSTS`` / ``UV_INDEX_URL`` /
-    ``UV_PYTHON_INSTALL_MIRROR`` 等环境变量，并写入 pip 配置文件。
+    通过 :func:`persist_env` 持久化 ``PIP_INDEX_URL`` / ``PIP_TRUSTED_HOSTS`` /
+    ``UV_INDEX_URL`` / ``UV_PYTHON_INSTALL_MIRROR`` 等环境变量（Windows 写注册表，
+    Linux/macOS 写 ``~/.profile``，同时更新当前进程），并写入 pip 配置文件。
 
     Parameters
     ----------
     mirror:
-        镜像源名称：tsinghua/aliyun/huaweicloud/ustc/zju（默认 tsinghua）
+        镜像源名称：tsinghua/aliyun/huaweicloud/ustc/zju（默认 aliyun）
     """
     if mirror not in _PIP_INDEX_URLS:
         print(f"未知 Python 镜像源: {mirror}")
@@ -200,12 +202,13 @@ def setup_python_mirror(mirror: str = "tsinghua") -> None:
     index_url = _PIP_INDEX_URLS[mirror]
     trusted_host = _PIP_TRUSTED_HOSTS[mirror]
 
-    os.environ["PIP_INDEX_URL"] = index_url
-    os.environ["PIP_TRUSTED_HOSTS"] = trusted_host
-    os.environ["UV_INDEX_URL"] = index_url
-    os.environ["UV_PYTHON_INSTALL_MIRROR"] = _UV_PYTHON_INSTALL_MIRROR
-    os.environ["UV_HTTP_TIMEOUT"] = "600"
-    os.environ["UV_LINK_MODE"] = "copy"
+    print(f"配置 Python 镜像源: {mirror}")
+    persist_env("PIP_INDEX_URL", index_url)
+    persist_env("PIP_TRUSTED_HOSTS", trusted_host)
+    persist_env("UV_INDEX_URL", index_url)
+    persist_env("UV_PYTHON_INSTALL_MIRROR", _UV_PYTHON_INSTALL_MIRROR)
+    persist_env("UV_HTTP_TIMEOUT", "600")
+    persist_env("UV_LINK_MODE", "copy")
 
     config_path = _pip_config_path()
     config_path.parent.mkdir(parents=True, exist_ok=True)
@@ -215,13 +218,13 @@ def setup_python_mirror(mirror: str = "tsinghua") -> None:
 
 
 @fcmd.tool("envdev", subcommand="setup-conda", help="配置 Conda 镜像源")
-def setup_conda_mirror(mirror: str = "tsinghua") -> None:
+def setup_conda_mirror(mirror: str = "aliyun") -> None:
     """配置 Conda 镜像源（写入 ~/.condarc）。
 
     Parameters
     ----------
     mirror:
-        镜像源名称：tsinghua/ustc/bsfu/aliyun（默认 tsinghua）
+        镜像源名称：tsinghua/ustc/bsfu/aliyun（默认 aliyun）
     """
     if mirror not in _CONDA_MIRROR_URLS:
         print(f"未知 Conda 镜像源: {mirror}")
@@ -235,27 +238,31 @@ def setup_conda_mirror(mirror: str = "tsinghua") -> None:
     print(f"Conda 镜像源已配置: {mirror} -> {config_path}")
 
 
-@fcmd.tool("envdev", subcommand="setup-rust", help="配置 Rust 镜像源")
-def setup_rust_mirror(mirror: str = "tsinghua") -> None:
-    """配置 Rust 镜像源（设置环境变量 + 写入 cargo config + 创建 sccache 目录）。
+# ============================================================================
+# Rust 工具链安装
+# ============================================================================
+@fcmd.tool("envdev", subcommand="setup-rust", help="配置 Rust 镜像源", hidden=True)
+def _setup_rust_mirror(mirror: str = "aliyun") -> None:
+    """配置 Rust 镜像源（持久化环境变量 + 写入 cargo config + 创建 sccache 目录）。
 
-    设置 ``RUSTUP_DIST_SERVER`` / ``RUSTUP_UPDATE_ROOT`` / ``RUST_SCCACHE_DIR``
-    等环境变量，写入 ``~/.cargo/config.toml``，并创建 sccache 缓存目录。
+    通过 :func:`persist_env` 持久化 ``RUSTUP_DIST_SERVER`` / ``RUSTUP_UPDATE_ROOT`` /
+    ``RUST_SCCACHE_DIR`` 等环境变量，写入 ``~/.cargo/config.toml``，并创建
+    sccache 缓存目录。
 
     Parameters
     ----------
     mirror:
-        镜像源名称：tsinghua/ustc/aliyun（默认 tsinghua）
+        镜像源名称：tsinghua/ustc/aliyun（默认 aliyun）
     """
     if mirror not in _RUSTUP_MIRRORS:
         print(f"未知 Rust 镜像源: {mirror}")
         return
 
     mirrors = _RUSTUP_MIRRORS[mirror]
-    os.environ["RUSTUP_DIST_SERVER"] = mirrors["RUSTUP_DIST_SERVER"]
-    os.environ["RUSTUP_UPDATE_ROOT"] = mirrors["RUSTUP_UPDATE_ROOT"]
-    os.environ["RUST_SCCACHE_DIR"] = str(_RUST_SCCACHE_DIR)
-    os.environ["RUST_SCCACHE_CACHE_SIZE"] = _RUST_SCCACHE_CACHE_SIZE
+    persist_env("RUSTUP_DIST_SERVER", mirrors["RUSTUP_DIST_SERVER"])
+    persist_env("RUSTUP_UPDATE_ROOT", mirrors["RUSTUP_UPDATE_ROOT"])
+    persist_env("RUST_SCCACHE_DIR", str(_RUST_SCCACHE_DIR))
+    persist_env("RUST_SCCACHE_CACHE_SIZE", _RUST_SCCACHE_CACHE_SIZE)
 
     _RUST_SCCACHE_DIR.mkdir(parents=True, exist_ok=True)
 
@@ -271,13 +278,8 @@ def setup_rust_mirror(mirror: str = "tsinghua") -> None:
     print(f"Rust 镜像源已配置: {mirror} -> {config_path}")
 
 
-# ============================================================================
-# Rust 工具链安装
-# ============================================================================
-
-
-@fcmd.tool("envdev", subcommand="download-rustup", help="下载 Rustup 安装脚本")
-def download_rustup_script() -> None:
+@fcmd.tool("envdev", subcommand="download-rustup", help="下载 Rustup 安装脚本", hidden=True)
+def _download_rustup() -> None:
     """下载 Rustup 安装脚本（跨平台，已安装 rustup 时跳过）。
 
     Linux 下载 ``rustup-init.sh``，Windows 下载 ``rustup-init.exe``。
@@ -304,8 +306,8 @@ def download_rustup_script() -> None:
         run_command(["curl", "-fsSL", _RUSTUP_DOWNLOAD_URL_LINUX, "-o", "rustup-init.sh"])
 
 
-@fcmd.tool("envdev", subcommand="install-rust", help="安装 Rust 工具链")
-def install_rust_toolchain(version: str = "stable") -> None:
+@fcmd.tool("envdev", subcommand="install-rust", help="安装 Rust 工具链", hidden=True)
+def _install_rust_toolchain(version: str = "stable") -> None:
     """安装 Rust 工具链（rustup 未安装时跳过）。
 
     Parameters
@@ -321,6 +323,83 @@ def install_rust_toolchain(version: str = "stable") -> None:
     print(f"Rust 工具链 {version} 安装完成")
 
 
+@fcmd.tool("envdev", subcommand="rust", help="配置 Rust 环境")
+def setup_rust_env(mirror: str = "aliyun", rust_version: str = "stable") -> None:
+    """配置 Rust 环境（镜像源 + 下载 rustup + 安装工具链）。
+
+    依次执行：配置 Rust 镜像源（环境变量 + ``~/.cargo/config.toml`` + sccache 目录）、
+    下载 Rustup 安装脚本（已安装 rustup 时跳过）、安装指定版本工具链
+    （rustup 未安装时跳过）。
+
+    Parameters
+    ----------
+    mirror:
+        镜像源名称：tsinghua/ustc/aliyun（默认 aliyun）
+    rust_version:
+        Rust 版本：``stable`` / ``nightly`` / ``beta``（默认 ``stable``）
+    """
+    _setup_rust_mirror(mirror)
+    _download_rustup()
+    _install_rust_toolchain(rust_version)
+
+
+# ============================================================================
+# JavaScript 工具链安装
+# ============================================================================
+
+
+@fcmd.tool("envdev", subcommand="setup-bun", help="配置 Bun 镜像源", hidden=True)
+def _setup_bun_mirror() -> None:
+    """配置 Bun npm 镜像源（持久化环境变量 + 写入 ``~/.bunfig.toml``）。
+
+    通过 :func:`persist_env` 持久化 ``BUN_CONFIG_REGISTRY`` 环境变量，
+    并写入 bunfig.toml 指向 npmmirror。
+    """
+    persist_env("BUN_CONFIG_REGISTRY", _BUN_NPM_REGISTRY)
+
+    config_path = Path.home() / ".bunfig.toml"
+    config_path.parent.mkdir(parents=True, exist_ok=True)
+    content = f'[install]\nregistry = "{_BUN_NPM_REGISTRY}"\n'
+    config_path.write_text(content, encoding="utf-8")
+    print(f"Bun 镜像源已配置: {_BUN_NPM_REGISTRY} -> {config_path}")
+
+
+@fcmd.tool("envdev", subcommand="install-bun", help="安装 Bun", hidden=True)
+def _install_bun() -> None:
+    """安装 Bun.js（已安装时跳过）。
+
+    Linux/macOS 通过官方脚本安装（Linux 先安装 curl/zip/unzip 依赖）；
+    Windows 提示使用 PowerShell 安装命令。
+    """
+    if shutil.which("bun") is not None:
+        print("bun 已安装，跳过安装")
+        return
+
+    if sys.platform == "win32":
+        print("Windows 请使用 PowerShell 执行: irm bun.sh/install.ps1 | iex")
+        return
+
+    if sys.platform.startswith("linux"):
+        print("更新系统包...")
+        run_command(["sudo", "apt", "update"])
+        run_command(["sudo", "apt", "install", "-y", "curl", "zip", "unzip"])
+
+    print("下载并安装 Bun.js...")
+    run_command(["bash", "-c", f"curl -fsSL {_BUN_INSTALL_SCRIPT_URL} | bash"])
+    print("Bun.js 安装完成")
+
+
+@fcmd.tool("envdev", subcommand="js-bun", help="配置 Bun 环境")
+def setup_bun_env() -> None:
+    """配置 Bun 环境（配置 npm 镜像源 + 安装 Bun.js）。
+
+    依次执行：配置 Bun npm 镜像源（环境变量 + ``~/.bunfig.toml``）、
+    安装 Bun.js（已安装时跳过）。
+    """
+    _setup_bun_mirror()
+    _install_bun()
+
+
 # ============================================================================
 # Linux 专用子命令
 # ============================================================================
@@ -396,3 +475,7 @@ def install_linux_docker() -> None:
 @fcmd.main("envdev")
 def main() -> None:
     pass
+
+
+if __name__ == "__main__":
+    main()

{fcmd-0.2.0 → fcmd-0.2.2}/src/fcmd/cli/filedate.py

@@ -167,3 +167,7 @@ def process_files_date_clear(files: list[Path]) -> None:
 @fcmd.main("filedate")
 def main() -> None:
     pass
+
+
+if __name__ == "__main__":
+    main()

{fcmd-0.2.0 → fcmd-0.2.2}/src/fcmd/cli/filelevel.py

@@ -142,3 +142,7 @@ def process_files_level(files: list[Path], level: int = 0) -> None:
 @fcmd.main("filelevel")
 def main() -> None:
     pass
+
+
+if __name__ == "__main__":
+    main()