🦉 human-readable regular expressions for PHP

The flags parameter in preg_match and preg_match all is of type int (not string as previously asserted in the code) and not nullable. Passing null leads to a deprecation warning in newer PHP versions, which is now also checked for in the provided GitHub actions

Ref #22

Changes

• use local PHPUnit
  • easier to use with various PHP versions, autoloaded (TestCase classes)
• use [] instead of array()
• use implode() instead of join()
• use strict types
• use return types
• drop random empty spaces
• add composer.lock to .gitignore, since not commited

adrianmiu via reddit

I would change ->eitherFind("png")->orFind("jpg")->orFind("gif") to something like ->anyOf(array('png', 'jpg', 'gif')) or something to that extent

Hi,

when you ship this (great, by the way) project to Packagist, could you remove the .git directory. It messes up my git installation by making your code as a submodule of my code that I have many pains to push.

Each time I update I need to manually remove your .git directory, add all your files to my change list and then I can commit.

Thanks

I just downloaded your repo using composer require gherkins/regexpbuilderphp and started soing some tests as suggested by you. i have created new test.php file under regexpbuilderphp folder

<?php
namespace Gherkins\RegExpBuilderPHP;


$builder = new \Gherkins\RegExpBuilderPHP\RegExpBuilder();

$regExp = $builder
    ->startOfInput()
    ->exactly(4)->digits()
    ->then("_")
    ->exactly(2)->digits()
    ->then("_")
    ->min(3)->max(10)->letters()
    ->then(".")
    ->anyOf(array("png", "jpg", "gif"))
    ->endOfInput()
    ->getRegExp();

//true
$regExp->matches("2020_10_hund.jpg");
$regExp->matches("2030_11_katze.png");
$regExp->matches("4000_99_maus.gif");

//false
$regExp->matches("123_00_nein.gif");
$regExp->matches("4000_0_nein.pdf");
$regExp->matches("201505_nein.jpg");

but i am getting error saying:

Fatal error: Class 'Gherkins\RegExpBuilderPHP\RegExpBuilder' not found in    C:\wamp\www\gherkins\regexpbuilderphp\src\test.php on line 5

can you please help.

thanks

Update: found a solution, is it proper?

I would like to match these cases:

- <code>hello</code>
- <code>hello
</code>

So I've created builder like this:

$surroundingTagRegExpWithLineBreaks = (new RegExpBuilder)->startOfInput()
    ->find(sprintf('<%s', $tag))
    ->anything()
    ->min(0)->lineBreaks()
    ->find(sprintf('</%s>', $tag))
    ->endOfInput()
    ->getRegExp();

I'd expect ->min(0)->lineBreaks() to compatible with ->any()->lineBreaks(). But it isn't.

I'm trying to match expression with exactly 10 digits. Maybe I don't understand it correctly, so here is my example:

$regExp = (new RegExpBuilder)->exactly(10)->digits()->getRegExp();

var_dump($regExp->test(123456789)); // should: FALSE, is FALSE
var_dump($regExp->test(1234567890)); // should: TRUE, is TRUE
var_dump($regExp->test(12345678901)); // should: FALSE, is TRUE

How to achieve my goal?

Instead of relying on Travis we now use GitHub workflows to automatically test the application with different PHP versions. For now we test with 7.3 and 8.1

The group matches are ignored when adding globalMatch flag.

$builder = new RegExpBuilder();
$regExp = $builder->getNew()->globalMatch()
    ->then('Foo of ')
    ->append($builder->getNew()->anythingBut(' '))
    ->asGroup()
    ->getRegExp();

$string = 'Foo of Bar Foo of Dummy';
$output = $regExp->findIn($string);

outputs this, where can see that group matches is missing:

array (2)
 · [0]: string (10) "Foo of Bar"
 · [1]: string (12) "Foo of Dummy"

So I added one more condition to RegExp.php:114 :

if (!isset($matches[1]) && isset($matches[0]) && is_array($matches[0])) {
    return $matches[0];
}

tests pass and it outputs this now:

 · [0]: array (2)
 ·  · [0]: string (10) "Foo of Bar"
 ·  · [1]: string (12) "Foo of Dummy"
 · [1]: array (2)
 ·  · [0]: string (3) "Bar"
 ·  · [1]: string (5) "Dummy"

Should I make a PR?

note that, if named, the group will be included twice in the preg_match array:

   [0]: string (49) "n° 1802"
 · [myname]: string (4) "1802"
 · [1]: string (4) "1802"

feature to implement, see: http://stackoverflow.com/questions/6971287/named-capture-in-php-using-regex

I may do a PR, if you have any recommendations, please share