mpyw\Co\Internal\GeneratorContainer

Complexity

Total Complexity

27

Size/Duplication

Total Lines	169
Duplicated Lines	10.65 %

Coupling/Cohesion

Components	1
Dependencies	0

Test Coverage

Coverage

100%

Importance

Changes	16
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
B	valid()	0	9	5
A	key()	0	5	1
A	current()	0	5	1
A	send()	9	9	3
A	throw_()	9	9	3
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 (\Throwable $e) {} catch (\Exception $e) {}

Consider adding a comment why this CATCH block is empty.

        $this->e = $e;

It seems like $e of type object<Throwable> or object<Exception> is incompatible with the declared type object<RuntimeException> of property $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 method seems to be duplicated in your project.

    {
        $this->validateValidity();
        try {
            $this->g->send($value);
            return;
        } catch (\Throwable $e) {} catch (\Exception $e) {}

Consider adding a comment why this CATCH block is empty.

        $this->e = $e;

It seems like $e of type object<Throwable> or object<Exception> is incompatible with the declared type object<RuntimeException> of property $e.

    }

    /**
     * Throw exception into generator.
     * @param \Throwable|\RuntimeException $e
     * @NOTE: This method returns nothing,
     *        while original generator returns something.
     */
    public function throw_($e)

The parameter $e is not used and could be removed.

This method seems to be duplicated in your project.

    {
        $this->validateValidity();
        try {
            $this->g->throw($e);
            return;
        } catch (\Throwable $e) {} catch (\Exception $e) {}

Consider adding a comment why this CATCH block is empty.

        $this->e = $e;

It seems like $e of type object<Throwable> or object<Exception> is incompatible with the declared type object<RuntimeException> of property $e.

    }

    /**
     * Return whether Throwable 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.');
        }
    }
}