mpyw\Co\Internal\GeneratorContainer

Complexity

Total Complexity

24

Size/Duplication

Total Lines	170
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	0

Test Coverage

Coverage

100%

Importance

Changes	15
Bugs	5	Features	2

12 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	7	1
A	getYieldKey()	0	4	1
A	__toString()	0	4	1
A	valid()	0	10	4
A	key()	0	5	1
A	current()	0	5	1
A	send()	0	9	2
A	throw_()	0	9	2
A	thrown()	0	4	1
B	getReturnOrThrown()	0	11	6
A	validateValidity()	0	6	2
A	validateInvalidity()	0	6	2

<?php

namespace mpyw\Co\Internal;
use mpyw\Co\CoInterface;

class GeneratorContainer
{
    /**
     * Generator.
     * @var \Generator
     */
    private $g;

    /**
     * Generator object hash.
     * @var string
     */
    private $h;

    /**
     * Thrown exception.
     * @var \RuntimeException
     */
    private $e;

    /**
     * Parent yield key.
     * @var mixed
     */
    private $yieldKey;

    /**
     * Constructor.
     * @param \Generator $g
     */
    public function __construct(\Generator $g, $yield_key = null)
    {
        $this->g = $g;
        $this->h = spl_object_hash($g);
        $this->yieldKey = $yield_key;
        $this->valid();
    }

    /**
     * Return parent yield key.
     * @return mixed
     */
    public function getYieldKey()
    {
        return $this->yieldKey;
    }

    /**
     * Return generator hash.
     * @return string
     */
    public function __toString()
    {
        return $this->h;
    }

    /**
     * Return whether generator is actually working.
     * @return bool
     */
    public function valid()
    {
        try {
            $this->g->current();
            return $this->e === null && $this->g->valid() && $this->g->key() !== CoInterface::RETURN_WITH;
        } catch (\RuntimeException $e) {
            $this->e = $e;
            return false;
        }
    }

    /**
     * Return current key.
     * @return mixed
     */
    public function key()
    {
        $this->validateValidity();
        return $this->g->key();
    }

    /**
     * Return current value.
     * @return mixed
     */
    public function current()
    {
        $this->validateValidity();
        return $this->g->current();
    }

    /**
     * Send value into generator.
     * @param mixed $value
     * @NOTE: This method returns nothing,
     *        while original generator returns something.
     */
    public function send($value)
    {
        $this->validateValidity();
        try {
            $this->g->send($value);
        } catch (\RuntimeException $e) {
            $this->e = $e;
        }
    }

    /**
     * Throw exception into generator.
     * @param \RuntimeException $e
     * @NOTE: This method returns nothing,
     *        while original generator returns something.
     */
    public function throw_(\RuntimeException $e)
    {
        $this->validateValidity();
        try {
            $this->g->throw($e);
        } catch (\RuntimeException $e) {
            $this->e = $e;
        }
    }

    /**
     * Return whether exception is thrown.
     * @return bool
     */
    public function thrown()
    {
        return $this->e !== null;
    }

    /**
     * Return value that generator has returned or thrown.
     * @return mixed
     */
    public function getReturnOrThrown()
    {
        $this->validateInvalidity();
        if ($this->e === null && $this->g->valid() && !$this->valid()) {
            return $this->g->current();
        }
        if ($this->e) {
            return $this->e;
        }
        return method_exists($this->g, 'getReturn') ? $this->g->getReturn() : null;
    }

    /**
     * Validate that generator has finished running.
     * @throws LogicException
     */
    private function validateValidity()
    {
        if (!$this->valid()) {
            throw new \BadMethodCallException('Unreachable here.');
        }
    }

    /**
     * Validate that generator is still running.
     * @throws LogicException
     */
    private function validateInvalidity()
    {
        if ($this->valid()) {
            throw new \BadMethodCallException('Unreachable here.');
        }
    }
}