Skip to content

A library that removes marked blocks from any type of code.

License

Notifications You must be signed in to change notification settings

kudashevs/remove-blocks

Repository files navigation

Remove Blocks test workflow

The remove-blocks is a library that removes marked blocks from any type of code.

Install

# NPM
npm install --save-dev remove-blocks
# Yarn
yarn add --dev remove-blocks

Usage

It removes blocks of code marked with two paired tags. A pair of tags consists of a start tag and an end tag. The format of each tag is prefix name:position suffix (e.g. /* debug:start */). The name, prefix, and suffix are configurable.

/* debug:start */ 
console.log('debug');
/* debug:end */

Note: The blocks cannot overlap each other.

Options

options.skips is an array of environments where the processing will be skipped.

options.blocks is an array of blocks' representations. Each element of this array describes a unique pair of tags with name, prefix, suffix and optional replacement. These values are represented by an object with these properties or by a string:

name: 'devblock'             # a string defines a name for the start/end tags (unique) - mandatory
prefix: '/*'                 # a string defines the beginning of a tag (non-empty string) - mandatory
suffix: '*/'                 # a string defines the end of a tag (can be an empty string) - mandatory
replacement: 'any'           # a string defines a substitution for a removed block - optional

When a pair of tags is represented by a string, this string will be used as a name for the start and end tag (e.g. string:start and string:end), and the default prefix and suffix are used (e.g. /* and */).

License

The MIT License (MIT). Please see the License file for more information.