Working with tests

UI Patterns is tested using both Behat and PHPUnit.

In order to work with tests you need a fully functional Drupal site. To build the test site just run:

$ composer install

Thanks to the integration with Drupal Component Scaffold you’ll find a fully functional Drupal 8 site under ./build.

After that proceed with the site installation and setup:

- ./vendor/bin/drush --root=$PWD/build si standard -y --db-url=mysql://YOUR_USER:YOUR_PASS@127.0.0.1/YOUR_DATABASE
- ./vendor/bin/drush --root=$PWD/build en ui_patterns_test -y

PHPUnit

Setup and run PHPUnit tests by running:

$ cp phpunit.xml.dist phpunit.xml # Then change environment-specific parameters.
$ ./vendor/bin/phpunit

Behat

Setup and run Behat tests by running:

$ vi behat.yml.dist behat.yml # Then change environment-specific parameters.
$ ./vendor/bin/behat

Working with the test site

Drupal Component Scaffold will setup a working development site but you’ll still need to manually disable Twig and other Drupal 8 caching by un-commenting the following lines in your settings.php file:

# if (file_exists($app_root . '/' . $site_path . '/settings.local.php')) {
#   include $app_root . '/' . $site_path . '/settings.local.php';
# }

Docker Compose

UI Patterns ships with a docker-compose.yml file which can be used to streamline local development and tests execution.

In the project root run:

$ docker-compose up -d
$ docker-compose exec -u root php composer install
$ docker-compose exec -u root php ./vendor/bin/run drupal:site-setup
$ docker-compose exec -u root php ./vendor/bin/run drupal:site-install
$ docker-compose exec -u root php chown -R www-data:www-data build

You’ll then have a fully functional test site at http://ui_patterns.localhost.

You can then run all tests as follows:

$ docker-compose exec -u root php ./vendor/bin/grumphp run
$ docker-compose exec -u root php ./vendor/bin/phpunit
$ docker-compose exec -u root php ./vendor/bin/behat