| line |
stmt |
bran |
cond |
sub |
pod |
time |
code |
|
1
|
|
|
|
|
|
|
package Test::HTML::Lint; |
|
2
|
|
|
|
|
|
|
|
|
3
|
6
|
|
|
6
|
|
113200
|
use warnings; |
|
|
6
|
|
|
|
|
27
|
|
|
|
6
|
|
|
|
|
163
|
|
|
4
|
6
|
|
|
6
|
|
24
|
use strict; |
|
|
6
|
|
|
|
|
10
|
|
|
|
6
|
|
|
|
|
107
|
|
|
5
|
|
|
|
|
|
|
|
|
6
|
6
|
|
|
6
|
|
2305
|
use Test::Builder; |
|
|
6
|
|
|
|
|
48042
|
|
|
|
6
|
|
|
|
|
124
|
|
|
7
|
6
|
|
|
6
|
|
24
|
use Exporter; |
|
|
6
|
|
|
|
|
9
|
|
|
|
6
|
|
|
|
|
189
|
|
|
8
|
|
|
|
|
|
|
|
|
9
|
6
|
|
|
6
|
|
1205
|
use HTML::Lint; |
|
|
6
|
|
|
|
|
15
|
|
|
|
6
|
|
|
|
|
161
|
|
|
10
|
|
|
|
|
|
|
|
|
11
|
6
|
|
|
6
|
|
31
|
use vars qw( @ISA $VERSION @EXPORT ); |
|
|
6
|
|
|
|
|
9
|
|
|
|
6
|
|
|
|
|
2684
|
|
|
12
|
|
|
|
|
|
|
|
|
13
|
|
|
|
|
|
|
@ISA = qw( HTML::Parser Exporter ); |
|
14
|
|
|
|
|
|
|
|
|
15
|
|
|
|
|
|
|
=head1 NAME |
|
16
|
|
|
|
|
|
|
|
|
17
|
|
|
|
|
|
|
Test::HTML::Lint - Test::More-style wrapper around HTML::Lint |
|
18
|
|
|
|
|
|
|
|
|
19
|
|
|
|
|
|
|
=head1 VERSION |
|
20
|
|
|
|
|
|
|
|
|
21
|
|
|
|
|
|
|
Version 2.30 |
|
22
|
|
|
|
|
|
|
|
|
23
|
|
|
|
|
|
|
=cut |
|
24
|
|
|
|
|
|
|
|
|
25
|
|
|
|
|
|
|
$VERSION = '2.30'; |
|
26
|
|
|
|
|
|
|
|
|
27
|
|
|
|
|
|
|
my $Tester = Test::Builder->new; |
|
28
|
|
|
|
|
|
|
|
|
29
|
|
|
|
|
|
|
=head1 SYNOPSIS |
|
30
|
|
|
|
|
|
|
|
|
31
|
|
|
|
|
|
|
use Test::HTML::Lint tests => 4; |
|
32
|
|
|
|
|
|
|
|
|
33
|
|
|
|
|
|
|
my $table = build_display_table(); |
|
34
|
|
|
|
|
|
|
html_ok( $table, 'Built display table properly' ); |
|
35
|
|
|
|
|
|
|
|
|
36
|
|
|
|
|
|
|
=head1 DESCRIPTION |
|
37
|
|
|
|
|
|
|
|
|
38
|
|
|
|
|
|
|
This module provides a few convenience methods for testing exception |
|
39
|
|
|
|
|
|
|
based code. It is built with L and plays happily with |
|
40
|
|
|
|
|
|
|
L and friends. |
|
41
|
|
|
|
|
|
|
|
|
42
|
|
|
|
|
|
|
If you are not already familiar with L now would be the time |
|
43
|
|
|
|
|
|
|
to go take a look. |
|
44
|
|
|
|
|
|
|
|
|
45
|
|
|
|
|
|
|
=head1 EXPORT |
|
46
|
|
|
|
|
|
|
|
|
47
|
|
|
|
|
|
|
C |
|
48
|
|
|
|
|
|
|
|
|
49
|
|
|
|
|
|
|
=cut |
|
50
|
|
|
|
|
|
|
|
|
51
|
|
|
|
|
|
|
@EXPORT = qw( |
|
52
|
|
|
|
|
|
|
html_ok |
|
53
|
|
|
|
|
|
|
html_fragment_ok |
|
54
|
|
|
|
|
|
|
); |
|
55
|
|
|
|
|
|
|
|
|
56
|
|
|
|
|
|
|
sub import { |
|
57
|
6
|
|
|
6
|
|
40
|
my $self = shift; |
|
58
|
6
|
|
|
|
|
12
|
my $pack = caller; |
|
59
|
|
|
|
|
|
|
|
|
60
|
6
|
|
|
|
|
22
|
$Tester->exported_to($pack); |
|
61
|
6
|
|
|
|
|
67
|
$Tester->plan(@_); |
|
62
|
|
|
|
|
|
|
|
|
63
|
6
|
|
|
|
|
1124
|
$self->export_to_level(1, $self, @EXPORT); |
|
64
|
|
|
|
|
|
|
|
|
65
|
6
|
|
|
|
|
6540
|
return; |
|
66
|
|
|
|
|
|
|
} |
|
67
|
|
|
|
|
|
|
|
|
68
|
|
|
|
|
|
|
=head2 html_ok( [$lint, ] $html, $name ) |
|
69
|
|
|
|
|
|
|
|
|
70
|
|
|
|
|
|
|
Checks to see if C<$html> is a valid HTML document, including checks |
|
71
|
|
|
|
|
|
|
for having C<< >>, C<< >>, C<< > >> and |
|
72
|
|
|
|
|
|
|
C<< >> tags. |
|
73
|
|
|
|
|
|
|
|
|
74
|
|
|
|
|
|
|
If you're checking something that is only a fragment of an HTML document, |
|
75
|
|
|
|
|
|
|
use C. |
|
76
|
|
|
|
|
|
|
|
|
77
|
|
|
|
|
|
|
If you pass an HTML::Lint object, C will use that for its |
|
78
|
|
|
|
|
|
|
settings. |
|
79
|
|
|
|
|
|
|
|
|
80
|
|
|
|
|
|
|
my $lint = new HTML::Lint( only_types => STRUCTURE ); |
|
81
|
|
|
|
|
|
|
html_ok( $lint, $content, "Web page passes structural tests only" ); |
|
82
|
|
|
|
|
|
|
|
|
83
|
|
|
|
|
|
|
Otherwise, it will use the default rules. |
|
84
|
|
|
|
|
|
|
|
|
85
|
|
|
|
|
|
|
html_ok( $content, "Web page passes ALL tests" ); |
|
86
|
|
|
|
|
|
|
|
|
87
|
|
|
|
|
|
|
Note that if you pass in your own HTML::Lint object, C |
|
88
|
|
|
|
|
|
|
will clear its errors before using it. |
|
89
|
|
|
|
|
|
|
|
|
90
|
|
|
|
|
|
|
=cut |
|
91
|
|
|
|
|
|
|
|
|
92
|
|
|
|
|
|
|
sub html_ok { |
|
93
|
6
|
|
|
6
|
1
|
3787
|
my $lint; |
|
94
|
|
|
|
|
|
|
|
|
95
|
6
|
100
|
|
|
|
19
|
if ( ref($_[0]) eq 'HTML::Lint' ) { |
|
96
|
1
|
|
|
|
|
2
|
$lint = shift; |
|
97
|
1
|
|
|
|
|
4
|
$lint->newfile(); |
|
98
|
1
|
|
|
|
|
3
|
$lint->clear_errors(); |
|
99
|
|
|
|
|
|
|
} |
|
100
|
|
|
|
|
|
|
else { |
|
101
|
5
|
|
|
|
|
26
|
$lint = HTML::Lint->new; |
|
102
|
|
|
|
|
|
|
} |
|
103
|
6
|
|
|
|
|
11
|
my $html = shift; |
|
104
|
6
|
|
|
|
|
10
|
my $name = shift; |
|
105
|
|
|
|
|
|
|
|
|
106
|
6
|
|
|
|
|
10
|
my $ok = defined $html; |
|
107
|
6
|
100
|
|
|
|
15
|
if ( !$ok ) { |
|
108
|
1
|
|
|
|
|
5
|
$Tester->ok( 0, $name ); |
|
109
|
|
|
|
|
|
|
} |
|
110
|
|
|
|
|
|
|
else { |
|
111
|
5
|
|
|
|
|
18
|
$lint->parse( $html ); |
|
112
|
5
|
|
|
|
|
17
|
$lint->eof(); |
|
113
|
5
|
|
|
|
|
17
|
my $nerr = scalar $lint->errors; |
|
114
|
5
|
|
|
|
|
10
|
$ok = !$nerr; |
|
115
|
5
|
|
|
|
|
22
|
$Tester->ok( $ok, $name ); |
|
116
|
5
|
100
|
|
|
|
2725
|
if ( !$ok ) { |
|
117
|
2
|
|
|
|
|
3
|
my $msg = 'Errors:'; |
|
118
|
2
|
50
|
|
|
|
5
|
$msg .= " $name" if $name; |
|
119
|
2
|
|
|
|
|
5
|
$Tester->diag( $msg ); |
|
120
|
2
|
|
|
|
|
421
|
$Tester->diag( $_->as_string ) for $lint->errors; |
|
121
|
|
|
|
|
|
|
} |
|
122
|
|
|
|
|
|
|
} |
|
123
|
|
|
|
|
|
|
|
|
124
|
6
|
|
|
|
|
1805
|
return $ok; |
|
125
|
|
|
|
|
|
|
} |
|
126
|
|
|
|
|
|
|
|
|
127
|
|
|
|
|
|
|
|
|
128
|
|
|
|
|
|
|
=head2 html_fragment_ok( [$lint, ] $html, $name ) |
|
129
|
|
|
|
|
|
|
|
|
130
|
|
|
|
|
|
|
Checks that C<$fragment> is valid HTML, but not necessarily a valid |
|
131
|
|
|
|
|
|
|
HTML document. |
|
132
|
|
|
|
|
|
|
|
|
133
|
|
|
|
|
|
|
For example, this is a valid fragment, but not a valid HTML document: |
|
134
|
|
|
|
|
|
|
|
|
135
|
|
|
|
|
|
|
|
|
136
|
|
|
|
|
|
|
Lorem ipsum |
|
137
|
|
|
|
|
|
|
|
|
138
|
|
|
|
|
|
|
|
|
139
|
|
|
|
|
|
|
because it doesn't contain C<< >> and C<< >> tags. If you |
|
140
|
|
|
|
|
|
|
want to check that it is a valid document, use C. |
|
141
|
|
|
|
|
|
|
|
|
142
|
|
|
|
|
|
|
If you pass an HTML::Lint object, C will use that for its |
|
143
|
|
|
|
|
|
|
settings. |
|
144
|
|
|
|
|
|
|
|
|
145
|
|
|
|
|
|
|
my $lint = new HTML::Lint( only_types => STRUCTURE ); |
|
146
|
|
|
|
|
|
|
html_fragment_ok( $lint, $content, 'Web page passes structural tests only' ); |
|
147
|
|
|
|
|
|
|
|
|
148
|
|
|
|
|
|
|
Otherwise, it will use the default rules. |
|
149
|
|
|
|
|
|
|
|
|
150
|
|
|
|
|
|
|
html_fragment_ok( $content, 'Fragment passes ALL tests' ); |
|
151
|
|
|
|
|
|
|
|
|
152
|
|
|
|
|
|
|
Note that if you pass in your own HTML::Lint object, C |
|
153
|
|
|
|
|
|
|
will clear its errors before using it. |
|
154
|
|
|
|
|
|
|
|
|
155
|
|
|
|
|
|
|
=cut |
|
156
|
|
|
|
|
|
|
|
|
157
|
|
|
|
|
|
|
sub html_fragment_ok { |
|
158
|
2
|
|
|
2
|
1
|
4094
|
my $lint; |
|
159
|
|
|
|
|
|
|
|
|
160
|
2
|
50
|
|
|
|
5
|
if ( ref($_[0]) eq 'HTML::Lint' ) { |
|
161
|
0
|
|
|
|
|
0
|
$lint = shift; |
|
162
|
0
|
|
|
|
|
0
|
$lint->newfile(); |
|
163
|
0
|
|
|
|
|
0
|
$lint->clear_errors(); |
|
164
|
|
|
|
|
|
|
} |
|
165
|
|
|
|
|
|
|
else { |
|
166
|
2
|
|
|
|
|
6
|
$lint = HTML::Lint->new; |
|
167
|
|
|
|
|
|
|
} |
|
168
|
2
|
|
|
|
|
3
|
my $html = shift; |
|
169
|
2
|
|
|
|
|
4
|
my $name = shift; |
|
170
|
|
|
|
|
|
|
|
|
171
|
2
|
|
|
|
|
3
|
my $ok = defined $html; |
|
172
|
2
|
50
|
|
|
|
4
|
if ( !$ok ) { |
|
173
|
0
|
|
|
|
|
0
|
$Tester->ok( 0, $name ); |
|
174
|
|
|
|
|
|
|
} |
|
175
|
|
|
|
|
|
|
else { |
|
176
|
2
|
|
|
|
|
5
|
$lint->parse( $html ); |
|
177
|
2
|
|
|
|
|
5
|
$lint->eof(); |
|
178
|
|
|
|
|
|
|
|
|
179
|
|
|
|
|
|
|
# Ignore doc-level errors. |
|
180
|
2
|
|
|
|
|
5
|
my @errors = grep { $_->errcode ne 'doc-tag-required' } $lint->errors; |
|
|
10
|
|
|
|
|
14
|
|
|
181
|
|
|
|
|
|
|
|
|
182
|
2
|
|
|
|
|
4
|
my $nerr = @errors; |
|
183
|
2
|
|
|
|
|
4
|
$ok = !$nerr; |
|
184
|
2
|
|
|
|
|
6
|
$Tester->ok( $ok, $name ); |
|
185
|
2
|
100
|
|
|
|
954
|
if ( !$ok ) { |
|
186
|
1
|
|
|
|
|
2
|
my $msg = 'Errors:'; |
|
187
|
1
|
50
|
|
|
|
4
|
$msg .= " $name" if $name; |
|
188
|
1
|
|
|
|
|
3
|
$Tester->diag( $msg ); |
|
189
|
1
|
|
|
|
|
186
|
$Tester->diag( $_->as_string ) for @errors; |
|
190
|
|
|
|
|
|
|
} |
|
191
|
|
|
|
|
|
|
} |
|
192
|
|
|
|
|
|
|
|
|
193
|
2
|
|
|
|
|
192
|
return $ok; |
|
194
|
|
|
|
|
|
|
} |
|
195
|
|
|
|
|
|
|
|
|
196
|
|
|
|
|
|
|
|
|
197
|
|
|
|
|
|
|
=head1 BUGS |
|
198
|
|
|
|
|
|
|
|
|
199
|
|
|
|
|
|
|
All bugs and requests are now being handled through GitHub. |
|
200
|
|
|
|
|
|
|
|
|
201
|
|
|
|
|
|
|
https://github.com/petdance/html-lint/issues |
|
202
|
|
|
|
|
|
|
|
|
203
|
|
|
|
|
|
|
DO NOT send bug reports to http://rt.cpan.org/. |
|
204
|
|
|
|
|
|
|
|
|
205
|
|
|
|
|
|
|
|
|
206
|
|
|
|
|
|
|
=head1 TO DO |
|
207
|
|
|
|
|
|
|
|
|
208
|
|
|
|
|
|
|
There needs to be a C to check that the HTML is a |
|
209
|
|
|
|
|
|
|
self-contained, well-formed table, and then a comparable one for |
|
210
|
|
|
|
|
|
|
C. |
|
211
|
|
|
|
|
|
|
|
|
212
|
|
|
|
|
|
|
If you think this module should do something that it doesn't do at the |
|
213
|
|
|
|
|
|
|
moment please let me know. |
|
214
|
|
|
|
|
|
|
|
|
215
|
|
|
|
|
|
|
=head1 ACKNOWLEDGEMENTS |
|
216
|
|
|
|
|
|
|
|
|
217
|
|
|
|
|
|
|
Thanks to chromatic and Michael G Schwern for the excellent Test::Builder, |
|
218
|
|
|
|
|
|
|
without which this module wouldn't be possible. |
|
219
|
|
|
|
|
|
|
|
|
220
|
|
|
|
|
|
|
Thanks to Adrian Howard for writing Test::Exception, from which most of |
|
221
|
|
|
|
|
|
|
this module is taken. |
|
222
|
|
|
|
|
|
|
|
|
223
|
|
|
|
|
|
|
=head1 COPYRIGHT & LICENSE |
|
224
|
|
|
|
|
|
|
|
|
225
|
|
|
|
|
|
|
Copyright 2005-2018 Andy Lester. |
|
226
|
|
|
|
|
|
|
|
|
227
|
|
|
|
|
|
|
This program is free software; you can redistribute it and/or modify |
|
228
|
|
|
|
|
|
|
it under the terms of the Artistic License v2.0. |
|
229
|
|
|
|
|
|
|
|
|
230
|
|
|
|
|
|
|
http://www.opensource.org/licenses/Artistic-2.0 |
|
231
|
|
|
|
|
|
|
|
|
232
|
|
|
|
|
|
|
Please note that these modules are not products of or supported by the |
|
233
|
|
|
|
|
|
|
employers of the various contributors to the code. |
|
234
|
|
|
|
|
|
|
|
|
235
|
|
|
|
|
|
|
=head1 AUTHOR |
|
236
|
|
|
|
|
|
|
|
|
237
|
|
|
|
|
|
|
Andy Lester, C |
|
238
|
|
|
|
|
|
|
|
|
239
|
|
|
|
|
|
|
=cut |
|
240
|
|
|
|
|
|
|
|
|
241
|
|
|
|
|
|
|
1; |