rustfinity test runner (#27)

.github/workflows/rustfinity-runner.yaml

@@ -0,0 +1,50 @@
+name: Build Rustfinity Runner
+
+on:
+  push:
+    branches:
+      - main
+      - staging
+    paths:
+      - ".github/workflows/rustfinity-runner.yaml"
+      - "crates/rustfinity-runner/**"
+      - "challenges/**"
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      packages: write
+      contents: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Login to GitHub Container Registry
+        run: echo "${{ github.token }}" | docker login ghcr.io -u ${{ github.actor }} --password-stdin
+
+      - name: Determine tag and Dockerfile
+        id: vars
+        run: |
+          if [[ "${GITHUB_REF#refs/heads/}" == "main" ]]; then
+            echo "TAG_NAME=latest" >> $GITHUB_ENV
+            echo "DOCKERFILE_PATH=crates/rustfinity-runner/Dockerfile" >> $GITHUB_ENV
+          elif [[ "${GITHUB_REF#refs/heads/}" == "staging" ]]; then
+            echo "TAG_NAME=staging" >> $GITHUB_ENV
+            echo "DOCKERFILE_PATH=crates/rustfinity-runner/Dockerfile.staging" >> $GITHUB_ENV
+          fi
+
+      - name: Build and push
+        uses: docker/build-push-action@v6
+        with:
+          file: ${{ env.DOCKERFILE_PATH }}
+          push: true
+          tags: |
+            ghcr.io/${{ github.repository_owner }}/rustfinity-runner:${{ env.TAG_NAME }}

crates/rustfinity-runner/.dockerignore

@@ -0,0 +1 @@
+target/**

crates/rustfinity-runner/Cargo.toml

@@ -0,0 +1,12 @@
+[package]
+name = "rustfinity-runner"
+version = "0.1.0"
+edition = "2021"
+
+[dependencies]
+anyhow = "1.0.86"
+base64 = "0.22.1"
+clap = { version = "4.5.11", features = ["derive"] }
+dotenvy = "0.15.7"
+duct = "0.13.7"
+tokio = { version = "1.39.2", features = ["full"] }

crates/rustfinity-runner/Dockerfile

@@ -0,0 +1,31 @@
+# Stage 1: Clone the repository
+FROM alpine/git AS git
+WORKDIR /app
+RUN git clone https://github.com/dcodesdev/rustfinity.com
+
+# Stage 2: Build the Runner CLI and the rustfinity.com project
+FROM rust:slim-buster
+LABEL rustfinity-runner="true"
+
+# Install OpenSSL development packages and pkg-config
+RUN apt-get update && apt-get install -y \
+    pkg-config \
+    libssl-dev \
+    && rm -rf /var/lib/apt/lists/*
+
+# Build the Runner CLI
+WORKDIR /app/runner
+COPY . .
+RUN cargo build --release
+
+# Move the Runner CLI executable
+RUN mv target/release/rustfinity-runner /app/
+
+# Build the rustfinity.com project
+WORKDIR /app/rustfinity.com
+COPY --from=git /app/rustfinity.com .
+RUN cargo build
+
+# The final structure:
+# /app/rustfinity-runner (executable)
+# /app/rustfinity.com/ (project directory)

crates/rustfinity-runner/Dockerfile.staging

@@ -0,0 +1,31 @@
+# Stage 1: Clone the repository
+FROM alpine/git AS git
+WORKDIR /app
+RUN git clone -b staging https://github.com/dcodesdev/rustfinity.com
+
+# Stage 2: Build the Runner CLI and the rustfinity.com project
+FROM rust:slim-buster
+LABEL rustfinity-runner="true"
+
+# Install OpenSSL development packages and pkg-config
+RUN apt-get update && apt-get install -y \
+    pkg-config \
+    libssl-dev \
+    && rm -rf /var/lib/apt/lists/*
+
+# Build the Runner CLI
+WORKDIR /app/runner
+COPY . .
+RUN cargo build --release
+
+# Move the Runner CLI executable
+RUN mv target/release/rustfinity-runner /app/
+
+# Build the rustfinity.com project
+WORKDIR /app/rustfinity.com
+COPY --from=git /app/rustfinity.com .
+RUN cargo build
+
+# The final structure:
+# /app/rustfinity-runner (executable)
+# /app/rustfinity.com/ (project directory)

crates/rustfinity-runner/README.md

@@ -0,0 +1,37 @@
+# Rustfinity code runner
+
+The official code runner used in [Rustfinity.com](https://www.rustfinity.com), a platform to learn Rust programming language.
+
+## How to use
+
+It's best to run this in a docker container to be completely isolated from the outside world.
+
+1. Build the image locally
+
+   ```sh
+   make build TAG=latest
+   ```
+
+2. Convert your code to **base64** format.
+
+   In JavaScript it would be something like this
+
+   ```js
+   const code = `fn main() {
+       println!("Hello, world!");
+   }`;
+
+   const base64Code = Buffer.from(code).toString("base64");
+   ```
+
+3. Run the code using the CLI
+
+```bash
+docker run -i \
+    --rm \
+    --network=none \
+    --cpus=1 \
+    -m=500m \
+    rustfinity-runner \
+    /bin/bash -c "/app/rustfinity-runner run --code 'cHViIGZuIGhlbGxvX3dvcmxkKCkgewogICAgcHJpbnRsbiEoIkdvb2Qgam9iLCB5b3UgZGVjb2RlZCBpdCA6RCIpCn0K' --challenge 'printing-hello-world'"
+```

crates/rustfinity-runner/makefile

@@ -0,0 +1,8 @@
+TAG ?= staging
+
+build:
+ifeq ($(TAG), staging)
+	docker build --no-cache -t rustfinity-runner:$(TAG) . -f Dockerfile.staging
+else
+	docker build --no-cache -t rustfinity-runner:$(TAG) . -f Dockerfile
+endif

crates/rustfinity-runner/src/cli.rs

@@ -0,0 +1,22 @@
+use clap::{Parser, Subcommand};
+
+#[derive(Debug, Parser)]
+#[clap(about = "CLI for rust code runner", long_about = None)]
+pub struct Cli {
+    #[clap(subcommand)]
+    pub command: Commands,
+}
+
+#[derive(Debug, Subcommand)]
+pub enum Commands {
+    #[clap(about = "Run and test the code based on the challenge and code provided")]
+    Run {
+        #[clap(short, long)]
+        /// Code base64 encoded
+        code: String,
+
+        #[clap(short, long)]
+        /// Challenge slug
+        challenge: String,
+    },
+}