test::json(3pm) [debian man page]

Test::JSON(3pm) 					User Contributed Perl Documentation					   Test::JSON(3pm)

NAME

       Test::JSON - Test JSON data

VERSION

       Version 0.11

SYNOPSIS

	use Test::JSON;

	is_valid_json $json,		     '... json is well formed';
	is_json       $json, $expected_json, '... and it matches what we expected';

EXPORT

       o   is_valid_json

       o   is_json

DESCRIPTION

       JavaScript Object Notation (JSON) is a lightweight data interchange format.  Test::JSON makes it easy to verify that you have built valid
       JSON and that it matches your expected output.

       See <http://www.json.org/> for more information.

TESTS

   is_valid_json
	is_valid_json $json, '... json is well formed';

       Test passes if the string passed is valid JSON.

   is_json
	is_json $json, $expected_json, '... and it matches what we expected';

       Test passes if the two JSON strings are valid JSON and evaluate to the same data structure.

       Test::Differences is used to provide easy diagnostics of why the JSON structures did not match.	For example:

	  Failed test '... and identical JSON should match'
	  in t/10testjson.t at line 14.
	+----+---------------------------+---------------------------+
	| Elt|Got			 |Expected		     |
	+----+---------------------------+---------------------------+
	|   0|{ 			 |{			     |
	|   1|	bool => '1',		 |  bool => '1',	     |
	|   2|	description => bless( {  |  description => bless( {  |
	|   3|	  value => undef	 |    value => undef	     |
	|   4|	}, 'JSON::NotString' ),  |  }, 'JSON::NotString' ),  |
	|   5|	id => '1',		 |  id => '1',		     |
	*   6|	name => 'foo'		 |  name => 'fo'	     *
	|   7|} 			 |}			     |
	+----+---------------------------+---------------------------+

AUTHOR

       Curtis "Ovid" Poe, "<ovid@cpan.org>"

BUGS

       Please report any bugs or feature requests to "bug-test-json@rt.cpan.org", or through the web interface at
       <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Test-JSON>.  I will be notified, and then you'll automatically be notified of progress on
       your bug as I make changes.

SEE ALSO

       This test module uses JSON::Any and Test::Differences.

ACKNOWLEDGEMENTS

       The development of this module was sponsored by Kineticode, <http://www.kineticode.com/>, the leading provider of services for the
       Bricolage content management system, <http://www.bricolage.cc/>.

       Thanks to Makamaka Hannyaharamitu "makamaka@cpan.org" for a patch to make this work with JSON 2.0.

       Thanks to Stevan Little for suggesting a switch to JSON::Any.  This makes it easier for this module to work with whatever JSON module you
       have installed.

COPYRIGHT &; LICENSE
       Copyright 2005-2007 Curtis "Ovid" Poe, all rights reserved.

       This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.10.1							    2009-08-09							   Test::JSON(3pm)

Check Out this Related Man Page

Jifty::JSON(3pm)					User Contributed Perl Documentation					  Jifty::JSON(3pm)

NAME

       Jifty::JSON -- Wrapper around JSON

SYNOPSIS

	 use Jifty::JSON qw/decode_json encode_json/;

	 my $obj  = decode_json(q! { "x": "1", "y": "2", "z": "3" } !);
	 my $json = encode_json($obj);

DESCRIPTION

       Provides a thin wrapper around the JSON 2.xx library, which provides a frontend for JSON::XS and JSON::PP.

       This module used to wrap JSON::Syck and JSON 1.xx with special-casing for outputting JSON with single quoted values.  Single quotes make it
       easy to simply plop JSON into HTML attributes but are in violation of the JSON spec which mandates only double quoted strings.

       The old behavior is now unsupported and it is recommended that you simply HTML escape your entire blob of JSON if you are sticking it in an
       HTML attribute.	You can use Jifty->web->escape() to properly escape problematic characters for HTML.

FUNCTIONS

   decode_json JSON, [ARGUMENT HASHREF]
   encode_json JSON, [ARGUMENT HASHREF]
       These functions are just like JSON's, except that you can pass options to them like you can with JSON's "from_json" and "to_json"
       functions.

       By default they encode/decode using UTF8 (like JSON's functions of the same name), but you can turn that off by passing "utf8 => 0" in the
       options.  The allow_nonref flag is also enabled for backwards compatibility with earlier versions of this module.  It allows
       encoding/decoding of values that are not references.

       JSON is imported with the "-support_by_pp" flag in order to support all options that JSON::PP provides when using JSON::XS as the backend.
       If you are concerned with speed, be careful what options you specify as it may cause the pure Perl backend to be used.  Read "JSON::PP
       SUPPORT METHODS" in JSON for more information.

DEPRECATED FUNCTIONS

   jsonToObj JSON, [ARGUMENTS]
   objToJson JSON, [ARGUMENTS]
       These functions are deprecated and provided for backwards compatibility.  They wrap the appropriate function above, but "croak" in Carp if
       you try to set the "singlequote" option.

LICENSE

       Jifty is Copyright 2005-2010 Best Practical Solutions, LLC.  Jifty is distributed under the same terms as Perl itself.

perl v5.14.2							    2010-12-08							  Jifty::JSON(3pm)

Linux and UNIX Man Pages

test::json(3pm) [debian man page]

Check Out this Related Man Page