_ ____ ___ _ _ ____ | / ___| / _ \| \ | | _ _ | _ \ __ _ _ __ ___ ___ _ | \___ \| | | | \| | (_|_) | |_) / _` | '__/ __|/ _ \ | |_| |___) | |_| | |\ | _ _ | __/ (_| | | \__ \ __/ \___/|____/ \___/|_| \_| (_|_) |_| \__,_|_| |___/\___| This is the README for JSON::Parse version 0.37. 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 means "JavaScript Object Notation" and it is specified in "RFC 7159". 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 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 act at a higher speed 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". 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. ----------------------------------------------------------------------------- 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.37.tar.gz, follow this sequence of commands: tar xfz JSON-Parse-0.37.tar.gz cd JSON-Parse-0.37 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 . If you think there is a problem in the module, you can report a bug at , or if you want to alter the source code of JSON::Parse, try the public repository on github at . ----------------------------------------------------------------------------- This README was written on Fri Oct 30 08:01:25 2015. -----------------------------------------------------------------------------