Rade\Traits\HelperTrait

Complexity

Total Complexity

41

Size/Duplication

Total Lines	248
Duplicated Lines	0 %

Test Coverage

Coverage

7.23%

Importance

Changes	6
Bugs	0	Features	0

11 Methods

Rating	Name	Duplication	Size	Complexity
A	isRunningInConsole()	0	3	1
A	isDebug()	0	3	1
A	inVagrantEnvironment()	0	3	3
A	mount()	0	3	1
A	escape()	0	3	1
A	loadExtensions()	0	8	2
A	getConfigLoader()	0	20	4
A	load()	0	15	4
A	getModule()	0	7	2
C	getLocation()	0	55	13
B	loadModules()	0	34	9

<?php

declare(strict_types=1);

/*
 * This file is part of DivineNii opensource projects.
 *
 * PHP version 7.4 and above required
 *
 * @author    Divine Niiquaye Ibok <divineibok@gmail.com>
 * @copyright 2019 DivineNii (https://divinenii.com/)
 * @license   https://opensource.org/licenses/BSD-3-Clause License
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

namespace Rade\Traits;

use Composer\InstalledVersions;
use Laminas\Escaper\Escaper;
use Nette\Utils\FileSystem;
use Rade\DI\Exceptions\ContainerResolutionException;
use Rade\DI\Exceptions\ServiceCreationException;
use Rade\DI\Extensions\ConfigExtension;
use Rade\DI\Extensions\ExtensionBuilder;
use Symfony\Component\Config\Exception\LoaderLoadException;
use Symfony\Component\Config\Loader\LoaderResolverInterface;

trait HelperTrait
{
    private array $loadedExtensionPaths = [], $loadedModules = [], $moduleExtensions = [];

    public function isDebug(): bool
    {
        return $this->parameters['debug'];
    }

    /**
     * Determine if the application is running in the console.
     */
    public function isRunningInConsole(): bool
    {
        return \in_array(\PHP_SAPI, ['cli', 'phpdbg', 'embed'], true);
    }

    /**
     * Determine if the application is in vagrant environment.
     */
    public function inVagrantEnvironment(): bool
    {
        return ('/home/vagrant' === \getenv('HOME') || 'VAGRANT' === \getenv('VAGRANT')) && \is_dir('/dev/shm');
    }

    /**
     * The delegated config loaders instance.
     */
    public function getConfigLoader(): LoaderResolverInterface
    {
        $configLoader = $this->services['config.loader_resolver'] ?? $this->privates['config.builder.loader_resolver'] ?? null;

        if (null === $configLoader) {
            if (isset($this->definitions['config.builder.loader_resolver'])) {
                $configLoader = $this->definitions['config.builder.loader_resolver'];
                unset($this->definitions['config.builder.loader_resolver']);

                return $this->privates['config.builder.loader_resolver'] = $configLoader;

The property privates does not exist. Although not strictly required by PHP, it is generally a best practice to declare properties explicitly.

            }

            if ($this->has('config.loader_resolver')) {

It seems like has() must be provided by classes using this trait. How about adding it as abstract method to this trait?

                return $this->get('config.loader_resolver');

It seems like get() must be provided by classes using this trait. How about adding it as abstract method to this trait?

            }

            throw new ContainerResolutionException(\sprintf('Did you forgot to register the "%s" class?', ConfigExtension::class));
        }

        return $configLoader;
    }

    /**
     * Context specific methods for use in secure output escaping.
     */
    public function escape(string $encoding = null): Escaper
    {
        return new Escaper($encoding);
    }

    /**
     * Mounts a service provider like controller taking in a parameter of application.
     *
     * @param callable(\Rade\DI\AbstractContainer) $controllers
     */
    public function mount(callable $controllers): void
    {
        $controllers($this);
    }

    /**
     * Loads a set of container extensions.
     *
     * Example for extensions:
     * [
     *    PhpExtension::class,
     *    CoreExtension::class => -1,
     *    [ProjectExtension::class, ['%project.dir%']],
     * ]
     *
     * @param array<int,mixed>    $extensions
     * @param array<string,mixed> $config     the default configuration for all extensions
     * @param string|null         $outputDir  Enable Generating ConfigBuilders to help create valid config
     */
    public function loadExtensions(array $extensions, array $configs = [], string $outputDir = null): void
    {
        $builder = new ExtensionBuilder($this, $configs);

$this of type Rade\Traits\HelperTrait is incompatible with the type Rade\DI\AbstractContainer expected by parameter $container of Rade\DI\Extensions\ExtensionBuilder::__construct().

        if (null !== $outputDir) {
            $builder->setConfigBuilderGenerator($outputDir);
        }
        $builder->load($extensions + $this->moduleExtensions);
    }

    /**
     * Loads a set of modules from module directory.
     *
     * This method should be called before the loadExtensions method.
     */
    public function loadModules(string $moduleDir, string $prefix = null): void
    {
        // Get list modules available in application
        foreach (\scandir($moduleDir) as $directory) {
            if ('.' === $directory || '..' === $directory) {
                continue;
            }

            // Check if file parsed is a directory (module need to be a directory)
            if (!\is_dir($directoryPath = \rtrim($moduleDir, '\/') . '/' . $prefix . $directory)) {
                continue;
            }

            // Load module configuration file
            if (!\file_exists($configFile = $directoryPath . '/config.json')) {
                continue;
            }

            // Load module
            $moduleLoad = new \Rade\Module($directoryPath, \json_decode($configFile, true));

            if (!\array_key_exists($directory, $this->loadedExtensionPaths)) {
                $this->loadedExtensionPaths[$directory] = $directoryPath;
            }

            if (!$moduleLoad->isEnabled()) {
                continue;
            }

            if (!empty($extensions = $moduleLoad->getExtensions())) {
                $this->moduleExtensions = \array_merge($this->moduleExtensions, $extensions);
            }

            $this->loadedModules[$directory] = $moduleLoad;
        }
    }

    /**
     * Loads a resource.
     *
     * @param mixed $resource the resource can be anything supported by a config loader
     *
     * @throws \Exception If something went wrong
     *
     * @return mixed
     */
    public function load($resource, string $type = null)
    {
        if (\is_string($resource)) {
            $resource = $this->parameter($resource);

It seems like parameter() must be provided by classes using this trait. How about adding it as abstract method to this trait?

            if ('@' === $resource[0]) {
                $resource = $this->getLocation($resource);
            }
        }

        if (false === $loader = $this->getConfigLoader()->resolve($resource, $type)) {
            throw new LoaderLoadException($resource, null, 0, null, $type);
        }

        return $loader->load($resource, $type);
    }

    /**
     * Returns the file path for a given service extension or class name resource.
     *
     * A Resource can be a file or a directory. The resource name must follow the following pattern:
     * "@CoreExtension/path/to/a/file.something"
     *
     * where CoreExtension is the name of the service extension or class,
     * and the remaining part is the relative path to a file or directory.
     *
     * We recommend using composer v2, as this method depends on it or use $baseDir parameter.
     *
     * @param string $name
     *
     * @throws \InvalidArgumentException    if the file cannot be found or the name is not valid
     * @throws \RuntimeException            if the name contains invalid/unsafe characters
     * @throws ContainerResolutionException if the service provider is not included in path
     *
     * @return string The absolute path of the resource
     */
    public function getLocation(string $path, string $baseDir = 'src')
    {
        if (\str_contains($path, '..')) {
            throw new \RuntimeException(\sprintf('File name "%s" contains invalid characters (..).', $path));
        }

        if ('@' === $path[0]) {
            [$bundleName, $path] = \explode('/', \substr($path, 1), 2);

            if (isset($this->loadedExtensionPaths[$bundleName])) {
                return $this->loadedExtensionPaths[$bundleName] . '/' . $path;
            }

            if (null !== $extension = $this->getExtension($bundleName)) {

It seems like getExtension() must be provided by classes using this trait. How about adding it as abstract method to this trait?

                $bundleName = \get_class($extension);
            }

            try {
                $ref = new \ReflectionClass($bundleName);
                $directory = \str_replace('\\', '/', \dirname($ref->getFileName()));
            } catch (\ReflectionException $e) {
                throw new ContainerResolutionException(\sprintf('Resource path is not supported for %s', $bundleName), 0, $e);
            }

            if ($pos = \strpos($directory, $baseDir)) {
                $directory = \substr($directory, 0, $pos + \strlen($baseDir));

                if (!\file_exists($directory)) {
                    $directory = \substr_replace($directory, '', $pos, 3);
                }

                return ($this->loadedExtensionPaths[$bundleName] = \substr($directory, 0, $pos + \strlen($baseDir))) . '/' . $path;

It seems like $directory can also be of type array; however, parameter $string of substr() does only seem to accept string, maybe add an additional type check?

            }

            if (\class_exists(InstalledVersions::class)) {
                $rootPath = InstalledVersions::getRootPackage()['install_path'] ?? false;

                if ($rootPath && $rPos = \strpos($rootPath, 'composer')) {
                    $rootPath = \substr($rootPath, 0, $rPos);

                    if (!$pos = \strpos($directory, $rootPath)) {
                        throw new \UnexpectedValueException(\sprintf('Looks like package "%s" does not live in composer\'s directory "%s".', InstalledVersions::getRootPackage()['name'], $rootPath));
                    }

                    $parts = \explode('/', \substr($directory, $pos));
                    $directory = InstalledVersions::getInstallPath($parts[1] . '/' . $parts[2]);

                    if (null !== $directory) {
                        return ($this->loadedExtensionPaths[$bundleName] = FileSystem::normalizePath($directory)) . '/' . $path;
                    }
                }
            }
        }

        throw new \InvalidArgumentException(\sprintf('Unable to find file "%s".', $path));
    }

    /**
     * Load up a module(s) (A.K.A plugin).
     *
     * @return \Rade\Module|array<string,\Rade\Module>
     */
    public function getModule(string $directory = null)
    {
        if (null === $directory) {
            return $this->loadedModules;
        }

        return $this->loadedModules[$directory] ?? throw new ServiceCreationException(\sprintf('Failed to load module %s, from modules root path.', $directory));
    }
}