Files
XC_VM/tests/Unit/ModuleLoaderTest.php
T
Divarion-D 3377236d77 chore(psr4): phase 3 (Cli) — namespace Cli + switch console.php to FQCN discovery
Namespace all 55 Cli classes into XcVm\Cli (CommandInterface, CommandRegistry,
CronTrait, DaemonTrait), XcVm\Cli\Commands (28) and XcVm\Cli\CronJobs (23);
migration_logic.php stays procedural/global.

- console.php: switch command discovery from basename==classname + manual require
  to FQCN resolution — each scan dir maps to its PSR-4 namespace, classes load via
  Composer, implementsInterface(CommandInterface::class). Drop the manual
  CommandInterface/CommandRegistry requires. This is the atomic switch the plan
  required to land with the Cli namespacing.
- Commands/CronJobs get 'use XcVm\Cli\CommandInterface;' (implements) and the
  trait imports 'use XcVm\Cli\CronTrait;'/'DaemonTrait;'; rewrite the modules'
  'use CommandRegistry;' → FQCN; qualify built-ins/global (\ReflectionClass,
  \PDO, \Exception, \RuntimeException, \XC_Autoloader, \XC_VM).
- Fixtures: 'use CommandRegistry;' → FQCN; InterfaceContractTest registerCommands
  param-type → FQCN. phpstan-baseline.neon regenerated.

Verified: php -l clean; PHPStan no errors; PHPUnit 295/295; FQCN discovery resolves
51 classes (49 implement CommandInterface); no mangled FQCNs; re-sweep clean.
2026-06-25 19:03:39 +03:00

109 lines
3.9 KiB
PHP

<?php
use XcVm\Cli\CommandRegistry;
use XcVm\Core\Container\ServiceContainer;
use XcVm\Core\Module\ModuleLoader;
use XcVm\Core\Module\NavbarRegistry;
use XcVm\Core\Module\ModuleInterface;
use XcVm\Core\Http\Router;
use PHPUnit\Framework\TestCase;
final class ModuleLoaderTest extends TestCase {
public function testLoadAllThrowsWhenDependencyMissing(): void {
$root = $this->createModulesRoot();
$this->createModule($root, 'missing-alpha', [
'dependencies' => ['missing-module'],
]);
$loader = new ModuleLoader();
$this->expectException(RuntimeException::class);
$this->expectExceptionMessage('requires missing dependency missing-module');
$loader->loadAll($root);
}
public function testLoadAllThrowsWhenDependenciesAreCyclic(): void {
$root = $this->createModulesRoot();
$this->createModule($root, 'cycle-alpha', ['dependencies' => ['cycle-beta']]);
$this->createModule($root, 'cycle-beta', ['dependencies' => ['cycle-alpha']]);
$loader = new ModuleLoader();
$this->expectException(RuntimeException::class);
$this->expectExceptionMessage('cyclic module dependency detected');
$loader->loadAll($root);
}
public function testLoadAllSortsModulesByDependencies(): void {
$root = $this->createModulesRoot();
$this->createModule($root, 'order-base');
$this->createModule($root, 'order-feature', ['dependencies' => ['order-base']]);
$loader = new ModuleLoader();
$loader->loadAll($root);
$this->assertSame(['order-base', 'order-feature'], array_keys($loader->getModules()));
}
public function testLoadAllSkipsForeignEnvironmentModules(): void {
$root = $this->createModulesRoot();
$this->createModule($root, 'env-main-only', ['environment' => 'main']);
$this->createModule($root, 'env-lb-only', ['environment' => 'lb']);
$loader = new ModuleLoader();
$loader->loadAll($root);
$this->assertTrue($loader->isLoaded('env-main-only'));
$this->assertFalse($loader->isLoaded('env-lb-only'));
}
private function createModulesRoot(): string {
$path = sys_get_temp_dir() . '/xc_vm_modules_test_' . bin2hex(random_bytes(6));
mkdir($path, 0775, true);
return $path;
}
private function createModule(string $root, string $name, array $manifestOverrides = []): void {
$modulePath = $root . '/' . $name;
mkdir($modulePath, 0775, true);
$pascal = implode('', array_map('ucfirst', explode('-', $name)));
$className = $pascal . 'Module';
$namespace = 'XcVm\\Module\\' . $pascal;
$manifest = array_merge([
'name' => $name,
'description' => 'test module',
'version' => '1.0.0',
'requires_core' => '>=2.0',
'environment' => 'main',
'dependencies' => [],
'has_navbar' => false,
'has_settings' => false,
], $manifestOverrides);
file_put_contents($modulePath . '/module.json', json_encode($manifest, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES));
$php = '<?php' . "\n"
. 'namespace ' . $namespace . ';' . "\n"
. 'use XcVm\Core\Module\ModuleInterface;' . "\n"
. 'use XcVm\Core\Container\ServiceContainer;' . "\n"
. 'use Router;' . "\n"
. 'use XcVm\Cli\CommandRegistry;' . "\n"
. 'use XcVm\Core\Module\NavbarRegistry;' . "\n"
. 'class ' . $className . ' implements ModuleInterface {' . "\n"
. "\tpublic function getName(): string { return '{$name}'; }" . "\n"
. "\tpublic function getVersion(): string { return '1.0.0'; }" . "\n"
. "\tpublic function boot(ServiceContainer \$container): void {}" . "\n"
. "\tpublic function registerRoutes(\\XcVm\\Core\\Http\\Router \$router): void {}" . "\n"
. "\tpublic function registerCommands(CommandRegistry \$registry): void {}" . "\n"
. "\tpublic function getEventSubscribers(): array { return []; }" . "\n"
. "\tpublic function install(): void {}" . "\n"
. "\tpublic function uninstall(): void {}" . "\n"
. "\tpublic function registerNavbar(NavbarRegistry \$registry): void {}" . "\n"
. '}' . "\n";
file_put_contents($modulePath . '/' . $className . '.php', $php);
}
}