Add setProcessInput and deprecate setInput. (consolidation#1034)

* Add setProcessInput and deprecate setInput.

* Set interactive to false when a process input is provided.

* Keep same behaviour for the deprecated method.

docs/tasks/Base.md

@@ -21,6 +21,7 @@ if ($this->taskExec('phpunit .')->run()->wasSuccessful()) {
 
 * `simulate($context)`  {@inheritdoc}
 * `setOutput($output)`  Sets the Console Output.
+* `setProcessInput($input)`  Sets the input for the command. Similar to a pipe like `echo "input" | cat`.
 * `dir($dir)`  Changes working directory of command
 * `arg($arg)`  Pass argument to executable. Its value will be automatically escaped.
 * `args($args)`  Pass methods parameters as arguments to executable. Argument values
@@ -49,7 +50,7 @@ $this->taskExecStack()
 * `executable($executable)`   * `param string` $executable
 * `exec($command)`   * `param string|string[]|CommandInterface` $command
 * `stopOnFail($stopOnFail = null)`   * `param bool` $stopOnFail
-* `result($result)` 
+* `result($result)`
 * `setOutput($output)`  Sets the Console Output.
 * `dir($dir)`  Changes working directory of command
 
@@ -94,7 +95,7 @@ $this->taskSymfonyCommand(new ModelGeneratorCommand())
 ```
 
 * `arg($arg, $value)`   * `param string` $arg
-* `opt($option, $value = null)` 
+* `opt($option, $value = null)`
 * `setOutput($output)`  Sets the Console Output.
 
 

src/Common/ExecTrait.php

@@ -215,8 +215,26 @@ public function envVars(array $env)
      *
      * @return $this
      */
+    public function setProcessInput($input)
+    {
+        $this->input = $input;
+        // A tty should not be allocated when the input is provided.
+        $this->interactive(false);
+        return $this;
+    }
+
+    /**
+     * Pass an input to the process. Can be resource created with fopen() or string
+     *
+     * @param resource|string $input
+     *
+     * @return $this
+     *
+     * @deprecated
+     */
     public function setInput($input)
     {
+        trigger_error('setInput() is deprecated. Please use setProcessInput(().', E_USER_DEPRECATED);
         $this->input = $input;
         return $this;
     }