Update README with additional supported commands.

README.md

@@ -34,6 +34,9 @@ The following commands have been implemented:
 
 - docker-compose up
 - docker-compose down
+- docker-compose start
+- docker-compose restart
+- docker-compose pause
 
 I'll be adding the rests of the docker-compose commands shortly. Or if you want
 to create a PR with additional commands that would be much appreciated.

src/DockerServicesTrait.php

@@ -0,0 +1,53 @@
+<?php
+
+namespace Droath\RoboDockerCompose;
+
+/**
+ * Define docker services trait.
+ */
+trait DockerServicesTrait
+{
+    /**
+     * Docker compose services.
+     *
+     * @var array
+     */
+    protected $services = [];
+
+    /**
+     * Add docker composer service.
+     *
+     * @param string $service
+     *   The docker services.
+     */
+    public function setService($service)
+    {
+        $this->services[] = $service;
+
+        return $this;
+    }
+
+    /**
+     * Add docker composer services.
+     *
+     * @param array $services
+     *   An array of services.
+     */
+    public function setServices(array $services)
+    {
+        foreach ($services as $service) {
+            $this->setService($service);
+        }
+
+        return $this;
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    protected function getCommand()
+    {
+        // Append the services to the end of the command.
+        return parent::getCommand() . ' ' . implode(' ', $this->services);
+    }
+}

src/ExecutableArguments.php

@@ -0,0 +1,41 @@
+<?php
+
+namespace Droath\RoboDockerCompose;
+
+use Robo\Common\CommandArguments;
+
+/**
+ * Define command executable arguments.
+ */
+trait ExecutableArguments
+{
+    /**
+     * Executable arguments.
+     *
+     * @var string
+     */
+    protected $executableArgs = '';
+
+    /**
+     * Add executable options.
+     *
+     * @param string $option
+     *   The executable option name.
+     * @param string $value
+     *   The executable option value.
+     */
+    protected function execOption($option, $value = null)
+    {
+        if (isset($option)) {
+            if (strpos($option, '-') !== 0) {
+                $option = "--$option";
+            }
+
+            $this->executableArgs .= null == $option ? '' : ' ' . $option;
+            $this->executableArgs .= null == $value ? '' : ' ' . CommandArguments::escape($value);
+        }
+
+        return $this;
+    }
+
+}

src/Task/Base.php

@@ -2,6 +2,7 @@
 
 namespace Droath\RoboDockerCompose\Task;
 
+use Droath\RoboDockerCompose\ExecutableArguments;
 use Robo\Common\ExecOneCommand;
 use Robo\Exception\TaskException;
 use Robo\Task\BaseTask;
@@ -12,6 +13,7 @@ use Robo\Task\BaseTask;
 abstract class Base extends BaseTask
 {
     use ExecOneCommand;
+    use ExecutableArguments;
 
     /**
      * Executable.
@@ -35,11 +37,9 @@ abstract class Base extends BaseTask
      */
     public function __construct($pathToDockerCompose = null)
     {
-        $this->executable = $pathToDockerCompose;
+        $this->executable = isset($pathToDockerCompose)
-
+            ? $pathToDockerCompose
-        if (!$this->executable) {
+            : $this->findExecutablePhar('docker-compose');
-            $this->executable = $this->findExecutablePhar('docker-compose');
-        }
 
         if (!$this->executable) {
             throw new TaskException(
@@ -49,6 +49,66 @@ abstract class Base extends BaseTask
         }
     }
 
+    /**
+     * Specify an alternate compose file.
+     *
+     * @param string $filename
+     *   An alternative docker composer file
+     */
+    public function file($filename)
+    {
+        if (!file_exists($filename)) {
+            throw new \InvalidArgumentException(
+                sprintf("File %s wasn't found on the filesystem", $filename)
+            );
+        }
+
+        $this->execOption('file', $filename);
+
+        return $this;
+    }
+
+    /**
+     * Specify multiple composer files.
+     *
+     * @param array $files
+     *   An array of alternative composer files.
+     */
+    public function files(array $files)
+    {
+        foreach ($files as $filename) {
+            $this->file($filename);
+        }
+
+        return $this;
+    }
+
+    /**
+     * Specify an alternate project name.
+     *
+     * @param string
+     *   An alternative docker compose project name.
+     */
+    public function projectName($name)
+    {
+        $this->execOption('project-name', $name);
+
+        return $this;
+    }
+
+    /**
+     * Daemon socket to connect to.
+     *
+     * @param string $hostname
+     *   The name of the host to connect to.
+     */
+    public function host($hostname)
+    {
+        $this->execOption('host', $hostname);
+
+        return $this;
+    }
+
     /**
      * {@inheritdoc}
      */
@@ -70,6 +130,6 @@ abstract class Base extends BaseTask
      */
     protected function getCommand()
     {
-        return "{$this->executable} {$this->action} {$this->arguments}";
+        return "{$this->executable} {$this->executableArgs} {$this->action} {$this->arguments}";
     }
 }

src/Task/Pause.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace Droath\RoboDockerCompose\Task;
+
+use Droath\RoboDockerCompose\DockerServicesTrait;
+
+/**
+ * Define docker compose pause command.
+ */
+class Pause extends Base
+{
+    use DockerServicesTrait;
+
+    /**
+     * {@inheritdoc}
+     */
+    protected $action = 'pause';
+}

src/Task/Restart.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace Droath\RoboDockerCompose\Task;
+
+use Droath\RoboDockerCompose\DockerServicesTrait;
+
+/**
+ * Define docker compose restart command.
+ */
+class Restart extends Base
+{
+    use DockerServicesTrait;
+
+    /**
+     * {@inheritdoc}
+     */
+    protected $action = 'restart';
+
+    /**
+     * Specify a shutdown timeout in seconds.
+     *
+     * @param int $timeout
+     *   The timeout in seconds.
+     *
+     * @return self
+     */
+    public function timeout($timeout = 10)
+    {
+        $this->option('timeout', $timeout);
+
+        return $this;
+    }
+}

src/Task/Start.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace Droath\RoboDockerCompose\Task;
+
+use Droath\RoboDockerCompose\DockerServicesTrait;
+
+/**
+ * Define docker compose start command.
+ */
+class Start extends Base
+{
+    use DockerServicesTrait;
+
+    /**
+     * {@inheritdoc}
+     */
+    protected $action = 'start';
+}

src/Task/Up.php

@@ -2,6 +2,7 @@
 
 namespace Droath\RoboDockerCompose\Task;
 
+use Droath\RoboDockerCompose\DockerServicesTrait;
 use Robo\Exception\TaskException;
 
 /**
@@ -9,18 +10,13 @@ use Robo\Exception\TaskException;
  */
 class Up extends Base
 {
+    use DockerServicesTrait;
+
     /**
      * {@inheritdoc}
      */
     protected $action = 'up';
 
-    /**
-     * Docker compose services.
-     *
-     * @var array
-     */
-    protected $services = [];
-
     /**
      * Command detached mode.
      *
@@ -28,34 +24,6 @@ class Up extends Base
      */
     protected $detachedMode = false;
 
-    /**
-     * Add docker composer service.
-     *
-     * @param string $service
-     *   The docker services.
-     */
-    public function setService($service)
-    {
-        $this->services[] = $service;
-
-        return $this;
-    }
-
-    /**
-     * Add docker composer services.
-     *
-     * @param array $services
-     *   An array of services.
-     */
-    public function setServices(array $services)
-    {
-        foreach ($services as $service) {
-            $this->setService($service);
-        }
-
-        return $this;
-    }
-
     /**
      * Run containers in the background.
      */
@@ -147,15 +115,6 @@ class Up extends Base
         return $this;
     }
 
-    /**
-     * {@inheritdoc}
-     */
-    protected function getCommand()
-    {
-        // Append the services to the end of the command.
-        return parent::getCommand() . ' ' . implode(' ', $this->services);
-    }
-
     /**
      * Set command detached mode.
      */

src/Task/loadTasks.php

@@ -16,10 +16,34 @@ trait loadTasks
     }
 
     /**
-     * Docker compose up task.
+     * Docker compose down task.
      */
     protected function taskDockerComposeDown($pathToDockerCompose = null)
     {
         return $this->task(Down::class, $pathToDockerCompose);
     }
+
+    /**
+     * Docker compose pause task.
+     */
+    protected function taskDockerComposePause($pathToDockerCompose = null)
+    {
+        return $this->task(Pause::class, $pathToDockerCompose);
+    }
+
+    /**
+     * Docker compose start task.
+     */
+    protected function taskDockerComposeStart($pathToDockerCompose = null)
+    {
+        return $this->task(Start::class, $pathToDockerCompose);
+    }
+
+    /**
+     * Docker compose restart task.
+     */
+    protected function taskDockerComposeRestart($pathToDockerCompose = null)
+    {
+        return $this->task(Restart::class, $pathToDockerCompose);
+    }
 }