Koded\Stdlib\ExtendedArguments

Complexity

Total Complexity

20

Size/Duplication

Total Lines	86
Duplicated Lines	0 %

Test Coverage

Coverage

100%

Importance

Changes	1
Bugs	0	Features	0

7 Methods

Rating	Name	Duplication	Size	Complexity
A	append()	0	6	1
A	extract()	0	7	2
A	flatten()	0	16	3
A	has()	0	12	4
A	set()	0	13	4
A	get()	0	3	1
A	delete()	0	15	5

<?php declare(strict_types=1);

/*
 * This file is part of the Koded package.
 *
 * (c) Mihail Binev <mihail@kodeart.com>
 *
 * Please view the LICENSE distributed with this source code
 * for the full copyright and license information.
 */

namespace Koded\Stdlib;

use RecursiveArrayIterator;
use RecursiveIteratorIterator;
use function array_key_exists;
use function array_push;
use function array_slice;
use function explode;
use function is_array;
use function join;

/**
 * Class ExtendedArguments
 *
 * - NULL key is not supported; also it doesn't make sense
 * - boolean is a wrong type for the key; do not use a boolean key (it's juggled into a string)
 *
 * Use string values for the keys and you'll be golden.
 */
class ExtendedArguments extends Arguments
{
    public function get(string $index, mixed $default = null): mixed
    {
        return $this->find($index, $default);
    }

    public function set(string $index, mixed $value): static
    {
        $storage = &$this->storage;
        foreach (explode('.', $index) as $i) {
            if (false === is_array($storage[$i]) ||
                false === array_key_exists($i, $storage)
            ) {
                $storage[$i] = [];
            }
            $storage = &$storage[$i];
        }
        $storage = $value;
        return $this;
    }

    public function append(string $index, mixed $value): static
    {
        $partial = (array)$this->get($index);
        array_push($partial, $value);
        $this->set($index, $partial);
        return $this;
    }

    public function has(mixed $index): bool
    {
        $storage = & $this->storage;
        foreach (explode('.', $index) as $i) {
            if (false === is_array($storage) ||
                false === array_key_exists($i, $storage)
            ) {
                return false;
            }
            $storage = &$storage[$i];
        }
        return true;
    }

    public function delete(string $index): static
    {
        $storage = &$this->storage;
        foreach (explode('.', $index) as $i) {
            if (false === is_array($storage[$i]) ||
                false === array_key_exists($i, $storage)
            ) {
                continue;
            }
            $storage = &$storage[$i];
        }
        if (isset($i)) {
            unset($storage[$i]);
        }
        return $this;
    }

    public function extract(array $indexes): array
    {
        $found = [];
        foreach ($indexes as $index) {
            $found[$index] = $this->find($index);
        }
        return $found;
    }

    public function flatten(): static
    {
        $indexes = [];
        $flatten = [];
        $iterator = new RecursiveIteratorIterator(
            new RecursiveArrayIterator($this->storage),
            RecursiveIteratorIterator::SELF_FIRST
        );
        foreach ($iterator as $index => $value) {
            $indexes[$iterator->getDepth()] = $index;
            if (false === is_array($value)) {
                $_ = join('.', array_slice($indexes, 0, $iterator->getDepth() + 1));
                $flatten[$_] = $value;
            }
        }
        return new static($flatten);
    }
}