zenstruck / callback

tests/CallbackTest.php

<?php

namespace Zenstruck\Callback\Tests;

use PHPUnit\Framework\TestCase;
use Zenstruck\Callback;
use Zenstruck\Callback\Argument;
use Zenstruck\Callback\Exception\UnresolveableArgument;
use Zenstruck\Callback\Parameter;

/**
 * @author Kevin Bond <kevinbond@gmail.com>
 */
final class CallbackTest extends TestCase
{
    /**
     * @test
     */
    public function create_must_be_callable(): void
    {
        $this->expectException(\InvalidArgumentException::class);

        Callback::createFor('not a callable');
    }

    /**
     * @test
     */
    public function invoke_all_can_enforce_min_arguments(): void
    {
        $callback = Callback::createFor(function() { return 'ret'; });

        $this->expectException(\ArgumentCountError::class);

        $callback->invokeAll(Parameter::untyped('foo'), 1);
    }

    /**
     * @test
     */
    public function invoke_all_with_no_arguments(): void
    {
        $actual = Callback::createFor(function() { return 'ret'; })
            ->invokeAll(Parameter::untyped('foo'))
        ;

        $this->assertSame('ret', $actual);
    }

    /**
     * @test
     */
    public function invoke_all_with_string_callable(): void
    {
        $actual = Callback::createFor('strtoupper')
            ->invokeAll(Parameter::union(
                Parameter::untyped('foobar'),
                Parameter::typed('string', 'foobar')
            )
        )
        ;

        $this->assertSame('FOOBAR', $actual);
    }

    /**
     * @test
     */
    public function invoke_all_untyped_argument(): void
    {
        $actual = Callback::createFor(function($string) { return \mb_strtoupper($string); })
            ->invokeAll(Parameter::untyped('foobar'))
        ;

        $this->assertSame('FOOBAR', $actual);
    }

    /**
     * @test
     */
    public function invoke_all_primitive_typed_argument(): void
    {
        $actual = Callback::createFor(function(string $string) { return \mb_strtoupper($string); })
            ->invokeAll(Parameter::typed('string', 'foobar'))
        ;

        $this->assertSame('FOOBAR', $actual);
    }

    /**
     * @test
     */
    public function invoke_all_class_arguments(): void
    {
        $object = new Object2();
        $function = static function(Object1 $object1, Object2 $object2, $object3) {
            return [
                'object1' => $object1,
                'object2' => $object2,
                'object3' => $object3,
            ];
        };

        $actual = Callback::createFor($function)
            ->invokeAll(Parameter::union(
                Parameter::untyped($object),
                Parameter::typed(Object1::class, $object)
            ))
        ;

        $this->assertSame(
            [
                'object1' => $object,
                'object2' => $object,
                'object3' => $object,
            ],
            $actual
        );
    }

    /**
     * @test
     */
    public function invoke_all_class_arguments_value_factories(): void
    {
        $function = static function(Object1 $object1, Object2 $object2, $object3) {
            return [
                'object1' => $object1,
                'object2' => $object2,
                'object3' => $object3,
            ];
        };
        $factoryArgs = [];
        $factory = Parameter::factory(static function($arg) use (&$factoryArgs) {
            $factoryArgs[] = $arg;

            if ($arg) {
                return new $arg();
            }

            return new Object1();
        });

        $ret = Callback::createFor($function)
            ->invokeAll(Parameter::union(
                Parameter::untyped($factory),
                Parameter::typed(Object1::class, $factory)
            ))
        ;

        $this->assertSame(['object1', 'object2', 'object3'], \array_keys($ret));
        $this->assertInstanceOf(Object1::class, $ret['object1']);
        $this->assertInstanceOf(Object2::class, $ret['object2']);
        $this->assertInstanceOf(Object1::class, $ret['object3']);
        $this->assertSame(
            [Object1::class, Object2::class, null],
            $factoryArgs
        );
    }

