pyaota

pyaota is a Python application for generating and grading multiple-choice and true/false exams. It provides:

• Exam generation with randomizable questions from YAML question banks

• Automatic grading of scanned answer sheets

• Answer sheet rendering with QR codes and bubble fields via LaTeX/TikZ

• Email delivery of graded exams to students

• PDF bundling utilities for print management

Note

pyaota is under active development.

Contents

• Installation
  • Requirements
  • Install from PyPI
  • Install from source
  • Installing Poppler
• Usage
  • Global options
  • Subcommands
• Grading
  • Typical workflow
  • Answer key format
  • Scoring
  • Gradebook integration
  • Failed pages
  • Interactive mode
  • Question-level statistics
  • Encrypted answer embedding
  • Debug output
• Examples
  • Math quiz (MCQ only, QR-encoded answers)
  • History quiz (MCQ + True/False, QR-encoded answers)
  • Programming quiz (code-block stems)
  • Compile-dump (review / proofreading)
  • Blank answer sheet
  • Answer keys summary
  • Tips
• YAML Question Schema
  • Top-Level Structure
  • Question Structure
  • Stem Blocks
  • Choices
  • Correct Answer and Explanation
  • Output Formatting Rules
  • Newline Rules
  • Summary of Constraints
• Changelog
  • Changelog
• API Reference
  • pyaota package