Smart File Organizer v0.3.0
Smart File Organizer v0.3.0
Highlights:
- User TOML semantic rules now extend built-in rules instead of replacing them (#25).
- Added optional recursive directory scanning with
--recursive(#22). - Added JSON plan preview output with
--format json(#24). - Added opt-in destination conflict resolution with
--conflict-strategy rename(#23). - Improved built-in filename rules for utilities, health, banking, INPS, and programming books (#28).
- Reduced false positives in
--inspect-contentmatching (#26). - Suppressed third-party PDF parser warnings by default; use
--verboseto show them (#27).
Compatibility:
- Default behavior remains a safe dry run.
- Files are moved only with
--apply. - Text plan output remains the default preview format.
- Destination conflicts still fail by default unless
--conflict-strategy renameis passed.
Real-world validation:
- Tested on a personal backup dataset (~125 files, recursive scan).
- Name-only classification: ~81% of files routed to semantic folders.
- With
--inspect-content: ~89% classified, 14 files remaining in genericdocuments/.
Validation:
- ruff format check
- ruff lint
- ty check
- pytest (120 tests)
Privacy boundary:
- Real/private files, local configuration, manual-run data, and private document contents are not included in the repository.