Generate multiple choice exams from YAML input files. The exams can have a randomized question order, randomized answer orders, and randomized numbers in the exams.
usage: exam-writer.py [-h] [-a] [-d] [-D] [-O] [-P] [-Y] file
Write an exam based on YAML input files
positional arguments:
file An input file describing the exam
optional arguments:
-h, --help show this help message and exit
-a, --all Include all questions and do not reorder
-d, --dry-run Don't generate output files
-D, --dump Dump the input file to the output
-O, --one-version Build a single version (for debugging exam)
-P, --pickle Load existing exam version from a pickle file
-Y, --yaml Dump a YAML representation of the parsed input
There is a sample exam in samples/sample-test.yaml which has been used
for testing the exam-writer.py script. The YAML file needs to be written
for the pyYAML input parser, with one minor extension. When the file is
read, and before it is parsed, lines with the format:
- Include: <filename.yaml>
are interpreted to name an include file, which is included into the input
stream of the pyYAML parser. The file name is search for along the path
.:./templates/:${SCRIPTDIR}/templates/ where SCRIPTDIR is the
directory containing exam-writer.py. The filename can be anything, but
it is recommended to use "yaml" as an extension.
[comment]: # Kludge a comment block with an empty line followed by lines [comment]: # prefixed by '[comment]: #'
[comment]: # Local Variables: [comment]: # mode:markdown [comment]: # End: