GitHunt
CO

codeclassroom/CodeRunner

A judge ๐Ÿ‘จ๐Ÿฝโ€โš–๏ธ for your programs, run and test your programs using python

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

Installation

Install using pip from PyPI

pip install coderunner

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

pip install git+https://github.com/codeclassroom/CodeRunner.git

Usage

from coderunner import coderunner
import os

from dotenv import load_dotenv
load_dotenv()

source_code = "testfiles/" + "test_python_input.py"
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
r.api(key=API_KEY)

# run the code
r.run()

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

# See Documentation for more methods.

Documentation

CodeRunner Documentation

Development

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

๐Ÿ“ Changelog

See the CHANGELOG.md file for details.

๐Ÿ”ฅ Powered By

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

Author

๐Ÿ‘ฅ Bhupesh Varshney

forthebadge

๐Ÿ“œ 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.

Languages

Python85.9%Java4.7%C++3.8%Shell3.3%C2.2%

Contributors

MIT License
Created July 13, 2019
Updated July 26, 2025