How josephcanzana/filesort works
filesort is a one-shot command-line utility that organizes top-level files in the current user’s Downloads folder. Its intended workflow scans files, skips partial or changing downloads, chooses a category by extension, avoids name collisions, and renames files into category folders; it also offers an interactive uninstall option. The source shows that sort_files does not return a value, although main uses its result to count successful moves, so the displayed summary may incorrectly report that nothing was sorted. The graph is based on the README and the two excerpted source files.
Main entry points: filesort.py Command entry · pyproject.toml filesort command
Components 11
Other components
- User
- filesort command
pyproject.toml - Command entry
filesort.py - Downloads folder
- Download check
filesort.py - File sorting
filesort.py - Extension categories
filesort.py - Name collision check
filesort.py - File move
filesort.py - Uninstall option
filesort.py - uv tool
Connections 11
- User → filesort command: runs
README.md - filesort command → Command entry: dispatches to
pyproject.toml - Command entry → Downloads folder: lists files
filesort.py - Command entry → Download check: checks stability
filesort.py - Command entry → File sorting: sorts files
filesort.py - File sorting → Extension categories: matches extensions
filesort.py - File sorting → Name collision check: checks destination
filesort.py - File sorting → File move: moves file
filesort.py - File move → Downloads folder: renames into
filesort.py - Command entry → Uninstall option: dispatches option
filesort.py - Uninstall option → uv tool: runs uninstall
filesort.py