1#!perl
2
3=head1 NAME
4
5copyright.t
6
7=head1 DESCRIPTION
8
9Tests that the latest copyright years in the top-level README file and the
10C<perl -v> output match each other.
11
12If the test fails, update at least one of README and perl.c so that they match
13reality.
14
15Optionally you can pass the C<--now> option to check they are at the current
16year. This isn't checked by default, so that it doesn't fail for people
17working on older releases. It should be run before making a new release.
18
19=cut
20
21use strict;
22use Config;
23BEGIN { require './test.pl' }
24
25if ( $Config{usecrosscompile} ) {
26  skip_all( "Not all files are available during cross-compilation" );
27}
28
29my ($opt) = @ARGV;
30
31my $readme_year = readme_year();
32my $v_year = v_year();
33
34# Check that both copyright dates are up-to-date, but only if requested, so
35# that tests still pass for people intentionally working on older versions:
36if ($opt eq '--now')
37{
38  my $current_year = (gmtime)[5] + 1900;
39  is $v_year, $current_year, 'perl -v copyright includes current year';
40  is $readme_year, $current_year, 'README copyright includes current year';
41}
42
43# Otherwise simply check that the two copyright dates match each other:
44else
45{
46  is $readme_year, $v_year, 'README and perl -v copyright dates match';
47}
48
49done_testing;
50
51
52sub readme_year
53# returns the latest copyright year from the top-level README file
54{
55
56  open my $readme, '<', '../README' or die "Opening README failed: $!";
57
58  # The copyright message is the first paragraph:
59  local $/ = '';
60  my $copyright_msg = <$readme>;
61
62  my ($year) = $copyright_msg =~ /.*\b(\d{4,})/s
63      or die "Year not found in README copyright message '$copyright_msg'";
64
65  $year;
66}
67
68
69sub v_year
70# returns the latest copyright year shown in perl -v
71{
72
73  my $output = runperl switches => ['-v'];
74  my ($year) = $output =~ /copyright 1987.*\b(\d{4,})/i
75      or die "Copyright statement not found in perl -v output '$output'";
76
77  $year;
78}
79