_ ____ ___ _ _ ____ _ | / ___| / _ \| \ | | _ _ / ___|_ __ ___ __ _| |_ ___ _ | \___ \| | | | \| | (_|_) | | | '__/ _ \/ _` | __/ _ \ | |_| |___) | |_| | |\ | _ _ | |___| | | __/ (_| | || __/ \___/|____/ \___/|_| \_| (_|_) \____|_| \___|\__,_|\__\___| This is the README for JSON::Create version 0.21. JSON::Create 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::Create - fast, minimal, UTF-8-only serialization of data to JSON JSON::Create encodes Perl variables into the JSON format. It offers "create_json", which uses common defaults, "create_json_strict", which accepts only unambiguous inputs, and a customizable object created with "new" and run with "run" where the user can specify a variety of behaviours. JSON::Create aims to provide fast and minimal serialization of data types. It handles no string encoding except UTF-8. The module supports serialization of objects and other non-data types via user-defined callbacks. Errors in processing result in a warning and an undefined return value. This behaviour can be altered with the method "fatal_errors". This module documentation is generated from machine readable code. All of the example programs in this documentation may be found in the directory "examples/" in the distribution. All of the example outputs displayed were generated by running the example programs. This module is a companion to "JSON::Parse" for parsing JSON into Perl. ----------------------------------------------------------------------------- 2. DOCUMENTATION You can read the documentation for the module online at the following websites: * http://search.cpan.org/perldoc?JSON::Create * http://metacpan.org/release/JSON-Create (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::Create ----------------------------------------------------------------------------- 3. INSTALLATION This module requires Perl version 5.6.1 or later. To install the module from CPAN, use cpan JSON::Create If you have the App::cpanminus installer, you may prefer cpanm JSON::Create To install the module from the source file, JSON-Create-0.21.tar.gz, follow this sequence of commands: tar xfz JSON-Create-0.21.tar.gz cd JSON-Create-0.21 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::Create, try the public repository on github at . ----------------------------------------------------------------------------- This README was written on Tue Jun 28 07:00:05 2016. -----------------------------------------------------------------------------