amphp/phpunit-util

Helper package to ease testing with PHPUnit.

Maintainers

Details

github.com/amphp/phpunit-util

Homepage

Source

Issues

IRC

Installs: 22 155

Dependents: 59

Suggesters: 0

Stars: 11

Watchers: 5

Forks: 1

Open Issues: 0

v1.2.0 2019-10-04 19:46 UTC

Requires

Requires (Dev)

MIT 840959c895593084bc3ef5c8021c30e361e0ba8d

  • Niklas Keller <me.woop@kelunik.com>
  • Aaron Piotrowski <aaron.woop@trowski.com>

README

License

amphp/phpunit-util is a small helper package to ease testing with PHPUnit in combination with the Amp concurrency framework.

Required PHP Version

  • PHP 7.0+

Installation

composer require --dev amphp/phpunit-util

Usage

<?php

namespace Foo;

use Amp\ByteStream;
use Amp\PHPUnit\AsyncTestCase;
use Amp\Socket;

class BarTest extends AsyncTestCase
{
    // Each test case is executed as a coroutine and checked to run to completion
    public function test()
    {
        $socket = yield Socket\connect('tcp://localhost:12345');
        yield $socket->write('foobar');
        
        $this->assertSame('foobar', yield ByteStream\buffer($socket));
    }
}

Deprecated Functionality

This package also provides a PHPUnit TestListener to reset the global event loop after each test, but this is deprecated.

<phpunit>
    <!-- ... -->

    <!-- DEPRECATED, use AsyncTestCase instead -->
    <listeners>
        <!-- DEPRECATED, use AsyncTestCase instead --> 
        <listener class="Amp\PHPUnit\LoopReset" />
    </listeners>

    <!-- ... -->
</phpunit>