match-test-replace

match-test-replace

Easy text pattern match and replace text.

This library does Match -> Test -> Replace pattern.

• Match pattern
• Does test
• Does replace

Install

Install with npm:

npm install match-test-replace

Usage

export interface PatternMatchDictArgs {
    index: number;
    match: string;
    captures: string[];
    all: string;
}
export interface TestMatchReplaceReturnDict {
    pattern: RegExp;
    replace: (args: PatternMatchDictArgs) => string;
    test?: (args: PatternMatchDictArgs) => boolean;
    message?: (args: PatternMatchDictArgs) => string;
}
export interface TestMatchReplaceReturnResult {
    index: number;
    match: string;
    replace: string;
    message?: string;
}
export interface TestMatchReplaceReturn {
    ok: boolean;
    results: TestMatchReplaceReturnResult[];
}
/**
 * replace `text` with `results`.
 */
export declare const replaceAll: (
    text: string,
    results: TestMatchReplaceReturnResult[]
) => {
    ok: boolean;
    output: string;
};
/**
 * test `text`, match `text`, and replace `text.
 */
export declare const testMatchReplace: (text: string, dict: TestMatchReplaceReturnDict) => TestMatchReplaceReturn;

Match -> Replace

import { replaceAll, matchTestReplace } from "match-test-replace";
const text = "Hello";
const res = matchTestReplace(text, {
    pattern: /hello/i,
    replace: () => "Hello"
});
assert.ok(res.ok, "should be ok: true");
assert.strictEqual(res.results.length, 1, "1 replace");
/**
[ { index: 0, match: 'Hello', replace: 'Hello', message: undefined } ]
*/

Match -> test -> Replace

match-test-replace not replace if test return false

import { replaceAll, matchTestReplace } from "match-test-replace";
const text = "webkit is matched,but node-webkit is not match";
const res = matchTestReplace(text, {
    pattern: /(\S*?)webkit/g,
    replace: () => "WebKit",
    test: ({ captures }) => {
        return captures[0] !== "node-";
    }
});
assert.ok(res.ok === true, "should be ok: false");
assert.strictEqual(res.results.length, 1, "no replace");
assert.strictEqual(replaceAll(text, res.results).output, "WebKit is matched,but node-webkit is not match");

Complex

import * as assert from "assert";
import { replaceAll, matchTestReplace } from "match-test-replace";
import { PatternMatcher } from "nlcst-pattern-match";
import { EnglishParser } from "nlcst-parse-english";
const englishParser = new EnglishParser();
const matcher = new PatternMatcher({ parser: englishParser });
// https://developers.google.com/style/clause-order
// NG: Click Delete if you want to delete the entire document.
// OK: To delete the entire document, click Delete.
const text = 'Click Delete if you want to delete the entire document.';
const res = matchTestReplace(text, {
    pattern: /Click (\w+) if you want to (.+)./,
    replace: ({ captures }) => {
        console.log(captures);
        return `To ${captures[1]}, click ${captures[0]}.`
    },
    test: ({ all }) => {
        const pattern = matcher.tag`Click ${{
            type: "WordNode",
            data: {
                // Verb
                pos: /^VB/
            }
        }}`;
        return matcher.test(all, pattern);
    }
});
assert.ok(res.ok === true, "should be ok: true");
const output = replaceAll(text, res.results).output;
assert.strictEqual(output, "To delete the entire document, click Delete.");

Changelog

See Releases page.

Running tests

Install devDependencies and Run npm test:

npm i -d && npm test

Contributing

Pull requests and stars are always welcome.

For bugs and feature requests, please create an issue.

• Fork it!
• Create your feature branch: git checkout -b my-new-feature
• Commit your changes: git commit -am 'Add some feature'
• Push to the branch: git push origin my-new-feature
• Submit a pull request :D

Author

• github/azu
• twitter/azu_re

License

MIT © azu

Changelog

1.4.0 (2022-02-23)

Bug Fixes

• build: fix build (519b981)
• deps: Update vulnerable packages (#14) (c2a0386)
• Fix package dependencies for security vulnerabilities (#9) (b3698da)
• lerna: bootstrap do build (2e0fd47)
• lerna: fix build (4ca42ac)
• match-test-replace: fix applyFixes (3ee62fe)
• monorepo: use fixed version (#16) (f2282f9)
• nlcst-parse-japanese: fix initializer error (f185381)
• nlcst-parse-japanese: remove word_position (398a89f)
• nlcst-pattern-match: add checker for arguments (be6af57)
• nlcst-pattern-match: export match and matchNode (2ba41f7)
• nlcst-pattern-match: fix multiple variable tags (7fee116)
• nlcst-pattern-match: fix non-parent nodes (8893f9a)
• nlcst-pattern-match: fix pretest (9b7f915)
• nlcst-pattern-match: fix throw [0] error (5e62647)
• nlcst-pattern-match: remove console.log (af87c30)
• nlcst-pattern-match: support multiple value pattern (57f94cf)
• nlcst-pattern-match: update --timeout to 5sec (e1a5e86)
• nlcst-types: isSymbol used wrong Symbol interface (#10) (e24c57a)
• nlcst-types: remove Text (63052fa)
• remove unused config (9f0b821)

Features

• match-test-replace: allow to replace? is undefined (1731df3)
• nlcst-pattern-match: add isNegative property (dc9233e)
• nlcst-pattern-match: Add matchCST and testCST (3ec96ec)
• nlcst-pattern-match: add MatchResult type (73c1434)
• packages: add nlcst-parse-japanese (a1b20e9)
• packages: add nlcst-types adn unist-types (802e452)
• pass dictPath option down to kuromojin (#6) (e313046)