amphp/phpunit-util

Helper package to ease testing with PHPUnit.

Maintainers

Details

github.com/amphp/phpunit-util

Homepage

Source

Issues

IRC

Installs: 26 520

Dependents: 64

Suggesters: 0

Security: 0

Stars: 13

Watchers: 6

Forks: 2

Open Issues: 4

v1.3.0 2020-02-14 16:07 UTC

Requires

Requires (Dev)

MIT bc4c6fdc0bde701f86fd1ee2b11d1f0f48e4350c

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

This package is auto-updated.

Last update: 2020-03-30 15:32:39 UTC

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>