Introduce Capability Registry & Discovery
This commit is contained in:
Christopher Hertel
parent
09707b4798
commit
da0d5a87a0
1 changed files with 7063 additions and 8 deletions
207
tests/Capability/Discovery/HandlerResolverTest.php
Normal file
207
tests/Capability/Discovery/HandlerResolverTest.php
Normal file
|
|
@ -0,0 +1,207 @@
|
|||
<?php
|
||||
|
||||
/*
|
||||
* This file is part of the official PHP MCP SDK.
|
||||
*
|
||||
* A collaboration between Symfony and the PHP Foundation.
|
||||
*
|
||||
* For the full copyright and license information, please view the LICENSE
|
||||
* file that was distributed with this source code.
|
||||
*/
|
||||
|
||||
namespace Mcp\Tests\Capability\Discovery;
|
||||
|
||||
use Mcp\Capability\Discovery\HandlerResolver;
|
||||
use Mcp\Exception\InvalidArgumentException;
|
||||
use PHPUnit\Framework\TestCase;
|
||||
|
||||
class HandlerResolverTest extends TestCase
|
||||
{
|
||||
public function testResolvesClosuresToReflectionFunction()
|
||||
{
|
||||
$closure = function (string $input): string {
|
||||
return "processed: $input";
|
||||
};
|
||||
$resolved = HandlerResolver::resolve($closure);
|
||||
$this->assertInstanceOf(\ReflectionFunction::class, $resolved);
|
||||
$this->assertEquals(1, $resolved->getNumberOfParameters());
|
||||
$this->assertInstanceOf(\ReflectionNamedType::class, $returnType = $resolved->getReturnType());
|
||||
$this->assertEquals('string', $returnType->getName());
|
||||
}
|
||||
|
||||
public function testResolvesValidArrayHandler()
|
||||
{
|
||||
$handler = [ValidHandlerClass::class, 'publicMethod'];
|
||||
$resolved = HandlerResolver::resolve($handler);
|
||||
$this->assertInstanceOf(\ReflectionMethod::class, $resolved);
|
||||
$this->assertEquals('publicMethod', $resolved->getName());
|
||||
$this->assertEquals(ValidHandlerClass::class, $resolved->getDeclaringClass()->getName());
|
||||
}
|
||||
|
||||
public function testResolvesValidInvokableClassStringHandler()
|
||||
{
|
||||
$handler = ValidInvokableClass::class;
|
||||
$resolved = HandlerResolver::resolve($handler);
|
||||
$this->assertInstanceOf(\ReflectionMethod::class, $resolved);
|
||||
$this->assertEquals('__invoke', $resolved->getName());
|
||||
$this->assertEquals(ValidInvokableClass::class, $resolved->getDeclaringClass()->getName());
|
||||
}
|
||||
|
||||
public function testResolvesStaticMethodsForManualRegistration()
|
||||
{
|
||||
$handler = [ValidHandlerClass::class, 'staticMethod'];
|
||||
$resolved = HandlerResolver::resolve($handler);
|
||||
$this->assertInstanceOf(\ReflectionMethod::class, $resolved);
|
||||
$this->assertEquals('staticMethod', $resolved->getName());
|
||||
$this->assertTrue($resolved->isStatic());
|
||||
}
|
||||
|
||||
public function testThrowsForInvalidArrayHandlerFormatCount()
|
||||
{
|
||||
$this->expectException(InvalidArgumentException::class);
|
||||
$this->expectExceptionMessage("Invalid array handler format. Expected [ClassName::class, 'methodName'].");
|
||||
HandlerResolver::resolve([ValidHandlerClass::class]); /* @phpstan-ignore argument.type */
|
||||
}
|
||||
|
||||
public function testThrowsForInvalidArrayHandlerFormatTypes()
|
||||
{
|
||||
$this->expectException(InvalidArgumentException::class);
|
||||
$this->expectExceptionMessage("Invalid array handler format. Expected [ClassName::class, 'methodName'].");
|
||||
HandlerResolver::resolve([ValidHandlerClass::class, 123]); /* @phpstan-ignore argument.type */
|
||||
}
|
||||
|
||||
public function testThrowsForNonExistentClassInArrayHandler()
|
||||
{
|
||||
$this->expectException(InvalidArgumentException::class);
|
||||
$this->expectExceptionMessage('Handler class "NonExistentClass" not found');
|
||||
HandlerResolver::resolve(['NonExistentClass', 'method']);
|
||||
}
|
||||
|
||||
public function testThrowsForNonExistentMethodInArrayHandler()
|
||||
{
|
||||
$this->expectException(InvalidArgumentException::class);
|
||||
$this->expectExceptionMessage('Handler method "nonExistentMethod" not found in class');
|
||||
HandlerResolver::resolve([ValidHandlerClass::class, 'nonExistentMethod']);
|
||||
}
|
||||
|
||||
public function testThrowsForNonExistentClassInStringHandler()
|
||||
{
|
||||
$this->expectException(InvalidArgumentException::class);
|
||||
$this->expectExceptionMessage('Invalid handler format. Expected Closure, [ClassName::class, \'methodName\'] or InvokableClassName::class string.');
|
||||
HandlerResolver::resolve('NonExistentInvokableClass');
|
||||
}
|
||||
|
||||
public function testThrowsForNonInvokableClassStringHandler()
|
||||
{
|
||||
$this->expectException(InvalidArgumentException::class);
|
||||
$this->expectExceptionMessage('Invokable handler class "Mcp\\Tests\\Capability\\Discovery\\NonInvokableClass" must have a public "__invoke" method.');
|
||||
HandlerResolver::resolve(NonInvokableClass::class);
|
||||
}
|
||||
|
||||
public function testThrowsForProtectedMethodHandler()
|
||||
{
|
||||
$this->expectException(InvalidArgumentException::class);
|
||||
$this->expectExceptionMessage('must be public');
|
||||
HandlerResolver::resolve([ValidHandlerClass::class, 'protectedMethod']);
|
||||
}
|
||||
|
||||
public function testThrowsForPrivateMethodHandler()
|
||||
{
|
||||
$this->expectException(InvalidArgumentException::class);
|
||||
$this->expectExceptionMessage('must be public');
|
||||
HandlerResolver::resolve([ValidHandlerClass::class, 'privateMethod']);
|
||||
}
|
||||
|
||||
public function testThrowsForConstructorAsHandler()
|
||||
{
|
||||
$this->expectException(InvalidArgumentException::class);
|
||||
$this->expectExceptionMessage('cannot be a constructor or destructor');
|
||||
HandlerResolver::resolve([ValidHandlerClass::class, '__construct']);
|
||||
}
|
||||
|
||||
public function testThrowsForDestructorAsHandler()
|
||||
{
|
||||
$this->expectException(InvalidArgumentException::class);
|
||||
$this->expectExceptionMessage('cannot be a constructor or destructor');
|
||||
HandlerResolver::resolve([ValidHandlerClass::class, '__destruct']);
|
||||
}
|
||||
|
||||
public function testThrowsForAbstractMethodHandler()
|
||||
{
|
||||
$this->expectException(InvalidArgumentException::class);
|
||||
$this->expectExceptionMessage('Handler method "Mcp\Tests\Capability\Discovery\AbstractHandlerClass::abstractMethod" must be abstract.');
|
||||
HandlerResolver::resolve([AbstractHandlerClass::class, 'abstractMethod']);
|
||||
}
|
||||
|
||||
public function testResolvesClosuresWithDifferentSignatures()
|
||||
{
|
||||
$noParams = function () {
|
||||
return 'test';
|
||||
};
|
||||
$withParams = function (int $a, string $b = 'default') {
|
||||
return $a.$b;
|
||||
};
|
||||
$variadic = function (...$args) {
|
||||
return $args;
|
||||
};
|
||||
$this->assertInstanceOf(\ReflectionFunction::class, HandlerResolver::resolve($noParams));
|
||||
$this->assertInstanceOf(\ReflectionFunction::class, HandlerResolver::resolve($withParams));
|
||||
$this->assertInstanceOf(\ReflectionFunction::class, HandlerResolver::resolve($variadic));
|
||||
$this->assertEquals(0, HandlerResolver::resolve($noParams)->getNumberOfParameters());
|
||||
$this->assertEquals(2, HandlerResolver::resolve($withParams)->getNumberOfParameters());
|
||||
$this->assertTrue(HandlerResolver::resolve($variadic)->isVariadic());
|
||||
}
|
||||
|
||||
public function testDistinguishesBetweenClosuresAndCallableArrays()
|
||||
{
|
||||
$closure = function () {
|
||||
return 'closure';
|
||||
};
|
||||
$array = [ValidHandlerClass::class, 'publicMethod'];
|
||||
$string = ValidInvokableClass::class;
|
||||
$this->assertInstanceOf(\ReflectionFunction::class, HandlerResolver::resolve($closure));
|
||||
$this->assertInstanceOf(\ReflectionMethod::class, HandlerResolver::resolve($array));
|
||||
$this->assertInstanceOf(\ReflectionMethod::class, HandlerResolver::resolve($string));
|
||||
}
|
||||
}
|
||||
|
||||
// Helper classes
|
||||
class ValidHandlerClass
|
||||
{
|
||||
public function publicMethod(): void
|
||||
{
|
||||
}
|
||||
|
||||
protected function protectedMethod(): void
|
||||
{
|
||||
}
|
||||
|
||||
private function privateMethod(): void /* @phpstan-ignore method.unused */
|
||||
{
|
||||
}
|
||||
|
||||
public static function staticMethod(): void
|
||||
{
|
||||
}
|
||||
|
||||
public function __construct()
|
||||
{
|
||||
}
|
||||
|
||||
public function __destruct()
|
||||
{
|
||||
}
|
||||
}
|
||||
class ValidInvokableClass
|
||||
{
|
||||
public function __invoke(): void
|
||||
{
|
||||
}
|
||||
}
|
||||
class NonInvokableClass
|
||||
{
|
||||
}
|
||||
abstract class AbstractHandlerClass
|
||||
{
|
||||
abstract public function abstractMethod(): void;
|
||||
}
|
||||
Loading…
Reference in a new issue