How pedal-edu/pedal works
Main Components
a) Core Framework Components:
• Report System (central component)
• Feedback System
• Resolver System
• Environment System
• Tools System
b) Major Tools (represented as modules):
• TIFA (Type Inference Feedback Analysis)
• CAIT (Code Analysis and Inspection Tool)
• Sandbox (Code Execution Environment)
• Assertions
• Questions
• Source Analysis
c) Environment Integrations:
• BlockPy
• Gradescope
• Jupyter
• NBGrader
• Terminal
• VPL
Component Relationships
[Instructor Control Script] → [Report]
• ↓
[Tools] → [Feedback Functions] → [Feedback] → [Resolver] → [Environment]
Specific Implementation Details
• Blue: Core Framework Components
• Green: Analysis Tools
• Orange: Environments
• Purple: Extensions
• Gray: Utilities
b) Component Groupings:
• Core Framework (Report, Feedback, Resolver)
• Analysis Tools (TIFA, CAIT, Sandbox, etc.)
• Environments (BlockPy, Gradescope, etc.)
• Extensions (Microbit, Plotting, Turtles)
Data Flow Representation
• Submission flow from Environment to Report
• Tool analysis results flowing to Feedback
• Feedback aggregation in Report
• Resolution process to final output
Important Details
a) Pipeline Stages:
1. Input/Submission
2. Analysis
3. Feedback Generation
4. Resolution
5. Output
b) Key Subsystems:
• Type checking (TIFA)
• AST analysis (CAIT)
• Runtime analysis (Sandbox)
• Static analysis (Source)
Architecture Patterns to Highlight
• Pipeline Architecture
• Plugin System (Tools)
• Environment Abstraction
• Feedback Collection and Resolution