rce-runner

Important

The release binary is used by rce-images to run code.

This is a command line application that reads code as a json payload from stdin – compiles and runs the code – and writes the result as json to stdout.

Prerequisites

rce-runner requires that the compiler / interpreter for the languages you want to run is installed and is in PATH.

Supported languages

• Assembly
• Ats
• Bash
• C
• Clojure
• Cobol
• CoffeeScript
• Cpp
• Crystal
• Csharp
• D
• Elixir
• Elm
• Erlang
• Fsharp
• Go
• Groovy
• Haskell
• Idris
• Java
• JavaScript
• Julia
• Kotlin
• Lua
• Mercury
• Nim
• Ocaml
• Perl
• Php
• Python
• Raku
• Ruby
• Rust
• SaC
• Scala
• Swift
• TypeScript

Input (stdin)

The input is required to be a json object containing the properties language and files. language must be a lowecase string matching one of the supported languages. files must be an array with at least one object containing the properties name and content. name is the name of the file and can include forward slashes to create the file in a subdirectory relative to the base directory. All files are written into the same base directory under the OS's temp dir.

In addition, one may optionally provide the stdin and command properties to provide stdin data to the running code and to run the code with a custom command. See examples below.

Output (stdout)

The output is a json object containing the properties stdout, stderr and error. stdout and stderr is captured from the output of the ran code. error is popuplated if there is a compiler / interpreter error. Note that the rce-runner will exit with a non-zero code if invalid input is given or if the files cannot be written to disk (permissions, disk space, etc). No json will be written to stdout in those cases. Otherwise the exit code is 0.

Examples

Simple example

Input

{
  "language": "python",
  "files": [
    {
      "name": "main.py",
      "content": "print(42)"
    }
  ]
}

Output

{
  "stdout": "42\n",
  "stderr": "",
  "error": ""
}

Read from stdin

Input

{
  "language": "python",
  "stdin": "42",
  "files": [
    {
      "name": "main.py",
      "content": "print(input('Number from stdin: '))"
    }
  ]
}

Output

{
  "stdout": "Number from stdin: 42\n",
  "stderr": "",
  "error": ""
}

Custom run command

Input

{
  "language": "bash",
  "command": "bash main.sh 42",
  "files": [
    {
      "name": "main.sh",
      "content": "echo Number from arg: $1"
    }
  ]
}

Output

{
  "stdout": "Number from arg: 42\n",
  "stderr": "",
  "error": ""
}