How spandandey961-max/spandy-shows works
Spandy Shows is an offline desktop app for running Python, Java, and C programs and visualizing their recorded execution. The main workflow is: a user edits or selects a program, requests a run or visualization, the backend manages execution and input, and the UI presents output and trace steps for playback and inspection. Desktop mode also provides a local program library. The README documents language-specific tracing and inspection capabilities; some implementation links are shown only as unverified where the excerpts do not establish the call path.
Main entry points: App.tsx Workspace App · runner.py Job Runner · app.py Execution API · c_worker.py C Execution Worker
Components 23
Code Workspace
- Workspace App
spandy-shows/src/App.tsx - Code Editor
spandy-shows/src/Editor.tsx - Example Programs
spandy-shows/src/examples.ts
Execution Service
- Execution API
spandy-shows/backend/app.py - Job and Trace Schema
spandy-shows/backend/schema.py - Job Runner
spandy-shows/backend/runner.py - Resource Limits
spandy-shows/backend/limits.py - Interactive Input
spandy-shows/backend/interactive.py
Trace Collection
- Python Tracing
spandy-shows/backend/python_worker.py - Java Tracing
spandy-shows/backend/java_worker.py - Java Runtime Helper
spandy-shows/backend/java/SpandyRun.java - Java JDI Tracer
spandy-shows/backend/java/SpandyTracer.java - C Execution Worker
spandy-shows/backend/c_worker.py - C State Observer
spandy-shows/backend/c_observer.py - C Output Capture
spandy-shows/backend/c_capture.c
Trace Inspection
- Memory Diagram
spandy-shows/src/Diagram.tsx - Memory Layout
spandy-shows/src/memoryLayout.ts - Program Output
spandy-shows/src/Output.tsx - Step Explanation
spandy-shows/src/stepDetails.ts
Desktop Services
- Local Program Library
spandy-shows/backend/library.py - Desktop Backend Service
spandy-shows/desktop/service.py - Desktop Shell
spandy-shows/desktop/main.cjs
Other components
- Programmer
Connections 23
- Programmer → Workspace App: edits and runs
- Workspace App → Code Editor: renders editor
spandy-shows/src/App.tsx - Workspace App → Example Programs: loads examples
spandy-shows/src/App.tsx - Workspace App → Execution API: sends requests
spandy-shows/src/App.tsx - Execution API → Job Runner: starts jobs
spandy-shows/backend/app.py - Execution API → Job and Trace Schema: validates requests
spandy-shows/backend/app.py - Execution API → Local Program Library: uses program library
spandy-shows/backend/app.py - Job Runner → Job and Trace Schema: validates traces
spandy-shows/backend/runner.py - Job Runner → Interactive Input: uses input helpers
spandy-shows/backend/runner.py - Job Runner → Resource Limits: applies limits
spandy-shows/backend/runner.py - Job Runner → Python Tracing: dispatches execution
- Job Runner → Java Tracing: dispatches execution
- Job Runner → C Execution Worker: dispatches execution
- Java Tracing → Java Runtime Helper: uses runtime helper
- Java Runtime Helper → Java JDI Tracer: supports tracing
spandy-shows/backend/java/SpandyTracer.java - C Execution Worker → C State Observer: collects state
- C Execution Worker → C Output Capture: captures output
- Workspace App → Memory Diagram: renders trace
spandy-shows/src/App.tsx - Memory Diagram → Memory Layout: layouts objects
spandy-shows/src/Diagram.tsx - Workspace App → Program Output: renders output
spandy-shows/src/App.tsx - Workspace App → Step Explanation: shows step details
spandy-shows/src/App.tsx - Desktop Shell → Desktop Backend Service: starts backend
- Desktop Backend Service → Execution API: loads FastAPI app
spandy-shows/desktop/service.py