parallel/tests/AbstractContextTest.php

<?php
namespace Icicle\Tests\Concurrent;

use Icicle\Concurrent\Sync\Internal\ExitSuccess;
use Icicle\Coroutine;
use Icicle\Loop;

abstract class AbstractContextTest extends TestCase
{
    abstract public function createContext(callable $function);

    public function testIsRunning()
    {
        Coroutine\create(function () {
            $context = $this->createContext(function () {
                usleep(100);
            });

            $this->assertFalse($context->isRunning());

            $context->start();

            $this->assertTrue($context->isRunning());

            yield $context->join();

            $this->assertFalse($context->isRunning());
        })->done();

        Loop\run();
    }

    public function testKill()
    {
        $context = $this->createContext(function () {
            usleep(1e6);
        });

        $context->start();

        $this->assertRunTimeLessThan([$context, 'kill'], 0.1);

        $this->assertFalse($context->isRunning());
    }

    /**
     * @expectedException \Icicle\Concurrent\Exception\StatusError
     */
    public function testStartWhileRunningThrowsError()
    {
        $context = $this->createContext(function () {
            usleep(100);
        });

        $context->start();
        $context->start();
    }

    /**
     * @expectedException \Icicle\Concurrent\Exception\StatusError
     */
    public function testStartMultipleTimesThrowsError()
    {
        Loop\loop();

        $this->assertRunTimeGreaterThan(function () {
            Coroutine\create(function () {
                $context = $this->createContext(function () {
                    sleep(1);
                });

                $context->start();
                yield $context->join();

                $context->start();
                yield $context->join();
            })->done();

            Loop\run();
        }, 2);
    }

    /**
     * @expectedException \Icicle\Concurrent\Exception\PanicError
     */
    public function testExceptionInContextPanics()
    {
        Coroutine\create(function () {
            $context = $this->createContext(function () {
                throw new \Exception('Exception in fork.');
            });

            $context->start();
            yield $context->join();
        })->done();

        Loop\run();
    }

    /**
     * @expectedException \Icicle\Concurrent\Exception\PanicError
     */
    public function testReturnUnserializableDataPanics()
    {
        Coroutine\create(function () {
            $context = $this->createContext(function () {
                yield function () {};
            });

            $context->start();
            yield $context->join();
        })->done();

        Loop\run();
    }

    public function testJoinWaitsForChild()
    {
        Loop\loop();

        $this->assertRunTimeGreaterThan(function () {
            Coroutine\create(function () {
                $context = $this->createContext(function () {
                    sleep(1);
                });

                $context->start();
                yield $context->join();
            })->done();

            Loop\run();
        }, 1);
    }

    /**
     * @expectedException \Icicle\Concurrent\Exception\StatusError
     */
    public function testJoinWithoutStartThrowsError()
    {
        Coroutine\create(function () {
            $context = $this->createContext(function () {
                usleep(100);
            });

            yield $context->join();
        })->done();

        Loop\run();
    }

    public function testJoinResolvesWithContextReturn()
    {
        Coroutine\create(function () {
            $context = $this->createContext(function () {
                return 42;
            });

            $context->start();
            $this->assertSame(42, (yield $context->join()));
        })->done();

        Loop\run();
    }

    public function testSendAndReceive()
    {
        Coroutine\create(function () {
            $context = $this->createContext(function () {
                yield $this->send(1);
                $value = (yield $this->receive());
                yield $value;
            });

            $value = 42;

            $context->start();
            $this->assertSame(1, (yield $context->receive()));
            yield $context->send($value);
            $this->assertSame($value, (yield $context->join()));
        })->done();

        Loop\run();
    }

    /**
     * @depends testSendAndReceive
     * @expectedException \Icicle\Concurrent\Exception\SynchronizationError
     */
    public function testJoinWhenContextSendingData()
    {
        Coroutine\create(function () {
            $context = $this->createContext(function () {
                yield $this->send(0);
                yield 42;
            });

            $context->start();
            $value = (yield $context->join());
        })->done();

        Loop\run();
    }

    /**
     * @depends testSendAndReceive
     * @expectedException \Icicle\Concurrent\Exception\StatusError
     */
    public function testReceiveBeforeContextHasStarted()
    {
        Coroutine\create(function () {
            $context = $this->createContext(function () {
                yield $this->send(0);
                yield 42;
            });

            $value = (yield $context->receive());
        })->done();

        Loop\run();
    }

    /**
     * @depends testSendAndReceive
     * @expectedException \Icicle\Concurrent\Exception\StatusError
     */
    public function testSendBeforeContextHasStarted()
    {
        Coroutine\create(function () {
            $context = $this->createContext(function () {
                yield $this->send(0);
                yield 42;
            });

            yield $context->send(0);
        })->done();

        Loop\run();
    }

    /**
     * @depends testSendAndReceive
     * @expectedException \Icicle\Concurrent\Exception\SynchronizationError
     */
    public function testReceiveWhenContextHasReturned()
    {
        Coroutine\create(function () {
            $context = $this->createContext(function () {
                yield $this->send(0);
                yield 42;
            });

            $context->start();
            $value = (yield $context->receive());
            $value = (yield $context->receive());
            $value = (yield $context->join());
        })->done();

        Loop\run();
    }

    /**
     * @depends testSendAndReceive
     * @expectedException \Icicle\Exception\InvalidArgumentError
     */
    public function testSendExitStatus()
    {
        Coroutine\create(function () {
            $context = $this->createContext(function () {
                $value = (yield $this->receive());
                yield 42;
            });

            $context->start();
            yield $context->send(new ExitSuccess(0));
            $value = (yield $context->join());
        })->done();

        Loop\run();
    }
}