手把手教你开发第一个命令行程序
最后更新于:2022-04-02 06:52:56
## 手把手教你开发第一个命令行程序
[TOC]
### 需求:
仿照`npm`命令,实现我们自己的命令行程序**`mynpm`**,包括`mynpm -V ,mynpm init ,mynpm install`这几个命令
### 简单需求分析:
* `mynpm -V `
打印版本
* `mynpm init `
1.仿照npm init提示用户输入各种信息
2.所有用户输入信息保存到mypackage.json的文件中
* `mynpm install `
调用`npm install`命令,根据`-save` ,`--save-dev `, `-g`这几个参数的不同使用不同的处理方法
* `--salve`:模块安装成功之后,把模块名称写入`mypackage.json`文件的`dependencies`字段中
* `--save-dev`:模块安装成功之后,把模块名称写入`mypackage.json`文件的`devDependencies`字段中
* `-g`:全局安装模块
### 需求实现
#### 创建工程
1. `mkdir mynpm`
1. `cd mynpm`
1. `npm init`
1. `创建入口文件index.js`
#### 第三方模块安装
实现上面的需求,需要用到的模块:
* 路径处理
* 文件系统处理
* 进程
* shelljs
* 命令行参数处理
* 命令行交互模块
使用`npm init`命令时,需要用户确认输入信息,这时,需要格式化输出`JSON`到命令行,可以使用第三方模块`jsonFormat`
除了路径处理(`path`)模块,其他模块均为第三方模块,需要先安装才能引用
`npm install --save json-format co co-prompt commander fs-extra shelljs `
#### 代码实现
* 模块引用
~~~
#!/usr/bin/env node
//模块引用
var path = require('path');
var co = require('co');
var prompt = require('co-prompt');
var program = require('commander');
var fs = require('fs-extra');
var shell = require('shelljs');
//格式化输出JSON对象
var jsonFormat = require('json-format');
~~~
* 子命令和参数定义
~~~
//定义版本号,由本模块package.json的version决定,使用-V或者--version打印
program
.version(require('./package.json').version)
.usage('[command] [options]')
.option('-d, --description', 'Description of the module.'); //参数定义
program
.command('init')
.description('general package.json')
.option('-y,--yes', 'general package.json without prompt')
.action(init);//init命令触发时,调用init()方法
program
.command('install [optional...]')
.description('install modules')
.option('-S,--save', 'save modules as dependencies')
.option('-D,--save-dev', 'save modules as dependencies')
.option('-g,--global', 'save modules as global')
.action(install);//install命令触发时,调用install()方法
program.parse(process.argv);
~~~
* 实现 init()方法
~~~
/**
* 处理init命令
* @param {Object} pOptions - init命令的参数
*/
function init(pOptions) {
co(function*() {
var mypackage = {};
var isPromptMode = pOptions.yes ? false : true;
//默认名称为当前文件夹名称的小写
var _defaultName = path.basename(process.cwd()).toLowerCase();
//默认入口文件为index.js
var _defaultEntryPoint = 'index.js'
// var jsArr = shell.ls('*.js');没有js文件时,有额外输出
var jsArr = shell.ls();
//当前工作目录下,如果存在js文件,将找到的第一个js文件作为默认值
for (var i = 0; i < jsArr.length; i++) {
if (path.extname(jsArr[i]) === '.js') {
_defaultEntryPoint = jsArr[i];
break;
}
};
var _testCommand = 'echo \"Error: no test specified\" && exit 1';
//拼接将生成的package.json文件的绝对路径
var mypackagePath = path.resolve(process.cwd(), 'package.json');
var _inputName = '',
_inputVersion = '',
_inputDesc = '',
_inputEntryPoint = '',
_inputTestCommand = '',
_gitRepository = '',
_keywords = '',
_author = '',
_license = '',
_confirm = '';
if (isPromptMode) {
console.log('This utility will walk you through creating a package.json file.It only covers the most common items, and tries to guess sensible defaults.\n\n' + 'Press ^C at any time to quit.');
_inputName = yield prompt('name: (' + _defaultName + ') ');
_inputVersion = yield prompt('version: (1.0.0) ');
_inputDesc = yield prompt.multiline('description: ');
_inputEntryPoint = yield prompt('entry point: (' + _defaultEntryPoint + ') ');
_inputTestCommand = yield prompt('test command: ');
_gitRepository = yield prompt('git repository: ');
_keywords = yield prompt('keywords: ');
_author = yield prompt('author: ');
_license = yield prompt('license: (ISC) ');
}
//处理将生成的package.json信息
mypackage.name = _inputName || _defaultName;
mypackage.version = _inputVersion || '1.0.0';
mypackage.description = _inputDesc || '';
mypackage.main = _inputEntryPoint || _defaultEntryPoint;
mypackage.scripts = {};
mypackage.scripts.test = _inputTestCommand || _testCommand;
if (_gitRepository) {
mypackage.repository = {};
mypackage.repository.type = 'git';
mypackage.repository.url = _gitRepository;
}
mypackage.keywords = _keywords.split(' ') || [];
mypackage.author = _author || '';
mypackage.license = _license || 'ISC';
if (isPromptMode) {
console.log('About to write to ' + mypackagePath + '\n');
console.log(jsonFormat(mypackage) + '\n');
_confirm = yield prompt.confirm('Is this ok?(y|n)');
if (!_confirm) {
console.log('Aborted');
process.exit();
}
} else {
console.log('Wrote to ' + mypackagePath + '\n');
console.log(jsonFormat(mypackage) + '\n');
}
//将信息写入package.json文件
fs.outputJsonSync(mypackagePath, mypackage);
/*确保入口文件存在——优化npm init方法,懒得每次都创建入口文件(比如index.js)*/
fs.ensureFileSync(mypackage.main);
process.exit();
});
}
~~~
* 实现install()方法
~~~
/**
* 处理install命令
* @param {Array} pOptional - 安装的模块名称
* @param {Object} pOptions - install命令后面带的参数
*/
function install(pOptional, pOptions) {
var _command = ['npm', 'install'];
_command = _command.concat(pOptional);
if (pOptions.global)
_command.push('-g')
else if (pOptions.save) {
ensurePackageJsonExist();
_command.push('--save')
} else if (pOptions.saveDev) {
ensurePackageJsonExist();
_command.push('--save-dev')
}
// console.log(_command.join(' '))
shell.exec(_command.join(' '), { async: true });
}
/**
* package.json不存在,显示帮助信息
*/
function ensurePackageJsonExist() {
if (!fs.existsSync(path.join(process.cwd(), 'package.json'))) {
console.log('在当前文件夹下找不到\"package.json\“文件,建议先init')
program.help();
}
}
~~~
### 使用命令行程序
#### 使用前的配置
为了能全局使用命令行程序,必须先在package.json文件中加一个字段
~~~
"bin": {
"mynpm": "./index.js"
},
~~~
这里,`mynpm`是我定义的名称(读者可自行定义),后面将使用`mynpm`来讲解命令的调用
>Tips:
要保证入口文件(`index.js`)第一行已经加上`#!/usr/bin/env node`,配置才算成功
#### 发布后再安装使用
* 发布模块
1. npm login
1. npm publish
* 使用已发布的模块**(假设发布模块的名称为`mynpm-cli`)**
1. 安装:
`npm install -g mynpm-cli`
1. 现在你可以使用mynpm命令代替npm命令来执行init和install了
#### 本地使用不发布
1. cd到模块工作目录下
1. 执行`npm link`或者`npm install -g`
1. 现在你可以使用mynpm命令代替npm命令来执行init和install了
### 完整demo源码下载地址
**mynpm-cli demo 源码下载地址:https://github.com/outsiderLazy/mynpm-cli
** **mynpm-cli模块npm地址:https://www.npmjs.com/package/mynpm-cli
** >Tips: 1.demo模块原本的名称是`mynpm`,但该名称已经被占用,故模块改名为`mynpm-cli`。 为了命令的简洁,`bin`的字段没改,模块安装成功之后,你可以直接使用`mynpm init`和`mynpm install`命令 2.如果你下载了源码,想要本地使用,需要先在工作目录下运行`npm install`安装依赖库
';
** **mynpm-cli模块npm地址:https://www.npmjs.com/package/mynpm-cli
** >Tips: 1.demo模块原本的名称是`mynpm`,但该名称已经被占用,故模块改名为`mynpm-cli`。 为了命令的简洁,`bin`的字段没改,模块安装成功之后,你可以直接使用`mynpm init`和`mynpm install`命令 2.如果你下载了源码,想要本地使用,需要先在工作目录下运行`npm install`安装依赖库