add testcases/complete-run.pl, a script for conveniently running the testsuite (or parts of it)

testcases/complete-run.pl

@@ -0,0 +1,56 @@
+#!/usr/bin/env perl
+# vim:ts=4:sw=4:expandtab
+
+use strict;
+use warnings;
+use v5.10;
+use DateTime;
+use Data::Dumper;
+use Cwd qw(abs_path getcwd);
+use Proc::Background;
+use TAP::Harness;
+use TAP::Parser::Aggregator;
+use File::Basename qw(basename);
+
+my $i3cmd = "export DISPLAY=:0; exec " . abs_path("../i3") . " -V -d all -c " . abs_path("../i3.config");
+
+# 1: get a list of all testcases
+my $curdir = getcwd();
+my @testfiles = @ARGV;
+
+# if no files were passed on command line, run all tests
+if (@testfiles == 0) {
+    chdir "t";
+    push @testfiles, "t/$_" while (<*.t>);
+    chdir $curdir;
+}
+
+# 2: create an output directory for this test-run
+my $outdir = "testsuite-";
+$outdir .= DateTime->now->strftime("%Y-%m-%d-%H-%M-%S-");
+$outdir .= `git describe --tags`;
+chomp($outdir);
+mkdir($outdir) or die "Could not create $outdir";
+unlink("latest") if -e "latest";
+symlink("$outdir", "latest") or die "Could not symlink latest to $outdir";
+
+# 3: run all tests
+my $harness = TAP::Harness->new({
+    verbosity => 1,
+    lib => [ 't/lib' ]
+});
+my $aggregator = TAP::Parser::Aggregator->new();
+$aggregator->start();
+for my $t (@testfiles) {
+    my $logpath = "$outdir/i3-log-for-" . basename($t);
+    my $cmd = "$i3cmd >$logpath 2>&1";
+
+    my $process = Proc::Background->new($cmd);
+    say "testing $t with logfile $logpath";
+    $harness->aggregate_tests($aggregator, [ $t ]);
+    kill(9, $process->pid) or die "could not kill i3";
+}
+$aggregator->stop();
+
+# 4: print summary
+$harness->summary($aggregator);