The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
       _ ____   ___  _   _         ____                     
      | / ___| / _ \| \ | |  _ _  |  _ \ __ _ _ __ ___  ___ 
   _  | \___ \| | | |  \| | (_|_) | |_) / _` | '__/ __|/ _ \
  | |_| |___) | |_| | |\  |  _ _  |  __/ (_| | |  \__ \  __/
   \___/|____/ \___/|_| \_| (_|_) |_|   \__,_|_|  |___/\___|
                                                            


This is the README for JSON::Parse version 0.41.

JSON::Parse is a "module" for the Perl computer programming language, a library
of computer code to install on a computer.  This document contains four
sections:

1. About - what the module does

2. Documentation - how to learn more about the module

3. Installation - how to install this module on a computer

4. Help - what to do if you get stuck

-----------------------------------------------------------------------------

1. ABOUT

JSON::Parse - Read JSON into a Perl variable

JSON::Parse offers the function "parse_json", which takes one
argument, a string containing JSON, and returns a Perl reference or
scalar. The input to "parse_json" must be a complete JSON
structure. 

JSON::Parse also offers two high-speed validation functions,
"valid_json", which returns true or false, and
"assert_valid_json", which produces a descriptive fatal error if the
JSON is invalid. These are much faster than "parse_json". See
"PERFORMANCE" for a comparison.

JSON::Parse also offers one convenience function to read JSON directly
from a file, "json_file_to_perl", and a safer version of
"parse_json" called "parse_json_safe" which doesn't throw
exceptions.

For special cases, such as JSON objects with non-unique names (key
collisions), or round-trips with JSON booleans, there are also "new"
and "run", which create a JSON parsing object and run it on text.

JSON::Parse accepts only UTF-8 as input. If its input is marked as
Unicode characters, the strings in its output are also marked as
Unicode characters. If its input contains Unicode escapes of the form
""\u3000"", its output is upgraded to Unicode character strings.

(JSON means "JavaScript Object Notation" and it is specified in "RFC
7159".)

-----------------------------------------------------------------------------

2. DOCUMENTATION

You can read the documentation for the module online at the following websites:

    * http://search.cpan.org/perldoc?JSON::Parse
    * http://metacpan.org/release/JSON-Parse

(These links go to the latest version of the module.)

After installing the module, you can read the documentation on your computer
using

    perldoc JSON::Parse

-----------------------------------------------------------------------------

3. INSTALLATION

This module requires Perl version 5.8.9 or later.

To install the module from CPAN, use

    cpan JSON::Parse

If you have the App::cpanminus installer, you may prefer

    cpanm JSON::Parse

To install the module from the source file, JSON-Parse-0.41.tar.gz, follow this
sequence of commands:

    tar xfz JSON-Parse-0.41.tar.gz
    cd JSON-Parse-0.41
    perl Makefile.PL
    make
    make install

If you want to test the module before installing it, use "make test" after
"make" and before "make install".

-----------------------------------------------------------------------------

4. HELP

To get help with the module, you can email the author, Ben Bullock, at
<bkb@cpan.org>. If you think there is a problem in the module, you can report a
bug at 

<https://github.com/benkasminbullock/JSON-Parse/issues>,

or if you want to alter the source code of JSON::Parse, try the public
repository on github at 

<https://github.com/benkasminbullock/JSON-Parse>. 

-----------------------------------------------------------------------------

This README was written on Tue Jun 14 09:14:30 2016.

-----------------------------------------------------------------------------