view-components/testing-helpers

Helpers for view-components testing

Testing Helpers for ViewComponents

, _(*1)

This repository contains utilities for testing PHP packages of ViewComponents family., _(*2)

1. Overview

1.1. Web Application

Package contains simple ready to use web-application based on Silex for components show-case and acceptance tests., _(*3)

1.1.1. Installation

If your package needs this web-application, add post-install script to composer.json:, _(*4)

"scripts": {
        "post-install-cmd": [
            "ViewComponents\\TestingHelpers\\Installer\\Installer::postComposerInstall"
        ]
},

Post-install script will allow to configure web-application using command-line interface. If you use composer install command with -no-interaction option, default settings will be used., _(*5)

1.1.2. Extending web-application

Packages that uses view-components/testing helpers can extend this application by adding it's controllers to WEBAPP_CONTROLLERS environmant variable., _(*6)

Routing will be automatically generated using EasyRouting class., _(*7)

1.1.3. Running web-application

Package contains serve command that is published to vendor/bin by composer., _(*8)

Run it from your package folder to start web-server:, _(*9)

./vendor/bin/serve

On Windows OS it will also open web-application in browser after starting web-server., _(*10)

1.2. Acceptance tests with PhpUnit

1.2.1. Starting & shutting down web-server during tests

Use vendor/view-components/testing-helpers/bootstrap/tests_bootstrap.php as bootstrap file if you need to implement acceptance tests using PhpUnit., _(*11)

1.2.2. Abstract acceptance test.

Use ViewComponents\TestingHelpers\Test\Acceptance\AbstractAcceptanceTest as base class for your acceptance tests. It allows to perform http requests using GuzzleHttp package and contains helper methods for assertions., _(*12)

1.3. Fixtures

Package provides set of fixtures for testing. It consists of data that is seeded to database during installation and same data in form of php array., _(*13)

2. Installation

Testing Helpers can be installed via composer., _(*14)

Important: Do not add view-components/testing-helpers to require section of composer.json. It must be added to require-dev section., _(*15)

3. License

© 2016 Vitalii Stepanenko, _(*16)

Licensed under the MIT License., _(*17)

Please see License File for more information., _(*18)