Extend Json::read() and Json::write() to accept files and streams

[thekid]

Files

The API now integrates seamlessly with io.Files:

use text\json\{Json, FileInput, FileOutput};
use io\File;

$file= new File('file.json');

$data= Json::read(new FileInput($file));
Json::write($data, new FileOutput($file));

// It's now also possible to pass file instances directly to read()
// and to write(), which uses Format::$DEFAULT
$data= Json::read($file);
Json::write($data, $file);

Streams

The API now integrates seamlessly with I/O streams:

use text\json\{Json, StreamInput, StreamOutput};
use io\streams\{MemoryInputStream, MemoryOutputStream};

$in= new MemoryInputStream('{"test":true}');
$out= new MemoryOutputStream();

$data= Json::read(new StreamInput($in));
Json::write($data, new StreamOutput($out));

// It's now also possible to pass input strams directly to read()
// and output streams to write(), which uses Format::$DEFAULT
$data= Json::read($in);
Json::write($data, $out);

[thekid]

Released in https://github.com/xp-forge/json/releases/tag/v6.0.0