Lazy JSON
Framework agnostic package to load heavy JSON in lazy collections. Under the hood, the brilliant JSON Machine by @halaxa is used as lexer and parser.
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 [email protected] instead of using the issue tracker.
Credits
License
The MIT License (MIT). Please see License File for more information.
2 Feb 12, 2022
14 Aug 14, 2022
620 Jan 7, 2023
6 Oct 14, 2022
152 Dec 18, 2022
3 Dec 29, 2022
72k Jan 7, 2023
27.8k Jan 2, 2023
18.2k Dec 29, 2022
60 Nov 9, 2022
356 Dec 29, 2022
6.5k Dec 27, 2022
10 Mar 16, 2022
45 Nov 29, 2022
13 Dec 9, 2022
269 Jul 23, 2022
150 Apr 12, 2022
14 Aug 14, 2022