How xssandreissx/code-runner works
code-runner accepts test suites and authenticated code submissions from external services, queues judging work, runs tests in a sandboxed worker, persists verdicts, and exposes status/results. The main path is API submission handling → task dispatch → worker execution → result tracking → API retrieval. Test-suite management and service/JWT administration are additional capabilities. Source excerpts show application startup, persistence helpers, task-result synchronization, and shared runner schemas; some router and worker details are supported only by the SOURCE INDEX or README, so uncertain implementation links are omitted.
Main entry points: app/database.py Database access · submission.py Submission API · result_awaiter.py Result awaiter · core/database.py PostgreSQL
Components 25
API and access
- FastAPI app
app/main.py - Submission API
app/routers/submission.py - Test suite API
app/routers - JWT access
app/core/deps.py - Client responses
app/schemas/client_response.py
Submission data
- Submission services
app/services/submission.py - Submission processing
app/services/process_submission.py - Submission model
app/models/submission.py - Service model
app/models/service.py - Database access
app/database.py - PostgreSQL
app/core/database.py - Result awaiter
app/services/result_awaiter.py
Judging execution
- Runner schemas
shared/schemas/runner.py - Celery configuration
shared/celery_app.py - RabbitMQ broker
- Worker task
worker/main.py - Test processing
worker/core/process_tests.py - Sandbox runner
worker/core/runner.py - nsjail sandbox
- Redis result backend
Service administration
- Management CLI
app/cli.py - Service commands
app/cli_commands/service.py - Problem commands
app/cli_commands/problem.py - Demo problem data
seed_problems
Other components
- External service
Connections 35
- External service → FastAPI app: calls API
README.md - FastAPI app → Submission API: registers route
app/main.py - FastAPI app → Test suite API: registers route
app/main.py - External service → Test suite API: manages suites
README.md - External service → Submission API: submits code
README.md - Submission API → JWT access: uses authorization
app/routers/submission.py - Submission API → Submission services: uses services
app/routers/submission.py - Submission API → Submission processing: dispatches processing
app/routers/submission.py - Submission API → Client responses: returns response
app/routers/submission.py - Submission services → Database access: reads and writes
app/services/submission.py - Submission processing → Database access: reads suite data
app/services/process_submission.py - Submission processing → Celery configuration: submits task
app/services/process_submission.py - Submission processing → Runner schemas: builds task input
app/services/process_submission.py - Database access → PostgreSQL: queries
app/database.py - Database access → Submission model: operates on
app/database.py - Database access → Service model: operates on
app/database.py - PostgreSQL → PostgreSQL: stores records
app/core/database.py - Celery configuration → RabbitMQ broker: uses broker
shared/celery_app.py - Celery configuration → Redis result backend: uses backend
shared/celery_app.py - Worker task → Test processing: dispatches task
worker/main.py - Test processing → Runner schemas: uses input and output
worker/core/process_tests.py - Test processing → Sandbox runner: runs tests
worker/core/process_tests.py - Sandbox runner → nsjail sandbox: executes isolated
README.md - FastAPI app → Result awaiter: starts listener
app/main.py - Result awaiter → Celery configuration: checks task results
app/services/result_awaiter.py - Result awaiter → Database access: loads submissions
app/services/result_awaiter.py - Result awaiter → PostgreSQL: persists verdicts
app/services/result_awaiter.py - Result awaiter → Redis result backend: reads task status
app/services/result_awaiter.py - External service → Submission API: retrieves verdict
README.md - Management CLI → Service commands: invokes commands
app/cli.py - Management CLI → Problem commands: invokes commands
app/cli.py - Problem commands → Database access: loads suite data
app/cli_commands/problem.py - Problem commands → Demo problem data: loads demo data
- Service commands → Database access: manages services
app/cli_commands/service.py - Service commands → PostgreSQL: opens session
app/cli_commands/service.py