AppKernel::kernel() - Code Metrics - Inspection of "Merge pull request #9 from Micro-PHP/v1.6.1-releas..." - Micro-PHP/micro-kernel-app - Measure and Improve Code Quality continuously with Scrutinizer

Passed

Branch — master (a91c94)

by Stanislau

created 2023-01-21 01:37 UTC

AppKernel::kernel() A

↳ Parent: AppKernel

Complexity

Conditions	2
Paths	2

Size

Total Lines	19
Code Lines	7

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	8
CRAP Score	2

Importance

Changes

Metric	Value
cc	2
eloc	7
nc	2
nop	0
dl	0
loc	19
ccs	8
cts	8
cp	1
crap	2
rs	10
c	0
b	0
f	0

<?php

/*
 *  This file is part of the Micro framework package.
 *
 *  (c) Stanislau Komar <[email protected]>
 *
 *  For the full copyright and license information, please view the LICENSE
 *  file that was distributed with this source code.
 */

namespace Micro\Kernel\App;

use Micro\Component\DependencyInjection\Container;
use Micro\Framework\Kernel\Boot\ConfigurationProviderBootLoader;
use Micro\Framework\Kernel\Boot\DependedPluginsBootLoader;
filter:
    dependency_paths: ["lib/*"]
use Micro\Framework\Kernel\Boot\DependencyProviderBootLoader;
use Micro\Framework\Kernel\Configuration\ApplicationConfigurationInterface;
use Micro\Framework\Kernel\KernelBuilder;
use Micro\Framework\Kernel\KernelInterface;
use Micro\Framework\Kernel\Plugin\PluginBootLoaderInterface;
use Micro\Kernel\App\Business\KernelActionProcessorInterface;
use Micro\Kernel\App\Business\KernelRunActionProcessor;
use Micro\Kernel\App\Business\KernelTerminateActionProcessor;
use Micro\Plugin\EventEmitter\EventEmitterPlugin;
use Micro\Plugin\Locator\LocatorPlugin;

class AppKernel implements AppKernelInterface
{
    private bool $isTerminated;

    private bool $isStarted;

    private ?KernelInterface $kernel;

    /**
     * @var PluginBootLoaderInterface[]
     */
    private array $additionalBootLoaders = [];

    /**
     * @param ApplicationConfigurationInterface|array<string, string> $configuration
     * @param class-string[]                                          $plugins

     */
    public function __construct(
        private readonly ApplicationConfigurationInterface|array $configuration = [],
        private array $plugins = [],
        private readonly string $environment = 'dev'
    ) {
        $this->kernel = null;
        $this->isTerminated = false;
        $this->isStarted = false;
    }

    /**
     * {@inheritDoc}
     */
    public function container(): Container
    {
        return $this->kernel()->container();
    }

    /**
     * {@inheritDoc}
     */
    public function plugins(string $interfaceInherited = null): \Traversable
    {
        return $this->kernel()->plugins($interfaceInherited);
    }

    /**
     * {@inheritDoc}
     */
    public function run(): void
    {
        if ($this->isStarted) {
            return;
        }

        $this->kernel = $this->createKernel();

        $this->kernel->run();
                       run();

        $this->createInitActionProcessor()->process($this);

        $this->isStarted = true;
    }

    /**
     * {@inheritDoc}
     */
    public function terminate(): void
    {
        if ($this->isTerminated || !$this->isStarted) {
            return;
        }

        $this->createTerminateActionProcessor()->process($this);

        $this->isTerminated = true;
    }

    /**
     * {@inheritDoc}
     */
    public function environment(): string
    {
        return $this->environment;
    }

    /**
     * {@inheritDoc}
     */
    public function isDevMode(): bool
    {
        return str_starts_with($this->environment(), 'dev');
    }

    /**
     * {@inheritDoc}
     */
    public function addBootLoader(PluginBootLoaderInterface $bootLoader): self
    {
        $this->additionalBootLoaders[] = $bootLoader;

        return $this;
    }

    /**
     * {@inheritDoc}
     */
    public function loadPlugin(string $applicationPluginClass): void
    {
        $this->kernel()->loadPlugin($applicationPluginClass);
    }

    protected function createKernel(): KernelInterface
    {
        $container = new Container();
        $plugins = $this->plugins;
        $this->plugins = [];

        return $this
            ->createKernelBuilder()
            ->setContainer($container)
            ->addBootLoaders($this->createBootLoaderCollection($container))
            ->setApplicationPlugins(array_unique([
                    EventEmitterPlugin::class,
                    LocatorPlugin::class,
                    ...$plugins,
                ])
            )
            ->build();
    }

    protected function kernel(): KernelInterface
    {
        if (!$this->kernel) {
            $trace = debug_backtrace();
            $caller = $trace[1];
            /**
             * @var string $cc
             *
             * @phpstan-ignore-next-line
             *
             * @psalm-suppress PossiblyUndefinedArrayOffset
             */
            $cc = $caller['class'];
            $cm = $caller['function'];

            throw new \RuntimeException(sprintf('Method %s::%s can not be called before %s::run() execution.', $cc, $cm, KernelInterface::class));
        }

        return $this->kernel;
    }

    protected function createKernelBuilder(): KernelBuilder
    {
        return new KernelBuilder();
    }

    protected function createInitActionProcessor(): KernelActionProcessorInterface
    {
        return new KernelRunActionProcessor();
    }

    protected function createTerminateActionProcessor(): KernelActionProcessorInterface
    {
        return new KernelTerminateActionProcessor();
    }

    /**
     * @return PluginBootLoaderInterface[]
     */
    protected function createBootLoaderCollection(Container $container): array
    {
        $bl = $this->additionalBootLoaders;

        $this->additionalBootLoaders = [];

        return [

            new ConfigurationProviderBootLoader($this->configuration),
            new DependencyProviderBootLoader($container),
            new DependedPluginsBootLoader($this),
            ...$bl,
        ];
    }

    public function setBootLoaders(iterable $bootLoaders): KernelInterface
    {
        $this->kernel()->setBootLoaders($bootLoaders);

        return $this;
    }
}


Micro-PHP / micro-kernel-app

Branch — master (a91c94)

AppKernel::kernel() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like