src/Bootstrap.php
<?php
declare(strict_types=1);
/*
* This file is part of the Composer package "cpsit/project-builder".
*
* Copyright (C) 2022 Elias Häußler <e.haeussler@familie-redlich.de>
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <https://www.gnu.org/licenses/>.
*/
namespace CPSIT\ProjectBuilder;
use Composer\InstalledVersions;
use Composer\Script;
use Symfony\Component\Filesystem;
/**
* Bootstrap.
*
* @author Elias Häußler <e.haeussler@familie-redlich.de>
* @license GPL-3.0-or-later
*
* @internal
*
* @codeCoverageIgnore
*/
final class Bootstrap
{
/**
* Create a new project.
*
* This is the entrypoint for the "composer create-project" command,
* see composer.json in repository root.
*/
public static function createProject(
Script\Event $event,
?string $targetDirectory = null,
bool $exitOnFailure = true,
bool $disableTemplateSourceCache = false,
): int {
// Early return if current environment is unsupported
if (self::runsOnAnUnsupportedEnvironment()) {
throw Exception\UnsupportedEnvironmentException::forOutdatedComposerInstallation();
}
$messenger = IO\Messenger::create($event->getIO());
$targetDirectory ??= Helper\FilesystemHelper::getProjectRootPath();
// Create new project
$exitCode = self::createApplication($messenger, $targetDirectory)->run($disableTemplateSourceCache);
$event->stopPropagation();
if ($exitCode > 0 && $exitOnFailure) {
exit($exitCode);
}
return $exitCode;
}
/**
* Simulate behavior of {@see Bootstrap::createProject()}.
*
* This is the entrypoint to test the original behavior of
* "composer create-project" command. It is not meant to be used
* anywhere else than in debugging test cases.
*
* @internal
*
* @codeCoverageIgnore
*/
public static function simulateCreateProject(Script\Event $event): never
{
$simulation = Console\Simulation::create();
$targetDirectory = $simulation->prepare();
$exitCode = $simulation->run(
static fn (): int => self::createProject($event, $targetDirectory, false, true),
);
exit($exitCode);
}
private static function createApplication(IO\Messenger $messenger, string $targetDirectory): Console\Application
{
return new Console\Application(
$messenger,
Builder\Config\ConfigReader::create(),
new Error\ErrorHandler($messenger),
new Filesystem\Filesystem(),
$targetDirectory,
);
}
private static function runsOnAnUnsupportedEnvironment(): bool
{
/* @phpstan-ignore-next-line function.alreadyNarrowedType */
return !method_exists(InstalledVersions::class, 'getInstallPath');
}
}