quick-quiz-generator

qqg is a rust program designed to let you create interactive quizzes blazingly fast, right in the terminal.

version 2.0.0

qqg version 2.0.0 is the third breaking release of qqg, after 1.0.0 and 0.1.0, filled with new features and code improvements.

features

• simple and portable text format for structured quizzes
• free and open-source, under GPL-3.0-or-later
• fast, handmade parser with robust lexing
• colored output and symbols
• 0 dependencies, only std

[!TIP] if your stdout is not a terminal, or the NO_COLOR environment variable is set, qqg doesn't use colors

install

using cargo, you can run:

cargo install quick-quiz-generator

you can also see our github releases for your platform. since 2.0.0, the following binaries are released:

• x86_64-windows
• aarch64-windows
• x86_64-linux
• aarch64-linux
• x86_64-apple
• aarch64-apple

usage

qqg parses .qq (quick-quiz) files, and runs them as quizzes. to get started, create a file test.qq and write:

title "quick-quiz-generator" by "sarkar-segfault" pass 1

question "what is 1 + 1?" {
	answer {
  	"2"
  }
	value 1
}

[!TIP] qqg supports comments, commas, unicode strings, and negative values in input too.

run it using the following command:

qqg start test.qq

for some sample quizzes, see samples/.

commands

qqg has 4 main subcommands:

most of the time, you'll only use help and start; the others are mostly for testing.

contribution

qqg was started as a one-man project by me, but i would appreciate any help i can get! just make an issue or pull request at the repo, and i promise i'll check it out.