pncat：pnpm工作空间的依赖管理增强工具

pncat：pnpm工作空间的依赖管理增强工具

pncat A CLI tool that extends pnpm catalogs with additional features. 项目地址: https://gitcode.com/gh_mirrors/pn/pncat

1. 项目介绍

pncat 是一个为 pnpm 工作空间提供增强依赖管理的 CLI 工具。它通过智能依赖目录支持，使得 monorepo 中的依赖管理更为简便。pncat 能够检测可目录化的依赖，自动按照规则迁移依赖，并支持在添加或移除依赖时进行提示和清理。

2. 项目快速启动

首先，确保你已经安装了 Node.js 和 pnpm。接下来，按照以下步骤操作：

# 克隆仓库
git clone https://github.com/jinghaihan/pncat.git
cd pncat

# 安装依赖
pnpm install

# 运行示例命令
pnpm run detect # 检测可目录化的依赖
pnpm run migrate # 将依赖迁移到目录中
pnpm run add <package_name> # 添加带有目录支持的依赖
pnpm run remove <package_name> # 安全移除依赖
pnpm run clean # 清理未使用的目录依赖
pnpm run revert # 将目录化依赖版本 revert 回 package.json

3. 应用案例和最佳实践

检测和迁移依赖

在 monorepo 中，依赖关系的混乱可能会导致项目难以维护。pncat 可以帮助你自动检测和迁移依赖到指定的目录中，提高项目结构清晰度。

pnpm run detect # 检测哪些依赖可以被目录化
pnpm run migrate # 按照默认或自定义规则迁移依赖

自定义目录规则

你可以通过创建 pncat.config.ts 文件来自定义目录规则，以更好地符合你的项目结构。

import { defineConfig, mergeCatalogRules } from 'pncat';

export default defineConfig({
  catalogRules: mergeCatalogRules([
    {
      name: 'custom-group',
      match: ['^@myorg/(.+)'], // 匹配自定义组织的依赖
      priority: 10
    },
    // 其他规则...
  ]),
  // 其他配置...
});

依赖的添加与移除

在添加或移除依赖时，pncat 提供了交互式提示，确保操作的正确性，并自动更新相关配置。

pnpm run add <package_name> # 添加依赖
pnpm run remove <package_name> # 移除依赖

4. 典型生态项目

pncat 适用于任何使用 pnpm 作为包管理器的 monorepo 项目。特别是那些有大量依赖和需要维护清晰依赖关系的大中型项目。例如，在使用 pnpm 管理的前端 monorepo 项目中，可以通过 pncat 高效地组织和管理不同包的依赖，提高开发效率和协作流畅度。

pncat A CLI tool that extends pnpm catalogs with additional features. 项目地址: https://gitcode.com/gh_mirrors/pn/pncat