使用node.js构建命令行工具

不言

Lepaskan： 2018-04-10 17:04:45

asal

1470 orang telah melayarinya

本篇文章给大家分享的内容是使用node.js构建命令行工具，有着一定的参考价值，有需要的朋友可以参考一下

工具说明

inquirer.js：一个封装了常用命令行交互的node.js模块，通过该模块可以很方便地构建一个新的命令行应用。
shell.js：跨平台的unix shell命令模块。
Node版本：由于inquirer.js的异步方法默认返回Promise，建议使用node.js>=8。

目标

工作中有大量项目上线前最后一步需要执行测试、编译、更新版本号、提交，甚至执行的命令都是一样，在这里我们通过命令行工具将这些步骤一键自动化，同时进行预检查，防止错漏。

准备

创建一个新的Node.js项目。
创建文件bin/my-cli.js，node.js项目通常会把cli入口放在bin目录下，其他模块放在lib目录下。
在bin/my-cli.js文件头部添加#!/usr/bin/env node。
添加 "bin": {"my-cli": "./bin/my-cli.js"},到package.json，声明我们要使用的命令。
项目根目录下执行npm link，创建一个全局命令my-cli。

稍微修改下my-cli.js，添加代码console.log("I am a cli tool!")，然后打开控制台运行my-cli命令，如果看到控制台输出I am a cli tool!就表示成功。

安装依赖

首先安装主要依赖的两个模块（关于这两个模块的使用请参考官方文档）

npm install inquirer shelljs

构建发布流程自动化

接下来首先实现测试、更新版本号、构建、自动提交发布的自动化

const pkg = JSON.parse(fs.readFileSync(pkgPath, &#39;utf8&#39;));

const { version } = await inquirer.prompt([
  {
    type: &#39;list&#39;,
    name: &#39;version&#39;,
    message: &#39;版本号更新方式：&#39;,
    choices: [
      {
        name: `v${semver.inc(pkg.version, &#39;patch&#39;)}: Fix Bugs / Patch`,
        value: &#39;patch&#39;
      },
      {
        name: `v${semver.inc(pkg.version, &#39;minor&#39;)}: Release New Version`,
        value: &#39;minor&#39;
      },
    ]
  }
]);
// 拉取最新版本
shelljs.exec(&#39;git pull&#39;);
// 运行测试
shelljs.exec(&#39;npm test&#39;);
//通过npm version更新版本号，但不自动添加git tag，而是在构建完成后由cli工具添加
shelljs.exec(`npm version ${version} --no-git-tag-version`);
// 构建
shelljs.exec(&#39;npm run build&#39;);
// 提交发布代码
const nextVersion = semver.inc(pkg.version, version);
shelljs.exec(&#39;git add . -A&#39;);
shelljs.exec(`git commit -m "build: v${nextVersion}"`)
shelljs.exec(`git tag -a v${nextVersion} -m "build: ${nextVersion}"`);
shelljs.exec("git push")
shelljs.exec("git push --tags");

Salin selepas log masuk

添加新功能：配置检查

接下来给my-cli添加一个功能：

当检查到package.json的my-cli对象的check-baidu-id属性为true时，检查项目的config.json是否存在baidu-id属性

if (pkg[&#39;my-cli&#39;] && pkg[&#39;my-cli&#39;][&#39;check-baidu-id&#39;]) {
  const configPath = path.join(process.cwd(), &#39;config.json&#39;);
  if (!fs.existsSync(configPath)) {
    shelljs.echo(&#39;找不到config.json&#39;);
    shelljs.exit(1);
  }
  const config = JSON.parse(fs.readFileSync(configPath, &#39;utf8&#39;));
  if (!config[&#39;baidu-id&#39;]) {
    shelljs.echo(&#39;config.json缺少属性[baidu-id]&#39;);
    shelljs.exit(1);
  }

Salin selepas log masuk