NAME

Gruntmaster::Data - Gruntmaster 6000 Online Judge -- database interface and tools

SYNOPSIS

for my $problem (problems) {
  say "Problem name: " . problem_name $problem;
  say "Problem level: " . problem_level $problem;
  ...
}

DESCRIPTION

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 $Gruntmaster::Data::contest variable.

local $Gruntmaster::Data::contest = 'mycontest';
say 'There are' . jobcard . ' jobs in my contest';

FUNCTIONS

Redis

Gruntmaster::Data exports some functions for talking directly to the Redis server. These functions should not normally be used, except for MULTI, EXEC, PUBLISH, SUBSCRIBE and WAIT_FOR_MESSAGES.

These functions correspond to Redis commands. The current list is: MULTI EXEC SMEMBERS GET HGET HGETALL HDEL HSET SADD SREM INCR HMSET HSETNX DEL PUBLISH SUBSCRIBE WAIT_FOR_MESSAGES.

Problems

problems: Returns a list of problems in the current contest.
problem_meta $problem: Returns a problem's meta.
set_problem_meta $problem, $meta: Sets a problem's meta.
problem_name $problem: Returns a problem's name.
set_problem_name $problem, $name: Sets a problem's name.
problem_level $problem: Returns a problem's level. The levels are beginner, easy, medium, hard.
set_problem_level $problem, $level: Sets a problem's level. The levels are beginner, easy, medium, hard.
problem_difficulty $problem: Returns a problem's difficulty.
set_problem_difficulty $problem, $name: Sets a problem's difficulty.
problem_statement $problem: Returns a problem's statement.
set_problem_statement $problem, $statement: Sets a problem's statement.
problem_owner $problem: Returns a problem's owner.
set_problem_owner $problem, $owner: Sets a problem's owner.
problem_author $problem: Returns a problem's author.
set_problem_author $problem, $author: Sets a problem's author.
problem_private $problem: Returns a problem's private flag (true if the problem is private, false otherwise).
set_problem_private $problem, $private: Sets a problem's private flag.
problem_generator $problem: Returns a problem's generator. The generators are File, Run and Undef. More might be added in the future.
set_problem_generator $problem, $generator: Sets a problem's generator.
problem_runner $problem: Returns a problem's runner. The runners are File, Verifier and Interactive. More might be added in the future.
set_problem_runner $problem, $runner: Sets a problem's runner.
problem_judge $problem: Returns a problem's judge. The judges are Absolute and Points. More might be added in the future.
set_problem_judge $problem, $judge: Sets a problem's judge.
problem_testcnt $problem: Returns a problem's test count.
set_problem_testcnt $problem, $testcnt: Sets a problem's test count.
problem_timeout $problem: Returns a problem's time limit, in seconds.
set_problem_timeout $problem, $timeout: Sets a problem's time limit, in seconds.
problem_olimit $problem: Returns a problem's output limit, in bytes.
set_problem_olimit $problem, $olimit: Sets a problem's output limit, in bytes.
get_open $problem, $user: Returns the time when $user opened $problem.
mark_open $problem, $user: Sets the time when $user opened $problem to the current time. Does nothing if $user has already opened $problem.
insert_problem $id, $key => $value, ...: Inserts a problem with id $id and the given initial configuration. Does nothing if a problem with id $id already exists. Returns true if the problem was added, false otherwise.
edit_problem $id, $key => $value, ...: Updates the configuration of a problem. The values of the given keys are updated. All other keys/values are left intact.
remove_problem $id: Removes a problem.

Contests

WARNING: these functions only work correctly when $Gruntmaster::Data::contest is undef

contests: Returns a list of contests.
contest_start $contest: Returns a contest's start time.
set_contest_start $contest, $start: Sets a contest's start time.
contest_end $contest: Returns a contest's end time.
set_contest_end $contest, $end: Sets a contest's end time.
contest_name $contest: Returns a contest's name.
set_contest_name $contest, $name: Sets a contest's name.
contest_owner $contest: Returns a contest's owner.
set_contest_owner $contest, $owner: Sets a contest's owner.
insert_contest $id, $key => $value, ...: Inserts a contest with id $id and the given initial configuration. Does nothing if a contest with id $id already exists. Returns true if the contest was added, false otherwise.
edit_contest $id, $key => $value, ...: Updates the configuration of a contest. The values of the given keys are updated. All other keys/values are left intact.
remove_contest $id: Removes a contest.

