psr7-unitesting

, _(*1)

Simple library to execute unit tests in psr-7 compatible http messages., _(*2)

It uses symfony/dom-crawler and symfony/css-selector library to parse and test the html in the body. And Guzzle as http client, _(*3)

This package provides a binary java file with the w3c vnu validator (to validate html) but you can use the REST api (slower) if you don't have (or don't want to have) java installed., _(*4)

Usage example:

use Psr7Unitesting\Assert;

class AppTest extends PHPUnit_Framework_TestCase
{
    public function testRemote()
    {
        //Execute a GET request and assert the response:

        Assert::get('http://example.com')
            ->statusCode(200)
            ->header('Content-Type', 'text/html')
            ->hasHeader('Cache-Control')
            ->hasNotHeader('Expires')

            ->assertBody()
                ->isReadable()
                ->isSeekable()
                ->end() //back to Response

            ->assertHtml()
                ->isValid() //use w3c vnu validator
                ->has('meta[property="og:title"]')
                ->hasNot('blink')
                ->contains('a.home-link', 'Go to home')
                ->notContains('p', '') //empty paragraphs

                //Execute more tests for each element individually
                ->map('img', function ($img) {
                    $this->assertNotEmpty($img->attr('alt'));
                });
    }

    public function testLocal()
    {
        //Assert local psr-7 instances
        $app = new App();
        $response = $app->dispatch('/post/34');

        Assert::create($response)
            ->statusCode(200);
    }
}

Available assertions:

Message

method	description
`hasHeader`	Asserts that a header exists
`hasNotHeader`	Asserts that a header does not exists
`header`	Asserts that a header has a specific value
`protocolVersion`	Asserts the protocol version of the message
`body`	Asserts the body content (as string)
`assertBody`	Returns a `Stream` assertion instance

Request

Extends Message with the following additions:, _(*5)

method	description
`method`	Asserts the method value
`requestTarget`	Asserts the request target value
`uri`	Asserts the uri value (as string)
`assertUri`	Returns a `Uri` assertion instance

ServerRequest

Extends Request with the following additions:, _(*6)

method	description
`hasServerParam`	Asserts that a server param exists
`serverParam`	Asserts a server param value
`hasCookieParam`	Asserts that a cookie param exists
`cookieParam`	Asserts a cookie param value
`hasQueryParam`	Asserts that a query param exists
`queryParam`	Asserts a query param value
`hasUploadedFile`	Asserts that an uploaded file exists
`hasParsedBody`	Asserts that a param exists in the parsed body
`parsedBody`	Asserts a value in the parsed body
`hasAttribute`	Asserts that an attribute exists
`attribute`	Asserts an attribute value

Response

Extends Message with the following additions:, _(*7)

method	description
`statusCode`	Asserts the status code value
`reasonPhrase`	Asserts the reason pharase value
`assertHtml`	Returns a `Html` assertion instance

Uri

method	description
`scheme`	Asserts the scheme value
`authority`	Asserts the authority value
`userInfo`	Asserts the user info value
`host`	Asserts the host value
`port`	Asserts the port value
`path`	Asserts the path value
`query`	Asserts the query value
`fragment`	Asserts the fragment value

Stream

method	description
`size`	Asserts the stream size
`isSeekable`	Asserts that the stream is seekable
`isNotSeekable`	Asserts that the stream is not seekable
`isWritable`	Asserts that the stream is writable
`isNotWritable`	Asserts that the stream is not writable
`isReadable`	Asserts that the stream is readable
`isNotReadable`	Asserts that the stream is not readable
`assertHtml`	Returns a `Html` assertion instance

Html

method	description
`count`	Asserts the number of elements matching with the selector
`has`	Asserts there is at least one element matching with the selector
`hasNot`	Asserts there is not any element matching with the selector
`contains`	Asserts there is at least one element matching with the selector containing the text
`notContains`	Asserts there is not any element matching with the selector and containing the text
`isValid`	Asserts the html value is w3c standard
`map`	Execute a callback for each element selected