quick-quiz-generator
| Crates.io | quick-quiz-generator |
| lib.rs | quick-quiz-generator |
| version | 2.1.0 |
| created_at | 2025-12-31 08:27:28.996591+00 |
| updated_at | 2026-01-24 08:58:57.820476+00 |
| description | generate interactive quizzes blazingly fast, right in your terminal |
| homepage | https://crates.io/crates/quick-quiz-generator |
| repository | https://github.com/sarkar-segfault/qqg |
| max_upload_size | |
| id | 2014242 |
| size | 71,143 |
Adhrit Sarkar (sarkar-segfault)
documentation
README
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_COLORenvironment 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:
| subcommand | description |
|---|---|
help |
prints help about the cli |
token <input.qq> |
tokenizes the file and prints its token list |
parse <input.qq> |
tokenizes and parses the file and prints the syntax tree |
start <input.qq> |
tokenizes, parses and runs the file as an interactive quiz |
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.