Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rsharifnasab/dj
Distributed code Judge
https://github.com/rsharifnasab/dj
automation judge
Last synced: about 20 hours ago
JSON representation
Distributed code Judge
- Host: GitHub
- URL: https://github.com/rsharifnasab/dj
- Owner: rsharifnasab
- License: mit
- Created: 2021-07-07T08:48:30.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-02-27T14:33:22.000Z (9 months ago)
- Last Synced: 2024-06-19T20:52:21.455Z (5 months ago)
- Topics: automation, judge
- Language: Go
- Homepage:
- Size: 2.06 MB
- Stars: 33
- Watchers: 3
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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](https://quera.ir)
## Badges
[](https://choosealicense.com/licenses/mit/)
## 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
- [Dr Mojtaba Vahidi, My Kind Supervisor](http://facultymembers.sbu.ac.ir/vahidi/)
- [Dr Sadegh Aliakbari, My Referee](http://facultymembers.sbu.ac.ir/aliakbary/)
- [Amir Arsalan San'ati, Who gave me the idea](https://github.com/Amirarsalan-sn)
## 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)
```bash
go install "github.com/rsharifnasab/DJ@latest"
```
And then use binary file like this:
```bash
DJ --help
```
## Distribute for students
To Distribute the project run
```bash
./scripts/dsitribute.sh
```
Then the distribution zip would be in `./bin/` directory.
## Running Tests
To run tests, run the following command
```bash
go test ./... -cover -count 1
```
## Documentation
Exploration on various software and library choices is Documented [here](https://github.com/rsharifnasab/DJ/tree/master/docs)
## 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](https://github.com/rsharifnasab/ta_utils): another repository for TAs which contains small and useful scripts.
- [Sharif Judge](https://github.com/mjnaderi/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](https://choosealicense.com/licenses/mit/)
## Support
For support, email [email protected].