NAME

       Catmandu::Importer::JSON - Package that imports JSON data

SYNOPSIS

           # From the command line

           $ catmandu convert JSON to YAML < data.json

           # or for faster newline delimited input

           $ catmandu convert JSON --line_delimited 1 to YAML < data.json

           # In a Perl script

           use Catmandu;

           my $importer = Catmandu->importer('JSON', file => "/foo/bar.json");

           my $n = $importer->each(sub {
               my $hashref = $_[0];
               # ...
           });

DESCRIPTION

       This package imports JSON data. The parser is quite liberal in the input it accepts. You
       can use the "line_delimited" option to parse "newline delimited JSON" faster:

           { "recordno": 1, "name": "Alpha" }
           { "recordno": 2, "name": "Beta" }
           { "recordno": 3, "name": "Gamma" }

CONFIGURATION

       file
           Read input from a local file given by its path. Alternatively a scalar reference can
           be passed to read from a string.

       fh  Read input from an IO::Handle. If not specified, Catmandu::Util::io is used to create
           the input stream from the "file" argument or by using STDIN.

       encoding
           Binmode of the input stream "fh". Set to ":utf8" by default.

       fix An ARRAY of one or more fixes or file scripts to be applied to imported items.

       line_delimited
           Read line-delimited JSON with a faster, non-incremental parser.

METHODS

       Every Catmandu::Importer is a Catmandu::Iterable all its methods are inherited. The
       methods are not idempotent: JSON streams can only be read once.

SEE ALSO

       Catmandu::Exporter::JSON