Jobs

jobcard: Returns the number of jobs in the database.
job_results $job: Returns an array of job results. Each element corresponds to a test and is a hashref with keys id (test number), result (result code, see Gruntmaster::Daemon::Constants), result_text (result description) and time (time taken).
set_job_results $job, $results: Sets a job's results.
job_inmeta $job: Returns a job's meta.
set_job_inmeta $job, $meta: Sets a job's meta.
job_daemon $job: Returns the hostname:pid of the daemon which ran this job.
set_job_daemon $job, $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.
job_date $job: Returns a job's submit date.
set_job_date $job, $date: Sets a job's submit date.
job_errors $job: Returns a job's compile errors.
set_job_errors $job, $errors: Sets a job's compile errors.
job_extension $job: Returns a job's file name extension (e.g. "cpp", "pl", "java").
set_job_extension $job, $extension: Sets a job's file name extension.
job_filesize $job: Returns a job's source file size, in bytes.
set_job_filesize $job, $filesize: Sets a job's source file size, in bytes.
job_private $job: Returns the value of a job's private flag.
set_job_private $job, $private: Sets the value of a job's private flag.
job_problem $job: Returns a job's problem.
set_job_problem $job, $problem: Sets a job's problem.
job_result $job: Returns a job's result code. Possible result codes are described in Gruntmaster::Daemon::Constants
set_job_result $job, $result: Sets a job's result code.
job_result_text $job: Returns a job's result text.
set_job_result_text $job, $result_text: Sets a job's result text.
job_user $job: Returns the user who submitted a job.
set_job_user $job, $user: Sets the suer who submitted a job.
clean_job $job: Removes a job's daemon, result code, result text and result array.
push_job $key => $value, ...: Inserts a job with a given initial configuration. Returns the id of the newly-added job.
edit_job $id, $key => $value, ...: Updates the configuration of a job. The values of the given keys are updated. All other keys/values are left intact.
remove_job $id: Removes a job.

Users

WARNING: these functions only work correctly when $Gruntmaster::Data::contest is undef

users: Returns a list of users.
user_name $user: Returns a user's full name.
set_user_name $user, $name: Sets a user's full name.
user_email $user: Returns a user's email address.
set_user_email $user, $email: Sets a user's email address.
user_lastjob $user: Returns the time (seconds since epoch) when the user last submitted a solution.
set_user_lastjob $user, $lastjob: Sets the time (seconds since epoch) when the user last submitted a solution.
user_town $user: Returns a user's town.
set_user_town $user, $town: Sets a user's town.
user_university $user: Returns a user's university/highschool/place of work/etc.
set_user_university $user, $university: Sets a user's university, highschool/place of work/etc.
user_level $user: Returns a user's current level of study. One of 'Highschool', 'Undergraduate', 'Master', 'Doctorate' or 'Other'.
set_user_level $user, $level: Sets a user's current level of study.
insert_user $id, $key => $value, ...: Inserts a user with id $id and the given initial configuration. Does nothing if a user with id $id already exists. Returns true if the user was added, false otherwise.
edit_user $id, $key => $value, ...: Updates the configuration of a user. The values of the given keys are updated. All other keys/values are left intact.
remove_user $id: Removes a user.

AUTHOR

Marius Gavrilescu <marius@ieval.ro>

COPYRIGHT AND LICENSE

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.

To install Gruntmaster::Data, copy and paste the appropriate command in to your terminal.

cpanm

cpanm Gruntmaster::Data

CPAN shell

perl -MCPAN -e shell
install Gruntmaster::Data

For more information on module installation, please visit the detailed CPAN module installation guide.

	Global
`s`	Focus search bar
`?`	Bring up this help dialog

	GitHub
`g` `p`	Go to pull requests
`g` `i`	go to github issues (only if github is preferred repository)

	POD
`g` `a`	Go to author
`g` `c`	Go to changes
`g` `i`	Go to issues
`g` `d`	Go to dist
`g` `r`	Go to repository/SCM
`g` `s`	Go to source
`g` `b`	Go to file browse

	Search terms
module: (e.g. module:Plugin)
distribution: (e.g. distribution:Dancer auth)
author: (e.g. author:SONGMU Redis)
version: (e.g. version:1.00)