Add examples for parsing JSON in a lazy way

[drupol]

This morning I discovered this: https://packagist.org/packages/halaxa/json-machine

I think we should provide an example and documentation on how to use it with this collection library.

Something like this?

With Guzzle:

<?php

require_once __DIR__ . '/../../vendor/autoload.php';

$client = new \GuzzleHttp\Client();
$response = $client->request('GET', $file);
$phpStream = \GuzzleHttp\Psr7\StreamWrapper::getResource($response->getBody());

$json = Collection::fromIterable(\JsonMachine\JsonMachine::fromStream($phpStream));

foreach ($json as $key => $value) {}

With Symfony client:

<?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;

use JsonMachine\JsonMachine;
use loophp\collection\Collection;
use Symfony\Component\HttpClient\HttpClient;
use Symfony\Contracts\HttpClient\ChunkInterface;

include __DIR__ . '/vendor/autoload.php';

$file = 'https://httpbin.org/anything';
//$file = 'https://github.com/json-iterator/test-data/blob/master/large-file.json?raw=true';

$client = HttpClient::create();
$response = $client->request('GET', $file);

$json = Collection::fromIterable(
        JsonMachine::fromIterable(
            Collection::fromIterable($client->stream($response))
                ->map(
                    static function(ChunkInterface $chunk): string {
                        return $chunk->getContent();
                    }
                )
        )
    );

foreach ($json as $key => $value) {}

What do you think?
Should we provide simpler example?

IMHO, the more examples we have, the better it is for a broader adoption.

@AlexandruGG anything to add ?

[AlexandruGG]

This looks nice! I think examples should be as simple as possible and only related to the things we care about. I feel like the bits related to instantiating the http clients might not be needed

[drupol]

Ok I see. However, most of the time it might be used with HTTP clients, so I guess it's not a big deal if we add those examples as well.