Rade\Traits\HelperTrait

Complexity

Total Complexity

29

Size/Duplication

Total Lines	189
Duplicated Lines	0 %

Importance

Changes	1
Bugs	0	Features	0

9 Methods

Rating	Name	Duplication	Size	Complexity
A	mount()	0	3	1
A	load()	0	15	4
A	escape()	0	3	1
A	loadExtensions()	0	3	1
A	getConfigLoader()	0	20	4
A	isRunningInConsole()	0	3	1
C	getLocation()	0	55	13
A	isDebug()	0	3	1
A	inVagrantEnvironment()	0	3	3

<?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\Extensions\ExtensionBuilder;
use Rade\Provider\ConfigServiceProvider;

The type Rade\Provider\ConfigServiceProvider was not found. Maybe you did not declare it correctly or list all dependencies?

use Symfony\Component\Config\Exception\LoaderLoadException;
use Symfony\Component\Config\Loader\LoaderResolverInterface;

trait HelperTrait
{
    /** @var array<string,string> */
    private array $loadedExtensionPaths = [];

    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 the delegated config loaders instance.
     */
    public function getConfigLoader(): LoaderResolverInterface
    {
        $configLoader = $this->services['config.loader_resolver'] ?? $this->privates['builder.loader_resolver'] ?? null;

        if (null === $configLoader) {
            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?

             }

Closing brace indented incorrectly; expected 12 spaces, found 13

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

                return $this->privates['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.

            }

Closing brace indented incorrectly; expected 13 spaces, found 12

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

        return $configLoader;
    }

    /**
     * Context specific methods for use in secure output escaping.
     *
     * @param string $encoding
     */
    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
     */
    public function loadExtensions(array $extensions, array $configs = []): void
    {
        (new ExtensionBuilder($this, $configs))->load($extensions);

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

    }

    /**
     * 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 (false !== \strpos($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));
    }
}