nbautoeval

nbautoeval is a Python framework designed to create auto-evaluated exercises within Jupyter notebooks, primarily for educational purposes. It enables teachers to provide immediate visual feedback on student code and quiz answers, facilitating interactive learning in Python courses.

Key Features

• Code-Oriented Exercises — Supports writing functions, regular expressions, generators, and classes with teacher-provided solutions and test data.
• Quiz Module — Allows creation of quizzes defined in YAML format with markdown support, managed via run_yaml_quiz().
• Visual Feedback — Displays green/red outcomes comparing student code against teacher solutions on defined data samples.
• Attempt Tracking — Stores each attempt as JSON in ~/.nbautoeval.trace and preserves quiz states in ~/.nbautoeval.storage.
• Teacher Statistics — Accumulates data on all correction attempts to provide feedback to instructors.

Philosophy

nbautoeval focuses on simplicity and practicality, providing a minimal setup for auto-evaluation directly in Jupyter environments to enhance hands-on programming education.