记npm包开发全过程

概述

• 为什么开发npm包？
• 如何开发？
• 如何写单元测试？
• package.json
• 如何发布模块？
• 如何使用？

为什么开发npm模块？

NPM的全称是Node Package Manager，是一个NodeJS包管理和分发工具，已经成为了非官方的发布Node模块（包）的标准。
npm官网

如何开发？

接下来由带领大家完成一个简单的npm包，功能：读写文件
是不是很复杂呢？？？

npm init

创建基础目录或文件

• mkdir tests lib
• touch index.js README.md

.
├── README.md //说明文档
├── index.js //主入口
├── lib //功能文件
├── package.json //包信息
└── tests //测试用例

开发功能

• cd lib/
• touch file.js utils.js

utils.js文件内容

var Promise = require("es6-promise").Promise;

/**
 * 提供各种工具方法
 * @type {{*}}
 */
module.exports = {
    /**
     * 获取Defer对象
     * @return {[type]} [description]
     */
    getDefer: function (){
        var deferred = {};
        deferred.promise = new Promise(function(resolve, reject){
            deferred.resolve = resolve;
            deferred.reject = reject;
        });
        return deferred;
    },
    /**
     * promise when方法
     * @param promises promise数组
     * @returns {[type]} [description]
     */
    when: function(promises) {
        var deffered = this.getDefer();
        Promise.all(promises).then(function(data) {
            deffered.resolve(data);
        }, function(err) {
            deffered.reject(err);
        });
        return deffered.promise;
    }
}

注：npm install es6-promise --save --verbos

file.js内容

var fs = require('fs');
var path = require('path');
var utils = require('./utils.js');

module.exports = {
	/**
	 * 写文件
	 * @param file 文件路径
	 * @param data 数据
	 */
	writeFile: function(file, data) {
		var deferred = utils.getDefer();
		file = path.resolve(file);

		fs.writeFile(file, data, 'utf-8', function(err) {
			if(err){
				deferred.reject(err);
			}else {
				deferred.resolve(true);
			}
		});
		return deferred.promise;
	},
	/**
	 * 读文件
	 * @param file 文件路径
	 */
	readFile: function(file) {
		var deferred = utils.getDefer();
		file = path.resolve(file);

		fs.readFile(file, 'utf-8', function(err, data) {
			if(err){
				deferred.reject(err);
			}else {
				deferred.resolve(data);
			}
		});
		return deferred.promise;
	}
};

主函数index.js内容

var file = require('./lib/file.js');

module.exports = {
	writeFile: file.writeFile,
	readFile: file.readFile
}

注：主要是在被使用时暴露的接口

功能开发基本完毕

此时我们并不知道我们实现的功能是否可行、可用
我们需要进行单元测试

如何写单元测试？

单元测试原则

• 对全新的代码或修改过的代码进行单元测试
• 单元测试根据单元测试计划和方案进行，排除测试的随意性
• 必须保证单元测试计划、单元测试方案、单元测试用例等经过评婶
• 当测试用例的测试结果与预期结果不一致时，单元测试的执行人员需如实记录实际的测试结果
• 只有当测试计划中的结束标准达到时，单元测试才能结束
• 对被测试单元需达到的一定的代码覆盖率要求

书写测试用例

前提条件
测试库mocha  教程

npm install -g mocha --verbos
npm install --save-dev chai --verbos

测试utils.js

var utils = require('../lib/utils.js');
var expect = require('chai').expect;

describe('utils：工具方法测试', function() {
    //defer对象测试
    describe('utils.getDefer', function() {
        var deferred = utils.getDefer();

        it('defer成功', function() {
            deferred.resolve(true);
            return deferred.promise.then(function(data) {
                expect(data).to.be.equal(true);
            });
        });

        it('defer失败', function() {
            deferred.reject(true);
            return deferred.promise.then(function() {}, function(data) {
                expect(data).to.be.equal(true);
            });
        });
    });
    //when测试
    describe('utils.when', function() {
        var deferred1 = utils.getDefer();
        var deferred2 = utils.getDefer();
        var deferred3 = utils.getDefer();
        var deferred4 = utils.getDefer();

        it('when成功', function() {
            deferred1.resolve(true);
            deferred2.resolve(true);
            return utils.when([deferred1.promise, deferred2.promise]).then(function(data) {
                expect(data).to.be.deep.equal([true, true]);
            });
        });

        it('when失败', function() {
            deferred3.resolve(true);
            deferred4.reject(false);
            return utils.when([deferred3.promise, deferred4.promise]).then(function() {},function(data) {
                expect(data).to.be.equal(false);
            });
        });
    });
});

