Ktomk\Pipelines\File\Pipeline\StepCaches

Complexity

Total Complexity

10

Size/Duplication

Total Lines	83
Duplicated Lines	0 %

Test Coverage

Coverage

100%

Importance

Changes	1
Bugs	0	Features	0

5 Methods

Rating	Name	Duplication	Size	Complexity
A	parseCaches()	0	16	5
A	getIterator()	0	3	1
A	getFile()	0	3	1
A	__construct()	0	7	1
A	getDefinitions()	0	7	2

<?php

/* this file is part of pipelines */

namespace Ktomk\Pipelines\File\Pipeline;

use Ktomk\Pipelines\File\Definitions\Caches;
use Ktomk\Pipelines\File\Dom\FileNode;
use Ktomk\Pipelines\File\File;
use Ktomk\Pipelines\File\ParseException;

/**
 * Class StepCaches
 *
 * Caches entry in a step
 *
 * @package Ktomk\Pipelines\File\File
 */
class StepCaches implements FileNode, \IteratorAggregate
{
    /**
     * @var Step
     */
    private $step;

    /**
     * @var array
     * @psalm-var array<string, int>
     */
    private $caches;

    /**
     * StepCaches constructor.
     *
     * @param Step $step
     * @param null|array|mixed $caches
     *
     * @return void
     */
    public function __construct(Step $step, $caches)
    {
        // quick validation: script
        $parsed = $this->parseCaches($caches);

        $this->step = $step;
        $this->caches = array_flip($parsed);
    }

    /**
     * get step caches (as defined)
     *
     * @return array cache map
     */
    public function getDefinitions()
    {
        if (null === $file = $this->getFile()) {
            return array();
        }

        return $file->getDefinitions()->getCaches()->getByNames(array_keys($this->caches));
    }

    /**
     * @return null|File
     */
    public function getFile()
    {
        return $this->step->getFile();
    }

    /**
     * @return \ArrayIterator|string[]
     */
    public function getIterator()
    {
        return new \ArrayIterator($this->getDefinitions());
    }

    /**
     * parse caches
     *
     * @param null|array|mixed $caches
     *
     * @return string[]
     */
    private function parseCaches($caches)
    {
        if (!is_array($caches)) {
            throw new ParseException("'caches' requires a list of caches");
        }

        $reservoir = array();
        foreach ($caches as $cache) {
            if (!is_string($cache)) {
                throw new ParseException("'caches' cache name string expected");
            }

            '' === ($cache = trim($cache)) || $reservoir[] = $cache;
        }

        return $reservoir;
    }
}