t/harness

   1 #!./perl
   2
   3 # We suppose that perl _mostly_ works at this moment, so may use
   4 # sophisticated testing.
   5
   6 BEGIN {
   7     chdir 't' if -d 't';
   8     @INC = '../lib';              # pick up only this build's lib
   9 }
  10 delete $ENV{PERL5LIB};
  11
  12 my $torture; # torture testing?
  13
  14 use TAP::Harness 3.13;
  15 use strict;
  16
  17 my $Verbose = 0;
  18 $Verbose++ while @ARGV && $ARGV[0] eq '-v' && shift;
  19
  20 if ($ARGV[0] && $ARGV[0] eq '-torture') {
  21     shift;
  22     $torture = 1;
  23 }
  24
  25 # Let tests know they're running in the perl core.  Useful for modules
  26 # which live dual lives on CPAN.
  27 $ENV{PERL_CORE} = 1;
  28
  29 #fudge DATA for now.
  30 my %datahandle = qw(
  31                 lib/bigint.t            1
  32                 lib/bigintpm.t          1
  33                 lib/bigfloat.t          1
  34                 lib/bigfloatpm.t        1
  35                 op/gv.t                 1
  36                 lib/complex.t           1
  37                 lib/ph.t                1
  38                 lib/soundex.t           1
  39                 op/misc.t               1
  40                 op/runlevel.t           1
  41                 op/tie.t                1
  42                 op/lex_assign.t         1
  43                 );
  44
  45 foreach (keys %datahandle) {
  46      unlink "$_.t";
  47 }
  48
  49 my (@tests, $re);
  50
  51 # [.VMS]TEST.COM calls harness with empty arguments, so clean-up @ARGV
  52 @ARGV = grep $_ && length( $_ ) => @ARGV;
  53
  54 sub _populate_hash {
  55     return map {$_, 1} split /\s+/, $_[0];
  56 }
  57
  58 sub _extract_tests;
  59 sub _extract_tests {
  60     # This can probably be done more tersely with a map, but I doubt that it
  61     # would be as clear
  62     my @results;
  63     foreach (@_) {
  64         my $ref = ref $_;
  65         if ($ref) {
  66             if ($ref eq 'ARRAY') {
  67                 push @results, _extract_tests @$_;
  68             } elsif ($ref eq 'HASH') {
  69                 push @results, _extract_tests values %$_;
  70             } else {
  71                 die "Unknown reference type $ref";
  72             }
  73         } else {
  74             push @results, glob $_;
  75         }
  76     }
  77     @results;
  78 }
  79
  80 if ($ARGV[0] && $ARGV[0]=~/^-re/) {
  81     if ($ARGV[0]!~/=/) {
  82         shift;
  83         $re=join "|",@ARGV;
  84         @ARGV=();
  85     } else {
  86         (undef,$re)=split/=/,shift;
  87     }
  88 }
  89
  90 my $jobs = $ENV{TEST_JOBS};
  91 my ($rules, $state, $color);
  92 if ($ENV{HARNESS_OPTIONS}) {
  93     for my $opt ( split /:/, $ENV{HARNESS_OPTIONS} ) {
  94         if ( $opt =~ /^j(\d*)$/ ) {
  95             $jobs ||= $1 || 9;
  96         }
  97         elsif ( $opt eq 'c' ) {
  98             $color = 1;
  99         }
 100         else {
 101             die "Unknown HARNESS_OPTIONS item: $opt\n";
 102         }
 103     }
 104 }
 105
 106 sub _tests_from_manifest {
 107     my ($extensions, $known_extensions) = @_;
 108     my %skip;
 109     my %extensions = _populate_hash($extensions);
 110     my %known_extensions = _populate_hash($known_extensions);
 111
 112     foreach (keys %known_extensions) {
 113         $skip{$_}++ unless $extensions{$_};
 114     }
 115
 116     my @results;
 117     my $mani  = '../MANIFEST';
 118     if (open(MANI, $mani)) {
 119         while (<MANI>) { # similar code in t/TEST
 120             if (m!^(ext/(\S+)/+(?:[^/\s]+\.t|test\.pl)|lib/\S+?(?:\.t|test\.pl))\s!) {
 121                 my ($test, $extension) = ($1, $2);
 122                 if (defined $extension) {
 123                     $extension =~ s!/t$!!;
 124                     # XXX Do I want to warn that I'm skipping these?
 125                     next if $skip{$extension};
 126                     my $flat_extension = $extension;
 127                     $flat_extension =~ s!-!/!g;
 128                     next if $skip{$flat_extension}; # Foo/Bar may live in Foo-Bar
 129                 }
 130                 push @results, "../$test";
 131             }
 132         }
 133         close MANI;
 134     } else {
 135         warn "$0: cannot open $mani: $!\n";
 136     }
 137     return @results;
 138 }
 139
 140 if (@ARGV) {
 141     # If you want these run in speed order, just use prove
 142     if ($^O eq 'MSWin32') {
 143         @tests = map(glob($_),@ARGV);
 144     }
 145     else {
 146         @tests = @ARGV;
 147     }
 148 } else {
 149     # Ideally we'd get somewhere close to Tux's Oslo rules
 150     # my $rules = {
 151     #     par => [
 152     #         { seq => '../ext/DB_File/t/*' },
 153     #         { seq => '../ext/IO_Compress_Zlib/t/*' },
 154     #         { seq => '../lib/CPANPLUS/*' },
 155     #         { seq => '../lib/ExtUtils/t/*' },
 156     #         '*'
 157     #     ]
 158     # };
 159
 160     # but for now, run all directories in sequence. In particular, it would be
 161     # nice to get the tests in t/op/*.t able to run in parallel.
 162
 163     unless (@tests) {
 164         my @seq = <base/*.t>;
 165
 166         my @next = qw(comp run cmd io op uni mro lib porting);
 167         push @next, 'japh' if $torture;
 168         push @next, 'win32' if $^O eq 'MSWin32';
 169         push @next, 'benchmark' if $ENV{PERL_BENCHMARK};
 170         # Hopefully TAP::Parser::Scheduler will support this syntax soon.
 171         # my $next = { par => '{' . join (',', @next) . '}/*.t' };
 172         my $next = { par => [
 173                              map { "$_/*.t" } @next
 174                             ] };
 175         @tests = _extract_tests ($next);
 176
 177         # This is a bit of a game, because we only want to sort these tests in
 178         # speed order. base/*.t wants to run first, and ext,lib etc last and in
 179         # MANIFEST order
 180         if ($jobs) {
 181             require App::Prove::State;
 182             $state = App::Prove::State->new({ store => 'test_state' });
 183             $state->apply_switch('slow', 'save');
 184             # For some reason get_tests returns *all* the tests previously run,
 185             # (in the right order), not simply the selection in @tests
 186             # (in the right order). Not sure if this is a bug or a feature.
 187             # Whatever, *we* are only interested in the ones that are in @tests
 188             my %seen;
 189             @seen{@tests} = ();
 190             @tests = grep {exists $seen{$_} } $state->get_tests(0, @tests);
 191         }
 192         @tests = (@seq, @tests);
 193         push @seq, $next;
 194
 195         my @last;
 196         use Config;
 197         push @last,  sort { lc $a cmp lc $b }
 198             _tests_from_manifest($Config{extensions}, $Config{known_extensions});
 199         push @last, <pod/*.t>;
 200         push @last, <x2p/*.t>;
 201
 202         my %times;
 203         if ($state) {
 204             # Where known, collate the elapsed times by test name
 205             foreach ($state->results->tests()) {
 206                 $times{$_->name} = $_->elapsed();
 207             }
 208         }
 209
 210         my %dir;
 211         my %total_time;
 212
 213         for (@last) {
 214             if ($^O eq 'MSWin32') {
 215                 s,\\,/,g; # canonicalize path
 216             };
 217             m!(.*[/])! or die "'$_'";
 218             push @{$dir{$1}}, $_;
 219             $total_time{$1} += $times{$_} || 0;
 220         }
 221
 222         push @tests, @last;
 223
 224         # Generate T::H schedule rules that run the contents of each directory
 225         # sequentially.
 226         push @seq, { par => [ map { { seq => "$_*" } } sort {
 227             # Directories, ordered by total time descending then name ascending
 228             $total_time{$b} <=> $total_time{$a} || $a cmp $b
 229         } keys %dir ] };
 230
 231         $rules = { seq => \@seq };
 232     }
 233 }
 234 if ($^O eq 'MSWin32') {
 235     s,\\,/,g for @tests;
 236 }
 237 @tests=grep /$re/, @tests
 238     if $re;
 239
 240 my $h = TAP::Harness->new({
 241     rules       => $rules,
 242     color       => $color,
 243     jobs        => $jobs,
 244     verbosity   => $Verbose,
 245 });
 246
 247 if ($state) {
 248     $h->callback(
 249                  after_test => sub {
 250                      $state->observe_test(@_);
 251                  }
 252                  );
 253     $h->callback(
 254                  after_runtests => sub {
 255                      $state->commit(@_);
 256                  }
 257                  );
 258 }
 259
 260 $h->callback(
 261              parser_args => sub {
 262                  my ( $args, $test ) = @_;
 263                  push @{ $args->{switches} }, '-I../lib';
 264              }
 265              );
 266 $h->runtests(@tests);
 267 exit(0);