folder_copy · folder_move · folder_delete¶
The file-operation tools. All take -j/--jobs <N|-1> for multi-threaded speed,
-v/--verbose, and -o/--output <file> for a CSV report. Reports are UTF-8
with a BOM. Exit codes: 0 success · 1 one or more operations failed ·
2 usage error.
folder_copy¶
Recursive, multi-threaded copy.
If <dest> is an existing directory (or there are multiple sources), each source
is copied into it; otherwise <dest> is the exact target. Existing
destination files are skipped unless --overwrite is given.
folder_move¶
Move / rename.
Within one volume this is an instant rename. Across volumes it falls back to a
multi-threaded copy and then deletes the source — only if every file copied
cleanly, so nothing is lost.
folder_delete¶
Recursive, multi-threaded delete. Dry run by default.
Prints what it would remove; pass --force to actually delete. Files are removed
in parallel, then empty directories bottom-up. Refuses to delete a filesystem
root as a guardrail. Report columns: path,size_bytes,action
(WOULD_DELETE / DELETED / ERROR).