[11.x] Add ability to transform Http\Client\Response into Fluent (#53771)

* Add ability to transform a response into a fluent instance

* Add tests

Author: stevebauman

src/Illuminate/Http/Client/Response.php

@@ -5,6 +5,7 @@
 use ArrayAccess;
 use GuzzleHttp\Psr7\StreamWrapper;
 use Illuminate\Support\Collection;
+use Illuminate\Support\Fluent;
 use Illuminate\Support\Traits\Macroable;
 use LogicException;
 use Stringable;
@@ -108,6 +109,17 @@ public function collect($key = null)
         return new Collection($this->json($key));
     }
 
+    /**
+     * Get the JSON decoded body of the response as a fluent object.
+     *
+     * @param  string|null  $key
+     * @return \Illuminate\Support\Fluent
+     */
+    public function fluent($key = null)
+    {
+        return new Fluent((array) $this->json($key));
+    }
+
     /**
      * Get the body of the response as a PHP resource.
      *

tests/Http/HttpClientTest.php

@@ -402,6 +402,21 @@ public function testResponseCanBeReturnedAsCollection()
         $this->assertEquals(collect(), $response->collect('missing_key'));
     }
 
+    public function testResponseCanBeReturnedAsFluent()
+    {
+        $this->factory->fake([
+            '*' => ['result' => ['foo' => 'bar']],
+        ]);
+
+        $response = $this->factory->get('http://foo.com/api');
+
+        $this->assertInstanceOf(Fluent::class, $response->fluent());
+        $this->assertEquals(fluent(['result' => ['foo' => 'bar']]), $response->fluent());
+        $this->assertEquals(fluent(['foo' => 'bar']), $response->fluent('result'));
+        $this->assertEquals(fluent(['bar']), $response->fluent('result.foo'));
+        $this->assertEquals(fluent([]), $response->fluent('missing_key'));
+    }
+
     public function testSendRequestBodyAsJsonByDefault()
     {
         $body = '{"test":"phpunit"}';