How gvvaughan/specl works
Main Components
a. Core Testing Framework
• Main execution flow components (runner, loader, matchers)
• Sandbox environment for test isolation
b. Input/Output Components
• YAML spec files input
• Multiple formatter outputs (progress, report, TAP)
• Command-line interface
c. Support Systems
• Shell execution environment
• Expectation handling
• Utility functions
Component Relationships
[YAML Spec Files] → [Loader] → [Runner] → [Formatters]
• ↓ ↓ ↑
• [Sandbox] → [Matchers] → [Expect]
• ↓ ↓
• [Shell] [Utilities]
Specific Implementation Details
a. Test Execution Flow:
• How specs flow from YAML files through the system
• Sandbox isolation boundary
• Formatter output options
b. Core Components:
• Loader (lib/specl/loader.lua): YAML spec file parsing
• Runner (lib/specl/runner.lua): Test execution engine
• Matchers (lib/specl/matchers.lua): Assertion system
• Expect (lib/specl/expect.lua): Expectation handling
c. Support Systems:
• Shell (lib/specl/shell.lua): Command execution
• Sandbox (lib/specl/sandbox.lua): Test isolation
• Utilities (lib/specl/util.lua): Helper functions