strangler v2.0.1

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

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

Example

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

.endsWith(str, candidate) ⇒ boolean

Tests whether the string ends with a particular substring

Kind: static method of strangler

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

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

.multiLineAppend(str, appendStr, joinStr) ⇒ string

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

Kind: static method of strangler

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

.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