cerbero90 / lazy-json by cerbero

Load heavy JSON in Laravel lazy collections.
268,762
230
3
Package Data
Maintainer Username: cerbero
Maintainer Contact: andrea.marco.sartori@gmail.com (Andrea Marco Sartori)
Package Create Date: 2021-05-02
Package Last Update: 2023-11-29
Home Page:
Language: PHP
License: MIT
Last Refreshed: 2024-03-23 03:01:04
Package Statistics
Total Downloads: 268,762
Monthly Downloads: 1,383
Daily Downloads: 65
Total Stars: 230
Total Watchers: 3
Total Forks: 3
Total Open Issues: 0

🐼 Lazy JSON

Author PHP Version Laravel Version Octane Compatibility Build Status Coverage Status Quality Score Latest Version Software License PSR-7 PSR-12 Total Downloads

Framework agnostic package to load heavy JSON in lazy collections. Under the hood, the brilliant JSON Machine by @halaxa is used as a lexer and parser.

Need to load paginated items of JSON APIs? Consider using Lazy JSON Pages instead.

Install

In a Laravel application, all you need to do is requiring the package:

composer require cerbero/lazy-json

Otherwise, you also need to register the lazy collection macro manually:

use Cerbero\LazyJson\Macro;
use Illuminate\Support\LazyCollection;

LazyCollection::macro('fromJson', new Macro());

Usage

Loading JSON in lazy collections is possible by using the collection itself or the included helper:

LazyCollection::fromJson($source);

lazyJson($source);

The following are the supported JSON sources:

$source = '{"foo":"bar"}'; // JSON string
$source = ['{"foo":"bar"}']; // any iterable containing JSON, i.e. array or Traversable
$source = 'https://foo.test/endpoint'; // endpoint
$source = Http::get('https://foo.test/endpoint'); // Laravel HTTP client response
$source = '/path/to/file.json'; // JSON file
$source = fopen('/path/to/file.json', 'rb'); // any resource
$source = <Psr\Http\Message\MessageInterface>; // any PSR-7 message, e.g. Guzzle response
$source = <Psr\Http\Message\StreamInterface>; // any PSR-7 stream

Optionally, you can define a dot-noted path to extract only a sub-tree of the JSON. For example, given the following JSON:

{
    "data": [
        {
            "name": "Team 1",
            "users": [
                {
                    "id": 1
                },
                {
                    "id": 2
                }
            ]
        },
        {
            "name": "Team 2",
            "users": [
                {
                    "id": 3
                }
            ]
        }
    ]
}

defining the path data.*.users.*.id would iterate only user IDs:

$ids = lazyJson($source, 'data.*.users.*.id')
    ->filter(fn ($id) => $id % 2 == 0)
    ->all();

Change log

Please see CHANGELOG for more information on what has changed recently.

Testing

composer test

Contributing

Please see CONTRIBUTING and CODE_OF_CONDUCT for details.

Security

If you discover any security related issues, please email andrea.marco.sartori@gmail.com instead of using the issue tracker.

Credits

License

The MIT License (MIT). Please see License File for more information.