Node.js 包发布辅助工具集

使用方式

package-tools - A Node.js package managing tool

Usage:
    package-tools [通用参数] <命令> [命令参数]

通用参数:
    --registry <value>     npm服务器，默认从.npmrc读取(必须有schema://)
    --dist-tag <value>     需要从服务器读取时使用的tag，默认为"latest"
    --package <value>      实际操作前，更改当前目录（此文件夹应包含package.json）
    --debug, -d            增加输出（最多2个）
    --quiet, -s, --silent  减少输出
    --help, -h             显示帮助信息

全部命令:
 * detect-package-change    本地运行npm pack并与npm上的最新版本对比差异
 * monorepo-bump-version    在monorepo中按照依赖顺序分别运行detect-package-change
 * monorepo-cnpm-sync       调用cnpm sync命令
 * monorepo-invalid         从npm缓存中删除关于本monorepo的数据，以便安装最新版本
 * monorepo-link-binaries   将monorepo中每个项目的bins连接到当前项目的 ./node_modules/.bin
 * monorepo-list            列出所有项目目录
 * monorepo-publish         在monorepo中按照依赖顺序发布修改过的包
 * monorepo-tsconfig        为所有项目的 tsconfig.json 添加 references 字段
 * monorepo-upgrade         更新monorepo中各个项目的所有依赖版本
 * run-if-version-mismatch  如果版本号改变，则运行命令

可用工具

• --bump: 不要输出，而是：如果发现有修改，则自动更新package.json（当前仅支持将version的PATCH位+1）
• --json: 输出json（当检测到stdout不是终端时，默认为json输出）

此工具要求PATH中存在git

输出结果示例:

• --json模式: { changedFiles: [......], changed: true }
• 默认模式: changed no. / changed yes.

只要运行过程没有错误，程序就返回0，无论是否发现修改。

1. 调用npm-registry-fetch包，从npm下载最新的package.json，它支持标准http缓存和代理设置
2. 和本地的package.json比较version字段
   • 如果本地版本号大于远程，则直接判定为有修改
3. 从npm下载dist.tarball指定的压缩包，解压到一个临时目录中
4. 在包目录中运行npm pack（也支持pnpm）得到压缩包
5. 检查两个压缩包是否相同
   1. 在临时目录中初始化git仓库
   2. 立即提交前面解压结果
   3. 将打包结果覆盖到同一个目录中
   4. 再次提交
   5. 检查git log输出的内容（强制LANG=C）
      • 如果没有任何修改，则判定为无修改
6. 如果有--bump，调用semver修改package.json中的version字段
7. 否则输出有修改

命令行中的“--”不可省略

示例：

Eg: njspkg run-if-version-mismatch --flush -- pnpm publish --no-git-checks

按照依赖顺序，只有上游项目至少成功一次，才会启动下游的watch脚本

通过匹配命令输出确定编译是否成功

目前仅支持 tsc、heft 两个命令，需要在这里添加新的判断函数

相当于按照依赖顺序，在每个项目中：

1. njspkg detect-package-change --bump
2. njspkg run-if-version-mismatch -- pnpm run publish

然后在工程中运行一次： 2. njspkg monorepo-cnpm-sync 3. njspkg monorepo-invalid