How debbuk/smart-file-organizer works
Smart File Organizer is a small CLI for sorting files into extension-based category folders. The user supplies a directory and options; the CLI calls the organizer to scan files, categorize them, and either preview or move them, then prints a report and optionally exports JSON. The README documents recursive scanning, hidden-file handling, ten categories, dry-run, and JSON reporting. The source excerpts show the CLI-to-organizer call and filesystem operations; reporting and export are implemented in the CLI.
Main entry points: cli.py CLI entry point · organizer.py Scan and organize
Components 7
CLI
- CLI entry point
smart_file_organizer/cli.py
Organization
- Scan and organize
smart_file_organizer/organizer.py - Extension categories
smart_file_organizer/organizer.py
Reporting
- Console report
smart_file_organizer/cli.py - JSON export
smart_file_organizer/cli.py
Other components
- User
- Local filesystem
Connections 8
- User → CLI entry point: runs command
README.md - CLI entry point → Scan and organize: calls planner
smart_file_organizer/cli.py - Scan and organize → Local filesystem: scans and moves
smart_file_organizer/organizer.py - Scan and organize → Extension categories: classifies files
smart_file_organizer/organizer.py - Scan and organize → CLI entry point: returns result
smart_file_organizer/cli.py - CLI entry point → Console report: prints report
smart_file_organizer/cli.py - CLI entry point → JSON export: exports report
smart_file_organizer/cli.py - JSON export → Local filesystem: writes JSON
smart_file_organizer/cli.py