node.js的命令行參數解析工具有很多,比如:argparse、optimist、yars、commander。optimist和yargs內部使用的解析引擎正是minimist,如果你喜歡輕量級的技術,那么minimist足夠簡單好用,代碼量也很少(只有幾百行),非常適合研讀。
minimist的特性比較全面:
- short options
- long options
- Boolean 和 Number類型的自動轉化
- option alias
先看一下minimist整體的解析過程,代碼大致是:
for (var i = 0; i < args.length; i++) {
var arg = args[i];
if (/^--.+=/.test(arg)) {
...
} else if (/^--no-.+/.test(arg)) {
...
} else if (/^--.+/.test(arg)) {
...
} else if (/^-[^-]+/.test(arg)) {
...
} else {
...
}
}
解析過程中,minimist會依次匹配不同的模式,從long options到short options,匹配之后再進行相應的解析工作。
我們可以寫一個簡單地例子來試試minimist:
// test.js
var args = require('minimist')(process.argv.slice(2));
console.log(args.hello);
$ node test.js --hello=world
// world
$ node test.js --hello world
// world
$ node test.js --hello
// true 注意:不是空字符串而是true
從上面的例子可以看到,minimist和optimist一樣會把參數解析成一個字典。但是最后一次的值與前兩次不太一樣。去掉world
之后,hello
的值變成了true
。一般情況下,如果參數后面沒有跟著的value的話,minimist會把參數的值解析成true。不過,minimist在解析接口當中提供的string
選項來修改上面的解析過程。string
選項可以傳入一個數組,數組中的參數會被一直解析成字符串。我們修改一下上面的test.js
var args = require('minimist')(process.argv.slice(2), {
string: ["hello"]
});
console.log(args.hello);
$ node test.js --hello world
// world
$ node test.js --hello
// ""
在string
選項當中添加了hello
之后,hello
的值會一直解析成字符串,如果去掉了world
,那么hello
將解析成空字符串。
minimist還支持boolean
選項,與string
選項相反,在boolean
選項當中的參數,會被一直解析成true
或false
,比如下面的例子:
var args = require('minimist')(process.argv.slice(2), {
boolean: ["hello"]
});
console.log(args.hello);
console.log(args._);
$ node test.js --hello world
// true
// [ 'world' ]
$ node test.js
// false
// []
hello
將一直被解析成true
或false
,添加的world
會保存到args
的_
選項里面。
除了string
和boolean
以外,minimist還提供了default
和alias
兩個選項,分別用來設定默認值和option alias。