AutoGrader

A Python based AutoGrader for Python Assignments.

Introduction

This system is developed for FAST-NUCES Peshawar Campus for the handling of student assignments. This system provide auto grading functionality for the students submission and generate submission reports for the instructor.

Functionality

Admin, Instructor and Student accounts
Course with unique enroll key
Assignments with test and assignment file
Assignment Submission Report (based on the latest submission)
Student Account: Password Recovery, Submission Password, Submission Score and Submission Log

Prerequisites

Check requirements.txt for the prerequisites packages. You can install requirment package using following command:

cd AutoGrader/
pip install -r requirements.txt

Installing

For the installation first grab the latest source from the GitHub

git clone git@github.com:BilalZaib/AutoGrader.git
cd AutoGrader/

Edit settings.py of Django

cd AutoGr/
mv settings-sample.py settings.py
vi settings.py
cd ../

Note: You have to add secret key and SMTP detail in this file. You can generate Django secret key from any online website.

Setting up super user for Django

python manage.py migrate
python manage.py createsuperuser
python manage.py runserver

Now go to http://127.0.0.1:8000/admin to logon to the system.

Getting into system?

After the installation admin user can logon to the system.
Admin can create the Instructor, set him as "is_staff" and assign the permissions for example Assignment (All), Course (View only), Student (All) and Submission (All).
After the creation of instructor, instructor will logon to his account.
Instructor will create Assignment and share enroll key with students.
Student will register to the system from http://127.0.0.1:8000/autograder
Student will logon to the system and enter the enroll key to enroll into the course.
Student will select the course, then assignment and then follow the instruction written on that page.

How system works?

Instructor uploads three files with Assignment which is assignment_file, instructor_test_file and student_test_file. Student will have to write code in assignment_file and it will be tested against student_test_file for student and after the submission to server the assignment_file will be tested againts instructor_test_file and submission will be stored with score in the database.

Deployment

Currently this system is used on a dedicated server located in the university with PostgresSQL database. Step for installation are same as the above.

Built With

Python - Language used
Django - The web framework used

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Authors

Hafiz M. Bilal Zaib - Initial coding - BilalZaib
Mohammad Nauman - Design and requirement gathering - recluze
Syed Owais Ali Chishti - Funtionality integrations - soachishti

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Acknowledgments

autograder-basic developed by recluze was used for grading purpose.
moss.py: Python interface of Moss was used for Detecting Software Similarity.

Note

There are no sandboxing mechanism in this system, however auto backups and system permission are used for now.

bilalzaib/AutoGrader