Work
05 / 08

Automation + Data

File Organizer — Automation Toolkit

Review the filesystem plan before changing the filesystem.

GitHub Documentation

StackPython 3.10+ · argparse · pytest · Ruff · GitHub Actions

A small Python CLI for safely organizing visible top-level files, designed around previewable changes, explicit conflict handling and conservative filesystem scope.

Business problem

Manual sorting is repetitive, but an unconstrained script can overwrite files or move hidden, linked or nested content that the user never intended to touch.

Implemented capability

The CLI organizes visible top-level files by type, size or modification year, previews changes with --dry-run and handles conflicts through explicit skip or rename strategies.

Reliability signal

Non-recursive defaults, no-overwrite behavior and safeguards for hidden files, symlinks and subdirectories constrain the operation before execution.

Delivery setup

pytest, Ruff and coverage checks run across Linux, macOS and Windows in GitHub Actions. The portfolio presents File Organizer as the implemented product; it does not imply other toolkit products are complete.

[DRY RUN]
WOULD MOVE photo.jpg → Images/photo.jpg
WOULD MOVE report.pdf → Documents/report.pdf
planned=2 · moved=0 · skipped=0 · failed=0