Test::HTML::Lint(3p)

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

VERSION
Version 2.06

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
"html_ok"

  html_ok( [$lint, ] $html, $name )
Checks to see that $html contains valid HTML.

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

If you pass an HTML::Lint object, "html_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, "html_ok()" will clear its errors before using it.

BUGS
All bugs and requests are now being handled through the Google Code issue tracker at http://code.google.com/p/html-lint/issues/list. DO NOT send bug reports to http://rt.cpan.org/

TO DO
There needs to be a "html_table_ok()" to check that the HTML is a self-contained, well-formed table, and then a comparable one for "html_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-2008 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, "andy@petdance.com"