Json Encoder

[nyamsprod]

Feature Request

Q	A
New Feature	yes
BC Break	yes
Version taget	10.0

Proposal

Adding a new converter to convert a tabular data into a JSON stream.

Proposed API

use League\Csv\JsonConverter;

$converter = JsonConverter::create(); ///returns a new converter with default options that match those of json_encode
$converter->convert(iterable $tabularData): Iterator; //returns an Iterator<string> object 

foreach ($converter->convert($tabularData) as $line) {
    echo $line;
}

//lazyly generates the JSON data


$converter->save(iterable $tabularData, mixed $destination): void;
// This methods uses the `convert` method internally to store the generated data to the filepath located at detination.

$converter->save(Reader::createFromPath('document.csv'), 'document.json');
//will convert the CSV into a JSON string and store the result in document.json

The class can be configured with the following methods:

JsonConverter::addFlags(int ...$flags);
JsonConverter::removeFlags(int ...$flags);
JsonConverter::flags(int $flags);
JsonConverter::depth(int $depth);
JsonConverter::indentSize(int $indentSize);

They all more or less map to json_encode parameters except for the indentSize method that enable creating JSON string in pretty print mode with different indentation size. By default the method uses and indentSize of 4 characters.

``