How jarrodfolinofc/examon-core works
Main Components
A. Core Framework Layer:
• ExamonItem Registry (Central coordination)
• ExamonSerializer (Data persistence)
• Question Models & Factories
B. Code Execution Layer:
• Sandbox Environment
• Restricted Python Driver
• Unrestricted Driver
• Print Collector
C. Question Types Layer:
• Multiple Choice Questions
• Code as String Questions
• Input Parameter Questions
• Free Text Questions
Component Relationships
┌─────────────────────────────────────────────────────┐
• Client Interface │
• ┘
• ↓
┌─────────────────────────────────────────────────────┐
• Examon Item Registry │
• (Central coordination and question management) │
• ┘
• ↙ ↓ ↘
┌──────────────┐ ┌─────────────┐ ┌─────────────┐
• Question │ │ Code │ │ Question │
• Factories │ │ Execution │ │ Models │
• ┘ └─────────────┘ └─────────────┘
• ↙ ↘ ↙ ↘ ↓
┌──────┐ ┌──────┐ ┌───────┐ ┌──────────┐ ┌─────────┐
• MC │ │Code │ │Restr. │ │Unrestr. │ │Question │
• Quest.│ │Quest.│ │Python │ │Execution │ │Response │
• ┘ └──────┘ └───────┘ └──────────┘ └─────────┘
Important Details
A. Security Boundaries:
• Sandbox environment
• Isolation between restricted and unrestricted execution
B. Data Flow:
• Question creation flow
• Code execution flow
• Result collection and validation
Additional Architectural Notes
• Factory Pattern Implementation: Show how different question types are created
• Serialization Layer: Include how questions are stored/retrieved
• Code Metrics: Show how difficulty calculations are integrated
Implementation Details to Emphasize
• The separation between question types and their factories
• The isolation of code execution environments
• The central role of the ExamonItemRegistry
• The extensibility points for new question types