折腾向:开发一个 Node.js 命令行程序

得益于 Node.js,我们可以使用熟悉的 Javascript 语言来开发跨平台的命令行程序。

图形界面:操作简单、门槛低;
命令行界面:轻量、高效、自由。

本文将从最简单的例子出发,然后介绍如何使用 commander 来简化开发,接着列出一些有用的工具

Hello World

CLI (Command Line Interface) 允许我们在命令行调用自定义的指令,达到执行某些操作的目的。

webpack main.js bundle.js --config webpack.config.js

上面命令使用 Webpack 来打包代码,webpack 命令可以接受参数 (argument) 和选项 (option) 。在这个例子中,参数是 main.jsbundle.js,选项是--config webpack.config.js,表示把 main.js 文件中的脚本打包输出到 bundle.js 文件中,并使用 webpack.config.js 文件的配置。

那么如何开发一个自定义命令呢。

首先,使用 npm init 初始化一个项目。

# new folder
mkdir mycli

# init a project
npm init

新建 bin/mycli.js 文件,添加以下代码。

// mycli.js
console.log('This is my first CLI.')

使用 node 命令执行它。

node ./bin/mycli.js 
# > This is my first CLI.

我们已经可以得到正确输出了,那么如何将命令名称改成我们的 mycli 呢?npm
允许将可执行文件加入到操作系统的环境变量中。修改 package.json,添加 bin 字段。

// package.json
{
    ...
    "bin": {
        "mycli": "bin/index.js"
    }
}

使用 bin 字段时,需要一个命令的名称,和一个对应的可执行文件地址。全局安装该模块时,会在 npm 安装目录下建立与可执行文件的 symlink(符号链接)。局部安装该模块时,会在当前项目的 node_modules/.bin/ 目录下建立链接。

同时在 bin/mycli.js 里声明指定脚本的解释程序为 node

#! /usr/bin/env node
console.log('This is my first CLI.');

可以使用 npm link 来调试本地模块。在 mycli 目录下输入以下命令。

npm link

相当于在全局安装了我们的本地模块。现在,我们可以使用 mycli 命令了。

mycli
# > This is my first CLI.

现在,我们能够看到正确的输出了。

有时候,我们希望在命令后面添加一些参数或者配置。使用 process.argv 来查看命令后面带的参数。修改 bin/mycli.js 如下。

#! /usr/bin/env node
console.log(process.argv);

执行 mycli 命令,并在后面加上一些参数。

mycli a -b c
# > [ 'C:\\Program Files\\nodejs\\node.exe',
# >   'C:\\Users\\me\\AppData\\Roaming\\npm\\node_modules\\mycli\\bin\\mycli.js',
# >   'a',
# >   '-b',
# >   'c' ]

可以看到,process.argv 是一个数组,数组的前两项用来做执行命令行映射的脚本,从 process.argv[2] 开始才是我们需要的参数。

至此,我们已经完成了一个最简单的命令行程序开发。

使用 commander 来简化开发流程

commander 是一个Node.js命令行程序的完全解决方案。使用 commander 可以很大程度地提升我们的开发效率。

安装 commander 依赖。注意需要用 --save,因为是代码运行时需要的模块。

# install dependeny
npm install commander --save

在学习 commander 之前,理清两个概念,argument (参数) 和 option (选项)。看看最开始的例子。

webpack main.js bundle.js --config webpack.config.js

argument 直接跟在命令后面,不需要加任何前缀,option 需要在前面添加一些前缀如 --config。所以,这里 main.jsbundle.js 是参数,而 --config webpack.config.js 是选项。

修改 bin/mycli.js 如下。

#! /usr/bin/env node
var program = require('commander');

program
  .version(require('../package.json').version)
  .usage('<path> [options]')
  .parse(process.argv);
    
console.log(program.args);

version 方法用来配置命令行程序的版本,这里取了 package.jsonversion
字段。usage 方法用来配置使用说明,示例表示 mycli 接受一个路径参数和可选的一个或多个选项。然后把 process.argv 传给 parse 方法用于处理参数。program.args 是命令接收的参数,已经过滤掉 process.argv 前两项的路径了。

执行如下命令。

# show version
mycli -V
# > 1.0.0
# show help
mycli -h
# > 
# >   Usage: mycli <path> [options]
# > 
# > 
# >   Options:
# > 
# >     -V, --version  output the version number
# >     -h, --help     output usage information

commander 默认存在两个选项 -V-h,代表查看版本和查看帮助。

继续执行。

mycli a -b c
# > [ 'a' ]

可以看到只打印了 a 参数,因为 -b c 被当作选项了。继续修改 bin/mycli.js,来解析选项。

#! /usr/bin/env node
var program = require('commander');

program
  .version(require('../package.json').version)
  .usage('<path> [options]')
  .option('-v --verbose', '启用啰嗦模式')
  .option('-o --output <path>', '输出到路径')
  .option('-l --list [item]', '输出列表')
  .parse(process.argv);
    
console.log('Arguments: ' + program.args);
console.log('Verbose: ' + program.verbose);
console.log('Output: ' + program.output);
console.log('List: ' + program.list);

option 方法的第一个参数接受一个包含选项简写选项全称可选的接收值 (<> 表示必填,[] 表示选填) 的字符串,第二个参数是使用说明,会在查看帮助时打印出来。

--xxx 选项需要接收一个值,program.xxx 可以拿到选项的值,如 program.outputprogram.list
--xxx 选项无接收值,program.xxx 可以拿到一个布尔值,如 program.verbose

执行命令。

mycli value1 -v value2 -o value3 -l value4
# > Arguments: value1,value2
# > Verbose: true
# > Output: value3
# > List: value4

-v 选项无接受值,所以 value2 被当作参数。

一些有用的工具

  • left-pad - 常用来制表,对齐(广为流传的一个包..)
const leftPad = require('left-pad')

leftPad('foo', 5) // => "  foo"

leftPad('foobar', 6) // => "foobar"

leftPad(1, 2, '0') // => "01"

leftPad(17, 5, 0) // => "00017"
  • chalk - 控制命令行文本样式
const chalk = require('chalk');

console.log(chalk.blue('Hello world!'));
  • ora - 终端加载动效
const ora = require('ora');

const spinner = ora('Loading unicorns').start();

setTimeout(() => {
    spinner.color = 'yellow';
    spinner.text = 'Loading rainbows';
}, 1000);
  • ink - 使用 React 来开发命令行界面

参考

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,456评论 5 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,370评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,337评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,583评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,596评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,572评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,936评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,595评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,850评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,601评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,685评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,371评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,951评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,934评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,167评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,636评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,411评论 2 342

推荐阅读更多精彩内容

  • linux资料总章2.1 1.0写的不好抱歉 但是2.0已经改了很多 但是错误还是无法避免 以后资料会慢慢更新 大...
    数据革命阅读 12,128评论 2 34
  • 一种编程语言是否易用,很大程度上,取决于开发命令行程序的能力。 Node.js 作为目前最热门的开发工具之一,怎样...
    猪猪9527阅读 705评论 0 1
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,585评论 18 139
  • Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行环境。Node.js 使用了一个...
    正凯阅读 27,755评论 4 24
  • 人潮涌动的时刻总是更显背影的沧桑 和狂欢笑声后的孤独感 华丽的表象是为了掩饰逝去的青春 我们总在年少轻狂时感慨时光...
    流浪诗人与狗阅读 159评论 0 0