recodex-wiki/Tasks.md

Tasks detailed

Basic information about tasks is on Assignments overview page. This text is more detailed explaination of all implemented internal tasks and used judges.

Internal tasks

Archivate task can be used for pack and compress a directory. Calling command is archivate. Requires two arguments:

• path and name of the directory to be archived
• path and name of the target archive. Only .zip format is supported.

Extract task is opposite to archivate task. It can extract different types of archives. Supported formats are the same as supports libarchive library (see libarchive wiki), mainly zip, tar, tar.gz, tar.bz2 and 7zip. Please note, that system administrator may not install all packages needed, so some formats may not work. Please, consult your system administrator for more information. Archives could contain only regular files or directories (ie. no symlinks, block and character devices sockets or pipes allowed). Calling command is extract and requires two arguments:

• path and name of the archive to extract
• directory, where the archive will be extracted

Fetch task will give you a file. It can be downloaded from remote file server or just copied from local cache if available. Calling comand is fetch with two arguments:

• name of the requested file without path
• path and name on the destination. Providing a different destination name can be used for easy rename.

Copy task can copy files and directories. Detailed info can be found on reference page of boost::filesystem::copy. Calling command is cp and require two arguments:

• path and name of source target
• path and name of destination targer

Make directory task can create arbitrary number of directories. Calling command is mkdir and requires at least one argument. For each provided one will be called boost::filesystem::create_directories command.

Rename task will rename files and directories. Detailed bahavior can be found on reference page of boost::filesystem::rename. Calling command is rename and require two arguments:

• path and name of source target
• path and name of destination target

Remove task is for deleting files and directories. Calling command is rm and require at least one argument. For each provided one will be called boost::filesystem::remove_all command.

Judges

Judges are treated as normal external command, so there is no special task for them. All judges are adopted from old Codex with only very small modifications. Judges base directory is in ${JUDGES_DIR} variable, which can be used in job config file.

TODO: judges requirements by other part of ReCodEx...

recodex-judge-normal is base judge used by most of exercises. This judge compares two text files. It compares only text tokens regardless amount of whitespace between them.

Usage: recodex-judge-normal [-r | -n | -rn] <file1> <file2>

• file1 and file2 are paths to files that will be compared
• switch options -r and -n can be specified as a 1st optional argument.
  • -n judge will treat newlines as ordinary whitespace (it will ignore line breaking)
  • -r judge will treat tokens as real numbers and compares them accordingly (with some amount of error)

recodex-judge-filter can be used for preprocess output files before real judging. This judge filters C-like comments from a text file. The comment starts with double slash sequence (//) and finishes with newline. If the comment takes whole line, then whole line is filtered.

Usage: recodex-judge-filter [inputFile [outputFile]]

• if outputFile is ommited, std. output is used instead.
• if both files are ommited, application uses std. input and output.

recodex-judge-shuffle is for judging shuffled files. This judge compares two text files and returns 0 if they matches (and 1 otherwise). Two files are compared with no regards for whitespace (whitespace acts just like token delimiter).

Usage: recodex-judge-shuffle [-[n][i][r]] <file1> <file2>

• -n ignore newlines (newline is considered only a whitespace)
• -i ignore items order on the row (tokens on each row may be permutated)
• -r ignore order of rows (rows may be permutated); this option has no effect when -n is used