How palliplease/simpfs works
SimpFS is a command-line block filesystem. A user enters commands in the loop in main.py, which dispatches file creation, reading, deletion, listing, storage reporting, and formatting to FileSystem; results are displayed in the terminal. The filesystem manages a fixed file table and contiguous data blocks, while VirtualDisk reads and writes the backing image in 512-byte blocks. The README also documents help, screen clearing, and exit commands. The map follows the sampled source; it does not assume additional filesystem features such as directories or file updates.
Main entry points: filesystem.py Filesystem · main.py Command loop · disk.py Virtual disk
Components 14
Command interface
- Command loop
main.py - Create command
main.py - Read command
main.py - Delete command
main.py - List command
main.py - Storage command
main.py - Format command
main.py
Filesystem operations
- Filesystem
filesystem.py - Block allocation
filesystem.py - File metadata
filesystem.py - File data I/O
filesystem.py
Block storage
- Virtual disk
disk.py - Disk image
Other components
- User
Connections 21
- User → Command loop: enters commands
- Command loop → Create command: dispatches
- Command loop → Read command: dispatches
- Command loop → Delete command: dispatches
- Command loop → List command: dispatches
- Command loop → Storage command: dispatches
- Command loop → Format command: dispatches
- Create command → Filesystem: creates file
- Read command → Filesystem: reads file
- Delete command → Filesystem: deletes file
- List command → Filesystem: lists files
- Storage command → Filesystem: measures usage
- Format command → Filesystem: formats filesystem
- Filesystem → Block allocation: finds free blocks
- Filesystem → File metadata: reads and writes entries
- Filesystem → File data I/O: reads and writes data
- Block allocation → File metadata: checks block ranges
- File metadata → Virtual disk: reads and writes blocks
- File data I/O → Virtual disk: reads and writes blocks
- Filesystem → Virtual disk: writes format header
- Virtual disk → Disk image: reads and writes