jnguyen1098 / quizmake

Randomized question generator for Moodle with editable tokens

quizmake

A question generator I made for the University of Guelph.

Despite developing this for Moodle, it should support anything that can take its export formats.

Questions are randomized from token files that are called dynamically by the user.

The user scripts the questions using a simple three-part file format to be covered later.

https://github.com/alvations/Quotables

Installation

If you use pip3, you can install it by doing

>>> pip3 install quizmake

Alternatively, you may install this repo locally by cloning it and running

>>> pip3 install -e .

Information

PyPi: https://pypi.org/project/quizmake/

Github: https://github.com/jnguyen1098

License: MIT License

Header

Lorem ipsum dolor sit amet.

• Lorem ipsum dolor sit amet

Lorem ipsum dolor sit amet

google

verbatim

Title

subtitle

subsubtitle

Lmao

If under and overline are used, their length must be identical

# with overline, for parts

• with overline, for chapters

=, for sections

-, for subsections

^, for subsubsections

“, for paragraphs

• This is a bulleted list.
• It has two items, the second item uses two lines. (note the indentation)

1. This is a numbered list
2. It also has two items
3. This is also a numbered list
4. But it doesn't use explicit numbering

Code block test

lmao
for (int i = 0; i < 10; i++) {
    puts("lmao");
}

Also a test

>>> Test

• What your project does
• How to install it
• Example usage
• How to set up the dev. environment
• How to ship a change
• Changelog
• License info

raw.githubusercontent.com/dbader/readme-template/master/README.md

quizmake's Issues

re-understand the project

Make a decision regarding recursive search

I don't know what should happen if you hand the program a question or token folder with subfolders. I think I might just add a recursive flag, but I don't know what would be best

If I implement recursive, then it would be best to have the flag specify to the main() whether it uses assert_nonempty_dir() or assert_dir_has_files().

write more tests before refactoring

requires #7

Add strictness flags

Currently the program will skip over invalid question/token files, but there should be:

• An option to disable the warnings regarding this (less-strict mode), and

• An option to disallow this behaviour (strict mode)

The former would be good for those who don't want to be badgered into deleting a ton of files. It would also give a deterministic answer for the situation of having a single folder containing both questions and tokens...

Inline/literal randomization

Both completely random and memory-based. for example:

Who did {jack|jill} fight at the round table?

or for memory:

Who did {jack|jill}1 fight at the round table?

README

I need an actual README lol.

Categories

eom

refactor the code and lint a lot

requires #8