_ ____ ___ _ _ ____
| / ___| / _ \| \ | | _ _ | _ \ __ _ _ __ ___ ___
_ | \___ \| | | | \| | (_|_) | |_) / _` | '__/ __|/ _ \
| |_| |___) | |_| | |\ | _ _ | __/ (_| | | \__ \ __/
\___/|____/ \___/|_| \_| (_|_) |_| \__,_|_| |___/\___|
This is the README for JSON::Parse version 0.56.
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
A module for parsing JSON. (JSON means "JavaScript Object Notation"
and it is specified in "RFC 7159".)
JSON::Parse offers the function "parse_json", which takes a string
containing JSON, and returns an equivalent Perl structure. It also
offers validation of JSON via "valid_json", which returns true or
false depending on whether the JSON is correct or not, and
"assert_valid_json", which produces a descriptive fatal error if the
JSON is invalid. A function "json_file_to_perl" reads JSON from a
file, and there is a safer version of "parse_json" called
"parse_json_safe" which doesn't throw exceptions.
For special cases of parsing, there are also methods "new" and
"run", which create a JSON parsing object and run it on text. See
"METHODS".
JSON::Parse accepts only UTF-8 as input. See "UTF-8 only" and
"Handling of Unicode".
-----------------------------------------------------------------------------
2. DOCUMENTATION
You can read the documentation for the module online at the following
website:
* http://metacpan.org/release/JSON-Parse
(This link goes 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.56.tar.gz, follow
this sequence of commands:
tar xfz JSON-Parse-0.56.tar.gz
cd JSON-Parse-0.56
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 Mon Feb 17 13:11:05 2020.
-----------------------------------------------------------------------------