strangler.js

It's a string wrangler, and not nearly as dangerous as it sounds. A set of string utilities which expand those in string-tools with additional features. ES module native

Usage

Often I do string parsing and I like some convenience functions to help out.

you can either retain an instance and use it that way:

import * as stringTool from 'strangler';
// or: const stringTool = require('strangler');
stringTool.contains(string, substring);

or you can just attach to the prototype (this can be OK in an app, but is a bad idea in a library):

require('string-tools').proto();
string.contains(substring);

• string-tools + strangler
  • .proto()
  • .contains(str, target) ⇒ boolean
  • .beginsWith(str, target) ⇒ boolean
  • .endsWith(str, target) ⇒ boolean
  • .splitHonoringQuotes(str, [delimiter], [quotes]) ⇒ Array
  • .decompose(str, [delimiter], [quotes]) ⇒ Array
  • .multiLineAppend(str, appendStr) ⇒ string

proto()

assign these utilities to String.prototype and throw caution to the wind...

Kind: static property of strangler

.contains(str, candidate) ⇒ boolean

Tests whether the string contains a particular substring or set of substrings

Kind: static method of strangler

| Param | Type | Description | | --- | --- | --- | | input | string | input string to test | | candidate | string or Array | the substring to test |

Example

'elongated'.contains('gate'); //returns true;
'elongated'.contains(['long', 'gate']); //returns true;
'elongated'.contains(['wall']); //returns false;

.beginsWith(str, candidate) ⇒ boolean

Tests whether the string begins with a particular substring

Kind: static method of strangler

| Param | Type | Description | | --- | --- | --- | | input | string | input string to test | | candidate | string | the substring to test |

Example

'max'.beginsWith('m'); //return true;

.endsWith(str, candidate) ⇒ boolean

Tests whether the string ends with a particular substring

Kind: static method of strangler

| Param | Type | Description | | --- | --- | --- | | input | string | input string to test | | candidate | string | the substring to test |

Example

'max'.endsWith('x'); //return true;

.splitHonoringQuotes(str, [delimiter], [escape], [quotes], [terminator]) ⇒ Array

like String.split(), but it will honor the opening and closing of quotes, so a delimiter inside a quote won't blow it up.

Kind: static method of strangler

| Param | Type | Default | Description | | --- | --- | --- | --- | | input | string | | input string to split | | delimiter | string | ',' | the pattern to split on | | escape | char | | the character to use as an escape value | | quotes | Array | ["'", '""'] | the quotes to respect | | terminator | char | | the character to split groups |

Example

'a, b, c="r, u, d", d'.splitHonoringQuotes(',');

returns

['a', ' b', ' c="r, u, d"', ' d']

.decompose(str, [delimit], [quotes]) ⇒ Array

like String.split(), but it will honor the opening and closing of quotes, so a delimiter inside a quote won't blow it up, rather than using a fixed delimiter, you can provide a RegExp to split on. Not as fast as splitHonoringQuotes, but much more flexible.

Kind: static method of strangler

| Param | Type | Default | Description | | --- | --- | --- | --- | | input | string | | input string to split | | delimiter | RegExp | ',' | the pattern to split on | | quotes | Array | ["'", '""'] | the quotes to respect |

.multiLineAppend(str, appendStr, [joinStr]) ⇒ string

returns the two strings which are appended together in a line by line fashion.

Kind: static method of strangler

| Param | Type | Default | Description | | --- | --- | --- | --- | | str | string | | multiline string prefix | | appendStr | string | | multiline string suffix | | joinStr | string | | the chars to stick between them |

Example

var firsts = 'this \
attaches \
the ';
var seconds = 'one \
to \
other'
firsts.multiLineAppend(seconds);

returns

'this one\
attaches to\
the other'

strangler.StreamDecomposer

.StreamDecomposer([options]) ⇒ Class

This class allows you to parse a large string as and to generate events during parse to prevent storing the results in memory. It is an EventEmitter and will generate token events for each token it finds and if options.terminator is set it will generate cell and row events.

Kind: constructor of strangler.StreamDecomposer

| Param | Type | Default | Description | | --- | --- | --- | --- | | options.delimiter | char | | the character to split individual pieces of data on | | options.terminator | char | | the character to split groups of data on | | options.escape | char | | the character to escape on | | options.quotes | Array | | list of characters to quote with |

.StreamDecomposer.writable ⇒ stream.Writable

Generate a writable stream to pipe a readable stream into in order to parse.

Kind: method of strangler

returns stream.Writable

Testing

just run

mocha

Enjoy,

-Abbey Hawk Sparrow