How subwaymatch/jupygrader works
Jupygrader is a notebook-grading package with two instructor workflows: generate a student-facing assignment from a solution notebook, or grade submitted notebooks and produce reviewable results. The main grading path accepts submissions through the public API, coordinates per-notebook execution or full-AI tasks, then packages scores and reports. Separate capabilities include manual and hybrid grading, hidden-test obfuscation, extracted student code, and integrity hashes. Edges reflect the supplied source excerpts, SOURCE INDEX references, and README; unsampled subsystem details and some integrations are therefore omitted or marked unverified.
Main entry points: batch_grading_manager.py Batch coordinator · execution_grading_task.py Notebook execution · ai_grader.py AI grading · results.py Grading results
Components 19
Assignment authoring
- CLI
src/jupygrader/cli.py - Assignment generation
src/jupygrader/generate_assignment.py - Test obfuscation
src/jupygrader/obfuscate.py
Grading workflow
- Notebook operations
src/jupygrader/notebook_operations.py - Grading API
src/jupygrader/grader.py - Batch coordinator
src/jupygrader/grading/batch_grading_manager.py - Task lifecycle
src/jupygrader/grading/base_grading_task.py - Grading configuration
src/jupygrader/models/config.py - File and template utilities
src/jupygrader/utils.py
Evaluation
- Notebook execution
src/jupygrader/grading/execution_grading_task.py - Full AI grading
src/jupygrader/grading/full_ai_grading_task.py - AI grading
src/jupygrader/grading/ai_grader.py - AI grading modes
src/jupygrader/models/ai_models.py - Grader cell templates
src/jupygrader/resources/jupyter_cell_scripts
Results and reports
- Grading results
src/jupygrader/models/results.py - HTML report export
src/jupygrader/html_export.py
Other components
- Instructor
- Notebook submission
- OpenAI-compatible service
Connections 24
- Instructor → CLI: runs commands
README.md - CLI → Assignment generation: generates assignment
src/jupygrader/cli.py - Assignment generation → Test obfuscation: obfuscates tests
src/jupygrader/generate_assignment.py - Assignment generation → Notebook operations: detects test cases
src/jupygrader/generate_assignment.py - Instructor → Grading API: submits grading request
README.md - Notebook submission → Grading API: provides notebooks
README.md - Grading API → Batch coordinator: creates coordinator
src/jupygrader/grader.py - Batch coordinator → Notebook execution: dispatches execution
src/jupygrader/grading/batch_grading_manager.py - Batch coordinator → Full AI grading: dispatches full AI
src/jupygrader/grading/batch_grading_manager.py - Batch coordinator → Grading configuration: configures batch
src/jupygrader/grading/batch_grading_manager.py - Notebook execution → Task lifecycle: extends lifecycle
src/jupygrader/grading/execution_grading_task.py - Notebook execution → Notebook operations: preprocesses notebook
src/jupygrader/grading/execution_grading_task.py - Notebook execution → Grader cell templates: loads grader scripts
src/jupygrader/grading/execution_grading_task.py - Notebook execution → AI grading: requests AI review
src/jupygrader/grading/execution_grading_task.py - Full AI grading → AI grading: grades notebook content
src/jupygrader/grading/full_ai_grading_task.py - AI grading → OpenAI-compatible service: requests model grading
- AI grading → AI grading modes: validates AI results
src/jupygrader/grading/ai_grader.py - Notebook execution → Grading results: records test outcomes
src/jupygrader/grading/execution_grading_task.py - Full AI grading → Grading results: records AI outcomes
src/jupygrader/grading/full_ai_grading_task.py - Task lifecycle → Notebook operations: extracts user code
src/jupygrader/grading/base_grading_task.py - Task lifecycle → HTML report export: exports HTML report
src/jupygrader/grading/base_grading_task.py - HTML report export → Grading results: renders result details
src/jupygrader/html_export.py - Batch coordinator → Grading results: collects batch results
src/jupygrader/grading/batch_grading_manager.py - Batch coordinator → File and template utilities: caches remote files
src/jupygrader/grading/batch_grading_manager.py