Add lazy JSON parsing examples using @halaxa JsonMachine library.

composer.json

@@ -26,12 +26,15 @@
         "amphp/parallel-functions": "^1",
         "drupol/php-conventions": "^5",
         "friends-of-phpspec/phpspec-code-coverage": "^6",
+        "guzzlehttp/guzzle": "^7.3",
+        "halaxa/json-machine": "^0.7.0",
         "infection/infection": "^0.22.0 || ^0.23.0",
         "infection/phpspec-adapter": "^0.1.1",
         "phpspec/phpspec": "^7",
         "phpstan/phpstan-strict-rules": "^0.12",
         "psr/cache": "^1.0",
         "symfony/cache": "^5",
+        "symfony/http-client": "^5.2",
         "symfony/polyfill-mbstring": "^1.18"
     },
     "suggest": {

docs/pages/code/lazy-json-parsing.php

@@ -0,0 +1,63 @@
+<?php
+
+/**
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+declare(strict_types=1);
+
+namespace App;
+
+require_once __DIR__ . '/../../../vendor/autoload.php';
+
+use JsonMachine\JsonMachine;
+use loophp\collection\Collection;
+use Symfony\Component\HttpClient\HttpClient;
+use Symfony\Contracts\HttpClient\ChunkInterface;
+
+/**
+ * In order to get this working, you will need the library halaxa/json-machine.
+ * Use composer to install it in your project.
+ *
+ * composer require halaxa/json-machine
+ *
+ * halaxa/json-machine is a lazy JSON parser and it is fully compatible
+ * with loophp/collection.
+ */
+
+// Parse a local JSON file
+$composerJson = __DIR__ . '/../../../composer.json';
+
+$json = Collection::fromIterable(JsonMachine::fromFile($composerJson));
+
+foreach ($json as $key => $value) {
+}
+
+$remoteFile = 'https://httpbin.org/anything';
+
+// Parse a remote JSON file with Guzzle
+$client = new \GuzzleHttp\Client();
+$response = $client->request('GET', $remoteFile);
+$phpStream = \GuzzleHttp\Psr7\StreamWrapper::getResource($response->getBody());
+
+$json = Collection::fromIterable(\JsonMachine\JsonMachine::fromStream($phpStream));
+
+foreach ($json as $key => $value) {
+}
+
+// Parse a remote JSON file with Symfony HTTP client
+$client = HttpClient::create();
+$response = $client->request('GET', $remoteFile);
+
+$json = Collection::fromIterable(
+    JsonMachine::fromIterable(
+        Collection::fromIterable($client->stream($response))
+            ->map(
+                static fn (ChunkInterface $chunk): string => $chunk->getContent()
+            )
+    )
+);
+
+foreach ($json as $key => $value) {
+}

docs/pages/usage.rst

@@ -144,3 +144,9 @@ Read a file
 
 .. literalinclude:: code/read-file.php
   :language: php
+
+Lazy json parsing
+~~~~~~~~~~~~~~~~~
+
+.. literalinclude:: code/lazy-json-parsing.php
+  :language: php