Create regex from natural language
Attention - This project isn't completed yet. There might be breaking changes until version 1.0.0. Feel free to contribute, see TODO to get started.
natural-regex is a parser that allows you to write regular expressions in natural language. This means that you can write self documentating regex using a simpler syntax that can be undestood by anyone. No more pain with validations and other stuff.
You can install natural-regex using npm:
npm install --save natural-regexIf you aren't using npm in your project, you can include NaturalRegex using UMD build in the dist folder with <script> tag.
Once you have installed natural-regex, supposing a CommonJS environment, you can import and immediately use it:
import NaturalRegex from 'natural-regex';
// validate string
const dateAndEmail = NaturalRegex.from('starts with dd/MM/yyyy, space, minus, space and then email, end.');
dateAndEmail.test('06/07/2016 - [email protected]'); // this evaluates true
dateAndEmail.test('Foo Bar foo@bar'); // this evaluates false
// replace in string
NaturalRegex.replace({
string: '06/07/2014 - [email protected]',
match: 'yyyy',
replace: '2016',
});
// this returns '06/07/2016 - [email protected]'NaturalRegex also includes a command line tool, check this for more information.
Visit the Wiki for the full documentation.
Examples can be found here
This project adheres to Semantic Versioning.
Every release, along with the migration instructions, is documented on the Github Releases page.
Matteo Basso
Copyright (c) 2016, Matteo Basso.
natural-regex source code is licensed under the MIT License.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent