Usage

$ quixote -h
Quizzes and tests in Markdown

<https://crates.io/crates/quixote> / <https://github.com/qtfkwk/quixote>

---

Usage: quixote [OPTIONS] [PATH/GLOB]...

Arguments:
  [PATH/GLOB]...  

Options:
  -q <PATH>              Generate quiz(zes)
  -a <answers.json>      Grade quiz(zes)
  -r                     Print readme
  -h, --help             Print help
  -V, --version          Print version

$ quixote -V
quixote 0.2.0

Example

Create Markdown files with questions and answers

• example/src
  • addition.md
  • multiple-answer.md
  • subtraction.md
  • word-problems.md

• Use multiple files to organize questions and enable generating quizzes from any subset.
• Write questions in one or more paragraphs, optionally with any Markdown span syntax and/or tables, images, lists, etc.
• Place answers after all question content as an unordered list with the correct answer(s) in bold/strong.
• Use a rule (---) between questions.

Generate a quiz

quixote example/src -q example/1

• example/1
  • quiz.md: Quiz for students
  • answers.md: Quiz with answers
  • answers.json: Answer key

• The quiz includes all questions and answers, both in random order.

• To generate a quiz from a subset of source files, use one or more paths or globs to specify it; for example, to only include questions from addition.md and subtraction.md, the command is:

  quixote example/src/addition.md example/src/subtraction.md \
  -q example/addition-subtraction
  

• Path/glob arguments:

  • Absolute or relative path to a file or directory
  • Use your shell's globbing.
  • If using the -q option and an argument is a directory, it converts to directory/**/*.md to include all *.md files under directory/.
  • Use built-in globbing by properly quoting and/or escaping the argument so it is not interpreted by your shell. See the reference section on globbing below for more details.

Grade a quiz

Completed quiz (period-1.json):

{
  "description":"Quiz 1 - Period 1",
  "students":{
    "Alvin Anderson":{"1":["A"],"2":["C"],"3":["A"],"4":["B"],"5":["A"],"6":["A"],"7":["A"],"8":["A"]},
    "Beatrice Brown":{"1":["E","G"],"2":["C"],"3":["E"],"4":["B"],"5":["C"],"6":["A"],"7":["A","B","C","D","E","F"],"8":["A"]},
    "Chris Clark":{"1":["E"],"2":["C"],"3":["E"],"4":["B"],"5":["C"],"6":["A"],"7":["A","B","D","E","F"],"8":["A"]},
    "Denise Dixon":{"1":["E","G"],"2":["C"],"3":["E"],"4":["B"],"5":["C"],"6":["A"],"7":["A","B","C"],"8":["A"]},
    "Erik Edwards":{"1":["E","G"],"2":["D"],"3":["B"],"4":["A"],"5":["C"],"6":["C"],"7":["A","B","C","D","E","F"],"8":["B"]}
  }
}

Answer key (answers.json):

{"1":["E","G"],"2":["C"],"3":["E"],"4":["B"],"5":["C"],"6":["A"],"7":["A","B","C","D","E","F"],"8":["A"]}

Run:

quixote -a example/1/answers.json example/1/period-1.json \
>example/1/period-1.md

Output (period-1.md):

# Quiz 1 - Period 1

| Name           | Score | Percent | Grade | Wrong         |
|----------------|------:|--------:|-------|---------------|
| Beatrice Brown |    14 |  100.0% | A     |               |
| Chris Clark    |    12 |   85.7% | B     | 1, 7          |
| Denise Dixon   |    11 |   78.6% | C     | 7             |
| Erik Edwards   |     9 |   64.3% | D     | 2, 3, 4, 6, 8 |
| Alvin Anderson |     4 |   28.6% | F     | 1, 3, 5, 7    |

| Description         | Value         |
|---------------------|---------------|
| Number of questions | 8             |
| Total points        | 14            |
| High score          | 14, 100.0%, A |
| Low score           | 4, 28.6%, F   |
| Mean score          | 10, 71.4%, C  |
| A                   | 1             |
| B                   | 1             |
| C                   | 1             |
| D                   | 1             |
| F                   | 1             |

Changelog

• 0.1.0 (2023-12-06): Initial release
  • 0.1.1 (2023-12-06): Save the quiz grading report to a file
  • 0.1.2 (2023-12-06): Fix typo
  • 0.1.3 (2023-12-07): Clean up readme and code
• 0.2.0 (2023-12-07): Streamline design: -g is now -q, improved tables; debug: bat pager, don't create quiz directories; fix typo

Reference

Globbing

• ? matches any single character.
• * matches any (possibly empty) sequence of characters.
• ** matches the current directory and arbitrary subdirectories. This sequence must form a single path component, so both **a and b** are invalid and will result in an error. A sequence of more than two consecutive * characters is also invalid.
• [...] matches any character inside the brackets. Character sequences can also specify ranges of characters, as ordered by Unicode, so e.g. [0-9] specifies any character between 0 and 9 inclusive. An unclosed bracket is invalid.
• [!...] is the negation of [...], i.e. it matches and characters not in the brackets.
• The metacharacters ?, *, [, ] can be matched by using brackets (e.g. [?]). When a ] occurs immediately following [ or [! then it is interpreted as being part of, rather then ending, the character set, so ] and NOT ] can be matched by []] and [!]] respectively. The - character can be specified inside a character sequence pattern by placing it at the start or the end, e.g. [abc-].

Source: Documentation for the glob::Pattern struct

See also glob on crates.io or docs.rs.