garethellis/hamcrest-matchers

A set of custom Hamcrest matchers

A simple collection of custom Hamcrest matchers for use with hamcrest/hamcrest-php., _(*1)

, _(*2)

Installation

Install with composer:, _(*3)

composer require --dev garethellis/hamcrest-matchers, _(*4)

Matchers

UUID matcher

Matches a valid UUID. Example usage:, _(*5)

<?php
/** ... **/
assertThat($uuid, is(aUUID()));

To match an array of UUIDs:, _(*6)

<?php
/** ... **/
assertThat([$uuid1, $uuid2, $uuid3], is(anArrayOfUUIDs()));

This matcher uses the callback matcher (see below) from Nils Luxton., _(*7)

HTML matcher

Matches a string containing HTML. Example usage;, _(*8)

<?php
/** ... **/
assertThat($html, containsHTML());

Valid JSON matcher

Matches a valid JSON string. Example usage:, _(*9)

<?php
/** .. **/
assertThat($json, is(validJSON()));

Array values matcher

Match the values of an array or Traversable instance. Note - ignores keys., _(*10)

assertThat($aTraversableInstance, hasEqualValuesTo($anArray));

Callback Matcher

Callback matching is achieved thanks to Nils Luxton and his callback matcher lib (included as a composer dependency in this library). Example usage:, _(*11)

assertThat("hello", matchesUsing(function($value) { return $value === "hello"; }));

Creating new custom callback matchers

You can create your own custom matchers with the callback matcher by using describedAs() to provide a better description for the expectation., _(*12)

function isSomething()
{
    return describedAs('a custom value', new CallbackMatcher(
        function($value) {
            return $value === 'my custom value';
        }
    )
}
assertThat($foo, isSomething());

```, <sub>(*13)</sub>