Add more POD

[gruntmaster-daemon.git] / lib / Gruntmaster / Daemon / Runner / Interactive.pm

diff --git a/lib/Gruntmaster/Daemon/Runner/Interactive.pm b/lib/Gruntmaster/Daemon/Runner/Interactive.pm
index 5edee04ea2055f533e92d53a3754bf4b98ffe6d5..aea381a4bdfab70f76c33a11b3ea9ee98c077840 100644 (file)
--- a/lib/Gruntmaster/Daemon/Runner/Interactive.pm
+++ b/lib/Gruntmaster/Daemon/Runner/Interactive.pm
@@ -10,18 +10,21 @@ use Log::Log4perl qw/get_logger/;
 use POSIX qw/mkfifo/;
 use Try::Tiny;
 
+our $VERSION = '5999.000_001';
+
 ##################################################
 
 sub run{
   my ($test, $meta) = @_;
   get_logger->trace("Running on test $test...");
-  my $ret = fork // get_logger->logdie("Fork failed: $!");
 
   mkfifo 'fifo1', 0600 or die $! unless -e 'fifo1';
   mkfifo 'fifo2', 0600 or die $! unless -e 'fifo2';
+
+  my $ret = fork // get_logger->logdie("Fork failed: $!");
   if ($ret) {
        $meta->{files}{prog}{run}->($meta->{files}{prog}{name}, fds => [qw/0 fifo1 1 >fifo2/], map {defined $meta->{$_} ? ($_ => $meta->{$_}) : () } qw/timeout mlimit/);
-       wait;
+       waitpid $ret, 0;
        die [WA, "Wrong Answer"] if $?;
   } else {
        try {
@@ -37,3 +40,36 @@ sub run{
 
 1;
 __END__
+
+=encoding utf-8
+
+=head1 NAME
+
+Gruntmaster::Daemon::Runner::Interactive - Make an interactive verifier talk to the program
+
+=head1 SYNOPSIS
+
+  use Gruntmaster::Daemon::Runner::Interactive;
+  Gruntmaster::Daemon::Runner::Interactive->run(5, $meta);
+
+=head1 DESCRIPTION
+
+B<WARNING: This runner is experimental!>
+
+Gruntmaster::Daemon::Runner::Interactive is a runner which runs the program and an interactive verifier in parallel, connecting each program's STDIN to the other's STDOUT. The verifier, C<< $meta->{files}{int} >>, should return nonzero if the program gives an incorrect answer, and print the test score to fd 4 then return 0 if the answer is correct.
+
+=head1 AUTHOR
+
+Marius Gavrilescu E<lt>marius@ieval.roE<gt>
+
+=head1 COPYRIGHT AND LICENSE
+
+Copyright (C) 2014 by Marius Gavrilescu
+
+This library is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+
+=cut