Skip to content

rsharifnasab/DJ

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DJ

DJ stands for Distributed Judge. A tool that many TAs wish they would have. This would provide more flexibility over normal judges such as Quera

Badges

MIT License Languages count Commit Freq

CI status

Features

  • Judges student codes locally
  • The most flexible judge out there
  • Checks out source codes against illegal usage of language constructs.
  • Doesn't need a server

Acknowledgements

Installation

Prerequisites

  • Golang should be installed on your system
  • Also there is heavy usage of Bash
  • For running tests you should have python3 and gcc and java in your PATH

How to Install

Official way to use this repository is to clone the repository and run the "Distribute script"

You can also install the binary file like this (which is not recommended because it does not contain examples)

  go install "github.com/rsharifnasab/DJ@latest"

And then use binary file like this:

  DJ --help 

Distribute for students

To Distribute the project run

  ./scripts/dsitribute.sh

Then the distribution zip would be in ./bin/ directory.

Running Tests

To run tests, run the following command

  go test ./... -cover  -count 1

Documentation

Exploration on various software and library choices is Documented here

FAQ

Do I need this as a student?

No you don't. The course TA should clone this repository and create questions and then distribute questions alongside the judge and the binary for you.

Do I Have to learn Go before using this project?

No you don't. The flexible part is not programmed in Go, but instead you need a bit of bash script knowledge to tune judges and develop creative questions.

Used By

This project is used by the following courses:

  • Shahid Beheshti university, Advanced programming (WIP at that time)
  • Sharif University, Compiler course for CE students

Related

Here are some related projects

  • TA utils: another repository for TAs which contains small and useful scripts.
  • Sharif Judge: A free and open source online judge system for programming courses

Roadmap

  • Better Windows support
  • Provide learning resources for Bash script
  • Better API for source code checks
  • Save student scores on a Block Chain

License

MIT

Support

For support, email [email protected].

About

Distributed code Judge

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published