-
-
22 Jun 2018 21:20:42 UTC
- Distribution: HTML-Lint
- Module version: 2.32
- Source (raw)
- Browse (raw)
- Changes
- Homepage
- How to Contribute
- Repository
- Issues (29)
- Testers (2141 / 0 / 0)
- Kwalitee
Bus factor: 1- 96.60% Coverage
- License: artistic_2
- Perl: v5.6.0
- Activity
24 month- Tools
- Download (30.01KB)
- MetaCPAN Explorer
- Permissions
- Subscribe to distribution
- Permalinks
- This version
- Latest version
- Dependencies
- Exporter
- File::Find
- HTML::Entities
- HTML::Parser
- HTML::Tagset
- Test::Builder
- Test::Builder::Tester
- Test::More
- and possibly others
- Reverse dependencies
- CPAN Testers List
- Dependency graph
NAME
Test::HTML::Lint - Test::More-style wrapper around HTML::Lint
VERSION
Version 2.32
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 if
$html
is a valid HTML document, including checks for having<html>
,<head>
,<title>>
and<body>
tags.If you're checking something that is only a fragment of an HTML document, use
html_fragment_ok()
.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.html_fragment_ok( [$lint, ] $html, $name )
Checks that
$fragment
is valid HTML, but not necessarily a valid HTML document.For example, this is a valid fragment, but not a valid HTML document:
<body> <p>Lorem ipsum</p> </body>
because it doesn't contain
<html>
and<head>
tags. If you want to check that it is a valid document, usehtml_ok()
.If you pass an HTML::Lint object,
html_fragment_ok()
will use that for its settings.my $lint = new HTML::Lint( only_types => STRUCTURE ); html_fragment_ok( $lint, $content, 'Web page passes structural tests only' );
Otherwise, it will use the default rules.
html_fragment_ok( $content, 'Fragment passes ALL tests' );
Note that if you pass in your own HTML::Lint object,
html_fragment_ok()
will clear its errors before using it.BUGS
All bugs and requests are now being handled through GitHub.
https://github.com/petdance/html-lint/issues
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 forhtml_page_ok()
.If you think this module should do something that it doesn't do at the moment please let me know.
ACKNOWLEDGEMENTS
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.
COPYRIGHT & LICENSE
Copyright 2005-2018 Andy Lester.
This program is free software; you can redistribute it and/or modify it under the terms of the Artistic License v2.0.
http://www.opensource.org/licenses/Artistic-2.0
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
Module Install Instructions
To install HTML::Lint, copy and paste the appropriate command in to your terminal.
cpanm HTML::Lint
perl -MCPAN -e shell install HTML::Lint
For more information on module installation, please visit the detailed CPAN module installation guide.