pest/src/Support/Closure.php

<?php

declare(strict_types=1);

namespace Pest\Support;

use Closure as BaseClosure;
use Pest\Exceptions\ShouldNotHappen;

/**
 * @internal
 */
final class Closure
{
    /**
     * Binds the given closure to the given "this".
     *
     * @return BaseClosure|never
     *
     * @throws ShouldNotHappen
     */
    public static function bind(BaseClosure|null $closure, ?object $newThis, object|string|null $newScope = 'static'): BaseClosure
    {
        if ($closure == null) {
            throw ShouldNotHappen::fromMessage('Could not bind null closure.');
        }

        $closure = BaseClosure::bind($closure, $newThis, $newScope);

        if ($closure == false) {
            throw ShouldNotHappen::fromMessage('Could not bind closure.');
        }

        return $closure;
    }
}