appeltaert/phpunit-assertion-message

Enhanced PHPUnit Assertion Messages - Debug assertions without creating a mess.

PHPUnit Assertion Message , _(*1)

composer require --dev appeltaert/phpunit-assertion-message

Usage

1) Simply wrap whatever message you normally pass to assertions in a new PAM(string $message, [mixed $context,...]) instance. 2) Run phpunit with --debug, _(*2)

$context can be basically be anything, for now there's only explicit support for Symfony Response and Request objects, but as a final resort a var flattening processor will take over to basically make anything readable if no processor can handle your context., _(*3)

Before

This will turn this occasional mess while debugging., _(*4)

$client->enableProfiler();
$response = $client->getResponse();

$this->assertTrue($response->isSuccessful(), "My message");

There was 1 failure:

1) Tests\AppBundle\Controller\DefaultControllerTest::testIndex
My message

// wtf is going on
// $this->assertTrue($client->getResponse()->isSuccessful())
// $collector = $profiler->getCollector()..
// var_dump($collector->...);
// echo $response->getContent();
// var_dump($response->headers->all();
// die.. die.. die..



#### After

Into this.

```php
$client->enableProfiler();
$response = $client->getResponse();

$this->assertTrue($response->isSuccessful(), 
    new PAM("My message", [$response, $profiler->getCollector('request')]));

There was 1 failure:, _(*5)

1) Tests\AppBundle\Controller\DefaultControllerTest::testIndex My message, _(*6)

HTTP response: Code: 200 Content-type: text/html; charset=UTF-8 Cookies: 0: qwer=qewrqwer; path=/; httponly, _(*7)

Request profile: Format: html StatusText: OK Route: app_router_index StatusCode: 200 ContentType: text/html; charset=UTF-8 PathInfo: /router/, _(*8)

## How it works

### Processors

All context passed is handled by a chain of `Processors`. The first one to accept the context wins.
The processors are then printed by a `Printer`. The default printer `Plain` dumps everything into human-readable blocks.

**Symfony Response object**

```php
$response = $client->getResponse();
$this->assertTrue($response->isSuccessful(), new PAM("My message", [$response]));

HTTP response:      Code: 500
                 Headers:  content-type: ["text\/html; charset=UTF-8"]
                          cache-control: ["no-cache, private"]
                                   date: ["Fri, 23 Feb 2018 21:12:32 GMT"]
                          x-debug-token: ["771d20"]
               Exception: qewr (500 Internal Server Error)




**Symfony request profiler**

```php
$this->assertSame(
    Response::HTTP_OK,
    $client->getResponse()->getStatusCode(),
    new PAM(sprintf('The %s public URL loads correctly.', $url), [$client->getProfile()->getCollector('request')])
);






Request profile:            Format: html
                             Route: blog_index
                        StatusText: Internal Server Error
                        StatusCode: 500
                       ContentType: text/html; charset=UTF-8
                          PathInfo: /en/blog/
                            Method: GET
                            Locale: en
                       RouteParams:    page: 1
                                    _format: html
                                    _locale: en
                 SessionAttributes: key: val
                   SessionMetaData:   Created: Fri, 23 Feb 18 22:12:31 +0100
                                    Last used: Fri, 23 Feb 18 22:12:31 +0100
                                     Lifetime: 0
                            Action: AppBundle\Controller\BlogController::indexAction




**Array**


$someArray = [];
$this->assertArrayHasKey("test", $array, new PAM("My message", [
    'qwerqwer' => 'qwerqewr', ['qwerqewr', 'qwerqwer']
]));

Array: qwerqwer: qwerqewr 0: 0: qwerqewr 1: qwerqwer, _(*9)

### Config

#### Printer
At the moment there is only one printer, `Plain`.

#### Statically set all options
```php
PAM::setDefaults($processors, $printer, $env);

Overriding the environment

$env = new Env($debug = null, $verbose = null, $supportsColors = null);
PAM::setDefaults([], null, $env);

roadmap

v1.1

processors, _(*10)

• more symfony
• move them to separate suggested repos
• make them pluggable

printer, _(*11)

• distinctive dumps based on env, more info --verbose, less without
• detect interactive terminal(for colored output f.e.), also check ansi arguments.
• posix_isatty, XTERM check?