minimist輕量級的命令行參數解析引擎

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選項當中的參數,會被一直解析成truefalse,比如下面的例子:

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將一直被解析成truefalse,添加的world會保存到args_選項里面。

除了stringboolean以外,minimist還提供了defaultalias兩個選項,分別用來設定默認值和option alias。

原文鏈接:http://jarvys.github.io/2014/06/01/minimist-js/

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容