unassert-js / unassert

Encourages programming with assertions by providing tools to compile them away.
MIT License
192 stars 13 forks source link

Make assertion and declaration patterns configurable #9

Closed twada closed 7 years ago

twada commented 8 years ago

Expose createVisitor to make assertion and declaration patterns configurable.

var visitor = unassert.createVisitor(options)

return type
object (visitor object for estraverse)

Create visitor object to be used with estraverse.replace. Visitor can be customized by options.

options

Object for configuration options. passed options is Object.assigned with default options. If not passed, default options will be used.

options.assertionPatterns

Target patterns for assertion removal.

If callee name (for example, assert.equal) matches exactly and number of arguments is satisfied, then the assertion will be removed. Patterns are handled with escallmatch. Any arguments enclosed in bracket (for example, [message]) means optional parameters. Without bracket means mandatory parameters.

options.requirePatterns

Target patterns for require call removal. Must be in form of assignments.

For example,

{
    requirePatterns: [
        'assert = require("assert")'
    ],

will remove var assert = require("assert"), let assert = require("assert"), const assert = require("assert") and var assert; assert = require("assert") as well.

options.importPatterns

Target patterns for import declaration removal.

For example,

{
    importPatterns: [
        'import assert from "assert"',
        'import * as assert from "assert"',
        'import assert from "power-assert"',
        'import * as assert from "power-assert"'
    ]