What you’ll learn to build
- Plan categories without moving any real files
- Execute a reversible move on copied data and inspect its journal
- Test collisions and recovery, then document an operational handoff
Who it’s for
Beginners who want to automate files safely while learning pathlib and program state. Start after running and modifying a small Python script.
Two focused lessons
- 01
Run and understand the working tool
- 02
Test, extend and document the workflow
Explore the curriculum topics
- Why organization is a filesystem operation
- Paths as objects
- Map extensions to categories
- Preview is the default
- Top-level traversal
- Files versus symlinks
- Collision handling
- Understanding apply
- Why create a journal
- Undo without guessing
- Permissions and failures
- Backups are not undo journals
- Milestone: a complete preview/recover cycle
- Plan before acting
- The reserved destination set
- Hidden journals and metadata
- An empty-folder run
- Preflight the entire undo
- Interrupted operations
- Symlink destination attacks
- Safe testing with tempfile
- Choosing a file classification policy
- Cross-volume and partial failure design
- User documentation is product design
- Capstone acceptance tests
- Roadmap to robust automation
Project boundaries
Organizes top-level files. Try copied files first and keep backups. Undo can refuse when paths conflict; no background monitoring is included.