ilario-pierbattista/reverse-regex

Convert Regular Expressions into text, for testing. Fork of icomefromthenet/reverse-regex

0.5.0 2024-12-07 09:29 UTC

Requires

• php: ^7.4 | ^8
• doctrine/collections: ^1.6.5
• doctrine/lexer: ^1.2.1 || ^2
• symfony/polyfill-mbstring: ^1.20.0

Requires (Dev)

• phpunit/phpunit: ^9

Conflicts

• icomefromthenet/reverse-regex: *

MIT

• Lewis Dyer

• generator
• testing
• regex
• test data

README

This is a fork of https://github.com/icomefromthenet/ReverseRegex (that provides icomefromthenet/reverse-regex).

Use Regular Expressions to generate text strings can be used in the following situations:

1. Writing test data for web forms.
2. Writing test data for databases.
3. Generating test data for regular expressions.

##Example

use ReverseRegex\Lexer;
use ReverseRegex\Random\SimpleRandom;
use ReverseRegex\Parser;
use ReverseRegex\Generator\Scope;

# load composer
require "vendor/autoload.php";

$lexer = new  Lexer('[a-z]{10}');
$gen   = new SimpleRandom(10007);
$result = '';

$parser = new Parser($lexer,new Scope(),new Scope());
$parser->parse()->getResult()->generate($result,$gen);

echo $result;

Produces

jmceohykoa
aclohnotga
jqegzuklcv
ixdbpbgpkl
kcyrxqqfyw
jcxsjrtrqb
kvaczmawlz
itwrowxfxh
auinmymonl
dujyzuhoag
vaygybwkfm

Other examples

1. Australian phone numbers
2. Australian postcodes
3. Mobile numbers

##Installing

To install use composer

composer require ilario-pierbattista/reverse-regex

Writing a Regex

1. Escape all meta-characters i.e. if you need to escape the character in a regex you will need to escape here.
2. Not all meta-characters are suppported see list below.
3. Use \X{####} to specify unicode value use [\X{####}-\X{####}] to specify range.
4. Unicdoe \p not supported, I could not find a port of UCD to php, maybe in the future support be added.
5. Quantifiers are applied to left most group, literal or character class.
6. Beware of the + and * quantifers they apply a possible maxium number of occurances up to PHP_INT_MAX.

Regex Support