summaryrefslogtreecommitdiffstats
path: root/gnu/usr.bin/perl/cpan/podlators/t/text/invalid.t
blob: 27a4e820fa723fd7ee5511dd635bc3200b2577a7 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
#!/usr/bin/perl -w
#
# Test Pod::Text with a document that produces only errors.
#
# Documents with only errors were shown as contentless but had a POD ERRORS
# section, which previously led to internal errors because state variables
# weren't properly initialized.  See CPAN RT #88724.
#
# Copyright 2013, 2018, 2020 Russ Allbery <rra@cpan.org>
#
# This program is free software; you may redistribute it and/or modify it
# under the same terms as Perl itself.
#
# SPDX-License-Identifier: GPL-1.0-or-later OR Artistic-1.0-Perl

use 5.008;
use strict;
use warnings;

use Test::More tests => 8;

BEGIN {
    use_ok('Pod::Text');
}

# Set up Pod::Text to output to a string.
my $parser = Pod::Text->new;
isa_ok($parser, 'Pod::Text');
my $output;
$parser->output_string(\$output);

# Ensure any warnings cause a test failure.
## no critic (ErrorHandling::RequireCarping)
local $SIG{__WARN__} = sub { die $_[0] };

# Parse a document provided as a string, ensure that it doesn't produce any
# warnings or errors, and check that it either contains no content or a POD
# ERRORS section.
#
# $document - Document to parse
# $name     - Name of the test
sub check_document {
    my ($document, $name) = @_;
    my $result = eval { $parser->parse_string_document($document) };
    ok($result, "Parsed $name");
    is($@, q{}, 'No exceptions');
    if ($output eq q{}) {
        # Older Pod::Simple doesn't always produce errors.
        ok(1, 'Output is empty');
    } else {
        like($output, qr{POD [ ] ERRORS}xms, 'Output contains POD ERRORS');
    }
    return;
}

# Document whose only content is an invalid command.
## no critic (ValuesAndExpressions::ProhibitEscapedCharacters)
check_document("=\xa0", 'invalid command');

# Document containing only a =cut.
check_document('=cut', 'document with only =cut');