@textlint/regexp-string-matcher

Regexp-like string matcher library.

Install

Install with npm:

npm install @textlint/regexp-string-matcher

Usage

Interface:

1export interface matchPatternResult {
2    match: string;
3    startIndex: number;
4    endIndex: number;
5}
6/**
7 * Match regExpLikeStrings and return matchPatternResults
8 * @param text target text
9 * @param regExpLikeStrings an array of pattern string
10 */
11export declare const matchPatterns: (text: string, regExpLikeStrings: string[]) => matchPatternResult[];

Example:

1import { matchPatterns } from "@textlint/regexp-string-matcher";
2const inputText = `
3GitHub is a web-based hosting service for version control using git.
4It is mostly used for computer code.
5GitHub launched in 2018-04-10.`;
6// RegExp like strings
7const inputPatterns = [
8    "git", // => /git/g
9    "/github/i", // => /github/ig
10    "/(\\d{4})-(\\d{2})-(\\d{2})/" // => /\d{4}-\d{2}-\d{2}/g
11];
12
13const results = matchPatterns(inputText, inputPatterns);
14assert.deepStrictEqual(results, [
15    { match: "GitHub", startIndex: 1, endIndex: 7, captures: [] },
16    { match: "git", startIndex: 65, endIndex: 68, captures: [] },
17    { match: "GitHub", startIndex: 107, endIndex: 113, captures: [] },
18    { match: "2018-04-10", startIndex: 126, endIndex: 136, captures: ["2018", "04", "10"] }
19]);

RegExp-like String

This library aim to represent RegExp in JSON and use it for ignoring words. g(global) flag and u(unicode) is added by default.

Input	Ouput	Note
"str"	/str/gu	convert string to regexp with global
"/str/"	/str/gu
"/str/g"	/str/gu	Duplicated g is just ignored
"/str/i"	/str/igu
"/str/u"	/str/ug
"/str/m"	/str/mgu
"/str/y"	/str/ygu
---	---	---
"/\\d+/"	/\d+/gu	You should escape meta character like \d
"/(\\d+)/"	/\d+/gu	You can use capture

:warning: You should escape meta character like \d in RegExp-like string.

For example, If you want to write \w(any word) in RegExp-like string, you should escape \w to \\w.

• Regular Expressions - JavaScript | MDN

Text:

This is a pen.

RegExp-like String:

1[
2    "/a (\\w+)/"
3]

Results:

[ { match: 'a pen', startIndex: 8, endIndex: 13, captures: ["pen"] } ]

Examples

string

text:

1GitHub is a web-based hosting service for version control using git.
2It is mostly used for computer code.
3GitHub launched in 2018-04-10.

pattern:

1[
2  "GitHub"
3]

results: 2 hits

1**GitHub** is a web-based hosting service for version control using git.
2It is mostly used for computer code.
3**GitHub** launched in 2018-04-10.

Ignore Case match

text:

1GitHub is a web-based hosting service for version control using git.
2It is mostly used for computer code.
3GitHub launched in 2018-04-10.

pattern:

1[
2  "/git/i"
3]

results:: 3 hits

1**Git**Hub is a web-based hosting service for version control using **git**.
2It is mostly used for computer code.
3**Git**Hub launched in 2018-04-10.

Special character

You should escape special charactor like \d in RegExp-like string.

text:

1GitHub is a web-based hosting service for version control using git.
2It is mostly used for computer code.
3GitHub launched in 2018-04-10.

pattern:

1[
2  "/\\d{4}-\\d{2}-\\d{2}/"
3]

results:: 1 hit

1GitHub is a web-based hosting service for version control using git.
2It is mostly used for computer code.
3GitHub launched in **2018-04-10**.

Multi-line

text:

1===START===
21st inline text.
3===END===
4
5===START===
62nd inline text.
7===END===

pattern:

1[
2  "/===START===[\\s\\S]*?===END===/m"
3]
4

results:: 2 hits

1**===START===
21st inline text.
3===END===**
4
5**===START===
62nd inline text.
7===END===**

For more details, see test/snapshots

Escape bracket

text:

1TODO [Issue #1]: it will be fixed

patterns:

1[
2  "/TODO \\[Issue #\\d+\\]:/i"
3]

:memo: You should escape bracket both. \\[ and \\],

results:

**TODO [Issue #1]:** it will be fixed

Changelog

See Releases page.

Running tests

Install devDependencies and Run npm test:

npm i -d && npm test

How to add snapshot tests?

1. Create new dir to ./snapshots/<name>/
2. Add input.txt and input-patterns.json
3. Run npm run test:updateSnapshot
4. You should verify the output results manually
5. Run npm test and pass it
6. Commit it

Contributing

Pull requests and stars are always welcome.

For bugs and feature requests, please create an issue.

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

Author

• github/azu
• twitter/azu_re

License

MIT © azu