How nicolasserranogarcia/nsbaci works
NSBACI is a desktop environment for learning concurrency by editing BACI source, compiling it to p-code, and stepping or running the resulting program while inspecting runtime state. The documented architecture places a Controller between the Qt interface and file, compiler, and runtime services. The runtime combines an interpreter, scheduler, and program state; the UI also includes preferences, error, guide, and drawing views. Source excerpts establish the main wiring, but several implementation files were not sampled, so uncertain internal links are omitted.
Main entry points: mainwindow.cpp Main window · controller.cpp Controller · main.cpp Application setup · runtimeService.cpp Runtime service
Components 21
Desktop interface
- Main window
source/ui/mainwindow/mainwindow.cpp - Code editor
source/ui/mainwindow/codeeditor.cpp - Preferences
source/ui/preferencesDialog/preferencesDialog.cpp - Runtime view
source/ui/runtimeView/runtimeView.cpp - User guide
source/ui/userGuideDialog/userGuideDialog.cpp - Error dialogs
source/ui/errorDialogFactory/errorDialogFactory.cpp - Drawing widget
source/ui/drawingWidget/drawingWidget.cpp
Application coordination
- Application setup
source/main.cpp - Controller
source/controller/controller.cpp
Source and compilation
- File service
source/services/fileService/fileService.cpp - Compiler service
source/services/compilerService/compilerService.cpp - NSBACI compiler
source/services/compilerService/compiler/nsbaci/nsbaciCompiler.cpp - P-code instructions
source/services/compilerService/compiler/instruction/instruction.cpp
Program execution
- Runtime service
source/services/runtimeService/runtimeService.cpp - Program state
source/services/runtimeService/program/program.cpp - NSBACI interpreter
source/services/runtimeService/interpreter/nsbaci/nsbaciInterpreter.cpp - NSBACI scheduler
source/services/runtimeService/scheduler/nsbaci/nsbaciScheduler.cpp - Thread state
source/services/runtimeService/thread/thread.cpp - Semaphore state
source/services/runtimeService/semaphore/semaphore.cpp
Drawing
- Drawing service
source/services/drawingService/drawingService.cpp
Other components
- Learner
Connections 28
- Learner → Main window: uses
- Main window → Controller: sends actions
- Controller → Main window: sends results
- Main window → Code editor: hosts editor
- Main window → Preferences: opens
- Main window → Runtime view: updates
- Main window → User guide: opens
- Main window → Error dialogs: shows errors
- Application setup → Main window: creates
source/main.cpp - Application setup → Controller: creates
source/main.cpp - Controller → File service: delegates file I/O
- Controller → Compiler service: delegates compilation
- Controller → Runtime service: controls execution
- Compiler service → NSBACI compiler: invokes compiler
- NSBACI compiler → P-code instructions: produces p-code
- Runtime service → NSBACI interpreter: executes instructions
- Runtime service → NSBACI scheduler: selects threads
- Runtime service → Program state: loads program
- Program state → P-code instructions: stores instructions
- NSBACI interpreter → Program state: uses program state
- NSBACI interpreter → Thread state: uses thread state
- Program state → Semaphore state: manages semaphores
- Controller → Drawing service: coordinates drawing
- Drawing service → Drawing widget: updates canvas
- Application setup → File service: creates service
source/main.cpp - Application setup → Compiler service: creates service
source/main.cpp - Application setup → Runtime service: creates service
source/main.cpp - Application setup → Drawing service: creates service
source/main.cpp