用Nodejs开发命令行工具(cli)入门

日常前端开发中,经常见到各种cli,如一行命令帮你生成vue项目模板的vue-cli。编写合适的命令行工具也可以快速构建出适合自己项目的模板。

前言

node cli的本质其实就是执行node脚本。
先安装好node及npm: Nodejs官网下载
构建命令的基础需要一个执行文件nono.js及package.json配置文件。

初识命令行

一个命令行中可以由命令、参数和选项等组成,如:

//create就是命令 app就是参数
vue create app
//-l就是选项,还有-v,--version 
ls -l                   

hello nodejs

创建一个命令行工具源码目录并进入该目录

mkdir nono-cli

初始化package.json

// package.json的name将作为发布到npm上的包名称
npm init

初始化执行文件nono.js

// 在nono-cli文件夹下
mkdir bin
// 在bin文件夹下新建nono.js
touch nono.js

测试程序nono is run!

// 在nono.js中写入
// #!/usr/bin/env node 表示使用node作为脚本的解释程序,node的路径通过env来查找
// 本来需要这样运行node ./nono.js,但是加上了这句后就可以直接./nono.js运行
#!/usr/bin/env node
console.log('nono is run!')

package.json中添加bin字段,增加命令nono

"bin": {
    "nono": "bin/nono.js"
}

将该命令行工具安装到本地全局

npm install . -g

命令行中输入nono,若正常打印nono is run!即表示测试通过

nono

通过建立软链接,当修改nono.js时,执行nono.js运行结果也会有变化

// 显示下面信息即链接成功
// /usr/local/bin/nono -> /usr/local/lib/node_modules/nono-cli/bin/nono.js
// /usr/local/lib/node_modules/nono-cli -> /Users/snow/program-files/my-study/node/nono-cli
npm link

// 修改nono.js 增加:
console.log('nono changes optionally')

// 再次执行命令nono,也会打印 nono changes optionally

安装依赖模块开发

用到的一些模块:

npm install commander inquirer ora chalk --save
  • commander: commander能够更好的解析命令行参数,使开发更简单
  • inquirer: 命令行交互界面集合。可以提问,解析输入,校验回答等
  • ora: 可以使终端输出更优雅,设置正在进行,成功或失败
  • chalk: 可以对终端输出的文字设置一些颜色等样式

commander基本使用

require('commander')
	// 指定版本
  .version(require('../package').version)
   // 使用说明
  .usage(' [options]')
  // 创建命令
  // .command('init')命令会找到同文件夹的xxx-init.js并执行
  .command('init', 'generate a new project from a template')
  .command('list', 'list available official templates')
  .command('build', 'prototype a new project')
  // 解析命令行
  // parse这句很重要,最后都要加这句
  .parse(process.argv)

inquirer基本使用

var inquirer = require('inquirer');
inquirer
  .prompt([
    /* Pass your questions in here */
			{
                type: 'confirm',
                name: 'install',
                message: '是否安装依赖',
                default: true
            }
  ])
  .then(answers => {
    // Use user feedback for... whatever!!
    // answers: {install: true/false}
  });

ora基本使用

const ora = require('ora');
spinner = ora('开始安装依赖...');
spinner.start();
....
spinner.succeed('初始化项目完成。')
spinner.stop();

//或者
const ora = require('ora');
ora().fail(err)

项目文件目录

该项目可以通过选择下载不同的项目模板,配置自己的 package.json,并且可以选择是否要进行安装依赖。
用Nodejs开发命令行工具(cli)入门_第1张图片

  • bin // 这里放置一些命令文件,例如nono.js为入口文件,nono-init.js 为nono init命令
  • lib // 存放一些编写需要的公共方法
  • config // 配置文件,一些配置项

nono.js

#!/usr/bin/env node

// console.log('nono is run!')

// console.log('nono changes optionally')

const program = require('commander');
program
.usage(' [项目名称]')
.version('1.0.3', '-v, --version')
// .command('init')命令会找到同文件夹的nono-init
.command('init', '初始化项目')
.parse(process.argv)

nono-init.js

根据传入的项目名称及命令行中选择的模板进行模板下载。具体执行过程如下:

userdeMacBook-Pro:nono-cli snow$ nono init app
开始创建...
? 请选择模板 simple-vue
⠹ 开始下载模板,模板地址: git@github.com:helloGrape/simple-vue.gitstdout:
✔ 模板下载完成,开始配置配置文件
? 请输入项目名称 app
? 请输入项目版本 1.0.0
? 请输入项目描述
? 是否安装依赖 Yes
✔ 初始化项目完成。

nono.default.config.js

选择你想选择的模板

module.exports = {
    templateUrls: {
        'test': 'https://code.aliyun.com/haokur/test.git',
        'simple-vue': '[email protected]:helloGrape/simple-vue.git',
        'vue-admain': '[email protected]:PanJiaChen/vue-admin-template.git'
    }
}

发布npm包

注册账号

在 npm 官网 https://www.npmjs.org 申请一个账号

添加用户名到npm环境中

npm adduser --registry http://registry.npmjs.org

指定registry为npm。这主要是区分本机已经安装了其它仓库例如cnpm的情况。

发布node项目

  • 发布的node项目需要有package.json.
  • 进入到npm项目,我的项目为nono-cli。执行命令: npm publish 也可以执行 npm publish --registry http://registry.npmjs.org 确保发往npm仓库

测试

  1. 进入到 https://www.npmjs.com/~hellogrape 查看是否有包
    用Nodejs开发命令行工具(cli)入门_第2张图片
  2. 在任意目录下执行 npm
    npm install nono-cli -g
    执行nono init app 看是否成功

版本更新

如果项目目录有所修改,则需要修改package.json中的version,修改之后再次执行 npm publish。


gitHub: https://github.com/helloGrape/nono-cli

参考:
https://blog.csdn.net/haokur/article/details/81460973
https://blog.csdn.net/wyc_cs/article/details/51568941
https://www.npmjs.com/package/commander
https://www.npmjs.com/package/inquirer

你可能感兴趣的:(node)