Improving Behat + Drupal VM integration.

phing/tasks/setup.xml

@@ -14,6 +14,41 @@
         <expandproperties />
       </filterchain>
     </copy>
+
+    <exec dir="${repo.root}" command="php -r 'require &quot;./vendor/jakoch/phantomjs-installer/src/PhantomInstaller/PhantomBinary.php&quot;; $pb = new \PhantomInstaller\PhantomBinary(); echo $pb->getBin();'" checkreturn="false" returnProperty="phantomjs.missing" outputProperty="phantomjs.bin"/>
+    <if>
+      <or>
+        <istrue value="${phantomjs.missing}"/>
+        <not><available file="${composer.bin}/phantomjs"/></not>
+        <not><available file="${phantomjs.bin}"/></not>
+      </or>
+      <then>
+        <exec dir="${repo.root}" command="composer install-phantom" checkreturn="true" logoutput="true" passthru="true" level="info"/>
+      </then>
+      <else>
+        <echo>Found PhantomJS at ${phantomjs.bin}</echo>
+      </else>
+    </if>
+
+    <property file="${repo.root}/tests/behat/local.yml" prefix="behatConfig"/>
+    <if>
+      <or>
+        <not><available file="${behatConfig.local.extensions.Drupal\DrupalExtension.drupal.drupal_root}"/></not>
+        <not><available file="${behatConfig.local.suites.default.paths.features}"/></not>
+        <not><available file="${behatConfig.local.suites.default.paths.bootstrap}"/></not>
+      </or>
+      <then>
+        <echo></echo>
+        <echo level="error">One or more values in tests/behat/local.yml reference file paths that do not exist on this system.</echo>
+        <echo level="error">Either correct the value(s) or remove tests/behat/local.yml so that it can be regenerated automatically from example.local.yml.</echo>
+        <echo level="error">Values are:</echo>
+        <echo level="error">drupal_root: ${behatConfig.local.extensions.Drupal\DrupalExtension.drupal.drupal_root}"</echo>
+        <echo level="error">features:    ${behatConfig.local.suites.default.paths.features}"</echo>
+        <echo level="error">bootstrap:   ${behatConfig.local.suites.default.paths.bootstrap}</echo>
+        <fail>Your Behat configuration is invalid.</fail>
+      </then>
+    </if>
+
   </target>
 
   <!-- This is run when a project is cloned to a new environment. -->

readme/local-development.md

@@ -47,7 +47,6 @@ To execute Behat tests using the 'drupal' driver on a Drupal VM environment, you
 1. Update `tests/behat/local.yml` with the absolute file path to your project _inside the VM_. I.e., find and replace all instances of `host/machine/path/to/repo` with `/vm/path/to/repo`, which should look something like `var/www/[project.machine_name]`. 
 1. SSH into the VM `vagrant ssh`.
 1. Change to your project directory `cd /var/www/[project.machine_name]`.
-1. Assert that PhantomJS is installed for VM. Unfortunately, this requires building Composer dependencies while SSHed into the VM: `rm -rf vendor && composer install`.
 1. Execute behat tests `blt tests:behat`
 
 #### Using the Drupal Extension's "drush" driver with Drupal VM

scripts/blt/install-alias.sh

@@ -35,6 +35,7 @@ if [ ! -z "$DETECTED_PROFILE" ]; then
   echo "BLT can automatically create a Bash alias to make it easier to run BLT tasks."
   echo "This alias may be created in .bash_profile or .bashrc depending on your system architecture."
   echo ""
+  sleep 1
 
   if [ -z $REPLY ]; then
     read -p "Install alias? (y/n)" -n 1 -r

scripts/drupal-vm/config.yml

@@ -50,4 +50,4 @@ extra_packages:
   - php-bcmath
 
 post_provision_scripts:
-  - "../vendor/acquia/blt/scripts/drupal-vm/post-provision.sh"
+  - "../../../acquia/blt/scripts/drupal-vm/post-provision.sh"

scripts/drupal-vm/post-provision.sh

@@ -1,3 +1,4 @@
 #!/usr/bin/env bash
 
-export $PATH=/var/www/$(hostname)/vendor/bin:$PATH
+# Append vendor/bin to $PATH via ~/.bashrc modification.
+grep -q -F 'export PATH=/var/www/$(hostname)/vendor/bin:$PATH' .bashrc || echo 'export PATH=/var/www/$(hostname)/vendor/bin:$PATH' >> .bashrc

template/composer.json

@@ -60,6 +60,7 @@
     }
   },
   "scripts": {
+    "reinstall-phantomjs": "rm -rf vendor/bin/phantomjs && @install-phantomjs",
     "install-phantomjs": "PhantomInstaller\\Installer::installPhantomJS",
     "blt-alias": "blt install-alias -Dcreate_alias=true",
     "post-install-cmd": [