myriad/README.md
2019-07-11 02:20:36 -04:00

47 lines
1.1 KiB
Markdown

# Myriad
Arbitrary code execution server using Docker.
## Install
- Install [Stack 2+](https://docs.haskellstack.org/en/stable/README/)
- Run `stack install`, a `myriad` executable will be installed
## Running
- Make sure the configuration is filled out, see `config.dhall` for an example
- Run `myriad --config path/to/config.dhall`
## Endpoints
### **GET** `/languages`
List of enabled languages.
Example response:
```json
["haskell", "javascript"]
```
### **POST** `/eval`
Evaluate code.
JSON payload with `language` and `code` keys.
The `language` is as in the name of a subfolder in the `languages` directory.
Example payload:
```json
{ "language": "haskell", "code": "main = print (1 + 1)" }
```
Example response:
```json
{ "result": "2\n" }
```
Errors with 404 if `language` is not found, `504` if evaluation timed out, or `500` if evaluation failed for other reasons.
### **GET** `/containers`
List of containers being handled by Myriad.
### **POST** `/cleanup`
Kill all containers, giving back the names of the containers killed.