{"id":13659574,"url":"https://github.com/power-assert-js/gulp-espower","last_synced_at":"2025-04-07T20:34:04.043Z","repository":{"id":12974301,"uuid":"15652913","full_name":"power-assert-js/gulp-espower","owner":"power-assert-js","description":"Gulp plugin for power-assert","archived":false,"fork":false,"pushed_at":"2017-06-12T02:56:22.000Z","size":75,"stargazers_count":17,"open_issues_count":0,"forks_count":1,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-04-03T08:41:12.128Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/power-assert-js.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE-MIT","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-01-05T14:57:02.000Z","updated_at":"2016-10-27T13:43:59.000Z","dependencies_parsed_at":"2022-09-17T14:10:34.717Z","dependency_job_id":null,"html_url":"https://github.com/power-assert-js/gulp-espower","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/power-assert-js%2Fgulp-espower","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/power-assert-js%2Fgulp-espower/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/power-assert-js%2Fgulp-espower/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/power-assert-js%2Fgulp-espower/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/power-assert-js","download_url":"https://codeload.github.com/power-assert-js/gulp-espower/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247725947,"owners_count":20985798,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-02T05:01:10.224Z","updated_at":"2025-04-07T20:33:59.035Z","avatar_url":"https://github.com/power-assert-js.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"# gulp-espower\n\n[![Build Status][travis-image]][travis-url]\n[![NPM version][npm-image]][npm-url]\n[![Dependency Status][depstat-image]][depstat-url]\n[![License][license-image]][license-url]\n\n\u003e A [gulp](https://github.com/gulpjs/gulp) plugin for [power-assert](https://github.com/power-assert-js/power-assert).\n\n## Description\n\n`gulp-espower` is a gulp plugin to instrument \"Power Assert\" feature into your code.\n\n\nInternally, `gulp-espower` task uses `espower` module that manipulates assertion expression (JavaScript Code) defined in [The ESTree Spec](https://github.com/estree/estree) (formerly known as [Mozilla SpiderMonkey Parser API](https://developer.mozilla.org/en-US/docs/SpiderMonkey/Parser_API)), to instrument power-assert feature into the code. The magic is done by using [Esprima](http://esprima.org/) and [Escodegen](https://github.com/Constellation/escodegen).\n\n\nPull-requests, issue reports and patches are always welcomed. See [power-assert](https://github.com/power-assert-js/power-assert) project for more documentation.\n\n\n## Usage\n\nFirst, install `gulp-espower` as a development dependency:\n\n```shell\nnpm install --save-dev gulp-espower\n```\n\nThen, add it to your `gulpfile.js`:\n\n```javascript\nvar espower = require('gulp-espower');\n\ngulp.src('./test/*.js')\n    .pipe(espower())\n    .pipe(gulp.dest('./dist'));\n```\n\n\n## Source maps\n\ngulp-espower works with [gulp-sourcemaps](https://github.com/floridoo/gulp-sourcemaps) to generate source maps for the instrumented javascript code. Note that you should `init` gulp-sourcemaps prior to running the gulp-espower and `write` the source maps after. gulp-espower works well with some gulp plugins that supports [gulp-sourcemaps](https://github.com/floridoo/gulp-sourcemaps).\n\n```javascript\nvar espower = require('gulp-espower');\nvar coffee = require('gulp-coffee');\nvar concat = require('gulp-concat');\nvar sourcemaps = require('gulp-sourcemaps');\n\n// compile, instrument then concatinate\ngulp.src('./test/*test.coffee')\n    .pipe(sourcemaps.init())\n    .pipe(coffee())\n    .pipe(espower())\n    .pipe(concat('all_test.js'))\n    .pipe(sourcemaps.write())\n    .pipe(gulp.dest('./build'));\n// will write the source maps inline in the code\n```\n\nFor more information, see [gulp-sourcemaps](https://github.com/floridoo/gulp-sourcemaps).\n\n\n## API\n\n### espower(options)\n\n#### options.patterns\n\n| type                | default value       |\n|:--------------------|:--------------------|\n| `Array` of `string` | objects shown below |\n\n```javascript\n[\n    'assert(value, [message])',\n    'assert.ok(value, [message])',\n    'assert.equal(actual, expected, [message])',\n    'assert.notEqual(actual, expected, [message])',\n    'assert.strictEqual(actual, expected, [message])',\n    'assert.notStrictEqual(actual, expected, [message])',\n    'assert.deepEqual(actual, expected, [message])',\n    'assert.notDeepEqual(actual, expected, [message])',\n    'assert.deepStrictEqual(actual, expected, [message])',\n    'assert.notDeepStrictEqual(actual, expected, [message])'\n]\n```\n\nTarget patterns for power assert feature instrumentation.\n\nIf callee name (for example, `assert.equal`) matches exactly and number of arguments is satisfied, then the assertion will be modified.\nDetection is done by [escallmatch](https://github.com/twada/escallmatch). Any arguments enclosed in bracket (for example, `[message]`) means optional parameters. Without bracket means mandatory parameters.\n\n\n## CHANGELOG\n\nSee [CHANGELOG](https://github.com/power-assert-js/gulp-espower/blob/master/CHANGELOG.md)\n\n\n## OUR SUPPORT POLICY\n\nWe support Node under maintenance. In other words, we stop supporting old Node version when [their maintenance ends](https://github.com/nodejs/LTS).\n\nThis means that any other environment is not supported.\n\nNOTE: If gulp-espower works in any of the unsupported environments, it is purely coincidental and has no bearing on future compatibility. Use at your own risk.\n\n\n## AUTHOR\n\n* [Takuto Wada](https://github.com/twada)\n\n\n## CONTRIBUTORS\n\n* [bouzuya](http://bouzuya.net)\n\n\n## License\n\nLicensed under the [MIT](https://github.com/power-assert-js/gulp-espower/blob/master/LICENSE-MIT) license.\n\n[npm-url]: https://npmjs.org/package/gulp-espower\n[npm-image]: https://badge.fury.io/js/gulp-espower.svg\n\n[travis-url]: https://travis-ci.org/power-assert-js/gulp-espower\n[travis-image]: https://secure.travis-ci.org/power-assert-js/gulp-espower.svg?branch=master\n\n[depstat-url]: https://gemnasium.com/power-assert-js/gulp-espower\n[depstat-image]: https://gemnasium.com/power-assert-js/gulp-espower.svg\n\n[license-url]: https://github.com/power-assert-js/gulp-espower/blob/master/LICENSE-MIT\n[license-image]: https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpower-assert-js%2Fgulp-espower","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpower-assert-js%2Fgulp-espower","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpower-assert-js%2Fgulp-espower/lists"}