File organization with preview and copy by Suls OpFile organization with preview and copy by Suls Op

File organization with preview and copy

Portfolio project
Suls Op

Overview

This sample organizes a flat synthetic inbox into folders by file type. A preview shows each destination before copying, and a manifest makes the result easy to check against the originals.

My role

I prepared this as a portfolio demonstration with AI assistance across implementation, tests, documentation and visuals. The source package and recorded checks are available on request.

Approach

The default command reads the inbox and prints a plan without creating files. An explicit copy command writes into a new directory, preserves filenames and records byte counts and SHA-256 hashes. Existing output paths, collisions, nested entries and links are rejected.

Verified result

Four files were copied into four type folders. Every copy matched its original bytes and manifest hash, all originals remained unchanged, and the preview created no output directory.
Nine focused tests passed, including a real Unicode filename collision and a Windows junction. A separate file-symlink check could not run because the Windows account lacks permission to create file symlinks.

Scope

Designed for a flat, stable local inbox. It copies file contents and leaves originals in place; recursive organization and metadata preservation are outside this example.

0 likes · 1 view · Oct 24, 2026

A Python copy tool with a read-only plan, a SHA-256 manifest and an unchanged source inbox.

Tags