Automating PhantomJS setup.

Author: grasmash

bin/blt-console

@@ -1,6 +1,7 @@
 #!/usr/bin/env php
 <?php
 
+use Acquia\Blt\Console\Command\ConfigurePhantomJsCommand;
 use Acquia\Blt\Console\Command\ComposerMungeCommand;
 use Acquia\Blt\Console\Command\YamlMungeCommand;
 use Acquia\Blt\Console\Command\UpdateCommand;
@@ -23,6 +24,7 @@ else {
 }
 
 $application = new Application();
+$application->add(new ConfigurePhantomJsCommand());
 $application->add(new ComposerMungeCommand());
 $application->add(new YamlMungeCommand());
 $application->add(new UpdateCommand());

phing/build.yml

@@ -10,7 +10,7 @@ behat:
   # If true, Selenium standalone server will be launched with Behat.
   launch-selenium: true
   # If true, PhantomJS GhostDriver will be launched with Behat.
-  launch-phantom: true
+  launch-phantom: false
   # An array of paths with behat tests that should be executed.
   paths:
     # - ${docroot}/modules

phing/tasks/tests.xml

@@ -154,6 +154,32 @@
           description="Launches a GhostDriver."
           hidden="true">
 
+    <exec dir="${repo.root}" command="grep 'jakoch/phantomjs-installer' composer.json" logoutput="false" level="${blt.exec_level}" passthru="false" returnProperty="phantom.required"/>
+    <if>
+      <isfailure code="${phantom.required}"/>
+      <then>
+        <echo level="Warning">behat.launch-phantom is true, but jakoch/phantomjs-installer is not required in composer.json. Attempting to install via composer... </echo>
+        <exec dir="${repo.root}" command="composer require jakoch/phantomjs-installer --dev" logoutput="true" level="${blt.exec_level}" passthru="true" />
+      </then>
+    </if>
+    <exec dir="${repo.root}" command="grep 'PhantomInstaller\\Installer::installPhantomJS' composer.json" logoutput="false" level="${blt.exec_level}" passthru="false" returnProperty="phantom.scripts"/>
+    <if>
+      <isfailure code="${phantom.scripts}"/>
+      <then>
+        <echo level="warning">behat.launch-phantom is true, but no corresponding scripts have been defined in composer.json. Updating composer config...</echo>
+        <exec command="${composer.bin}/blt-console configure:phantomjs ${repo.root}" logoutput="true" level="${blt.exec_level}" passthru="false" checkreturn="true"/>
+      </then>
+    </if>
+    <if>
+      <not><available file="${composer.bin}/phantomjs"/></not>
+      <then>
+        <exec dir="${repo.root}" command="composer install-phantom" checkreturn="true" logoutput="true" passthru="true" level="${blt.exec_level}"/>
+      </then>
+      <else>
+        <echo>Found PhantomJS at ${phantomjs.bin}</echo>
+      </else>
+    </if>
+
     <if>
       <equals arg1="${behat.launch-phantom}" arg2="true"/>
       <then>

readme/ci.md

@@ -36,6 +36,8 @@ To initialize Pipelines support for your BLT project:
 
         curl -o pipelines https://cloud.acquia.com/pipeline-client/download
         chmod a+x pipelines
+        # Move to a location specified in $PATH. E.g.,
+        mv pipelines /usr/local/bin
 
 1. [Configure the Pipelines client](https://docs.acquia.com/pipelines/install#authenticate) 
 1. Initialize Pipelines for your project

src/Console/Command/ConfigurePhantomJsCommand.php

@@ -0,0 +1,48 @@
+<?php
+
+namespace Acquia\Blt\Console\Command;
+
+use Symfony\Component\Console\Command\Command;
+use Symfony\Component\Console\Input\InputArgument;
+use Symfony\Component\Console\Input\InputInterface;
+use Symfony\Component\Console\Input\InputOption;
+use Symfony\Component\Console\Output\OutputInterface;
+
+class ConfigurePhantomJsCommand extends Command
+{
+  protected function configure()
+  {
+    $this
+      ->setName('configure:phantomjs')
+      ->setDescription('Configure PhantomJs')
+      ->addArgument(
+        'repo-root',
+        InputArgument::REQUIRED,
+        'The root directory for the repository.'
+      )
+    ;
+  }
+
+  protected function execute(InputInterface $input, OutputInterface $output)
+  {
+    $repo_root = $input->getArgument('repo-root');
+    $composer_json = json_decode(file_get_contents($repo_root . '/composer.json'), TRUE);
+    $composer_json['scripts']['post-install-cmd'] = array_merge(
+      (array) $composer_json['scripts']['post-install-cmd'],
+      [
+        "PhantomInstaller\\Installer::installPhantomJS",
+      ]
+    );
+    $composer_json['scripts']['post-update-cmd'] = array_merge(
+      (array) $composer_json['scripts']['post-update-cmd'],
+      [
+        "PhantomInstaller\\Installer::installPhantomJS",
+      ]
+    );
+    $composer_json['scripts']['install-phantomjs'] = [
+      "rm -rf vendor/bin/phantomjs",
+      "PhantomInstaller\\Installer::installPhantomJS",
+    ];
+    file_put_contents($repo_root . '/composer.json', json_encode($composer_json, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES));
+  }
+}