Skip to main content

A judge for your programs, run and test your programs using python

Project description

CodeRunner 🏃

A judge 👨🏽‍⚖️ for your programs, run and test your programs using Python

PyPI Build Status codecov PyPI - Format PyPI - Python Version Documentation Status PyPI - Downloads


Install using pip from PyPI

pip install coderunner

or directly from GitHub if you cannot wait to test new features

pip install git+


from coderunner import coderunner
import os

from dotenv import load_dotenv

source_code = "testfiles/" + ""
language = "Python3"
output = "testfiles/output/" + "output2.txt"
Input = "testfiles/input/" + "input.txt"

API_KEY = os.environ["API_KEY"]

r = coderunner.code(source_code, language, output, Input)

# Necessary step to initialize API keys & URL

# run the code

print("Running r :")
print("Status : " + r.getStatus())
print("Output : " + r.getOutput())

# See Documentation for more methods.


CodeRunner Documentation


  • Python 3.6+
  • virtualenv
  1. Create virtual environment.
virtualenv -p python3 venv && cd venv && source bin/activate
  1. Clone the repository.
  1. Install Dependencies.
pip install -r requirements.txt
  1. Run tests.
  1. Lint the project with
flake8 coderunner --max-line-length=88 --ignore=F401
black --check --diff coderunner

📝 Changelog

See the file for details.

:fire: Powered By

Judge0 API - Free, robust and scalable open-source online code execution system


👥 Bhupesh Varshney


📜 License

This project is licensed under the MIT License. See the LICENSE file for details.

👋 Contributing

Please read the CONTRIBUTING guidelines for the process of submitting pull requests to us.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for coderunner, version 1.0
Filename, size File type Python version Upload date Hashes
Filename, size coderunner-1.0-py3-none-any.whl (6.0 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size coderunner-1.0.tar.gz (6.2 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page