Merge pull request #356 from Toflar/exec-task

Added task to execute arbitrary commands

src/Task/BuiltIn/ExecTask.php

@@ -0,0 +1,84 @@
+<?php
+/*
+ * This file is part of the Magallanes package.
+ *
+ * (c) Andrés Montañez <andres@andresmontanez.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Mage\Task\BuiltIn;
+
+use Mage\Task\Exception\ErrorException;
+use Mage\Task\AbstractTask;
+
+/**
+ * Exec task. Allows you to execute arbitrary commands.
+ *
+ * @author Yanick Witschi <https://github.com/Toflar>
+ */
+class ExecTask extends AbstractTask
+{
+    /**
+     * @return string
+     */
+    public function getName()
+    {
+        return 'exec';
+    }
+
+    /**
+     * @return string
+     */
+    public function getDescription()
+    {
+        $options = $this->getOptions();
+
+        if ('' !== $options['descr']) {
+            return (string) $options['descr'];
+        }
+
+        return '[Exec] Executing custom command';
+    }
+
+    /**
+     * @return bool
+     *
+     * @throws ErrorException
+     */
+    public function execute()
+    {
+        $options = $this->getOptions();
+
+        if ('' === $options['cmd']) {
+            throw new ErrorException('What about if you gave me a command to execute?');
+        }
+
+        // If not jailed, it must run as remote command
+        if (false === $options['jail']) {
+            $process = $this->runtime->runRemoteCommand($options['cmd'], false, $options['timeout']);
+            return $process->isSuccessful();
+        }
+
+        $process = $this->runtime->runCommand($options['cmd'], $options['timeout']);
+        return $process->isSuccessful();
+    }
+
+    /**
+     * @return array
+     */
+    protected function getOptions()
+    {
+        $options = array_merge([
+                'cmd' => '',
+                'descr' => '',
+                'jail' => true,
+                'timeout' => 120
+            ],
+            $this->options
+        );
+
+        return $options;
+    }
+}