    /**
     * @test
     */
    public function invoke_all_unresolvable_parameter(): void
    {
        $callback = Callback::createFor(static function(Object1 $object1, Object2 $object2, Object3 $object3) {});

        $this->expectException(UnresolveableArgument::class);
        $this->expectExceptionMessage('Unable to resolve argument 2 for callback. Expected type: "mixed|Zenstruck\Callback\Tests\Object1"');

        $callback->invokeAll(Parameter::union(
            Parameter::untyped(new Object1()),
            Parameter::typed(Object1::class, new Object1())
        ));
    }

    /**
     * @test
     */
    public function invoke_with_no_args(): void
    {
        $actual = Callback::createFor(function() { return 'ret'; })
            ->invoke()
        ;

        $this->assertSame('ret', $actual);
    }

    /**
     * @test
     */
    public function invoke_with_resolvable_args(): void
    {
        $object = new Object2();
        $function = static function(Object1 $object1, Object2 $object2, $object3, $extra) {
            return [
                'object1' => $object1,
                'object2' => $object2,
                'object3' => $object3,
                'extra' => $extra,
            ];
        };

        $actual = Callback::createFor($function)
            ->invoke(
                Parameter::typed(Object1::class, $object),
                Parameter::typed(Object2::class, $object),
                Parameter::untyped($object),
                'value'
            )
        ;

        $this->assertSame(
            [
                'object1' => $object,
                'object2' => $object,
                'object3' => $object,
                'extra' => 'value',
            ],
            $actual
        );
    }

    /**
     * @test
     */
    public function invoke_with_unresolvable_argument(): void
    {
        $object = new Object2();
        $function = static function(Object1 $object1, $object2, $object3, $extra) {};

        $this->expectException(UnresolveableArgument::class);
        $this->expectExceptionMessage('Unable to resolve argument 2 for callback. Expected type: "Zenstruck\Callback\Tests\Object2"');

        Callback::createFor($function)
            ->invoke(
                Parameter::typed(Object1::class, $object),
                Parameter::typed(Object2::class, $object),
                Parameter::untyped($object),
                'value'
            )
        ;
    }

    /**
     * @test
     */
    public function invoke_with_not_enough_required_arguments(): void
    {
        $object = new Object2();
        $function = static function(Object1 $object1) {};

        $this->expectException(\ArgumentCountError::class);
        $this->expectExceptionMessage('No argument 2 for callable. Expected type: "Zenstruck\Callback\Tests\Object2"');

        Callback::createFor($function)
            ->invoke(
                Parameter::typed(Object1::class, $object),
                Parameter::typed(Object2::class, $object),
                Parameter::untyped($object),
                'value'
            )
        ;
    }

    /**
     * @test
     */
    public function can_mark_invoke_parameter_arguments_as_optional(): void
    {
        $actual = Callback::createFor(static function() { return 'ret'; })
            ->invoke(Parameter::typed('string', 'foobar')->optional())
        ;

        $this->assertSame('ret', $actual);

        $actual = Callback::createFor(static function(string $v) { return $v; })
            ->invoke(Parameter::typed('string', 'foobar')->optional())
        ;

        $this->assertSame('foobar', $actual);
    }

    /**
     * @test
     */
    public function is_stringable(): void
    {
        $this->assertStringMatchesFormat(__CLASS__.':%d', (string) Callback::createFor(function() {}));
        $this->assertStringMatchesFormat(__CLASS__.':%d', (string) Callback::createFor([$this, __METHOD__]));
        $this->assertStringMatchesFormat(Object4::class.':%d', (string) Callback::createFor(new Object4()));
        $this->assertStringMatchesFormat(Object4::class.':%d', (string) Callback::createFor([Object4::class, 'staticMethod']));
        $this->assertSame(__NAMESPACE__.'\test_function', (string) Callback::createFor(__NAMESPACE__.'\test_function'));
    }

    /**
     * @test
     * @requires PHP >= 8.0
     */
    public function invoke_can_support_union_typehints(): void
    {
        // hack to allow test suite to run on php 7 w/o syntax errors
        eval('$callback = fn(\Zenstruck\Callback\Tests\Object1|string $arg) => \'ret\';');

        $this->assertSame('ret', Callback::createFor($callback)->invokeAll(Parameter::typed(Object1::class, new Object1())));
        $this->assertSame('ret', Callback::createFor($callback)->invokeAll(Parameter::typed('string', 'value')));
        $this->assertSame('ret', Callback::createFor($callback)->invoke(Parameter::typed(Object1::class, new Object1())));
        $this->assertSame('ret', Callback::createFor($callback)->invoke(Parameter::typed('string', 'value')));
    }

