ArcaneExamz is a humble script for generating randomized exams with questions and answers randomization using LaTeX and Python. You can generate unique variants of your exam in seconds. You can also generate version with solutions at the same time. So far it works with open and multichoice questions.
Development is still in progress; tutorials will be added in the foreseeable future. So far: works on windows, make sure you have latex installed - it's used for compilation... check in pycharm, it should work...
For me as a teacher it's important that you understand how it works. (full documentation will be added in the future) Right, check the PDF files in the repository. You can see that there two variants of the test. The questions come from .CSV files (you can edit them in excel, make sure to save them back as UTF-8 CSV). Script loads data from CSV files based on the first column (OPEN = open question, MULTI = multichoice question). You can use any number of source files. I use one for current subject matter questions, the second file (old questions) are from the previous exams. You can edit how many questions from which category will be there. It's up to you.
My tests are cumulative - some questions are part of the current subject matter, and some questions are from older tests - to keep the facts in the long-term memory and create logical connections.
This script randomly picks n questions from the files defined by user. If there MULTI - multichoice questions, the order of them is also randomized. Check in example.pdf
Hell yeah. All those parameters can be set in the main.py, check it, change it. I want you to be creative!
- Windows (tested on W11)
- python installed
- pdflatex installed (check if pdflatex command in cmd works, if so, you should be fine)
- PyMuPDF==1.24.9
Look, maybe in the future I'll make it work from the command line. But for now it's easier to load this project in PyCharm (or IDE of your choice) and run it from there. You have to edit parameters in the main.py, the functions that take care of the code are in the functions.py.
I write this script in my free time, and I dare my students (or you) to help with development. There are several things to be added... (like things to be added section) if you miss something, please create an issue.