gulp-unassert

> A gulp plugin for unassert.

[![unassert][unassert-banner]][unassert-url]

[![Build Status][ci-image]][ci-url]
[![NPM version][npm-image]][npm-url]
[![Code Style][style-image]][style-url]
[![License][license-image]][license-url]

Description

gulp-unassert is a gulp plugin for unassert: Encourages programming with assertions) by providing tools to compile them away.

$3

- unassert: Encourages programming with assertions by providing tools to compile them away.
- unassertify: Browserify transform for unassert
- babel-plugin-unassert: Babel plugin for unassert
- webpack-unassert-loader: Webpack loader for unassert
- unassert-cli: CLI for unassert
- rollup-plugin-unassert: RollupJS plugin for unassert

Install

``shell
npm install --save-dev gulp-unassert
`

Usage

$3

`javascript
const unassert = require('gulp-unassert');

gulp.task('build', () => {
gulp.src('./src/*.js')
.pipe(unassert())
.pipe(gulp.dest('./dist'));
});
`

$3

`javascript
const { src, dest } = require('gulp');
const unassert = require('gulp-unassert');

function build() {
return src('./src/*.js')
.pipe(unassert())
.pipe(dest('./dist'));
}
exports.build = build;
`

$3

`javascript
const { src, dest } = require('gulp');
const unassert = require('gulp-unassert');

function build() {
return src('./src/*.js')
.pipe(unassert({
modules: [
'assert',
'assert/strict',
'node:assert',
'node:assert/strict',
'invariant',
'uvu/assert'
]
}))
.pipe(dest('./dist'));
}
exports.build = build;
`

Source maps

$3

gulp-unassert can be used with gulp-sourcemaps to generate source maps for the transformed javascript code. Note that you should init gulp-sourcemaps prior to running the gulp-unassert and write the source maps after. gulp-unassert works well with some gulp plugins that supports gulp-sourcemaps.

`javascript
const unassert = require('gulp-unassert');
const coffee = require('gulp-coffee');
const concat = require('gulp-concat');
const sourcemaps = require('gulp-sourcemaps');

gulp.task('build', () => {
// compile, instrument then concatinate
gulp.src('./src/*/.coffee')
.pipe(sourcemaps.init())
.pipe(coffee({bare: true}))
.pipe(unassert())
.pipe(concat('bundle.js'))
.pipe(sourcemaps.write())
.pipe(gulp.dest('./build'));
// will write the source maps inline in the code
});
`

For more information, see gulp-sourcemaps.

$3

In gulp 4, sourcemaps are built-in by default.

`javascript
const { src, dest } = require('gulp');
const unassert = require('gulp-unassert');
const coffee = require('gulp-coffee');
const concat = require('gulp-concat');

function build() {
return src('./src/*.coffee', { sourcemaps: true })
.pipe(coffee({ bare: true }))
.pipe(unassert())
.pipe(concat('bundle.js'))
.pipe(dest('./build'));
}
exports.build = build;
``

Changelog

See CHANGELOG

Author

* Takuto Wada

Our Support Policy

We support Node under maintenance. In other words, we stop supporting old Node version when their maintenance ends.

This means that any other environment is not supported.

NOTE: If gulp-unassert works in any of the unsupported environments, it is purely coincidental and has no bearing on future compatibility. Use at your own risk.

License

Licensed under the MIT license.

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

[npm-url]: https://npmjs.org/package/gulp-unassert
[npm-image]: https://badge.fury.io/js/gulp-unassert.svg

[ci-image]: https://github.com/unassert-js/gulp-unassert/workflows/Node.js%20CI/badge.svg
[ci-url]: https://github.com/unassert-js/gulp-unassert/actions?query=workflow%3A%22Node.js+CI%22

[license-url]: https://github.com/unassert-js/gulp-unassert/blob/master/LICENSE-MIT
[license-image]: https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat

[style-url]: https://github.com/Flet/semistandard
[style-image]: https://img.shields.io/badge/code%20style-semistandard-brightgreen.svg