NAME
Test::BSON - Test BSON documents
VERSION
This document describes Test::BSON version 0.01.
SYNOPSIS
use Test::BSON;
bson_ok $bson, 'BSON is valid';
bson_is $bson, $expected_bson, 'BSON matches what we expected';
DESCRIPTION
BSON is a binary-encoded extension of JSON. Test::BSON makes it easy to
verify that you have built a valid BSON document and that it matches
what you expected.
EXPORTED TESTS
bson_ok
Test passes if the BSON document is valid.
bson_ok $bson, 'BSON is valid';
"is_valid_bson" is provided as an alternative to "bson_ok" using the
same naming convention as Test::JSON but is not exported by default.
bson_is
Test passes if the two BSON documents are valid and evaluate to the same
data structure.
bson_is $bson, $expected_bson, 'BSON matches what we expected';
Test::Differences is used to provide easy diagnostics of why the BSON
documents did not match. For example:
Failed test 'BSON matches what we expected'
in t/bson.t at line 10.
+----+----------------+----------------+
| Elt|Got |Expected |
+----+----------------+----------------+
| 0|{ |{ |
| 1| BSON => [ | BSON => [ |
* 2| 'AWSUM!!', | 'awesome', *
| 3| '5.05', | '5.05', |
* 4| 1984 | 1986 *
| 5| ] | ] |
| 6|} |} |
+----+----------------+----------------+
"is_bson" is provided as an alternative to "bson_is" using the same
naming convention as Test::JSON but is not exported by default.
SEE ALSO
This module uses BSON and Test::Differences, and is based on Test::JSON.
Learn more about BSON at <
http://bsonspec.org/>.
AUTHOR
Nick Patch <
[email protected]>
ACKNOWLEDGEMENTS
This module was forked from Test::JSYNC, which was forked from
Test::JSON authored by Curtis “Ovid” Poe.
COPYRIGHT & LICENSE
© 2011–2012 Nick Patch
© 2005–2007 Curtis “Ovid” Poe
This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.
