@zjex/git-workflow 0.2.23 → 0.3.0

package/tests/update.test.ts

@@ -0,0 +1,402 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { execSync } from "child_process";
+import { existsSync, unlinkSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+
+// Mock 所有外部依赖
+vi.mock("child_process", () => ({
+  execSync: vi.fn(),
+}));
+
+vi.mock("fs", () => ({
+  existsSync: vi.fn(),
+  unlinkSync: vi.fn(),
+}));
+
+vi.mock("os", () => ({
+  homedir: vi.fn(),
+}));
+
+vi.mock("path", () => ({
+  join: vi.fn(),
+}));
+
+vi.mock("ora", () => ({
+  default: vi.fn(() => ({
+    start: vi.fn().mockReturnThis(),
+    stop: vi.fn().mockReturnThis(),
+    succeed: vi.fn().mockReturnThis(),
+    fail: vi.fn().mockReturnThis(),
+  })),
+}));
+
+vi.mock("boxen", () => ({
+  default: vi.fn((content: string) => content),
+}));
+
+vi.mock("semver", () => ({
+  default: {
+    gte: vi.fn(),
+  },
+}));
+
+vi.mock("../src/utils.js", () => ({
+  colors: {
+    bold: (text: string) => text,
+    green: (text: string) => text,
+    yellow: (text: string) => text,
+    red: (text: string) => text,
+    dim: (text: string) => text,
+    cyan: (text: string) => text,
+  },
+}));
+
+describe("Update 模块测试", () => {
+  const mockExecSync = vi.mocked(execSync);
+  const mockExistsSync = vi.mocked(existsSync);
+  const mockUnlinkSync = vi.mocked(unlinkSync);
+  const mockHomedir = vi.mocked(homedir);
+  const mockJoin = vi.mocked(join);
+
+  beforeEach(() => {
+    vi.clearAllMocks();
+    // Mock console methods
+    vi.spyOn(console, "log").mockImplementation(() => {});
+    vi.spyOn(process, "exit").mockImplementation(() => {
+      throw new Error("process.exit called");
+    });
+    
+    // Default mocks
+    mockHomedir.mockReturnValue("/home/user");
+    mockJoin.mockReturnValue("/home/user/.gw-update-check");
+  });
+
+  afterEach(() => {
+    vi.restoreAllMocks();
+  });
+
+  describe("版本检查", () => {
+    it("应该正确获取最新版本", async () => {
+      mockExecSync.mockReturnValueOnce("1.2.4\n");
+      
+      const semver = await import("semver");
+      vi.mocked(semver.default.gte).mockReturnValue(true);
+      
+      const { update } = await import("../src/commands/update.js");
+      
+      await update("1.2.3");
+      
+      expect(mockExecSync).toHaveBeenCalledWith(
+        "npm view @zjex/git-workflow version",
+        expect.objectContaining({
+          encoding: "utf-8",
+          timeout: 3000,
+          stdio: ["pipe", "pipe", "ignore"],
+        })
+      );
+    });
+
+    it("应该处理网络错误", async () => {
+      mockExecSync.mockImplementation(() => {
+        throw new Error("Network error");
+      });
+      
+      const { update } = await import("../src/commands/update.js");
+      
+      await update("1.2.3");
+      
+      expect(console.log).toHaveBeenCalledWith(expect.stringContaining("请检查网络连接后重试"));
+    });
+
+    it("应该正确比较版本号", async () => {
+      mockExecSync
+        .mockReturnValueOnce("/usr/local/bin/gw\n") // which gw (isUsingVolta)
+        .mockReturnValueOnce("1.2.4\n") // npm view
+        .mockReturnValueOnce("update success"); // npm install
+      
+      const semver = await import("semver");
+      vi.mocked(semver.default.gte).mockReturnValue(false);
+      
+      const { update } = await import("../src/commands/update.js");
+      
+      try {
+        await update("1.2.3");
+      } catch (error) {
+        // 期望 process.exit 被调用
+        expect(error).toEqual(new Error("process.exit called"));
+      }
+      
+      expect(semver.default.gte).toHaveBeenCalledWith("1.2.3", "1.2.4");
+    });
+  });
+
+  describe("Volta 检测", () => {
+    it("应该正确检测 Volta 环境", async () => {
+      mockExecSync
+        .mockReturnValueOnce("/home/user/.volta/bin/gw\n") // which gw (isUsingVolta)
+        .mockReturnValueOnce("1.2.4\n") // npm view
+        .mockReturnValueOnce("update success"); // volta install
+      
+      const semver = await import("semver");
+      vi.mocked(semver.default.gte).mockReturnValue(false);
+      
+      const { update } = await import("../src/commands/update.js");
+      
+      try {
+        await update("1.2.3");
+      } catch (error) {
+        // 期望 process.exit 被调用
+        expect(error).toEqual(new Error("process.exit called"));
+      }
+      
+      expect(mockExecSync).toHaveBeenCalledWith(
+        "volta install @zjex/git-workflow@latest",
+        expect.any(Object)
+      );
+    });
+
+    it("应该正确检测非 Volta 环境", async () => {
+      mockExecSync
+        .mockReturnValueOnce("1.2.4\n") // npm view
+        .mockReturnValueOnce("/usr/local/bin/gw\n"); // which gw
+      
+      const semver = await import("semver");
+      vi.mocked(semver.default.gte).mockReturnValue(false);
+      
+      // Mock 更新命令
+      mockExecSync.mockReturnValueOnce("update success");
+      
+      const { update } = await import("../src/commands/update.js");
+      
+      try {
+        await update("1.2.3");
+      } catch (error) {
+        // 期望 process.exit 被调用
+        expect(error).toEqual(new Error("process.exit called"));
+      }
+      
+      expect(mockExecSync).toHaveBeenCalledWith(
+        "npm install -g @zjex/git-workflow@latest",
+        expect.any(Object)
+      );
+    });
+
+    it("应该处理 which 命令失败", async () => {
+      mockExecSync
+        .mockImplementationOnce(() => { // which gw (isUsingVolta)
+          throw new Error("Command not found");
+        })
+        .mockReturnValueOnce("1.2.4\n") // npm view
+        .mockReturnValueOnce("update success"); // npm install
+      
+      const semver = await import("semver");
+      vi.mocked(semver.default.gte).mockReturnValue(false);
+      
+      const { update } = await import("../src/commands/update.js");
+      
+      try {
+        await update("1.2.3");
+      } catch (error) {
+        // 期望 process.exit 被调用
+        expect(error).toEqual(new Error("process.exit called"));
+      }
+      
+      // 应该使用 npm 命令（默认）
+      expect(mockExecSync).toHaveBeenCalledWith(
+        "npm install -g @zjex/git-workflow@latest",
+        expect.any(Object)
+      );
+    });
+  });
+
+  describe("更新流程", () => {
+    it("应该在已是最新版本时显示提示", async () => {
+      mockExecSync
+        .mockReturnValueOnce("/usr/local/bin/gw\n") // which gw (isUsingVolta)
+        .mockReturnValueOnce("1.2.3\n"); // npm view (same version)
+      
+      const semver = await import("semver");
+      vi.mocked(semver.default.gte).mockReturnValue(true);
+      
+      const { update } = await import("../src/commands/update.js");
+      
+      await update("1.2.3");
+      
+      expect(console.log).toHaveBeenCalledWith(expect.stringContaining("✅ 已是最新版本"));
+    });
+
+    it("应该成功执行更新", async () => {
+      mockExecSync
+        .mockReturnValueOnce("1.2.4\n") // npm view
+        .mockReturnValueOnce("/usr/local/bin/gw\n") // which gw
+        .mockReturnValueOnce("update success"); // npm install
+      
+      const semver = await import("semver");
+      vi.mocked(semver.default.gte).mockReturnValue(false);
+      
+      const { update } = await import("../src/commands/update.js");
+      
+      try {
+        await update("1.2.3");
+      } catch (error) {
+        // 期望 process.exit 被调用
+        expect(error).toEqual(new Error("process.exit called"));
+      }
+      
+      expect(console.log).toHaveBeenCalledWith(expect.stringContaining("🎉 发现新版本！"));
+      expect(console.log).toHaveBeenCalledWith(expect.stringContaining("✨ 更新完成！"));
+    });
+
+    it("应该处理更新失败", async () => {
+      mockExecSync
+        .mockReturnValueOnce("1.2.4\n") // npm view
+        .mockReturnValueOnce("/usr/local/bin/gw\n") // which gw
+        .mockImplementationOnce(() => { // npm install
+          throw new Error("Update failed");
+        });
+      
+      const semver = await import("semver");
+      vi.mocked(semver.default.gte).mockReturnValue(false);
+      
+      const { update } = await import("../src/commands/update.js");
+      
+      try {
+        await update("1.2.3");
+      } catch (error) {
+        // 期望 process.exit 被调用
+        expect(error).toEqual(new Error("process.exit called"));
+      }
+      
+      expect(console.log).toHaveBeenCalledWith(expect.stringContaining("你可以手动运行以下命令更新"));
+    });
+  });
+
+  describe("缓存管理", () => {
+    it("应该在更新成功后清理缓存", async () => {
+      mockExistsSync.mockReturnValue(true);
+      mockExecSync
+        .mockReturnValueOnce("1.2.4\n") // npm view
+        .mockReturnValueOnce("/usr/local/bin/gw\n") // which gw
+        .mockReturnValueOnce("update success"); // npm install
+      
+      const semver = await import("semver");
+      vi.mocked(semver.default.gte).mockReturnValue(false);
+      
+      const { update } = await import("../src/commands/update.js");
+      
+      try {
+        await update("1.2.3");
+      } catch (error) {
+        // 期望 process.exit 被调用
+        expect(error).toEqual(new Error("process.exit called"));
+      }
+      
+      expect(mockUnlinkSync).toHaveBeenCalledWith("/home/user/.gw-update-check");
+    });
+
+    it("应该处理缓存文件不存在的情况", async () => {
+      mockExistsSync.mockReturnValue(false);
+      mockExecSync
+        .mockReturnValueOnce("1.2.4\n") // npm view
+        .mockReturnValueOnce("/usr/local/bin/gw\n") // which gw
+        .mockReturnValueOnce("update success"); // npm install
+      
+      const semver = await import("semver");
+      vi.mocked(semver.default.gte).mockReturnValue(false);
+      
+      const { update } = await import("../src/commands/update.js");
+      
+      try {
+        await update("1.2.3");
+      } catch (error) {
+        // 期望 process.exit 被调用
+        expect(error).toEqual(new Error("process.exit called"));
+      }
+      
+      expect(mockUnlinkSync).not.toHaveBeenCalled();
+    });
+
+    it("应该静默处理缓存清理错误", async () => {
+      mockExistsSync.mockReturnValue(true);
+      mockUnlinkSync.mockImplementation(() => {
+        throw new Error("Permission denied");
+      });
+      
+      mockExecSync
+        .mockReturnValueOnce("1.2.4\n") // npm view
+        .mockReturnValueOnce("/usr/local/bin/gw\n") // which gw
+        .mockReturnValueOnce("update success"); // npm install
+      
+      const semver = await import("semver");
+      vi.mocked(semver.default.gte).mockReturnValue(false);
+      
+      const { update } = await import("../src/commands/update.js");
+      
+      try {
+        await update("1.2.3");
+      } catch (error) {
+        // 期望 process.exit 被调用，而不是缓存清理错误
+        expect(error).toEqual(new Error("process.exit called"));
+      }
+    });
+  });
+
+  describe("用户界面", () => {
+    it("应该显示检查更新的提示", async () => {
+      mockExecSync.mockReturnValueOnce("1.2.3\n");
+      
+      const semver = await import("semver");
+      vi.mocked(semver.default.gte).mockReturnValue(true);
+      
+      const { update } = await import("../src/commands/update.js");
+      
+      await update("1.2.3");
+      
+      expect(console.log).toHaveBeenCalledWith("🔍 检查更新...");
+    });
+
+    it("应该显示版本比较信息", async () => {
+      mockExecSync
+        .mockReturnValueOnce("/usr/local/bin/gw\n") // which gw (isUsingVolta)
+        .mockReturnValueOnce("1.2.4\n") // npm view
+        .mockReturnValueOnce("update success"); // npm install
+      
+      const semver = await import("semver");
+      vi.mocked(semver.default.gte).mockReturnValue(false);
+      
+      const { update } = await import("../src/commands/update.js");
+      
+      try {
+        await update("1.2.3");
+      } catch (error) {
+        // 期望 process.exit 被调用
+        expect(error).toEqual(new Error("process.exit called"));
+      }
+      
+      expect(console.log).toHaveBeenCalledWith(expect.stringContaining("1.2.3"));
+      expect(console.log).toHaveBeenCalledWith(expect.stringContaining("1.2.4"));
+    });
+
+    it("应该显示验证命令提示", async () => {
+      mockExecSync
+        .mockReturnValueOnce("1.2.4\n") // npm view
+        .mockReturnValueOnce("/usr/local/bin/gw\n") // which gw
+        .mockReturnValueOnce("update success"); // npm install
+      
+      const semver = await import("semver");
+      vi.mocked(semver.default.gte).mockReturnValue(false);
+      
+      const { update } = await import("../src/commands/update.js");
+      
+      try {
+        await update("1.2.3");
+      } catch (error) {
+        // 期望 process.exit 被调用
+        expect(error).toEqual(new Error("process.exit called"));
+      }
+      
+      expect(console.log).toHaveBeenCalledWith(expect.stringContaining("hash -r && gw --version"));
+    });
+  });
+});

package/tests/utils.test.ts

@@ -0,0 +1,229 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { execSync } from "child_process";
+import {
+  colors,
+  TODAY,
+  theme,
+  exec,
+  execOutput,
+  checkGitRepo,
+  getMainBranch,
+  divider,
+} from "../src/utils";
+
+// Mock child_process
+vi.mock("child_process");
+
+describe("Utils 模块测试", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  afterEach(() => {
+    vi.restoreAllMocks();
+  });
+
+  describe("colors 工具", () => {
+    it("应该正确添加红色", () => {
+      const result = colors.red("error");
+      expect(result).toContain("error");
+      expect(result).toMatch(/\x1b\[31m.*\x1b\[0m/);
+    });
+
+    it("应该正确添加绿色", () => {
+      const result = colors.green("success");
+      expect(result).toContain("success");
+      expect(result).toMatch(/\x1b\[32m.*\x1b\[0m/);
+    });
+
+    it("应该正确添加黄色", () => {
+      const result = colors.yellow("warning");
+      expect(result).toContain("warning");
+      expect(result).toMatch(/\x1b\[33m.*\x1b\[0m/);
+    });
+
+    it("应该正确添加青色", () => {
+      const result = colors.cyan("info");
+      expect(result).toContain("info");
+      expect(result).toMatch(/\x1b\[36m.*\x1b\[0m/);
+    });
+
+    it("应该正确添加暗淡效果", () => {
+      const result = colors.dim("dimmed");
+      expect(result).toContain("dimmed");
+      expect(result).toMatch(/\x1b\[2m.*\x1b\[0m/);
+    });
+
+    it("应该正确添加粗体", () => {
+      const result = colors.bold("bold");
+      expect(result).toContain("bold");
+      expect(result).toMatch(/\x1b\[1m.*\x1b\[0m/);
+    });
+
+    it("应该有 reset 代码", () => {
+      expect(colors.reset).toBe("\x1b[0m");
+    });
+  });
+
+  describe("TODAY 常量", () => {
+    it("应该是 YYYYMMDD 格式", () => {
+      expect(TODAY).toMatch(/^\d{8}$/);
+    });
+
+    it("应该是今天的日期", () => {
+      const today = new Date().toISOString().slice(0, 10).replace(/-/g, "");
+      expect(TODAY).toBe(today);
+    });
+  });
+
+  describe("exec 函数", () => {
+    it("应该执行命令并返回输出", () => {
+      const mockExecSync = vi.mocked(execSync);
+      mockExecSync.mockReturnValue("output" as any);
+
+      const result = exec("git status", true);
+
+      expect(result).toBe("output");
+      expect(mockExecSync).toHaveBeenCalledWith("git status", {
+        encoding: "utf-8",
+        stdio: "pipe",
+      });
+    });
+
+    it("静默模式失败时应该返回空字符串", () => {
+      const mockExecSync = vi.mocked(execSync);
+      mockExecSync.mockImplementation(() => {
+        throw new Error("Command failed");
+      });
+
+      const result = exec("git status", true);
+
+      expect(result).toBe("");
+    });
+
+    it("非静默模式失败时应该抛出错误", () => {
+      const mockExecSync = vi.mocked(execSync);
+      mockExecSync.mockImplementation(() => {
+        throw new Error("Command failed");
+      });
+
+      expect(() => exec("git status", false)).toThrow();
+    });
+  });
+
+  describe("execOutput 函数", () => {
+    it("应该执行命令并返回 trim 后的输出", () => {
+      const mockExecSync = vi.mocked(execSync);
+      mockExecSync.mockReturnValue("  output  \n" as any);
+
+      const result = execOutput("git branch");
+
+      expect(result).toBe("output");
+    });
+
+    it("失败时应该返回空字符串", () => {
+      const mockExecSync = vi.mocked(execSync);
+      mockExecSync.mockImplementation(() => {
+        throw new Error("Command failed");
+      });
+
+      const result = execOutput("git branch");
+
+      expect(result).toBe("");
+    });
+  });
+
+  describe("checkGitRepo 函数", () => {
+    it("在 git 仓库中应该正常执行", () => {
+      const mockExecSync = vi.mocked(execSync);
+      mockExecSync.mockReturnValue("true" as any);
+
+      expect(() => checkGitRepo()).not.toThrow();
+    });
+
+    it("不在 git 仓库中应该退出", () => {
+      const mockExecSync = vi.mocked(execSync);
+      mockExecSync.mockImplementation(() => {
+        throw new Error("Not a git repository");
+      });
+
+      const mockExit = vi.spyOn(process, "exit").mockImplementation(() => {
+        throw new Error("process.exit");
+      });
+
+      expect(() => checkGitRepo()).toThrow("process.exit");
+      expect(mockExit).toHaveBeenCalledWith(1);
+
+      mockExit.mockRestore();
+    });
+  });
+
+  describe("getMainBranch 函数", () => {
+    it("应该返回 origin/main 如果存在", () => {
+      const mockExecSync = vi.mocked(execSync);
+      mockExecSync.mockReturnValue("  origin/main\n  origin/develop\n" as any);
+
+      const result = getMainBranch();
+
+      expect(result).toBe("origin/main");
+    });
+
+    it("应该返回 origin/master 如果 main 不存在", () => {
+      const mockExecSync = vi.mocked(execSync);
+      mockExecSync.mockReturnValue(
+        "  origin/master\n  origin/develop\n" as any
+      );
+
+      const result = getMainBranch();
+
+      expect(result).toBe("origin/master");
+    });
+
+    it("都不存在时应该默认返回 origin/main", () => {
+      const mockExecSync = vi.mocked(execSync);
+      mockExecSync.mockReturnValue("  origin/develop\n" as any);
+
+      const result = getMainBranch();
+
+      expect(result).toBe("origin/main");
+    });
+  });
+
+  describe("divider 函数", () => {
+    it("应该输出分隔线", () => {
+      const consoleSpy = vi.spyOn(console, "log").mockImplementation(() => {});
+
+      divider();
+
+      expect(consoleSpy).toHaveBeenCalledWith(
+        expect.stringContaining("─".repeat(40))
+      );
+
+      consoleSpy.mockRestore();
+    });
+  });
+
+  describe("theme 对象", () => {
+    it("应该有 helpMode 属性", () => {
+      expect(theme).toHaveProperty("helpMode");
+      expect(theme.helpMode).toBe("always");
+    });
+
+    it("应该有 style.keysHelpTip 方法", () => {
+      expect(theme.style).toHaveProperty("keysHelpTip");
+      expect(typeof theme.style.keysHelpTip).toBe("function");
+    });
+
+    it("keysHelpTip 应该格式化按键提示", () => {
+      const keys: [string, string][] = [
+        ["↑↓", "选择"],
+        ["space", "确认"],
+      ];
+      const result = theme.style.keysHelpTip(keys);
+
+      expect(result).toContain("↑↓ 选择");
+      expect(result).toContain("space 确认");
+      expect(result).toContain("Ctrl+C quit");
+    });
+  });
+});

package/vitest.config.ts

@@ -0,0 +1,22 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: "node",
+    // 抑制测试中的console输出，保持测试输出清洁
+    silent: false,
+    setupFiles: ["./tests/setup.ts"],
+    coverage: {
+      provider: "v8",
+      reporter: ["text", "json", "html"],
+      exclude: [
+        "node_modules/",
+        "dist/",
+        "**/*.config.ts",
+        "scripts/",
+        "**/*.test.ts",
+      ],
+    },
+  },
+});

package/zjex-logo.svg

@@ -0,0 +1,22 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 120 120" width="100" height="100">
+  <!-- ZJEX 纯图标版本 - 修复裁切问题，确保内容居中 -->
+  
+  <!-- 交叉图案 - 完美居中，适当缩小 -->
+  <g transform="translate(60, 60) scale(0.8) translate(-51, -50)">
+    <!-- 蓝色条纹 -->
+    <path d="M69.3 59.41l-9.89 9.89L51 77.73 30.46 98.26A6 6 0 0 1 22 89.83L42.56 69.3 51 60.88l9.9-9.9z" fill="#0059cc"/>
+    <path d="M102 24.28a6 6 0 0 1-1.75 4.21L77.72 51l-8.42-8.44 22.5-22.5a6 6 0 0 1 10.2 4.22z" fill="#0059cc"/>
+    
+    <!-- 青色条纹 -->
+    <path d="M83.64 6a5.94 5.94 0 0 1-1.74 4.21L41.08 51l-8.42-8.42 9.9-9.89L51 24.24 73.48 1.75A6 6 0 0 1 83.64 6z" fill="#00dac7"/>
+    <path d="M32.66 59.41L12.13 79.93a6 6 0 0 1-8.42-8.42L24.24 51z" fill="#00dac7"/>
+    
+    <!-- 浅蓝色条纹 -->
+    <path d="M51 24.24l-8.42 8.43-22.5-22.5A6 6 0 0 1 24.28 0a5.89 5.89 0 0 1 4.2 1.75z" fill="#00baec"/>
+    <path d="M98.25 79.93a5.94 5.94 0 0 1-8.42 0L51 41.09l8.42-8.42 9.9 9.89 8.4 8.44 20.53 20.51a6 6 0 0 1 0 8.42z" fill="#00baec"/>
+    
+    <!-- 深蓝色条纹 -->
+    <path d="M51 60.88l-8.44 8.42L1.74 28.49a6 6 0 0 1 8.43-8.43l22.49 22.5L41.08 51z" fill="#00abd8"/>
+    <path d="M79.93 98.26a6 6 0 0 1-8.42 0L51 77.73l8.42-8.43 20.51 20.53a6 6 0 0 1 0 8.43z" fill="#00abd8"/>
+  </g>
+</svg>