Flipbox\Transform\Helpers\TransformerHelper

Complexity

Total Complexity

22

Size/Duplication

Total Lines	106
Duplicated Lines	0 %

Coupling/Cohesion

Components	0
Dependencies	1

Test Coverage

Coverage

8.33%

Importance

Changes

0

6 Methods

Rating	Name	Duplication	Size	Complexity
A	isTransformer()	0	5	3
A	isTransformerClass()	0	8	3
A	resolve()	0	12	3
A	inInclude()	0	4	1
B	normalizeIncludes()	0	31	8
A	findInArray()	0	9	4

<?php

/**
 * @author    Flipbox Factory
 * @copyright Copyright (c) 2017, Flipbox Digital
 * @link      https://github.com/flipbox/transform/releases/latest
 * @license   https://github.com/flipbox/transform/blob/master/LICENSE
 */

namespace Flipbox\Transform\Helpers;

use Closure;
use Flipbox\Transform\Transformers\TransformerIncludesInterface;
use Flipbox\Transform\Transformers\TransformerInterface;

/**
 * @author Flipbox Factory <hello@flipboxfactory.com>
 * @since 1.0.0
 */
class TransformerHelper
{
    /**
     * @param $transformer
     * @return bool
     */
    public static function isTransformer($transformer): bool
    {
        return (is_object($transformer) && ($transformer instanceof Closure)) ||
            $transformer instanceof TransformerInterface;
    }

    /**
     * @param $transformer
     * @return bool
     */
    public static function isTransformerClass($transformer): bool
    {
        return is_string($transformer) &&
            (
                is_subclass_of($transformer, TransformerInterface::class) ||

Due to PHP Bug #53727, is_subclass_of might return inconsistent results on some PHP versions if \Flipbox\Transform\Transformers\TransformerInterface::class can be an interface. If so, you could instead use ReflectionClass::implementsInterface.

                method_exists($transformer, '__invoke') // TODO - REVIEW PUBLIC ACCESS
            );
    }

    /**
     * @param $transformer
     * @return null|callable|TransformerInterface
     */
    public static function resolve($transformer)
    {
        if (static::isTransformer($transformer)) {
            return $transformer;
        }

        if (static::isTransformerClass($transformer)) {
            return new $transformer();
        }

        return null;
    }

    /**
     * @param TransformerIncludesInterface $transformer
     * @param string $key
     * @return bool
     */
    public static function inInclude(TransformerIncludesInterface $transformer, string $key): bool
    {
        return self::findInArray($transformer->getIncludes(), $key) !== null;
    }

    /**
     * @param array $includes
     * @return array
     */
    public static function normalizeIncludes(array $includes): array
    {
        foreach ($includes as $k => $v) {
            if (is_string($v) && ($pos = strrpos($v, '.')) !== false) {
                $v = [substr($v, 0, $pos) => [substr($v, $pos + 1)]];
            }

            // normalize sub-includes
            $v = is_array($v) ? static::normalizeIncludes($v) : $v;

            if (is_numeric($k)) {
                unset($includes[$k]);

                if (is_array($v)) {
                    $k = key($v);
                    $v = reset($v);
                } else {
                    $k = $v;
                }
            }

            $includes[$k] = $v;

            if (($pos = strrpos($k, '.')) !== false) {
                $includes[substr($k, 0, $pos)] = [substr($k, $pos + 1) => $includes[$k]];
                unset($includes[$k]);
            }
        }

        return $includes;
    }

    /**
     * Retrieves the value of an array element or object property with the given key or property name.
     *
     * @param $array
     * @param $key
     * @param null $default
     * @return mixed|null
     */
    private static function findInArray(array $array, string $key, $default = null)
    {
        if (($pos = strrpos($key, '.')) !== false) {
            $array = self::findInArray($array, substr($key, 0, $pos), $default);
            $key = substr($key, $pos + 1);
        }

        return is_array($array) && array_key_exists($key, $array) ? $array[$key] : $default;
    }
}