Add support for types in expectFilter mocks

[badasswp]

Summary

This PR introduces support for type inclusion in the expectFilter mock expressions. In this way it is possible to assert if an object has been passed in as an argument like so:

\WP_Mock::expectFilter( 'my_filter', \WP_Mock\Functions::type( MyClass::class ) );

Closes: #253

Details

At the moment, when we pass in an object or instance in our apply_filters and proceed to mock it using types, it incorrectly compares two different hashes, because our \WP_Mock\Functions::type( MyClass::class ) returns a Mockery Type object whose hash is different from a new MyClass() object. See here.

$key = $this->safe_offset($arg);
if (! is_array($processors) || ! isset($processors[ $key ])) {
    $this->strict_check();


    return $arg;
}

I have introduced the use of a static array in the Hook abstraction called $objects which basically acts as a hash map to store key/value pairs of the object's class name and the unique hash value of the Mockery Type associated with that object when the WP_Mock\Functions::type() is called in the expectFilter.

/** @var array<mixed> collection of objects mapped to their Type hashes */
    public static array $objects = [];

AND

{
    $type = Mockery::type($expected);
    Filter::$objects[ $expected ] = spl_object_hash($type);

    return $type;
}

In this way, I am able to cross-check if the key exists in the is_object call of the safe_offset method when an object or instance is passed in and then effectively return the correct hash for that object like so:

if (is_object($value)){
    if (! $value instanceof Type) {
        $class = get_class($value);

        if (isset(static::$objects[ $class ])) {
            return static::$objects[ $class ];
        }
    }

    return spl_object_hash($value);
}

Contributor checklist

• I agree to follow this project's Code of Conduct.
• I have updated the documentation accordingly
• I have added tests to cover changes introduced by this pull request
• All new and existing tests pass

Testing

Create classes called MyClass & NewClass like so:

namespace MyPlugin;

class MyClass
{
    public function filterContent() : NewClass
    {
        return apply_filters('custom_content_filter', new NewClass());
    }
}

class NewClass
{
    public function __construct()
    {
        echo 'New Class';
    }
}

Create Test like so:

use WP_Mock;
use WP_Mock\Tools\TestCase as TestCase;

use MyPlugin\MyClass;
use MyPlugin\NewClass;

final class MyClassTest extends TestCase
{
    public function testAnonymousObject() : void 
    {
        WP_Mock::expectFilter('custom_content_filter', WP_Mock\Functions::type(NewClass::class));

        $this->assertInstanceOf(NewClass::class, (new MyClass())->filterContent());
        $this->assertConditionsMet();
    }
}

Run test, it should pass successfully:

composer run test

Reviewer checklist

• Code changes review
• Documentation changes review
• Unit tests pass
• Static analysis passes

[coveralls]

coverage: 66.446% (+0.1%) from 66.312%
when pulling cb4f051 on badasswp:feat/add-support-for-types-in-expect-filter-mocks
into 010d556 on 10up:trunk.

[nmolham-godaddy]

Wonderful work @badasswp, I just added few comments and suggestions below

[badasswp]

Hi @nmolham-godaddy If you've got some spare time later today, could you pls help me review this PR at your earliest convenience. Thanks.