nyx\console\input\parameter\Values

Complexity

Total Complexity

13

Size/Duplication

Total Lines	98
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	3

Importance

Changes

0

6 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	6	1
A	definitions()	0	4	1
A	set()	0	18	4
A	finalize()	0	15	4
A	assertIsDefined()	0	9	2
A	derive()	0	4	1

<?php namespace nyx\console\input\parameter;

// External dependencies
use nyx\core;

// Internal dependencies
use nyx\console\input;

/**
 * Input Values
 *
 * Base class for Input Argument and Option value collections.
 *
 * Those collections are bound by their definitions and as such parameters that are not defined cannot be set.
 * They can also not escape their definition, eg. a definition may only be set during construction to avoid
 * mismatches between the master and the bag definitions referenced in Values collections.
 *
 * @version     0.1.0
 * @author      Michal Chojnacki <m.chojnacki@muyo.io>
 * @copyright   2012-2017 Nyx Dev Team
 * @link        https://github.com/unyx/nyx
 */
abstract class Values extends core\collections\Map
{
    /**
     * @var Definitions  The Definitions of the Parameters that can be present in this collection.
     */
    protected $definitions;

    /**
     * {@inheritdoc}
     *
     * @param   Definitions $definition     The Definitions of the Parameters that can be present in this collection.
     */
    public function __construct(Definitions $definition, $items = null)
    {
        $this->definitions = $definition;

        parent::__construct($items);
    }

    /**
     * Returns the Definitions of the Parameters that can be present in this collection.
     *
     * @return  Definitions
     */
    public function definitions() : Definitions
    {
        return $this->definitions;
    }

    /**
     * {@inheritdoc}
     */
    public function set($name, $value) : core\collections\interfaces\Map
    {
        if (!isset($name, $value)) {
            throw new \InvalidArgumentException('Input Values must be named and have a value that is not null.');
        }

        $parameter = $this->assertIsDefined($name);

        // When dealing with a multi-value parameter, push the value into an array instead of just setting it,
        // unless it's an array itself (in which case it will override the currently set array).
        if ($parameter->getValue() instanceof input\values\Multiple && !is_array($value)) {
            $this->items[$name][] = $value;
        } else {
            $this->items[$name] = $value;
        }

        return $this;

The return type of return $this; (nyx\console\input\parameter\Values) is incompatible with the return type of the parent method nyx\core\collections\Map::set of type nyx\core\collections\traits\Map.

    }

    /**
     * Finalizes the Collection, populating it with Parameters that have not been explicitly set, but
     * have defined default values.
     *
     * @return  $this
     */
    public function finalize() : Values
    {
        /* @var input\Parameter $parameter */
        foreach ($this->definitions as $name => $parameter) {
            if (isset($this->items[$name])) {
                continue;
            }

            // In the case of Parameters which do not accept values (ie. optional flags), we explicitly default them
            // to a boolean false, opposed to a boolean true when they are actually set in input.
            $this->items[$name] = ($value = $parameter->getValue()) ? $value->getDefault() : false;
        }

        return $this;
    }

    /**
     * Asserts a Parameter with the given name is defined for this collection and returns it.
     *
     * @param   string  $name           The name of the Parameter.
     * @throws  \OutOfBoundsException   When no Parameter with the given name has been defined.
     * @return  input\Parameter
     */
    protected function assertIsDefined(string $name) : input\Parameter
    {
        /* @var input\Parameter $parameter */
        if (!$parameter = $this->definitions->get($name)) {
            throw new \OutOfBoundsException("The parameter [$name] is not defined.");
        }

        return $parameter;
    }

    /**
     * {@inheritdoc}
     */
    protected function derive($items) : core\collections\interfaces\Collection
    {
        return new static($this->definitions, $items);

The return type of return new static($this->definitions, $items); (nyx\console\input\parameter\Values) is incompatible with the return type of the parent method nyx\core\collections\Map::derive of type nyx\core\collections\traits\Collection.

    }
}