babel-plugin-empower-assert

[![power-assert][power-assert-banner]][power-assert-url]

[![Build Status][travis-image]][travis-url]
[![NPM version][npm-image]][npm-url]
[![License][license-image]][license-url]

babel-plugin-empower-assert is a Babel plugin to convert assert to power-assert at compile time.

INSTALL
---------------------------------------

``
$ npm install --save-dev babel-plugin-empower-assert power-assert
`


CAUTION
---------------------------------------

Babel7 is incompatible with Babel6.

For Babel6, you need to use the 1.x release of babel-plugin-empower-assert.

`
$ npm install --save-dev babel-plugin-empower-assert@1.4.0
`


HOW TO USE
---------------------------------------

$3

`javascript
{
"presets": [
...
],
"env": {
"development": {
"plugins": [
"babel-plugin-empower-assert"
],
}
}
}
`

`
$ babel /path/to/src/target.js > /path/to/build/target.js
`

$3

`
$ babel --plugins babel-plugin-empower-assert /path/to/src/target.js > /path/to/build/target.js
`

or shortly,

`
$ babel --plugins empower-assert /path/to/src/target.js > /path/to/build/target.js
`

$3

`javascript
var babel = require('@babel/core');
var jsCode = fs.readFileSync('/path/to/src/target.js');
var transformed = babel.transform(jsCode, {
presets: [...],
plugins: ['babel-plugin-empower-assert']
});
console.log(transformed.code);
`


EXAMPLE
---------------------------------------

For given math.js below,

`javascript
'use strict';

var assert = require('assert');

function add (a, b) {
assert(!isNaN(a));
assert.equal(typeof b, 'number');
assert.ok(!isNaN(b));
return a + b;
}
`

Run babel with --plugins empower-assert to transform code.

`
$ babel --plugins empower-assert /path/to/demo/math.js > /path/to/build/math.js
`

You will see assert is converted to power-assert.

`javascript
'use strict';

var assert = require('power-assert');

function add(a, b) {
assert(!isNaN(a));
assert.equal(typeof b, 'number');
assert.ok(!isNaN(b));
return a + b;
}
``

AUTHOR
---------------------------------------
* Takuto Wada

LICENSE
---------------------------------------
Licensed under the MIT license.

[power-assert-url]: https://github.com/power-assert-js/power-assert
[power-assert-banner]: https://raw.githubusercontent.com/power-assert-js/power-assert-js-logo/master/banner/banner-official-fullcolor.png

[travis-url]: https://travis-ci.org/power-assert-js/babel-plugin-empower-assert
[travis-image]: https://secure.travis-ci.org/power-assert-js/babel-plugin-empower-assert.svg?branch=master

[npm-url]: https://npmjs.org/package/babel-plugin-empower-assert
[npm-image]: https://badge.fury.io/js/babel-plugin-empower-assert.svg

[license-url]: https://github.com/power-assert-js/babel-plugin-empower-assert/blob/master/LICENSE
[license-image]: https://img.shields.io/badge/license-MIT-brightgreen.svg