CodeShuffler empowers instructors to rearrange lines within coding files, regardless of the programming language used, producing an output image that presents the shuffled lines of code. Additionally, it generates multiple-choice options, with one of them signifying the correct sequence of coding lines. This tool simplifies the process of conducting paper-based coding assessments, eliminating the need for manual grading and streamlining the evaluation process for educators.
CodeShuffler, along with all associated coding files, and the assessment template, are copyrighted by Hasan Baig and are made publicly available under the following license terms:
"CodeShuffler © 2025 by Hasan Baig is licensed under Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0)". To view a copy of this license, visit http://creativecommons.org/licenses/by-nc-sa/4.0/.
-
You need to install Python Pillow library, which you can do simply by executing the following command:
pip install pillow -
To run the program, you need to execute
main.pyfile alongwith the input code filename as a commandline argument. For example, to shuffle the code, for examplesamplecode.py, first place it in the directory\codefiles\and then execute the following:python main.py samplecode.py
-
You can optionally add incorrect instructions at the end of the input code after adding the comment line "#Incorrect lines below". See
samplecode.pyfor help. Then set the switchinclude_incorrect_instructions = Trueinlib\settings.pyfile. -
You can optionally specify to keep X number of lines same in the generated multiple choice questions by setting the value of switch
first_same_X_lines_MCQinlib\settings.pyfile. -
You can specify how many multiple choice options you want to generate by setting the value of a switch
no_of_choicesinlib\settings.pyfile.