注：mocha tests/utils.js

测试file.js

var file = require('../lib/file.js');
var expect = require('chai').expect;

describe('file：功能测试', function() {

    //writeFile功能测试
    describe('file.writeFile', function() {

        it('写文件：成功', function() {
            var path = 'README.md';
            var data = '说明文档';
            return file.writeFile(path, data).then(function(flag) {
                expect(flag).to.be.equal(true);
            });
        });

        it('写文件：失败', function() {
            var path = 'write-test.txt';
            var data = '我是写入的数据';
            return file.writeFile(path, data).then(function(){}, function(err) {
                expect(true).to.be.equal(true);
            });
        });
    });

    //readFile功能测试
    describe('file.readFile功能测试', function() {

        it('读文件：成功', function() {
            var path = 'README.md';
            return file.readFile(path).then(function(data) {
                expect(data).to.be.equal('说明文档');
            });
        });

        it('读文件：失败', function() {
            var path = 'write-test.txt';
            return file.readFile(path).then(function(){}, function(err) {
                expect(true).to.be.equal(true);
            });
        });
    });
});

注：mocha tests/file.js

持续测试...

一遍遍测试，查看测试结果，都要输入命令很无语~~
新技能：mocha --watch tests

还能做什么？

通过上面测试感觉好了不少，有没有更好的展现形式呢？

• 测试结果生成html报表（mocha --reporter mochawesome tests）
• 能不能看看测试覆盖率呢？（istanbul cover ./node_modules/mocha/bin/_mocha -- -t 2000 --recursive -R spec tests/）

注：
npm install --save-dev mochawesome --verbos
npm install --save-dev mocha --verbos
sudo npm install -g istanbul --verbos

package.json

经过上述操作之后我们发现，package.json发生了变化

{
  "name": "read-write-file",
  "version": "1.0.0",
  "description": "简单的读写文件",
  "main": "index.js",
  "scripts": {
    "test": "mocha --reporter spec --timeout 2000 --recursive tests/"
  },
  "keywords": [
    "read",
    "write"
  ],
  "author": "黑MAO",
  "license": "MIT",
  "dependencies": {
    "es6-promise": "^3.0.2"
  },
  "devDependencies": {
    "chai": "^3.4.1",
    "istanbul": "^0.4.1",
    "mocha": "^2.3.4",
    "mochawesome": "^1.2.1"
  }
}

回顾

发现不爽的地方，要执行一对命令，还有一些参数特别长，不容易记忆
该怎么办呢？

scripts脚本

npm 提供简单的执行脚本，可以通过npm run * 执行scripts写的简单脚本
于是乎~~

常用脚本

    "scripts": {
        "watch": "mocha --watch tests/",
        "test": "mocha --reporter spec --timeout 2000 --recursive tests/",
        "test-cov": "istanbul cover ./node_modules/mocha/bin/_mocha -- -t 2000 --recursive  -R spec tests/",
        "test-html": "mocha --reporter mochawesome tests/"
      },

命令行

命令行模式又是怎么做的呢？

    "bin": {
        "writeFile": "./bin/writeFile.js",
        "readFile": "./bin/readFile.js"
    },

注：
开发模式可以使用：
sudo npm link（添加命令行模式）
sudo npm unlink（取消命令行模式）

---

截至现在，我们的一个npm包就开发完成了~
是不是也没有想想中那么复杂呢？

如何发布？

• npm adduser（用户名、密码、邮箱）-- 注册帐号
• npm whoami（查看当前帐号）
• sudo npm publish（发布到npmjs.org）-- 注意：sudo权限

如何使用？

npm install read-write-file

var file = require('read-write-file');

var path = 'test.txt';
var data = '我是测试文本';

file.writeFile(path, data).then(function() {
  return file.readFile(path);
}).then(function(txt) {
  console.log('测试结果：'+txt);
});

注：sudo install -g read-write-file可以使用命令行形式

终

到目前为止，一个npm包就开发完成了~

参考资料：

• mocha教程 http://www.ruanyifeng.com/blog/2015/12/a-mocha-tutorial-of-examples.html
• nodejs教程 http://nqdeng.github.io/7-days-nodejs/