Implement Assert::matches()

[thekid]

Code that asserts using preg_match() does not produce meaningful error messages:

$ xp -e '\test\Assert::equals(1, preg_match("/ABC/i", "Testing"))'
Uncaught exception: Exception test.AssertionFailed (Failed asserting that 0 is equal to 1)
# ...

This pull request solves the problem by adding a matches shorthand method which uses the test.assert.Matches class.

Usage

The pattern is included in the assertion error message:

Assert::matches('/^test/i', 'Testing');
// Pass

Assert::matches('/ABC/i', 'Testing');
// Uncaught exception: Exception test.AssertionFailed (Failed asserting that "Testing" matches /ABC/i)
//   at test.Assert::matches((0x6)'/ABC/i', (0x7)'Testing') [line 1 of (command line argument)]
//   at <main>::include((0x17)'(command line argument)') [line 163 of Code.class.php]
//   at xp.runtime.Code::run(array[1]) [line 31 of Evaluate.class.php]
//   at xp.runtime.Evaluate::main(array[1]) [line 389 of class-main.php]

Errors

If preg_match() returns an error, an exception is raised. Its stacktrace includes the error message

Assert::matches('not.a.regex', 'Testing');
// Uncaught exception: Exception lang.FormatException (Using not.a.regex)
//   at <main>::preg_match() [line 15 of Matches.class.php] preg_match(): Delimiter must not be alphanumeric, [...]
//   at test.assert.Matches::matches((0x7)'Testing') [line 27 of Assertable.class.php]
//   at test.assert.Assertable::is(test.assert.Matches{}) [line 89 of Assert.class.php]
//   at test.Assert::matches((0xb)'not.a.regex', (0x7)'Testing') [line 1 of (command line argument)]
//   at <main>::include((0x17)'(command line argument)') [line 163 of Code.class.php]
//   at xp.runtime.Code::run(array[1]) [line 31 of Evaluate.class.php]
//   at xp.runtime.Evaluate::main(array[1]) [line 389 of class-main.php]

[thekid]

Released in https://github.com/xp-framework/test/releases/tag/v1.5.0