    /**
     * @test
     */
    public function can_get_callback_arguments(): void
    {
        $callback = Callback::createFor(function(Object1 $a, $b, string $c) {});

        $this->assertSame(Object1::class, $callback->argument(0)->type());
        $this->assertNull($callback->argument(1)->type());
        $this->assertSame('string', $callback->argument(2)->type());
        $this->assertSame(
            [
                Object1::class,
                null,
                'string',
            ],
            \array_map(function(Argument $a) { return $a->type(); }, $callback->arguments())
        );
    }

    /**
     * @test
     * @requires PHP >= 8.0
     */
    public function can_get_union_callback_arguments(): void
    {
        // hack to allow test suite to run on php 7 w/o syntax errors
        eval('$callback = fn(\Zenstruck\Callback\Tests\Object1|string $a, $b, string $c) => null;');
        $callback = Callback::createFor($callback);

        $this->assertSame(Object1::class.'|string', $callback->argument(0)->type());
        $this->assertNull($callback->argument(1)->type());
        $this->assertSame('string', $callback->argument(2)->type());
        $this->assertSame(
            [
                Object1::class.'|string',
                null,
                'string',
            ],
            \array_map(function(Argument $a) { return $a->type(); }, $callback->arguments())
        );
    }

    /**
     * @test
     */
    public function exception_thrown_when_trying_to_access_invalid_argument(): void
    {
        $this->expectException(\OutOfRangeException::class);

        Callback::createFor(function() {})->argument(0);
    }

    /**
     * @test
     */
    public function value_factory_injects_argument_if_type_hinted(): void
    {
        $callback = Callback::createFor(function(string $a, int $b, $c) { return [$a, $b, $c]; });
        $factory = Parameter::factory(function(Argument $argument) {
            if ($argument->supports('string')) {
                return 'string';
            }

            if ($argument->supports('int')) {
                return 17;
            }

            return 'invalid';
        });

        $ret = $callback->invokeAll(
            Parameter::union(
                Parameter::typed('string', $factory),
                Parameter::typed('int', $factory),
                Parameter::untyped($factory)
            )
        );

        $this->assertSame(['string', 17, 'string'], $ret);
    }

    /**
     * @test
     */
    public function can_use_value_factory_with_no_argument(): void
    {
        $ret = Callback::createFor(function($value) { return $value; })
            ->invoke(Parameter::untyped(Parameter::factory(function() { return 'value'; })))
        ;

        $this->assertSame('value', $ret);
    }

    /**
     * @test
     * @requires PHP >= 8.0
     */
    public function value_factory_can_be_used_with_union_arguments_if_no_value_factory_argument(): void
    {
        // hack to allow test suite to run on php 7 w/o syntax errors
        eval('$callback = fn(\Zenstruck\Callback\Tests\Object1|string $a) => $a;');

        $ret = Callback::createFor($callback)
            ->invoke(Parameter::typed('string', Parameter::factory(function() { return 'value'; })))
        ;

        $this->assertSame('value', $ret);
    }

    /**
     * @test
     * @requires PHP >= 8.0
     */
    public function value_factory_can_be_used_with_union_arguments_as_array(): void
    {
        $array = [];
        $factory = Parameter::factory(function(array $types) use (&$array) {
            $array = $types;

            return 'value';
        });

        // hack to allow test suite to run on php 7 w/o syntax errors
        eval('$callback = fn(\Zenstruck\Callback\Tests\Object1|string $a) => $a;');
        $ret = Callback::createFor($callback)
            ->invoke(Parameter::typed('string', $factory))
        ;

        $this->assertSame('value', $ret);
        $this->assertSame([Object1::class, 'string'], $array);
    }

