wellrested/test/tests/unit/Message/StreamTest.php

<?php

namespace WellRESTed\Test\Message;

use WellRESTed\Message\Stream;

/**
 * @coversDefaultClass WellRESTed\Message\Stream
 * @uses WellRESTed\Message\Stream
 * @group message
 */
class StreamTest extends \PHPUnit_Framework_TestCase
{
    private $resource;
    private $content = "Hello, world!";

    public function setUp()
    {
        $this->resource = fopen("php://memory", "w+");
        fwrite($this->resource, $this->content);
    }

    public function tearDown()
    {
        if (is_resource($this->resource)) {
            fclose($this->resource);
        }
    }

    /**
     * @covers ::__construct
     */
    public function testCreatesInstanceWithStreamResource()
    {
        $stream = new \WellRESTed\Message\Stream($this->resource);
        $this->assertNotNull($stream);
    }

    public function testCreatesInstanceWithString()
    {
        $stream = new \WellRESTed\Message\Stream("Hello, world!");
        $this->assertNotNull($stream);
    }

    /**
     * @covers ::__construct
     * @expectedException \InvalidArgumentException
     * @dataProvider invalidResourceProvider
     */
    public function testThrowsExceptiondWithInvalidResource($resource)
    {
        new \WellRESTed\Message\Stream($resource);
    }

    public function invalidResourceProvider()
    {
        return [
            [null],
            [true],
            [4],
            [[]]
        ];
    }

    /**
     * @covers ::__toString
     */
    public function testCastsToString()
    {
        $stream = new \WellRESTed\Message\Stream($this->resource);
        $this->assertEquals($this->content, (string) $stream);
    }

    /**
     * @covers ::close
     */
    public function testClosesHandle()
    {
        $stream = new Stream($this->resource);
        $stream->close();
        $this->assertFalse(is_resource($this->resource));
    }

    /**
     * @covers ::detach
     */
    public function testDetachReturnsHandle()
    {
        $stream = new Stream($this->resource);
        $this->assertSame($this->resource, $stream->detach());
    }

    /**
     * @covers ::detach
     */
    public function testDetachUnsetsInstanceVariable()
    {
        $stream = new \WellRESTed\Message\Stream($this->resource);
        $stream->detach();
        $this->assertNull($stream->detach());
    }

    /**
     * @covers ::getSize
     */
    public function testReturnsSize()
    {
        $stream = new \WellRESTed\Message\Stream($this->resource);
        $this->assertEquals(strlen($this->content), $stream->getSize());
    }

    /**
     * @covers ::tell
     */
    public function testTellReturnsHandlePosition()
    {
        $stream = new \WellRESTed\Message\Stream($this->resource);
        fseek($this->resource, 10);
        $this->assertEquals(10, $stream->tell());
    }

    /**
     * @covers ::eof
     */
    public function testReturnsOef()
    {
        $stream = new Stream($this->resource);
        $stream->rewind();
        $stream->getContents();
        $this->assertTrue($stream->eof());
    }

    /**
     * @covers ::isSeekable
     */
    public function testReadsSeekableStatusFromMetadata()
    {
        $stream = new \WellRESTed\Message\Stream($this->resource);
        $metadata = stream_get_meta_data($this->resource);
        $seekable = $metadata["seekable"] == 1;
        $this->assertEquals($seekable, $stream->isSeekable());
    }

    /**
     * @covers ::seek
     */
    public function testSeeksToPosition()
    {
        $stream = new \WellRESTed\Message\Stream($this->resource);
        $stream->seek(10);
        $this->assertEquals(10, ftell($this->resource));
    }

    /**
     * @covers ::rewind
     */
    public function testRewindReturnsToBeginning()
    {
        $stream = new Stream($this->resource);
        $stream->seek(10);
        $stream->rewind();
        $this->assertEquals(0, ftell($this->resource));
    }

    /**
     * @covers ::write
     */
    public function testWritesToHandle()
    {
        $message = "\nThis is a stream.";
        $stream = new \WellRESTed\Message\Stream($this->resource);
        $stream->write($message);
        $this->assertEquals($this->content . $message, (string) $stream);
    }

    /**
     * @covers ::write
     * @expectedException \RuntimeException
     */
    public function testThrowsExceptionOnErrorWriting()
    {
        $filename = tempnam(sys_get_temp_dir(), "php");
        $handle = fopen($filename, "r");
        $stream = new \WellRESTed\Message\Stream($handle);
        $stream->write("Hello, world!");
    }

    /**
     * @covers ::read
     * @expectedException \RuntimeException
     */
    public function testThrowsExceptionOnErrorReading()
    {
        $filename = tempnam(sys_get_temp_dir(), "php");
        $handle = fopen($filename, "w");
        $stream = new \WellRESTed\Message\Stream($handle);
        $stream->read(10);
    }

    /**
     * @covers ::read
     */
    public function testReadsFromStream()
    {
        $stream = new \WellRESTed\Message\Stream($this->resource);
        $stream->seek(7);
        $string = $stream->read(5);
        $this->assertEquals("world", $string);
    }

    /**
     * @covers ::getContents
     * @expectedException \RuntimeException
     */
    public function testThrowsExceptionOnErrorReadingToEnd()
    {
        $filename = tempnam(sys_get_temp_dir(), "php");
        $handle = fopen($filename, "w");
        $stream = new \WellRESTed\Message\Stream($handle);
        $stream->getContents();
    }

    /**
     * @covers ::getContents
     */
    public function testReadsToEnd()
    {
        $stream = new Stream($this->resource);
        $stream->seek(7);
        $string = $stream->getContents();
        $this->assertEquals("world!", $string);
    }

    /**
     * @covers ::getMetadata
     */
    public function testReturnsMetadataArray()
    {
        $stream = new \WellRESTed\Message\Stream($this->resource);
        $this->assertEquals(stream_get_meta_data($this->resource), $stream->getMetadata());
    }

    /**
     * @covers ::getMetadata
     */
    public function testReturnsMetadataItem()
    {
        $stream = new Stream($this->resource);
        $metadata = stream_get_meta_data($this->resource);
        $this->assertEquals($metadata["mode"], $stream->getMetadata("mode"));
    }

    /**
     * @covers ::isReadable
     * @dataProvider modeProvider
     */
    public function testReturnsIsReadableForReadableStreams($mode, $readable, $writeable)
    {
        $tmp = tempnam(sys_get_temp_dir(), "php");
        if ($mode[0] === "x") {
            unlink($tmp);
        }
        $resource = fopen($tmp, $mode);
        $stream = new Stream($resource);
        $this->assertEquals($readable, $stream->isReadable());
    }

    /**
     * @covers ::isWritable
     * @dataProvider modeProvider
     */
    public function testReturnsIsWritableForWritableStreams($mode, $readable, $writeable)
    {
        $tmp = tempnam(sys_get_temp_dir(), "php");
        if ($mode[0] === "x") {
            unlink($tmp);
        }
        $resource = fopen($tmp, $mode);
        $stream = new \WellRESTed\Message\Stream($resource);
        $this->assertEquals($writeable, $stream->isWritable());
    }

    public function modeProvider()
    {
        return [
            ["r",  true,  false],
            ["r+", true,  true],
            ["w",  false, true],
            ["w+", true,  true],
            ["a",  false, true],
            ["a+", true,  true],
            ["x",  false, true],
            ["x+", true,  true],
            ["c",  false, true],
            ["c+", true,  true]
        ];
    }
}