Regex Expression Builder
An incredible way to build efficient, concise and human readable regular expressions. Made with ❤️ by ohitslaurence
Installing
Using yarn:
$ yarn add exceptional-expressionsUsing npm:
$ npm install exceptional-expressionsUsing bower:
$ bower install exceptional-expressionsHello World
import { ExpBuilder, or, Constants, anythingBut } from 'exceptional-expressions;
const builder = new ExpBuilder('ig');
builder
.beginsWith(or(['hello', 'goodbye']))
.followedBy(Constants.whitespace)
.endsWith(anythingBut('world'));
builder.matchesString('Hello World'); // false
builder.matchesString('Goodbye Earth'); // true
builder.matchesString('hello world'); // false
builder.matchesString('helloearth'); // falseExamples
The exceptional expressions builder class exposes many methods for chaining expressions in various combinations. These methods, combined with the various utility functions provide extensive functionality such as named grouping, or and optional chaining, exclusions and many more.
// Optional chaining
import { ExpBuilder, or, Constants, Sequences } from 'exceptional-expressions;
const builder = new ExpBuilder('g');
builder
.beginsWith('(a)')
.orBeginsWith('(b)')
.followedBy(Constants.whitespace)
.followedBy(or([Constants.word, Sequences.numbers(3)]));
builder.matchesString('(a) Test'); // true
builder.matchesString('(b) word'); // true
builder.matchesString('(a)string'); // false
builder.matchesString('(a) 123'); // true
builder.getMatches('(a) first extra test string (b) second');
// ['(a) first']
builder.toRegex(); // /^(?:(?:\(a\))|(?:\(b\)))\s(?:(?:[A-Za-z']+\b)|(?:[\d]{3}))/gNamed groups allow you to group chunks of your expression and then extract that chunk by the name that you gave it. This functionality seeks to improve on the regex.exec(string) method, which requires you to keep careful track on the ordering of your regex capture groups in order to determine which array index your group will be extracted into.
// Named groups
import { ExpBuilder, group, Constants } from 'exceptional-expressions;
const builder = new ExpBuilder('g');
builder
.contains(group([Constants.word, '.', Constants.word], 'username'))
.followedBy('@')
.followedBy(
group([
group(Constants.word, 'company'), '.', group(Constants.word, 'tld')
], 'domain')
);
builder.getCaptureGroups();
// ['username', 'domain', 'company', 'tld']
builder.matchesString('test.person@example.com');
// true
builder.getMatchesWithGroups('test.person@example.com, another.guy@test.io')
/* [{
match: 'test.person@example.com',
groups:
{
username: 'test.person',
domain: 'example.com',
company: 'example',
tld: 'com'
}
},
{
match: 'another.guy@test.io',
groups:
{
username: 'another.guy',
domain: 'test.io',
company: 'test',
tld: 'io'
}
}]
*/
builder.getMatchesByGroup('test.person@example.com, another.guy@test.io', 'company')
// ['example', 'test']