    /**
     * @test
     * @requires PHP >= 8.0
     */
    public function value_factory_cannot_accept_union_argument(): void
    {
        $this->expectException(\LogicException::class);

        // hack to allow test suite to run on php 7 w/o syntax errors
        eval('$callback = fn(\Zenstruck\Callback\Tests\Object1|string $a) => $a;');

        Callback::createFor($callback)
            ->invoke(Parameter::typed('string', Parameter::factory(function(string $type) { return $type; })))
        ;
    }

    /**
     * @test
     */
    public function argument_supports(): void
    {
        $callback1 = Callback::createFor(function(?Object1 $object, string $string, int $int, $noType) {});

The parameter $noType is not used and could be removed.

The parameter $int is not used and could be removed.

The parameter $string is not used and could be removed.

The parameter $object is not used and could be removed.

        $callback2 = Callback::createFor(function(Object2 $object, string $string, $noType) {});

The parameter $noType is not used and could be removed.

The parameter $string is not used and could be removed.

The parameter $object is not used and could be removed.

        $this->assertTrue($callback1->argument(0)->supports(Object1::class));
        $this->assertTrue($callback1->argument(0)->supports(Object2::class));
        $this->assertTrue($callback1->argument(0)->supports('null'));
        $this->assertTrue($callback1->argument(0)->supports('NULL'));
        $this->assertFalse($callback1->argument(0)->supports('string'));
        $this->assertFalse($callback1->argument(0)->supports(Object3::class));
        $this->assertFalse($callback1->argument(0)->supports(Object2::class, Argument::EXACT));
        $this->assertTrue($callback1->argument(1)->supports('string'));
        $this->assertFalse($callback1->argument(1)->supports('int'));
        $this->assertTrue($callback1->argument(2)->supports('int'));
        $this->assertTrue($callback1->argument(2)->supports('integer'));
        $this->assertTrue($callback1->argument(3)->supports(Object1::class));
        $this->assertTrue($callback1->argument(3)->supports(Object2::class));
        $this->assertTrue($callback1->argument(3)->supports('string'));
        $this->assertTrue($callback1->argument(3)->supports('int'));

        $this->assertTrue($callback2->argument(0)->supports(Object1::class, Argument::EXACT|Argument::COVARIANCE|Argument::CONTRAVARIANCE));
        $this->assertFalse($callback2->argument(0)->supports(Object3::class, Argument::EXACT|Argument::COVARIANCE|Argument::CONTRAVARIANCE));
    }

    /**
     * @test
     */
    public function argument_supports_value(): void
    {
        $callback1 = Callback::createFor(function(Object1 $object, string $string, int $int, $noType) {});

The parameter $noType is not used and could be removed.

The parameter $object is not used and could be removed.

The parameter $int is not used and could be removed.

The parameter $string is not used and could be removed.

        $callback2 = Callback::createFor(function(Object2 $object, string $string, $noType) {});

The parameter $string is not used and could be removed.

The parameter $object is not used and could be removed.

The parameter $noType is not used and could be removed.

        $this->assertTrue($callback1->argument(0)->allows(new Object1()));
        $this->assertTrue($callback1->argument(0)->allows(new Object2()));
        $this->assertFalse($callback1->argument(0)->allows('string'));
        $this->assertFalse($callback1->argument(0)->allows(new Object3()));
        $this->assertTrue($callback1->argument(1)->allows('string'));
        $this->assertFalse($callback1->argument(1)->allows(16));
        $this->assertTrue($callback1->argument(2)->allows(16));
        $this->assertFalse($callback1->argument(2)->allows('string'));
        $this->assertFalse($callback1->argument(2)->allows(16.0));
        $this->assertTrue($callback1->argument(3)->allows(new Object1()));
        $this->assertTrue($callback1->argument(3)->allows(new Object2()));
        $this->assertTrue($callback1->argument(3)->allows('string'));
        $this->assertTrue($callback1->argument(3)->allows(16));

        $this->assertFalse($callback2->argument(0)->allows(new Object1()));
        $this->assertFalse($callback2->argument(0)->allows(new Object3()));
    }
}

class Object1
{
}

class Object2 extends Object1
{
}

class Object3
{
}

class Object4
{
    public function __invoke()
    {
    }

    public static function staticMethod()
    {
    }
}

function test_function()
{
}