Sortium
A Python utility that automatically organizes files in a directory based on their type (e.g., Images, Documents, Videos, etc.) and optionally by their last modified date.
The Narrative
Built a high-performance Python utility for organizing file systems with a preview-first workflow, allowing users to audit JSON plans before execution.
Engineered memory-efficient recursive scanning using generators and streaming I/O, capable of handling massive directories without exhausting RAM.
Implemented flexible sorting strategies based on file extensions, modification dates, and custom regex patterns with collision-safe unique renaming.
Published to PyPI with comprehensive Sphinx documentation, 100% test coverage using pytest, and automated GitHub Actions CI pipelines.
System Highlights
Auto-sort
Recursively classifies files into category folders using extension-based rules or custom regex patterns.
CLI Tool
Argparse-powered commands support plan generation, preview modes, and reversible executions.
Plan-first
Generates editable JSON plans so you can review and tweak intended moves before touching the disk.
PyPI Package
Published to PyPI with versioned releases for easy installation and global accessibility.
