Humweb\Features\Features

Complexity

Total Complexity

12

Size/Duplication

Total Lines	133
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	1

Importance

Changes

0

8 Methods

Rating	Name	Duplication	Size	Complexity
A	create()	0	13	2
A	pushStrategy()	0	7	2
A	getCollection()	0	4	1
A	exists()	0	4	1
A	flush()	0	4	1
A	get()	0	8	3
A	isEnabled()	0	4	1
A	setThreshold()	0	6	1

<?php

namespace Humweb\Features;

use Humweb\Features\Strategy\StrategyInterface;

/**
 * Feature registry.
 */
class Features
{
    /**
     * Features collections.
     *
     * @var array
     */
    protected $features = [];


    /**
     * Create a new feature
     *
     * @param string $name        Feature identifier.
     * @param string $description Feature description
     * @param array  $strategies  array of strategies
     *
     * @return StrategyCollection
     */
    public function create($name, $description = '', $strategies = [])
    {
        if ($this->exists($name)) {
            throw new \InvalidArgumentException('Duplicate feature identifier.');
        }

        $this->features[$name] = [
            'description' => $description,
            'collection'  => new StrategyCollection($strategies),
        ];

        return $this->features[$name]['collection'];
    }


    /**
     * Adds strategy to feature
     *
     * @param string                            $feature      Feature identifier
     * @param string                            $strategyName Strategy name
     * @param string|callable|StrategyInterface $strategy     Strategy class or closure
     * @param array                             $args
     */
    public function pushStrategy($feature, $strategyName, $strategy = null, $args = [])
    {
        if ( ! $this->exists($feature)) {
            throw new \InvalidArgumentException('Duplicate feature identifier.');
        }
        $this->getCollection($feature)->add($strategyName, $strategy, $args);
    }


    /**
     * Get Collection by feature name
     *
     * @param string $name Feature identifier
     *
     * @return StrategyCollection
     */
    public function getCollection($name)
    {
        return $this->get($name, 'collection');
    }


    /**
     * Checks if a feature with given name exists.
     *
     * @param string $name Feature identifier.
     *
     * @return bool
     */
    public function exists($name)
    {
        return isset($this->features[$name]);
    }


    /**
     * Flush all features.
     */
    public function flush()
    {
        $this->features = [];
    }


    /**
     * Get Feature or item from feature array
     *
     * @param string      $name
     * @param null|string $key
     *
     * @return
     */
    public function get($name, $key = null)
    {
        if ( ! $this->exists($name)) {
            throw new \InvalidArgumentException('Unknown feature identifier.');
        }

        return ! is_null($key) ? $this->features[$name][$key] : $this->features[$name];
    }


    /**
     * Check if feature is enabled
     *
     * @param string $feature Feature identifier
     * @param array  $args    arguments passed to strategies checker
     *
     * @return bool
     */
    public function isEnabled($feature, array $args = [])
    {
        return $this->getCollection($feature)->check($args);
    }


    /**
     * Set the feature's threshold
     *
     * @param string $name Feature identifier
     * @param int    $threshold
     *
     * @return $this
     */
    public function setThreshold($name, $threshold = 1)
    {
        $this->getCollection($name)->setThreshold($threshold);

        return $this;
    }
}