[10.x] Add syntax sugar to the Process::pipe method (#46745)

* 10.x - Add syntax sugar to the Process::pipe method

* fix code style issues

* simplify code

---------

Co-authored-by: Taylor Otwell <[email protected]>

Author: WendellAdriel

src/Illuminate/Process/Factory.php

@@ -274,12 +274,16 @@ public function pool(callable $callback)
     /**
      * Start defining a series of piped processes.
      *
-     * @param  callable  $callback
+     * @param  callable|array  $callback
      * @return \Illuminate\Process\Pipe
      */
-    public function pipe(callable $callback, ?callable $output = null)
+    public function pipe(callable|array $callback, ?callable $output = null)
     {
-        return (new Pipe($this, $callback))->run(output: $output);
+        return is_array($callback)
+            ? (new Pipe($this, fn ($pipe) => collect($callback)->each(
+                fn ($command) => $pipe->command($command)
+            )))->run(output: $output)
+            : (new Pipe($this, $callback))->run(output: $output);
     }
 
     /**

src/Illuminate/Support/Facades/Process.php

@@ -35,7 +35,7 @@
  * @method static \Illuminate\Process\Factory assertDidntRun(\Closure|string $callback)
  * @method static \Illuminate\Process\Factory assertNothingRan()
  * @method static \Illuminate\Process\Pool pool(callable $callback)
- * @method static \Illuminate\Process\Pipe pipe(callable $callback, callable|null $output = null)
+ * @method static \Illuminate\Process\Pipe pipe(callable|array $callback, callable|null $output = null)
  * @method static \Illuminate\Process\ProcessPoolResults concurrently(callable $callback, callable|null $output = null)
  * @method static \Illuminate\Process\PendingProcess newPendingProcess()
  * @method static void macro(string $name, object|callable $macro)

tests/Process/ProcessTest.php

@@ -534,6 +534,44 @@ public function testProcessPipeFailed()
         $this->assertTrue($pipe->failed());
     }
 
+    public function testProcessSimplePipe()
+    {
+        if (windows_os()) {
+            $this->markTestSkipped('Requires Linux.');
+        }
+
+        $factory = new Factory;
+        $factory->fake([
+            'cat *' => "Hello, world\nfoo\nbar",
+        ]);
+
+        $pipe = $factory->pipe([
+            'cat test',
+            'grep -i "foo"',
+        ]);
+
+        $this->assertSame("foo\n", $pipe->output());
+    }
+
+    public function testProcessSimplePipeFailed()
+    {
+        if (windows_os()) {
+            $this->markTestSkipped('Requires Linux.');
+        }
+
+        $factory = new Factory;
+        $factory->fake([
+            'cat *' => $factory->result(exitCode: 1),
+        ]);
+
+        $pipe = $factory->pipe([
+            'cat test',
+            'grep -i "foo"',
+        ]);
+
+        $this->assertTrue($pipe->failed());
+    }
+
     public function testFakeInvokedProcessOutputWithLatestOutput()
     {
         $factory = new Factory;