Editer NPM | npm.io

editer

A high level multiline string manipulation library.

What it does

Using editer, you can:

insert a string before/after a certain line in a multiline string optionally as a new line
insert a string before/after nth match of a regex in a multiline string optionally as a new line
remove a string from a multiline string before/after a regex matches, optionally from the same line and/or multiple times.

Installation

npm install --save editer

Usage

Here are some examples of what editer can do.

Example 1

Insert a new line after a certain line number.

var editer = require('editer');
var target = 'line 1\nline 3';

var result = editer.insert('line 2', target, {after: {line: 1}, asNewLine: true});
console.log(result);
// => 'line 1\nline 2\nline 3';

Example 2

Insert a string after the second occurrence of regex.

import create from './create';
import generate from './generate';

export {
  create
  generate
};

var fs = require('fs');
var editer = require('editer');
var target = fs.readFileSync('./target');

var result = editer.insert("import modify from './modify'", target, {
  after: {
    regex: /import .*$/,
    occurrence: 2,
  },
  asNewLine: true
});
console.log(result);
// import create from './create';
// import generate from './generate';
// import modify from './modify';
//
// export {
//   create
//   generate
// };

API

insert(string, target, options)

Inserts string to target at the position specified by options and returns the modified target. If options fails to find the desired position, returns undefined.

string

type: String
a string to be inserted at the target

target

type: String
a string to be modified by inserting string

options

type: Object
an object specifying the position at which the string is to be inserted to target and how it should be inserted (e.g. as a new line or a regular line).

At top level, it can have the following keys:

before
after
or
asNewLine

before, after

An object with either before or after is a 'condition'. A condition cannot have both before and after. They take as value an object with following possible key-value pairs.

line

type: Number
the line number in the target

regex

type: RegExp
the regex to be matched in the target. You may optionally provide occurrence if providing this option. See below. All regex should have global flag, as Editer uses lcoater internally.

occurrence

type: Number
the order of occurrence after which target is to be modified. If not provided, target is modified at the first occurrence of the regex.

last

type: Boolean
if set to true, modify the target at last occurrence of the regex.

Example

var target = "I love you\nHoney Bunny.";
var options = {before: {regex: /[a-zA-z]{5}/g, occurrence: 2}};
var result = editer.insert("Nooby ", target, options);
console.log(result);
// => "I love you\nHoney Nooby Bunny."

var target = "Whoa, whoa, whoa, whoa... stop right there.";
var options = {before: {regex: /whoa/ig, last: true}};
var result = editer.insert("my god, ", target, options);
console.log(result);
// => "Whoa, whoa, whoa, my god, whoa... stop right there."

or

or is an array of conditions. Editer attempts to use the conditions sequentially from the first to the last. If a condition matches, Editer ignores the rest of the conditions.

Example

var target = "Whoa, whoa, whoa, whoa... stop right there.";
var options = {or: [
  {before: {regex: /unicorn/ig, last: true}},
  {after: {regex: /whoa,\s/ig, occurrence: 3}},
  {after: {regex: /stop/i}}
]};
var result = editer.insert("hey, ", target, options);
console.log(result);
// => "Whoa, whoa, whoa, hey, whoa... stop right there."

asNewLine

type: Boolean
default: false
insert the string as a new line to the target.

Example

var target = "It's Zed's.\nWho's Zed?";
var options = {before: {regex: /Zed.*\n/g}, asNewLine: true};
var result = editer.insert("...", target, options);
console.log(result);
// => "It's \n...\nZed's.\nWho's Zed?"

remove(string, target, options)

Removes string from the target at the position specified by options.

string

type: String
a string to be removed from the target

target

type: String
a string to be modified by removing string

options

type: Object
an object specifying the position at which the string is to be removed from target.

At top level, it can have the following keys:

before
after
or
multi
onSameLine

All before, after, and or options are similar to those of insert API. The only difference is that here they support only regex, not line number.

multi

type: Boolean
default: false
Remove all occurrences of the string in the section of the target scoped by the condition, and other options such as onSameLine.