Compilers
Multi-file Submissions

In a basic scenario, a submission contains a source code that is a single file. Multi-file mode allows for creating submissions consisting of multiple files.

Thanks to this, it is possible to:

• launch complex projects consisting of multiple files,
• use external libraries,
• attach files that are not source code,
• attach configuration files.

Sending all files as an archive (.tar.gz)

Use this method when you want to send a complex project containing a large number of files (e.g., when attaching an external library).

The archive is sent using the source parameter of the POST /submissions method. The following examples present how to send multi-file submission using either the curl command or PHP Client library. There are separate examples for the Compilers and the Problems modules of Sphere Engine:

• PHP
• curl

$client = new CompilersClientV4('<access_token>', '<endpoint>');

$tarSource = '<tar_source>';
try {
    $compilerId = 116;
    $response = $client->createSubmissionWithTarSource($tarSource, $compilerId);
    // response['id'] stores the ID of the created submission
} catch (SphereEngineResponseException $e) {
    // catch errors
}

curl -X POST \
    -F "compilerId=116" \
    -F "source=@prog.py.tar.gz" \
    "https://<endpoint>/api/v4/submissions?access_token=<access_token>"
    

Sending all files separately

Use this method for a small number of files.

Individual files are uploaded using the files parameter of the POST /submissions method (the source parameter is ignored in this case). Execute the files parameter multiple times, separately for each file.

An example of using the curl command on Linux:

• PHP
• curl

$client = new CompilersClientV4('<access_token>', '<endpoint>');

$files = array(
   'prog.c' => '<source_code>',
   'prog.h' => '<source_code>'
);
try {
    $compilerId = 11;
    $response = $client->createSubmissionMultiFiles($files, $compilerId);
    // response['id'] stores the ID of the created submission
} catch (SphereEngineResponseException $e) {
    // catch errors
}

curl -X POST \
    -F "compilerId=11" \
    -F "files[prog.c]=@prog.c" \
    -F "files[prog.h]=@prog.h" \
    "https://<endpoint>/api/v4/submissions?access_token=<access_token>"

Submission containing binary data

A submission can be sent in the form of binary data (e.g., when uploading an archive) or contain binary data (e.g., graphic files). Therefore, when using the multi-file mode you must create requests in the MULTIPART format (i.e. Content-Type: multipart/form-data)

It is impossible to use the JSON format and we advise against using the FORM format. In this case, the binary data is converted to a text format which can result in transferring big files and creating unnecessary overhead.

The structure of a multi-file submission

The structure of files and directories of submissions sent in the multi-file mode is not limited in any way. However, some programming languages ​​require sending an entry file with the appropriate name and extension (depending on the programming language).

The entry file will be used to execute the submission. It must be located at the highest level of the submission's directory structure. For example, a submission in Python must contain a file named prog.pyand this file will be executed.

Supported programming languages

The following table shows a list of programming languages supported by the multi-file mode. In addition, we define the entry file, which should be located at the highest level of the submission's directory structure: