Added initial support for Behat out of the box

Author: smfsh

Makefile

@@ -231,6 +231,17 @@ code-fix: # Fix minor errors using Drupal standards
 	-$(CURDIR)/bin/tool phpcbf --standard=Drupal --extensions=php,module,inc,install,test,profile,theme,info /var/www/webroot/modules/custom
 	-$(CURDIR)/bin/tool phpcbf --standard=Drupal --extensions=php,module,inc,install,test,profile,theme,info /var/www/webroot/themes/custom
 
+behat-start:
+	docker-compose -f tests/behat/docker-compose.yml up -d
+
+behat-run:
+	-./bin/behat
+
+behat-stop:
+	docker-compose -f tests/behat/docker-compose.yml down -v
+
+behat: behat-start behat-run behat-stop
+
 ##
 # Removes "No rule to make target" message which allows us to pass an argument
 # without having to specify the name when running the make command.

README.md

@@ -398,6 +398,32 @@ currently being done in the environment.
 When possible, update during a state of clean development. Between the two 
 commands, `make update` should be used _much_ more often.
 
+### Running Behat Tests
+
+Some tests require the use of a browser, real or headless. This environment
+has Behat installed as a dependency and runs Selenium with drivers for Chrome
+and Firefox preconfigured. These browsers are run in a self-contained docker
+environment.
+
+Feature yaml files can be placed in tests/behat/features. These features can
+be run with `make behat`. By default, the Firefox browser is used. If Chrome
+is preferred, call the handler script with the option: `bin/behat -p chrome`.
+
+For debugging purposes, the processes around bring the testing environment up,
+running the tests, and finally bringing the environment down are isolated into
+separate make targets:
+
+* `make behat-start`
+* `make behat-run`
+* `make behat-stop`
+
+While the environment is running, it can be accessed via a VNC connection:
+
+* [Firefox (localhost:5900)](vnc://localhost:5900)
+* [Chrome (localhost:5901)](vnc://localhost:5901)
+
+The password to the VNC environment is "secret". 
+
 ### Problems With Permissions
 
 The environment runs in two different fashions concurrently: locally and in 

bin/behat

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+
+readonly PROGDIR="$(cd "$( dirname "${BASH_SOURCE[0]}" )" >/dev/null && pwd)"
+readonly PROJECT="$(basename "$(dirname "$PROGDIR")" | tr '[:upper:]' '[:lower:]')"
+
+PARAMS=""
+
+for PARAM in "$@"
+do
+  PARAMS="${PARAMS} \"${PARAM}\""
+done
+docker exec -it ${PROJECT}-php sh -c "cd /var/www/tests/behat && ../../vendor/bin/behat --config /var/www/tests/behat/behat.yml ${PARAMS}"

composer.json

@@ -29,6 +29,11 @@
     },
     "require-dev": {
         "webflo/drupal-core-require-dev": "^8.7.0",
+        "behat/behat": "^3.5.0",
+        "emuse/behat-html-formatter": "^0.1.0",
+        "bex/behat-screenshot": "^1.2",
+        "drupal/drupal-extension": "~3.2",
+        "jarnaiz/behat-junit-formatter": "^1.3.2",
         "drupal/devel": "^1.0",
         "jakub-onderka/php-parallel-lint": "^0.9.2",
         "jakub-onderka/php-console-highlighter": "^0.3.2"