How mohamed-irban8738/punas-power-shell-pps works
Punas Power Shell is an educational command-line shell whose commands operate on an isolated, in-memory virtual filesystem. The main workflow is user input → parsing → command dispatch → shell handlers → filesystem operations → virtual filesystem state, with command history and logging recorded during the loop. The README also describes configuration and a broader command set, including extra commands. Edges reflect the shown excerpts or README; some command-registration wiring is not visible in the sampled shell excerpt, so it is not asserted.
Main entry points: shell.py Shell Engine · extra_commands.py Extra Commands · filesystem.py File Manager · main.py Application Entry
Components 14
Shell Runtime
- Application Entry
main.py - Shell Engine
src/shell.py - Command Parser
src/parser.py - Command Dispatcher
src/commands.py
Command Features
- Core Handlers
src/shell.py - Extra Commands
src/extra_commands.py
Virtual Filesystem
- File Manager
src/filesystem.py - Virtual Filesystem
src/virtual_fs.py
Session State
- Command History
src/history.py - Configuration
src/config.py - Config File
config.json - Activity Logger
src/logger.py - Log File
Other components
- Shell User
Connections 16
- Shell User → Application Entry: starts shell
README.md - Application Entry → Shell Engine: starts
main.py - Shell User → Shell Engine: enters commands
README.md - Shell Engine → Command Parser: parses input
src/shell.py - Shell Engine → Command Dispatcher: dispatches commands
src/shell.py - Shell Engine → File Manager: runs file operations
src/shell.py - Shell Engine → Command History: records commands
src/shell.py - Shell Engine → Activity Logger: logs commands
src/shell.py - Shell Engine → Configuration: loads settings
src/shell.py - File Manager → Virtual Filesystem: delegates operations
src/filesystem.py - Extra Commands → File Manager: reads virtual files
src/extra_commands.py - Extra Commands → Virtual Filesystem: traverses virtual paths
src/extra_commands.py - Extra Commands → Command Dispatcher: registers handlers
src/extra_commands.py - Configuration → Config File: loads and saves
src/config.py - Activity Logger → Log File: writes entries
src/logger.py - Shell Engine → Extra Commands: registers extra commands
src/shell.py