-use utf8;
package Gruntmaster::Data;
+use 5.014;
+use warnings;
-# Created by DBIx::Class::Schema::Loader
-# DO NOT MODIFY THE FIRST PART OF THIS FILE
+use parent qw/Exporter/;
+our $VERSION = '6000.001';
+our @EXPORT = qw/dbinit purge db user_list user_entry problem_list problem_entry contest_list contest_entry contest_has_problem job_list job_entry create_job standings update_status rerun_job rerun_problem take_job finish_job open_problem/;
+our @EXPORT_OK = @EXPORT;
-use strict;
-use warnings;
+use JSON::MaybeXS qw/decode_json/;
+use HTTP::Tiny;
+use PerlX::Maybe qw/maybe/;
-use base 'DBIx::Class::Schema';
+use DBI;
+use DBIx::Simple;
+use List::Util qw/sum/;
+use SQL::Abstract;
-__PACKAGE__->load_namespaces;
+use constant PROBLEM_PUBLIC_COLUMNS => [qw/id author writer level name owner private timeout olimit value/];
+use constant JOBS_PER_PAGE => 50;
+my %statements = (
+ user_list_sth => 'SELECT * FROM user_list LIMIT 200',
+ user_entry_sth => 'SELECT * FROM user_data WHERE id = ?',
-# Created by DBIx::Class::Schema::Loader v0.07039 @ 2014-03-05 13:11:39
-# DO NOT MODIFY THIS OR ANYTHING ABOVE! md5sum:dAEmtAexvUaNXLgYz2rNEg
+ problem_status_sth => 'SELECT problem,solved FROM problem_status WHERE owner = ?',
+ contest_status_sth => 'SELECT contest,score,rank FROM contest_status WHERE owner = ?',
-use parent qw/Exporter/;
-our $VERSION = '5999.000_013';
-our @EXPORT = qw/purge/; ## no critic (ProhibitAutomaticExportation)
+ contest_list_sth => 'SELECT * FROM contest_entry',
+ contest_entry_sth => 'SELECT * FROM contest_entry WHERE id = ?',
+ contest_has_problem_sth => 'SELECT EXISTS(SELECT 1 FROM contest_problems WHERE contest = ? AND problem = ?)',
+ opens_sth => 'SELECT problem,owner,time FROM opens WHERE contest = ?',
-use Lingua::EN::Inflect qw/PL_N/;
-use JSON::MaybeXS qw/decode_json/;
-use HTTP::Tiny;
-use PerlX::Maybe qw/maybe/;
-use Sub::Name qw/subname/;
+ problem_entry_sth => 'SELECT ' . (join ',', @{PROBLEM_PUBLIC_COLUMNS()}, 'statement', 'solution') . ' FROM problems WHERE id = ?',
+ limits_sth => 'SELECT format,timeout FROM limits WHERE problem = ?',
+
+ job_entry_sth => 'SELECT * FROM job_entry WHERE id = ?',
+
+ rerun_problem_sth => 'UPDATE jobs SET daemon=NULL,result=-2,result_text=NULL,results=NULL,errors=NULL WHERE problem = ?',
+ rerun_job_sth => 'UPDATE jobs SET daemon=NULL,result=-2,result_text=NULL,results=NULL,errors=NULL WHERE id = ?',
+ take_job_sth => 'UPDATE jobs SET daemon=? WHERE id = (SELECT id FROM jobs WHERE daemon IS NULL LIMIT 1 FOR UPDATE) RETURNING id',
+);
-use constant PROBLEM_PUBLIC_COLUMNS => [qw/id author writer level name owner private statement timeout olimit value/];
-use constant USER_PUBLIC_COLUMNS => [qw/id admin name town university level/];
-use constant JOBS_PER_PAGE => 10;
+our $db;
+sub db () { $db }
-sub dynsub{
- our ($name, $sub) = @_;
- no strict 'refs'; ## no critic (Strict)
- *$name = subname $name => $sub
+sub dbinit {
+ $db = DBIx::Simple->new(@_);
+ $db->keep_statements = 100;
+ $db->dbh->do('SET search_path TO gruntmaster, public');
+};
+
+sub purge;
+
+sub _query {
+ my ($stat, @extra) = @_;
+ $db->query($statements{$stat}, @extra)
}
-BEGIN {
- for my $rs (qw/contest contest_problem job open problem user problem_status contest_status/) {
- my $rsname = ucfirst $rs;
- $rsname =~ s/_([a-z])/\u$1/gs;
- dynsub PL_N($rs) => sub { $_[0]->resultset($rsname) };
- dynsub $rs => sub { $_[0]->resultset($rsname)->find($_[1]) };
+my (%name_cache, %name_cache_time);
+use constant NAME_CACHE_MAX_AGE => 5;
+
+sub _object_name {
+ my ($table, $id) = @_;
+ $name_cache_time{$table} //= 0;
+ if (time - $name_cache_time{$table} > NAME_CACHE_MAX_AGE) {
+ $name_cache_time{$table} = time;
+ $name_cache{$table} = {};
+ $name_cache{$table} = $db->select($table, 'id,name')->map;
}
+
+ $name_cache{$table}{$id}
}
-sub user_list {
- my ($self) = @_;
- my $rs = $self->users->search(undef, {columns => USER_PUBLIC_COLUMNS} );
- my (%solved, %attempted, %contests);
- for my $row ($self->problem_statuses->all) {
- $solved {$row->rawowner}++ if $row->solved;
- $attempted{$row->rawowner}++ unless $row->solved;
+sub _add_names ($) { ## no critic (ProhibitSubroutinePrototypes)
+ my ($el) = @_;
+ return unless defined $el;
+ if (ref $el eq 'ARRAY') {
+ &_add_names ($_) for @$el ## no critic (ProhibitAmpersandSigils)
+ } else {
+ for my $object (qw/contest owner problem/) {
+ my $table = $object eq 'owner' ? 'users' : "${object}s";
+ $el->{"${object}_name"} = _object_name $table, $el->{$object} if defined $el->{$object}
+ }
}
- $contests{$_->rawowner}++ for $self->contest_statuses->all;
-
- [ sort { $b->{solved} <=> $a->{solved} or $b->{attempted} <=> $a->{attempted} } map { ## no critic (ProhibitReverseSort)
- my $id = $_->id;
- +{ $_->get_columns,
- solved => ($solved{$id} // 0),
- attempted => ($attempted{$id} // 0),
- contests => ($contests{$id} // 0) }
- } $rs->all ]
+
+ $el
}
+sub user_list { scalar _query('user_list_sth')->hashes }
+
sub user_entry {
- my ($self, $id) = @_;
- my $user = $self->users->find($id, {columns => USER_PUBLIC_COLUMNS, prefetch => [qw/problem_statuses contest_statuses/]});
- my @problems = map { {problem => $_->get_column('problem'), solved => $_->solved} } $user->problem_statuses->search(undef, {order_by => 'problem'});
- my @contests = map { {contest => $_->contest->id, contest_name => $_->contest->name, rank => $_->rank, score => $_->score} } $user->contest_statuses->search(undef, {prefetch => 'contest', order_by => 'contest.start DESC'});
- +{ $user->get_columns, problems => \@problems, contests => \@contests }
+ my ($id) = @_;
+ my $ret = _query('user_entry_sth', $id)->hash;
+ $ret->{problems} = _add_names _query('problem_status_sth', $id)->hashes;
+ $ret->{contests} = _add_names _query('contest_status_sth', $id)->hashes;
+
+ $ret;
}
sub problem_list {
- my ($self, %args) = @_;
- my $rs = $self->problems->search(undef, {order_by => 'me.name', columns => PROBLEM_PUBLIC_COLUMNS, prefetch => 'owner'});
- $rs = $rs->search({-or => ['contest_problems.contest' => undef, 'contest.stop' => {'<=', time}], 'me.private' => 0}, {join => {'contest_problems' => 'contest'}, distinct => 1}) unless $args{contest} || $args{private};
- $rs = $rs->search({'contest_problems.contest' => $args{contest}}, {join => 'contest_problems'}) if $args{contest};
- $rs = $rs->search({'me.owner' => $args{owner}}) if $args{owner};
- my %params;
- $params{contest} = $args{contest} if $args{contest};
- for ($rs->all) {
- $params{$_->level} //= [];
- push @{$params{$_->level}}, {$_->get_columns, owner_name => $_->owner->name} ;
- }
- \%params
+ my (%args) = @_;
+ my @columns = @{PROBLEM_PUBLIC_COLUMNS()};
+ push @columns, 'solution' if $args{solution};
+ my %where;
+ $where{private} = 0 unless $args{contest} || $args{private};
+ $where{'cp.contest'} = $args{contest} if $args{contest};
+ $where{owner} = $args{owner} if $args{owner};
+
+ my $table = $args{contest} ? 'problems JOIN contest_problems cp ON cp.problem = id' : 'problems';
+ _add_names $db->select(\$table, \@columns, \%where, 'name')->hashes
}
sub problem_entry {
- my ($self, $id, $contest, $user) = @_;
- my $running = $contest && $self->contest($contest)->is_running;
- my $columns = PROBLEM_PUBLIC_COLUMNS;
- push @$columns, 'solution' unless $running;
- my $pb = $self->problems->find($id, {columns => $columns, prefetch => 'owner'});
- my $open;
- $open = $self->opens->find_or_create({
- contest => $contest,
- problem => $id,
- owner => $user,
- time => time,
- }) if $running;
- $contest &&= $self->contest($contest);
- +{
- $pb->get_columns,
- owner_name => $pb->owner->name,
- cansubmit => $running || !$contest,
- $running ? (
- contest_start => $contest->start,
- contest_stop => $contest->stop,
- open_time => $open->time
- ) : (),
+ my ($id, $contest) = @_;
+ $contest = contest_entry ($contest) if $contest;
+ my $ret = _add_names _query(problem_entry_sth => $id)->hash;
+ my $limits = _query(limits_sth => $id)->hashes;
+ $ret->{limits} = $limits if @$limits;
+
+ if ($contest) {
+ $ret->{contest_start} = $contest->{start};
+ $ret->{contest_stop} = $contest->{stop};
+ delete $ret->{solution}
}
-}
-sub contest_list {
- my ($self, %args) = @_;
- my $rs = $self->contests->search(undef, {order_by => {-desc => 'start'}, prefetch => 'owner'});
- $rs = $rs->search({owner => $args{owner}}) if $args{owner};
- my %params;
- for ($rs->all) {
- my $state = $_->is_pending ? 'pending' : $_->is_running ? 'running' : 'finished';
- $params{$state} //= [];
- push @{$params{$state}}, { $_->get_columns, started => !$_->is_pending, owner_name => $_->owner->name };
- }
- \%params
+ $ret
}
-sub contest_entry {
- my ($self, $id) = @_;
- my $ct = $self->contest($id);
- +{ $ct->get_columns, started => !$ct->is_pending, owner_name => $ct->owner->name }
-}
+sub contest_list { _add_names _query('contest_list_sth')->hashes }
+
+sub contest_entry { _add_names _query(contest_entry_sth => $_[0])->hash }
+
+sub contest_has_problem { _query('contest_has_problem_sth', @_[0, 1])->flat }
sub job_list {
- my ($self, %args) = @_;
- $args{page} //= 1;
- my $rs = $self->jobs->search(undef, {order_by => {-desc => 'me.id'}, prefetch => ['problem', 'owner'], rows => JOBS_PER_PAGE, page => $args{page}});
- $rs = $rs->search({'me.private'=> 0}) unless $args{private};
- $rs = $rs->search({'me.owner' => $args{owner}}) if $args{owner};
- $rs = $rs->search({contest => $args{contest}}) if $args{contest};
- $rs = $rs->search({problem => $args{problem}}) if $args{problem};
- return {
- log => [map {
- my %params = $_->get_columns;
- $params{owner_name} = $_->owner->name;
- $params{problem_name} = $_->problem->name;
- $params{results} &&= decode_json $params{results};
- $params{size} = length $params{source};
- delete $params{source};
- \%params
- } $rs->all],
- current_page => $rs->pager->current_page,
- maybe previous_page => $rs->pager->previous_page,
- maybe next_page => $rs->pager->next_page,
- maybe last_page => $rs->pager->last_page,
- }
+ my (%args) = @_;
+ $args{page} = int ($args{page} // 1);
+ my %where = (
+ maybe contest => $args{contest},
+ maybe owner => $args{owner},
+ maybe problem => $args{problem},
+ maybe result => $args{result},
+ );
+ $where{private} = 0 unless $args{private};
+
+ my $rows = $db->select('job_entry', 'COUNT(*)', \%where)->list;
+ my $pages = int (($rows + JOBS_PER_PAGE - 1) / JOBS_PER_PAGE);
+ my ($stmt, @bind) = $db->abstract->select('job_entry', '*', \%where, {-desc => 'id'});
+ my $jobs = _add_names $db->query("$stmt LIMIT " . JOBS_PER_PAGE . ' OFFSET ' . ($args{page} - 1) * JOBS_PER_PAGE, @bind)->hashes;
+ my $pageinfo = {
+ current_page => $args{page},
+ last_page => $pages,
+ ($args{page} - 1) ? (previous_page => $args{page} - 1) : (),
+ ($args{page} < $pages) ? (next_page => $args{page} + 1) : (),
+ };
+ wantarray ? ($jobs, $pageinfo) : $jobs;
}
sub job_entry {
- my ($self, $id) = @_;
- my $job = $self->jobs->find($id, {prefetch => ['problem', 'owner', 'contest']});
- my %params = $job->get_columns;
- $params{owner_name} = $job->owner->name;
- $params{problem_name} = $job->problem->name;
- $params{contest_name} = $job->contest->name if $params{contest};
- $params{results} &&= decode_json $params{results};
- $params{size} = length $params{source};
- delete $params{source};
- \%params
+ my $ret = _add_names _query(job_entry_sth => $_[0])->hash;
+ $ret->{results} = decode_json $ret->{results} if $ret->{results};
+ $ret
+}
+
+sub create_job {
+ my (%args) = @_;
+ $db->update('users', {lastjob => time}, {id => $args{owner}});
+ purge '/log/';
+ scalar $db->insert('jobs', \%args, {returning => 'id'})->list
+}
+
+sub _calc_score {
+ my ($mxscore, $time, $tries, $totaltime) = @_;
+ my $score = $mxscore;
+ $time = 300 if $time > $totaltime; # uncoverable branch true does not happen anymore (only possible if opens are broken)
+ $score = ($totaltime - $time) / $totaltime * $score;
+ $score -= $tries / 10 * $mxscore;
+ $score = $mxscore * 3 / 10 if $score < $mxscore * 3 / 10;
+ int $score + 0.5
+}
+
+sub standings {
+ my ($ct) = @_;
+ my @problems = sort { $a->{value} <=> $b->{value} } @{problem_list contest => $ct};
+ my %values = map { $_->{id} => $_->{value} } @problems;
+ $ct = contest_entry $ct;
+
+ my (%scores, %tries, %opens);
+ my $opens = _query(opens_sth => $ct->{id});
+ while ($opens->into(my ($problem, $owner, $time))) {
+ $opens{$problem, $owner} = $time;
+ }
+
+ # result IS NULL if job was never run
+ # result = -2 if job is being rerun
+ my %where = (contest => $ct->{id}, result => {'>=', 0});
+ my $jobs = $db->select('job_entry', '*', \%where, 'id');
+
+ while (my $job = $jobs->hash) {
+ my $open = $opens{$job->{problem}, $job->{owner}} // $ct->{start};
+ my $time = $job->{date} - $open;
+ next if $time < 0; # uncoverable branch true job sent before contest is deprecated
+ my $value = $values{$job->{problem}};
+ my $factor = $job->{result} ? 0 : 1;
+ $factor = $1 / 100 if $job->{result_text} =~ /^(\d+ )/s;
+ $scores{$job->{owner}}{$job->{problem}} = int ($factor * _calc_score ($value, $time, $tries{$job->{owner}}{$job->{problem}}++, $ct->{stop} - $ct->{start}));
+ }
+
+ my @st = sort { $b->{score} <=> $a->{score} or $a->{user} cmp $b->{user} } map { ## no critic (ProhibitReverseSortBlock)
+ my $user = $_;
+ +{
+ user => $user,
+ user_name => _object_name(users => $user),
+ score => sum (values %{$scores{$user}}),
+ scores => [map { $scores{$user}{$_->{id}} // '-'} @problems],
+ }
+ } keys %scores;
+
+ $st[0]->{rank} = 1 if @st;
+ $st[$_]->{rank} = $st[$_ - 1]->{rank} + ($st[$_]->{score} < $st[$_ - 1]->{score}) for 1 .. $#st;
+
+ \@st
}
sub update_status {
- my ($self) = @_;
- my @jobs = $self->jobs->search(undef, {cache => 1})->all;
+ my $jobs = $db->select('jobs', 'id,owner,problem,result', {-not_bool => 'private'}, 'id');
my %hash;
- $hash{$_->get_column('problem'), $_->get_column('owner')} = [$_->id, $_->result ? 0 : 1] for @jobs;
+ while ($jobs->into(my ($id, $owner, $problem, $result))) {
+ $hash{$problem, $owner} = [$id, $result ? 0 : 1];
+ }
+
my @problem_statuses = map { [split ($;), @{$hash{$_}} ] } keys %hash;
my @contest_statuses = map {
- my $contest = $_->id;
- map { [$contest, $_->{user}, $_->{score}, $_->{rank}] } $_->standings
- } $self->contests->all;
-
- my $txn = sub {
- $self->problem_statuses->delete;
- $self->problem_statuses->populate([[qw/problem owner job solved/], @problem_statuses]);
- $self->contest_statuses->delete;
- $self->contest_statuses->populate([[qw/contest owner score rank/], @contest_statuses]);
+ my $ct = $_;
+ map { [$ct, $_->{user}, $_->{score}, $_->{rank}] } @{standings $ct}
+ } $db->select('contests', 'id')->flat;
+
+ $db->begin;
+ $db->delete('problem_status');
+ $db->query('INSERT INTO problem_status (problem,owner,job,solved) VALUES (??)', @$_) for @problem_statuses;
+ $db->delete('contest_status');
+ $db->query('INSERT INTO contest_status (contest,owner,score,rank) VALUES (??)', @$_) for @contest_statuses;
+ $db->commit
+}
+
+sub rerun_problem {
+ my ($problem) = @_;
+ _query rerun_problem_sth => $problem;
+ purge '/log/';
+}
+
+sub rerun_job {
+ my ($id) = @_;
+ _query rerun_job_sth => $id;
+ purge '/log/';
+ purge "/log/$id";
+}
+
+sub take_job {
+ my ($daemon) = @_;
+ my $id = _query(take_job_sth => $daemon)->list;
+ return unless $id;
+ purge '/log/';
+ purge "/log/$id";
+ db->select(jobs => '*', {id => $id})->hash
+}
+
+sub finish_job {
+ my ($job, $private, %args) = @_;
+ db->update(jobs => \%args, {id => $job->{id}});
+ purge '/log/';
+ purge '/log/' . $job->{id};
+ purge '/st/' . $job->{contest} if $job->{contest};
+ return if $private;
+ my $status = {
+ problem => $job->{problem},
+ owner => $job->{owner},
+ job => $job->{id},
+ solved => ($args{result} ? 0 : 1),
};
+ eval {
+ db->insert(problem_status => $status)
+ } or db->update(problem_status => $status, {owner => $job->{owner}, problem => $job->{problem}});
+ purge '/us/' . $job->{owner};
+}
- $self->txn_do($txn);
+sub open_problem {
+ my ($contest, $problem, $owner, $time) = @_;
+ my $ct = contest_entry($contest);
+ return unless $ct->{id} && $time >= $ct->{start} && $time < $ct->{stop}; ## no critic (ProhibitNegativeExpressionsInUnlessAndUntilConditions)
+ eval { db->insert(opens => { ## no critic (RequireCheckingReturnValueOfEval)
+ contest => $contest,
+ problem => $problem,
+ owner => $owner,
+ time => $time}) };
}
my @PURGE_HOSTS = exists $ENV{PURGE_HOSTS} ? split ' ', $ENV{PURGE_HOSTS} : ();
=head1 SYNOPSIS
- my $db = Gruntmaster::Data->connect('dbi:Pg:');
-
- my $problem = $db->problem('my_problem');
- $problem->update({timeout => 2.5}); # Set time limit to 2.5 seconds
- $problem->rerun; # And rerun all jobs for this problem
-
- # ...
-
- my $contest = $db->contests->create({ # Create a new contest
- id => 'my_contest',
- name => 'My Awesome Contest',
- start => time + 100,
- end => time + 1900,
- });
- $db->contest_problems->create({ # Add a problem to the contest
- contest => 'my_contest',
- problem => 'my_problem',
- });
-
- say 'The contest has not started yet' if $contest->is_pending;
-
- # ...
-
- my @jobs = $db->jobs->search({contest => 'my_contest', owner => 'MGV'})->all;
- $_->rerun for @jobs; # Rerun all jobs sent by MGV in my_contest
=head1 DESCRIPTION
-Gruntmaster::Data is the interface to the Gruntmaster 6000 database. Read the L<DBIx::Class> documentation for usage information.
+Gruntmaster::Data is the interface to the Gruntmaster 6000 database.
-In addition to the typical DBIx::Class::Schema methods, this module contains several convenience methods:
+All functions are exported by default.
=over
-=item contests
-
-Equivalent to C<< $schema->resultset('Contest') >>
+=item B<dbinit>(I<@args>)
-=item contest_problems
+This function connects to the database. I<@args> are the arguments
+passed to the L<DBIx::Simple> constructor.
-Equivalent to C<< $schema->resultset('ContestProblem') >>
+=item B<purge>(I<$url_path>)
-=item jobs
+Purges a relative URL from the Varnish Cache by sending PURGE
+$url_path requests to all hosts in the PURGE_HOSTS environment
+variable.
-Equivalent to C<< $schema->resultset('Job') >>
+=item B<db>
-=item problems
+Returns a L<DBIx::Simple> object for interacting with the database
+directly. Use this when no other function in this module is suitable.
-Equivalent to C<< $schema->resultset('Problem') >>
+=item B<user_list>
-=item users
+Returns an arrayref of the top 200 users.
-Equivalent to C<< $schema->resultset('User') >>
+=item B<user_entry>(I<$id>)
-=item contest($id)
+Returns a hashref describing the user I<$id>.
-Equivalent to C<< $schema->resultset('Contest')->find($id) >>
+=item B<problem_list>([I<%args>])
-=item job($id)
+Returns an arrayref of problems.
-Equivalent to C<< $schema->resultset('Job')->find($id) >>
+Takes the following named arguments:
-=item problem($id)
+=over
-Equivalent to C<< $schema->resultset('Problem')->find($id) >>
+=item owner
-=item user($id)
+Only show problems owned by this user
-Equivalent to C<< $schema->resultset('User')->find($id) >>
+=item contest
-=item user_list
+Only show problems in this contest
-Returns a list of users as an arrayref containing hashrefs.
+=item private
-=item user_entry($id)
+If true, include private problems. Always true if contest is present.
-Returns a hashref with information about the user $id.
+=item solution
-=item problem_list([%args])
+If true, include problem solutions
-Returns a list of problems grouped by level. A hashref with levels as keys.
+=back
-Takes the following arguments:
+=item B<problem_entry>(i<$id>, [I<$contest>])
-=over
+Returns a hashref describing the problem I<$id>. If $contest is
+present, contest start and stop times are included, and the solution
+is deleted.
-=item owner
+=item B<contest_list>
-Only show problems owned by this user
+Returns an arrayref of contests.
-=item contest
+=item B<contest_entry>(I<$id>)
-Only show problems in this contest
+Returns a hashref describing the contest I<$id>.
-=back
+=item B<contest_has_problem>(I<$contest>, I<$problem>)
-=item problem_entry($id, [$contest, $user])
+Returns true if the contest I<$contest> includes the problem
+I<$problem>, false otherwise.
-Returns a hashref with information about the problem $id. If $contest and $user are present, problem open data is updated.
+=item B<job_list>([I<%args>])
-=item contest_list([%args])
+In scalar context, returns an arrayref of jobs. In list context,
+returns an arrayref of jobs and a hashref of information about pages.
-Returns a list of contests grouped by state. A hashref with the following keys:
+Takes the following named arguments:
=over
-=item pending
+=item page
-An arrayref of hashrefs representing pending contests
+Show this page of the job log. Defaults to 1.
-=item running
+=item owner
-An arrayref of hashrefs representing running contests
+Only show jobs submitted by this user.
-=item finished
+=item contest
-An arrayref of hashrefs representing finished contests
+Only show jobs submitted in this contest.
-=back
+=item problem
-Takes the following arguments:
+Only show jobs submitted for this problem.
-=over
+=item result
-=item owner
+Only show jobs with this result (see the constants in
+L<Gruntmaster::Daemon::Constants>).
+
+=item private
-Only show contests owned by this user.
+If true, include private jobs. Defaults to false.
=back
-=item contest_entry($id)
+=item B<job_entry>(I<$id>)
-Returns a hashref with information about the contest $id.
+Returns a hashref describing the job I<$id>.
-=item job_list([%args])
+=item B<create_job>(I<%args>)
-Returns a list of jobs as an arrayref containing hashrefs. Takes the following arguments:
+Insert a new job into the database. This function also updates the
+lastjob field for the job's owner.
-=over
+=item B<standings>(I<$ct>)
-=item owner
+Returns an arrayref of the standings of contest I<$ct>.
-Only show jobs submitted by this user.
+=item B<update_status>
-=item contest
+Rebuilds the problem_status and contest_status tables.
-Only show jobs submitted in this contest.
+=item B<rerun_job>(I<$id>)
-=item problem
+Marks the job $id as pending and clears its results, so that it will
+be run again by the daemon.
-Only show jobs submitted for this problem.
+=item B<take_job>(I<$daemon>)
-=item page
+Marks a random job as being run by I<$daemon>. Returns a hashref
+describing the job, or undef if no job was available.
-Show this page of results. Defaults to 1. Pages have 10 entries, and the first page has the most recent jobs.
+=item B<finish_job>(I<$job>, I<$private>, I<%results>)
-=back
+Updates the job $job with the results in %results. If $private is
+false, also updates the problem_status table.
-=item job_entry($id)
+=item B<open_problem>(I<$contest>, I<$problem>, I<$owner>, I<$time>)
-Returns a hashref with information about the job $id.
+Notes that I<$owner> has opened the problem I<$problem> of contest
+I<$contest> at time I<$time>. If the C<opens> table already contains
+this (I<$contest>, I<$problem>, I<$owner>) triplet, this function does
+nothing.
=back
=head1 COPYRIGHT AND LICENSE
-Copyright (C) 2014 by Marius Gavrilescu
+Copyright (C) 2014-2016 by Marius Gavrilescu
This library is free software; you can redistribute it and/or modify
-it under the same terms as Perl itself, either Perl version 5.18.1 or,
+it under the same terms as Perl itself, either Perl version 5.20.1 or,
at your option, any later version of Perl 5 you may have available.