https://github.com/toolkithub/rce-runner
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.
https://github.com/toolkithub/rce-runner
command-line-application command-line-tool nix rust-embed rust-lang
Last synced: 8 months ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/toolkithub/rce-runner
- Owner: ToolKitHub
- License: mit
- Created: 2024-08-06T16:31:03.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-12-18T17:58:44.000Z (about 1 year ago)
- Last Synced: 2025-04-24T01:46:02.939Z (8 months ago)
- Topics: command-line-application, command-line-tool, nix, rust-embed, rust-lang
- Language: Nix
- Homepage:
- Size: 68.4 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# rce-runner
> [!IMPORTANT]
> The release binary is used by [rce-images](https://github.com/ToolKitHub/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
```javascript
{
"language": "python",
"files": [
{
"name": "main.py",
"content": "print(42)"
}
]
}
```
##### Output
```javascript
{
"stdout": "42\n",
"stderr": "",
"error": ""
}
```
### Read from stdin
##### Input
```javascript
{
"language": "python",
"stdin": "42",
"files": [
{
"name": "main.py",
"content": "print(input('Number from stdin: '))"
}
]
}
```
##### Output
```javascript
{
"stdout": "Number from stdin: 42\n",
"stderr": "",
"error": ""
}
```
### Custom run command
##### Input
```javascript
{
"language": "bash",
"command": "bash main.sh 42",
"files": [
{
"name": "main.sh",
"content": "echo Number from arg: $1"
}
]
}
```
##### Output
```javascript
{
"stdout": "Number from arg: 42\n",
"stderr": "",
"error": ""
}
```