NAME

       Test::YAML::Valid - Test for valid YAML

VERSION

       Version 0.04

SYNOPSIS

       This module lets you easily test the validity of YAML:

           use Test::More tests => 3;
           use Test::YAML::Valid;

           yaml_string_ok(YAML::Dump({foo => 'bar'}), 'YAML generates good YAML?');
           yaml_string_ok('this is not YAML, is it?', 'This one will fail');
           yaml_file_ok('/path/to/some/YAML', '/path/to/some/YAML is YAML');
           yaml_files_ok('/path/to/YAML/files/*', 'all YAML files are valid');

       You can also test with YAML::Syck instead of YAML by passing "-Syck" in the import list:

           use Test::YAML::Valid qw(-Syck);
           yaml_string_ok(...); # uses YAML::Syck::Load instead of YAML::Load

       It's up to you to make sure you have YAML::Syck if you specify the "-Syck" option, since
       it's an optional prerequisite to this module.  If it's requested but not found, a warning
       will be issued and YAML will be used instead.

       As of version 0.04, you can use any module you want in the same way; "-Tiny" for
       YAML::Tiny and "-XS" for YAML::XS.

EXPORT

       •   yaml_string_ok

       •   yaml_file_ok

       •   yaml_files_ok

FUNCTIONS

   yaml_string_ok($yaml, [$message])
       Test will pass if $yaml contains valid YAML (according to YAML.pm) and fail otherwise.
       Returns the result of loading the YAML.

   yaml_file_ok($filename, [$message])
       Test will pass if $filename is a valid YAML file (according to YAML.pm) and fail
       otherwise.  Returns the result of loading the YAML.

   yaml_files_ok($file_glob_string, [$message])
       Test will pass if all files matching the glob $file_glob_string contain valid YAML.  If a
       file is not valid, the test will fail and no further files will be examined.

       Returns a list of all loaded YAML;

AUTHOR

       Jonathan Rockway, "<jrockway at cpan.org>"

BUGS

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

SUPPORT

       You can find documentation for this module with the perldoc command.

           perldoc Test::YAML::Valid

       You can also look for information at:

       •   AnnoCPAN: Annotated CPAN documentation

           <http://annocpan.org/dist/Test-YAML-Valid>

       •   CPAN Ratings

           <http://cpanratings.perl.org/d/Test-YAML-Valid>

       •   RT: CPAN's request tracker

           <http://rt.cpan.org/NoAuth/Bugs.html?Dist=Test-YAML-Valid>

       •   Search CPAN

           <http://search.cpan.org/dist/Test-YAML-Valid>

ACKNOWLEDGEMENTS

       Stevan Little "<stevan.little@iinteractive.com>" contributed "yaml_files_ok" and some more
       tests.

COPYRIGHT & LICENSE

       Copyright 2007 Jonathan Rockway, all rights reserved.

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