Cerbero\Dto\Manipulators\ArrayConverter

Complexity

Total Complexity

20

Size/Duplication

Total Lines	168
Duplicated Lines	0 %

Test Coverage

Coverage

100%

Importance

Changes	1
Bugs	0	Features	0

9 Methods

Rating	Name	Duplication	Size	Complexity
A	convert()	0	18	5
A	resolveConverter()	0	3	1
A	getConverterByClass()	0	11	3
A	__construct()	0	2	1
A	instance()	0	3	2
A	getConverterByInstance()	0	16	4
A	setConversions()	0	5	1
A	getConversions()	0	3	1
A	formatArrayKey()	0	7	2

<?php

namespace Cerbero\Dto\Manipulators;

/**
 * The array converter.
 *
 */
class ArrayConverter
{
    /**
     * The snake case pattern
     *
     * - Look behind for lower case letters or digits
     * - Look ahead for upper case letters
     */
    public const RE_SNAKE_CASE = '/(?<=[a-z\d])(?=[A-Z])/';

    /**
     * The class instance.
     *
     * @var self
     */
    protected static $instance;

    /**
     * The registered conversions.
     *
     * @var array
     */
    protected $conversions = [];

    /**
     * The cached value converters.
     *
     * @var ValueConverter[]
     */
    protected $cachedConverters = [];

    /**
     * Instantiate the class
     *
     */
    protected function __construct()
    {
        //
    }

    /**
     * Retrieve the class instance
     *
     * @return self
     */
    public static function instance(): self
    {
        return static::$instance = static::$instance ?: new static();
    }

    /**
     * Set the given value conversions
     *
     * @param array $conversions
     * @return self
     */
    public function setConversions(array $conversions): self
    {
        $this->conversions = $conversions;

        return $this;
    }

    /**
     * Retrieve the value conversions
     *
     * @return array
     */
    public function getConversions(): array
    {
        return $this->conversions;
    }

    /**
     * Convert the given item into an array
     *
     * @param mixed $item
     * @param bool $snakeCase
     * @return mixed
     */
    public function convert($item, $snakeCase = false)
    {
        if (is_object($item) && $converter = $this->getConverterByInstance($item)) {
            return $converter->fromDto($item);
        }

        if (is_iterable($item)) {
            $result = [];

            foreach ($item as $key => $value) {
                $formattedKey = $this->formatArrayKey($key, $snakeCase);
                $result[$formattedKey] = $this->convert($value);
            }

            return $result;
        }

        return $item;
    }

    /**
     * Retrieve the converter for the given object instance
     *
     * @param object $instance
     * @return ValueConverter|null
     */
    public function getConverterByInstance($instance): ?ValueConverter
    {
        $class = get_class($instance);

        if (isset($this->cachedConverters[$class])) {
            return $this->cachedConverters[$class];
        }

        foreach ($this->getConversions() as $type => $class) {
            if (is_a($instance, $type)) {
                $converter = $this->resolveConverter($class);
                return $this->cachedConverters[$class] = $this->cachedConverters[$type] = $converter;
            }
        }

        return null;
    }

    /**
     * Retrieve the instance of the given converter
     *
     * @param string $converter
     * @return ValueConverter
     */
    protected function resolveConverter(string $converter): ValueConverter
    {
        return new $converter();
    }

    /**
     * Retrieve the formatted array key
     *
     * @param string $key
     * @param bool $snakeCase
     * @return string
     */
    protected function formatArrayKey(string $key, bool $snakeCase): string
    {
        if (!$snakeCase) {
            return $key;
        }

        return strtolower(preg_replace(static::RE_SNAKE_CASE, '_', $key));
    }

    /**
     * Retrieve the converter for the given class
     *
     * @param string $class
     * @return ValueConverter|null
     */
    public function getConverterByClass(string $class): ?ValueConverter
    {
        if (isset($this->cachedConverters[$class])) {
            return $this->cachedConverters[$class];
        }

        if ($converter = $this->conversions[$class] ?? null) {
            return $this->cachedConverters[$class] = $this->resolveConverter($converter);
        }

        return null;
    }
}