Repository files navigation

A Python based AutoGrader for Python Assignments.

This system is developed forFAST-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.

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

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

cd AutoGrader/pip install -r requirements.txt

For the installation first grab the latest source from theGitHub

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

Edit settings.py of Django

cd AutoGr/mv settings-sample.py settings.pyvi settings.pycd ../

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 migratepython manage.py createsuperuserpython manage.py runserver

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

1. After the installation admin user can logon to the system.
2. 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).
3. After the creation of instructor, instructor will logon to his account.
4. Instructor will create Assignment and share enroll key with students.
5. Student will register to the system fromhttp://127.0.0.1:8000/autograder
6. Student will logon to the system and enter the enroll key to enroll into the course.
7. Student will select the course, then assignment and then follow the instruction written on that page.

Instructor uploads three files with Assignment which isassignment_file,instructor_test_file andstudent_test_file. Student will have to write code inassignment_file andit will be tested againststudent_test_file for student and after the submission to server theassignment_file will be tested againtsinstructor_test_file and submission will be stored with score in the database.

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

• Python - Language used
• Django - The web framework used

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

We useSemVer for versioning. For the versions available, see thetags on this repository.

• 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 ofcontributors who participated in this project.

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

• autograder-basic developed byrecluze was used for grading purpose.
• moss.py: Python interface ofMoss was used for Detecting Software Similarity.

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