man Test::HTML::Lint () - Test::More-style wrapper around HTML::Lint

NAME

Test::HTML::Lint - Test::More-style wrapper around HTML::Lint

VERSION

Version 2.00

SYNOPSIS

    use Test::HTML::Lint tests => 4;

    my $table = build_display_table();
    html_ok( $table, 'Built display table properly' );

DESCRIPTION

This module provides a few convenience methods for testing exception based code. It is built with Test::Builder and plays happily with Test::More and friends.

If you are not already familiar with Test::More now would be the time to go take a look.

EXPORT

CWhtml_ok Checks to see that CW$html contains valid HTML.

Checks to see if CW$html contains valid HTML. CW$html being blank is OK. CW$html being undef is not.

If you pass an HTML::Lint object, CWhtml_ok() will use that for its settings.

    my $lint = new HTML::Lint( only_types => STRUCTURE );
    html_ok( $lint, $content, "Web page passes structural tests only" );

Otherwise, it will use the default rules.

    html_ok( $content, "Web page passes ALL tests" );

Note that if you pass in your own HTML::Lint object, CWhtml_ok() will clear its errors before using it.

BUGS

Please report any bugs or feature requests to CWbug-html-lint@rt.cpan.org, or through the web interface at <http://rt.cpan.org>. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

TO DO

There needs to be a CWhtml_table_ok() to check that the HTML is a self-contained, well-formed table, and then a comparable one for CWhtml_page_ok().

If you think this module should do something that it doesn't do at the moment please let me know.

ACKNOWLEGEMENTS

Thanks to chromatic and Michael G Schwern for the excellent Test::Builder, without which this module wouldn't be possible.

Thanks to Adrian Howard for writing Test::Exception, from which most of this module is taken.

LICENSE

Copyright 2003 Andy Lester, All Rights Reserved.

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

Please note that these modules are not products of or supported by the employers of the various contributors to the code.

AUTHOR

Andy Lester, CWandy@petdance.com