+use utf8;
package Gruntmaster::Data;
-use v5.14;
+
+# Created by DBIx::Class::Schema::Loader
+# DO NOT MODIFY THE FIRST PART OF THIS FILE
+
+use strict;
use warnings;
+
+use base 'DBIx::Class::Schema';
+
+__PACKAGE__->load_namespaces;
+
+
+# Created by DBIx::Class::Schema::Loader v0.07039 @ 2014-03-05 13:11:39
+# DO NOT MODIFY THIS OR ANYTHING ABOVE! md5sum:dAEmtAexvUaNXLgYz2rNEg
+
use parent qw/Exporter/;
+our $VERSION = '5999.000_013';
+our @EXPORT = qw/purge/; ## no critic (ProhibitAutomaticExportation)
-use JSON qw/encode_json decode_json/;
-use Redis;
+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/;
-our $VERSION = '5999.000_001';
-
-our $contest;
-my $redis = Redis->new;
-my $pubsub = Redis->new;
+use constant PROBLEM_PUBLIC_COLUMNS => [qw/id author writer level name owner private timeout olimit value/];
+use constant USER_PUBLIC_COLUMNS => [qw/id admin name town university country level/];
+use constant JOBS_PER_PAGE => 10;
sub dynsub{
our ($name, $sub) = @_;
- no strict 'refs';
+ no strict 'refs'; ## no critic (Strict)
*$name = subname $name => $sub
}
BEGIN {
- for my $cmd (qw/multi exec smembers get hget hgetall hdel hset sadd srem incr hmset hsetnx publish del/) {
- dynsub uc $cmd, sub { $redis->$cmd(@_) };
+ 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]) };
}
+}
- for my $cmd (qw/subscribe wait_for_messages/) {
- dynsub uc $cmd, sub { $pubsub->$cmd(@_) };
+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;
}
+ $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 ]
}
-sub cp { defined $contest ? "contest.$contest." : '' }
-
-sub problems () { SMEMBERS cp . 'problem' }
-sub contests () { SMEMBERS cp . 'contest' }
-sub users () { SMEMBERS cp . 'user' }
-sub jobcard () { GET cp . 'job' }
-
-sub job_results (_) { decode_json HGET cp . "job.$_[0]", 'results' }
-sub set_job_results ($+) { HSET cp . "job.$_[0]", 'results', encode_json $_[1] }
-sub job_inmeta (_) { decode_json HGET cp . "job.$_[0]", 'inmeta' }
-sub set_job_inmeta ($+) { HSET cp . "job.$_[0]", 'inmeta', encode_json $_[1] }
-sub problem_meta (_) { decode_json HGET cp . "problem.$_[0]", 'meta' }
-sub set_problem_meta ($+) { HSET cp . "problem.$_[0]", 'meta', encode_json $_[1] }
-sub job_daemon (_) { HGET cp . "job.$_[0]", 'daemon' }
-sub set_job_daemon ($$) { HSETNX cp . "job.$_[0]", 'daemon', $_[1] };
-
-sub defhash{
- my ($name, @keys) = @_;
- for my $key (@keys) {
- dynsub "${name}_$key", sub (_) { HGET cp . "$name.$_[0]", $key };
- dynsub "set_${name}_$key", sub ($$) { HSET cp . "$name.$_[0]", $key, $_[1] };
- }
+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 }
+}
- dynsub "edit_$name", sub {
- my ($key, %values) = @_;
- HMSET cp . "$name.$key", %values;
- };
+sub problem_list {
+ my ($self, %args) = @_;
+ my @columns = @{PROBLEM_PUBLIC_COLUMNS()};
+ push @columns, 'solution' if $args{solution} && $args{contest} && !$self->contest($args{contest})->is_running;
+ my $rs = $self->problems->search(undef, {order_by => 'me.name', columns => \@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
+}
- dynsub "insert_$name", sub {
- my ($key, %values) = @_;
- SADD cp . $name, $key or return;
- HMSET cp . "$name.$key", %values;
- };
- dynsub "remove_$name", sub (_) {
- my $key = shift;
- SREM cp . $name, $key;
- DEL cp . "$name.$key";
- };
+sub problem_entry {
+ my ($self, $id, $contest, $user) = @_;
+ my $running = $contest && $self->contest($contest)->is_running;
+ my @columns = @{PROBLEM_PUBLIC_COLUMNS()};
+ push @columns, 'statement';
+ 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 => !$contest || !$contest->is_finished,
+ $running ? (
+ contest_start => $contest->start,
+ contest_stop => $contest->stop,
+ open_time => $open->time
+ ) : (),
+ }
+}
- dynsub "push_$name", sub {
- my $nr = INCR cp . $name;
- HMSET cp . "$name.$nr", @_;
- $nr
- };
+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, owner_name => $_->owner->name };
+ }
+ \%params
}
-defhash problem => qw/name level difficulty statement owner author private generator runner judge testcnt timeout olimit/;
-defhash contest => qw/start end name owner/;
-defhash job => qw/date errors extension filesize private problem result result_text user/;
-defhash user => qw/name email lastjob town university level/;
+sub contest_entry {
+ my ($self, $id) = @_;
+ my $ct = $self->contest($id);
+ +{ $ct->get_columns, started => !$ct->is_pending, finished => $ct->is_finished, owner_name => $ct->owner->name }
+}
-sub clean_job (_){
- HDEL cp . "job.$_[0]", qw/result result_text results daemon/
+sub job_list {
+ my ($self, %args) = @_;
+ $args{page} //= 1;
+ my $rs = $self->jobs->search({contest => $args{contest}}, {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({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,
+ }
}
-sub mark_open {
- my ($problem, $user) = @_;
- HSETNX cp . 'open', "$problem.$user", time;
+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
}
-sub get_open {
- my ($problem, $user) = @_;
- HGET cp . 'open', "$problem.$user";
+sub update_status {
+ my ($self) = @_;
+ my @jobs = $self->jobs->search({'me.private' => 0}, {cache => 1, prefetch => 'problem'})->all;
+
+ my %private;
+ my %hash;
+ for (@jobs) {
+ my $pb = $_->get_column('problem');
+ $private{$pb} //= $_->problem->is_private;
+ next if !$private{$pb};
+ $hash{$pb, $_->get_column('owner')} = [$_->id, $_->result ? 0 : 1] for @jobs;
+ }
+
+ 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]);
+ };
+
+ $self->txn_do($txn);
}
-our @EXPORT = do {
- no strict 'refs';
- grep { $_ =~ /^[a-zA-Z]/ and exists &$_ } keys %{__PACKAGE__ . '::'};
-};
+my @PURGE_HOSTS = exists $ENV{PURGE_HOSTS} ? split ' ', $ENV{PURGE_HOSTS} : ();
+my $ht = HTTP::Tiny->new;
+
+sub purge {
+ $ht->request(PURGE => "http://$_$_[0]") for @PURGE_HOSTS;
+}
1;
+
__END__
=encoding utf-8
=head1 SYNOPSIS
- for my $problem (problems) {
- say "Problem name: " . problem_name $problem;
- say "Problem level: " . problem_level $problem;
- ...
- }
+ my $db = Gruntmaster::Data->connect('dbi:Pg:');
-=head1 DESCRIPTION
+ 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
-Gruntmaster::Data is the Redis interface used by the Gruntmaster 6000 Online Judge. It exports many functions for talking to the database. All functions are exported by default.
+ # ...
-The current contest is selected by setting the C<< $Gruntmaster::Data::contest >> variable.
+ 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',
+ });
- local $Gruntmaster::Data::contest = 'mycontest';
- say 'There are' . jobcard . ' jobs in my contest';
+ say 'The contest has not started yet' if $contest->is_pending;
-=head1 FUNCTIONS
+ # ...
-=head2 Redis
+ my @jobs = $db->jobs->search({contest => 'my_contest', owner => 'MGV'})->all;
+ $_->rerun for @jobs; # Rerun all jobs sent by MGV in my_contest
-Gruntmaster::Data exports some functions for talking directly to the Redis server. These functions should not normally be used, except for B<MULTI>, B<EXEC>, B<PUBLISH>, B<SUBSCRIBE> and B<WAIT_FOR_MESSAGES>.
+=head1 DESCRIPTION
-These functions correspond to Redis commands. The current list is: B<< MULTI EXEC SMEMBERS GET HGET HGETALL HDEL HSET SADD SREM INCR HMSET HSETNX DEL PUBLISH SUBSCRIBE WAIT_FOR_MESSAGES >>.
+Gruntmaster::Data is the interface to the Gruntmaster 6000 database. Read the L<DBIx::Class> documentation for usage information.
-=head2 Problems
+In addition to the typical DBIx::Class::Schema methods, this module contains several convenience methods:
=over
-=item B<problems>
-
-Returns a list of problems in the current contest.
-
-=item B<problem_meta> I<$problem>
-
-Returns a problem's meta.
-
-=item B<set_problem_meta> I<$problem>, I<$meta>
-
-Sets a problem's meta.
-
-=item B<problem_name> I<$problem>
-
-Returns a problem's name.
-
-=item B<set_problem_name> I<$problem>, I<$name>
-
-Sets a problem's name.
+=item contests
-=item B<problem_level> I<$problem>
+Equivalent to C<< $schema->resultset('Contest') >>
-Returns a problem's level. The levels are beginner, easy, medium, hard.
+=item contest_problems
-=item B<set_problem_level> I<$problem>, I<$level>
+Equivalent to C<< $schema->resultset('ContestProblem') >>
-Sets a problem's level. The levels are beginner, easy, medium, hard.
+=item jobs
-=item B<problem_difficulty> I<$problem>
+Equivalent to C<< $schema->resultset('Job') >>
-Returns a problem's difficulty.
+=item problems
-=item B<set_problem_difficulty> I<$problem>, I<$name>
+Equivalent to C<< $schema->resultset('Problem') >>
-Sets a problem's difficulty.
+=item users
-=item B<problem_statement> I<$problem>
+Equivalent to C<< $schema->resultset('User') >>
-Returns a problem's statement.
+=item contest($id)
-=item B<set_problem_statement> I<$problem>, I<$statement>
+Equivalent to C<< $schema->resultset('Contest')->find($id) >>
-Sets a problem's statement.
+=item job($id)
-=item B<problem_owner> I<$problem>
+Equivalent to C<< $schema->resultset('Job')->find($id) >>
-Returns a problem's owner.
+=item problem($id)
-=item B<set_problem_owner> I<$problem>, I<$owner>
+Equivalent to C<< $schema->resultset('Problem')->find($id) >>
-Sets a problem's owner.
+=item user($id)
-=item B<problem_author> I<$problem>
+Equivalent to C<< $schema->resultset('User')->find($id) >>
-Returns a problem's author.
+=item user_list
-=item B<set_problem_author> I<$problem>, I<$author>
+Returns a list of users as an arrayref containing hashrefs.
-Sets a problem's author.
+=item user_entry($id)
-=item B<problem_private> I<$problem>
+Returns a hashref with information about the user $id.
-Returns a problem's private flag (true if the problem is private, false otherwise).
+=item problem_list([%args])
-=item B<set_problem_private> I<$problem>, I<$private>
+Returns a list of problems grouped by level. A hashref with levels as keys.
-Sets a problem's private flag.
-
-=item B<problem_generator> I<$problem>
-
-Returns a problem's generator. The generators are File, Run and Undef. More might be added in the future.
-
-=item B<set_problem_generator> I<$problem>, I<$generator>
-
-Sets a problem's generator.
-
-=item B<problem_runner> I<$problem>
-
-Returns a problem's runner. The runners are File, Verifier and Interactive. More might be added in the future.
-
-=item B<set_problem_runner> I<$problem>, I<$runner>
-
-Sets a problem's runner.
-
-=item B<problem_judge> I<$problem>
-
-Returns a problem's judge. The judges are Absolute and Points. More might be added in the future.
-
-=item B<set_problem_judge> I<$problem>, I<$judge>
-
-Sets a problem's judge.
-
-=item B<problem_testcnt> I<$problem>
-
-Returns a problem's test count.
-
-=item B<set_problem_testcnt> I<$problem>, I<$testcnt>
-
-Sets a problem's test count.
-
-=item B<problem_timeout> I<$problem>
-
-Returns a problem's time limit, in seconds.
-
-=item B<set_problem_timeout> I<$problem>, I<$timeout>
-
-Sets a problem's time limit, in seconds.
-
-=item B<problem_olimit> I<$problem>
-
-Returns a problem's output limit, in bytes.
-
-=item B<set_problem_olimit> I<$problem>, I<$olimit>
-
-Sets a problem's output limit, in bytes.
-
-=item B<get_open> I<$problem>, I<$user>
-
-Returns the time when I<$user> opened I<$problem>.
-
-=item B<mark_open> I<$problem>, I<$user>
-
-Sets the time when I<$user> opened I<$problem> to the current time. Does nothing if I<$user> has already opened I<$problem>.
-
-=item B<insert_problem> I<$id>, I<$key> => I<$value>, ...
-
-Inserts a problem with id I<$id> and the given initial configuration. Does nothing if a problem with id I<$id> already exists. Returns true if the problem was added, false otherwise.
-
-=item B<edit_problem> I<$id>, I<$key> => I<$value>, ...
-
-Updates the configuration of a problem. The values of the given keys are updated. All other keys/values are left intact.
-
-=item B<remove_problem> I<$id>
-
-Removes a problem.
-
-=back
-
-=head2 Contests
-
-B<<< WARNING: these functions only work correctly when C<< $Gruntmaster::Data::contest >> is undef >>>
+Takes the following arguments:
=over
-=item B<contests>
-
-Returns a list of contests.
-
-=item B<contest_start> I<$contest>
-
-Returns a contest's start time.
-
-=item B<set_contest_start> I<$contest>, I<$start>
+=item owner
-Sets a contest's start time.
+Only show problems owned by this user
-=item B<contest_end> I<$contest>
+=item contest
-Returns a contest's end time.
-
-=item B<set_contest_end> I<$contest>, I<$end>
-
-Sets a contest's end time.
-
-=item B<contest_name> I<$contest>
-
-Returns a contest's name.
-
-=item B<set_contest_name> I<$contest>, I<$name>
-
-Sets a contest's name.
-
-=item B<contest_owner> I<$contest>
-
-Returns a contest's owner.
-
-=item B<set_contest_owner> I<$contest>, I<$owner>
-
-Sets a contest's owner.
-
-=item B<insert_contest> I<$id>, I<$key> => I<$value>, ...
-
-Inserts a contest with id I<$id> and the given initial configuration. Does nothing if a contest with id I<$id> already exists. Returns true if the contest was added, false otherwise.
-
-=item B<edit_contest> I<$id>, I<$key> => I<$value>, ...
-
-Updates the configuration of a contest. The values of the given keys are updated. All other keys/values are left intact.
-
-=item B<remove_contest> I<$id>
-
-Removes a contest.
+Only show problems in this contest
=back
-=head2 Jobs
-
-=over
-
-=item B<jobcard>
-
-Returns the number of jobs in the database.
-
-=item B<job_results> I<$job>
-
-Returns an array of job results. Each element corresponds to a test and is a hashref with keys B<id> (test number), B<result> (result code, see L<Gruntmaster::Daemon::Constants>), B<result_text> (result description) and B<time> (time taken).
-
-=item B<set_job_results> I<$job>, I<$results>
-
-Sets a job's results.
-
-=item B<job_inmeta> I<$job>
-
-Returns a job's meta.
-
-=item B<set_job_inmeta> I<$job>, I<$meta>
-
-Sets a job's meta.
-
-=item B<job_daemon> I<$job>
-
-Returns the hostname:pid of the daemon which ran this job.
-
-=item B<set_job_daemon> I<$job>, I<$hostname_and_pid>
-
-If the job has no associated daemon, it sets the daemon and returns true. Otherwise it returns false without setting the daemon.
-
-=item B<job_date> I<$job>
-
-Returns a job's submit date.
-
-=item B<set_job_date> I<$job>, I<$date>
-
-Sets a job's submit date.
-
-=item B<job_errors> I<$job>
-
-Returns a job's compile errors.
-
-=item B<set_job_errors> I<$job>, I<$errors>
-
-Sets a job's compile errors.
-
-=item B<job_extension> I<$job>
-
-Returns a job's file name extension (e.g. "cpp", "pl", "java").
+=item problem_entry($id, [$contest, $user])
-=item B<set_job_extension> I<$job>, I<$extension>
+Returns a hashref with information about the problem $id. If $contest and $user are present, problem open data is updated.
-Sets a job's file name extension.
+=item contest_list([%args])
-=item B<job_filesize> I<$job>
+Returns a list of contests grouped by state. A hashref with the following keys:
-Returns a job's source file size, in bytes.
-
-=item B<set_job_filesize> I<$job>, I<$filesize>
-
-Sets a job's source file size, in bytes.
-
-=item B<job_private> I<$job>
-
-Returns the value of a job's private flag.
-
-=item B<set_job_private> I<$job>, I<$private>
-
-Sets the value of a job's private flag.
-
-=item B<job_problem> I<$job>
-
-Returns a job's problem.
-
-=item B<set_job_problem> I<$job>, I<$problem>
-
-Sets a job's problem.
-
-=item B<job_result> I<$job>
-
-Returns a job's result code. Possible result codes are described in L<Gruntmaster::Daemon::Constants>
-
-=item B<set_job_result> I<$job>, I<$result>
-
-Sets a job's result code.
-
-=item B<job_result_text> I<$job>
-
-Returns a job's result text.
-
-=item B<set_job_result_text> I<$job>, I<$result_text>
-
-Sets a job's result text.
-
-=item B<job_user> I<$job>
-
-Returns the user who submitted a job.
-
-=item B<set_job_user> I<$job>, I<$user>
-
-Sets the suer who submitted a job.
-
-=item B<clean_job> I<$job>
-
-Removes a job's daemon, result code, result text and result array.
+=over
-=item B<push_job> I<$key> => I<$value>, ...
+=item pending
-Inserts a job with a given initial configuration. Returns the id of the newly-added job.
+An arrayref of hashrefs representing pending contests
-=item B<edit_job> I<$id>, I<$key> => I<$value>, ...
+=item running
-Updates the configuration of a job. The values of the given keys are updated. All other keys/values are left intact.
+An arrayref of hashrefs representing running contests
-=item B<remove_job> I<$id>
+=item finished
-Removes a job.
+An arrayref of hashrefs representing finished contests
=back
-=head2 Users
-
-B<<< WARNING: these functions only work correctly when C<< $Gruntmaster::Data::contest >> is undef >>>
+Takes the following arguments:
=over
-=item B<users>
-
-Returns a list of users.
-
-=item B<user_name> I<$user>
-
-Returns a user's full name.
-
-=item B<set_user_name> I<$user>, I<$name>
-
-Sets a user's full name.
-
-=item B<user_email> I<$user>
+=item owner
-Returns a user's email address.
+Only show contests owned by this user.
-=item B<set_user_email> I<$user>, I<$email>
-
-Sets a user's email address.
-
-=item B<user_lastjob> I<$user>
-
-Returns the time (seconds since epoch) when the user last submitted a solution.
-
-=item B<set_user_lastjob> I<$user>, I<$lastjob>
-
-Sets the time (seconds since epoch) when the user last submitted a solution.
-
-=item B<user_town> I<$user>
-
-Returns a user's town.
+=back
-=item B<set_user_town> I<$user>, I<$town>
+=item contest_entry($id)
-Sets a user's town.
+Returns a hashref with information about the contest $id.
-=item B<user_university> I<$user>
+=item job_list([%args])
-Returns a user's university/highschool/place of work/etc.
+Returns a list of jobs as an arrayref containing hashrefs. Takes the following arguments:
-=item B<set_user_university> I<$user>, I<$university>
+=over
-Sets a user's university, highschool/place of work/etc.
+=item owner
-=item B<user_level> I<$user>
+Only show jobs submitted by this user.
-Returns a user's current level of study. One of 'Highschool', 'Undergraduate', 'Master', 'Doctorate' or 'Other'.
+=item contest
-=item B<set_user_level> I<$user>, I<$level>
+Only show jobs submitted in this contest.
-Sets a user's current level of study.
+=item problem
-=item B<insert_user> I<$id>, I<$key> => I<$value>, ...
+Only show jobs submitted for this problem.
-Inserts a user with id I<$id> and the given initial configuration. Does nothing if a user with id I<$id> already exists. Returns true if the user was added, false otherwise.
+=item page
-=item B<edit_user> I<$id>, I<$key> => I<$value>, ...
+Show this page of results. Defaults to 1. Pages have 10 entries, and the first page has the most recent jobs.
-Updates the configuration of a user. The values of the given keys are updated. All other keys/values are left intact.
+=back
-=item B<remove_user> I<$id>
+=item job_entry($id)
-Removes a user.
+Returns a hashref with information about the job $id.
=back
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.
+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,
+at your option, any later version of Perl 5 you may have available.
=cut