How stephrobert/dsoxlab works
dsoxlab is a domain-agnostic CLI for discovering declarative training catalogs, provisioning and opening labs, validating actual system state, and tracking learner progress locally. The graph preserves the documented course/challenge workflow, shell and VM runtimes, infrastructure-only use, diagnostics, and catalog authoring. Some command-to-service wiring is not shown in the excerpts; documented workflow edges cite the README, while uncertain implementation links are omitted.
Main entry points: lab_service.py Lab orchestration · demarrage.py CLI commands · repo.py Catalog discovery · scanner.py Lab scanner
Components 22
CLI experience
- CLI commands
src/dsoxlab/cli/demarrage.py - Course guide
src/dsoxlab/cli/parcours.py - Host diagnostics
src/dsoxlab/cli/diagnostic.py - Catalog commands
src/dsoxlab/cli/catalogues.py
Catalog and contracts
- Catalog metadata
src/dsoxlab/models/repo.py - Catalog discovery
src/dsoxlab/discovery/repo.py - Lab scanner
src/dsoxlab/discovery/scanner.py - Lab definitions
src/dsoxlab/models/lab.py - Contract validation
src/dsoxlab/validators/contract.py
Lab execution
- Lab orchestration
src/dsoxlab/services/lab_service.py - Runtime selection
src/dsoxlab/runtimes/manager.py - Shell runtime
src/dsoxlab/runtimes/shell.py - VM runtime
src/dsoxlab/runtimes/vm.py - Lab services
src/dsoxlab/runtimes/services.py - Infrastructure inventory
src/dsoxlab/infra/inventory.py - Terraform providers
src/dsoxlab/infra/terraform.py
Validation and progress
- State validation
src/dsoxlab/validators/content.py - Progress scoring
src/dsoxlab/services/progress_service.py - Local history
src/dsoxlab/sessions/store.py - Results output
src/dsoxlab/reporting/console.py - Hints and costs
src/dsoxlab/models/hint.py
Other components
- Learner
Connections 26
- Learner → CLI commands: runs commands
README.md - CLI commands → Course guide: opens lesson
README.md - CLI commands → Lab orchestration: runs lab
README.md - CLI commands → Host diagnostics: checks host
README.md - CLI commands → Catalog commands: manages catalog
- Catalog commands → Catalog discovery: discovers labs
- Catalog discovery → Catalog metadata: reads metadata
src/dsoxlab/discovery/repo.py - Catalog discovery → Lab scanner: scans catalog
src/dsoxlab/discovery/scanner.py - Lab scanner → Lab definitions: loads definitions
src/dsoxlab/discovery/scanner.py - Contract validation → Catalog metadata: checks contract
src/dsoxlab/validators/contract.py - Contract validation → Lab scanner: validates catalog
src/dsoxlab/validators/contract.py - Lab orchestration → Catalog discovery: locates catalog
src/dsoxlab/services/lab_service.py - Lab orchestration → Lab scanner: loads lab
src/dsoxlab/services/lab_service.py - Lab orchestration → Runtime selection: selects runtime
src/dsoxlab/services/lab_service.py - Runtime selection → Shell runtime: builds shell
src/dsoxlab/runtimes/manager.py - Runtime selection → VM runtime: builds VM
src/dsoxlab/runtimes/manager.py - Lab orchestration → Lab services: starts services
- VM runtime → Infrastructure inventory: provisions VM
- Infrastructure inventory → Terraform providers: routes provider
src/dsoxlab/infra/inventory.py - Lab orchestration → State validation: checks system state
README.md - State validation → Progress scoring: scores result
README.md - Progress scoring → Local history: persists history
README.md - Progress scoring → Results output: shows score
src/dsoxlab/reporting/console.py - Lab orchestration → Hints and costs: offers hints
src/dsoxlab/services/lab_service.py - Learner → Lab orchestration: requests challenge
README.md - CLI commands → Infrastructure inventory: runs infra-only
src/dsoxlab/cli/demarrage.py