Глава 23 · Часть IV · Реализуем SafeSort

Что делать, если имя уже занято

Ни на диске, ни внутри одного плана два файла никогда не получат одинаковое имя назначения.

Issue #6 · Project «SafeSort — первый релиз»

Handle destination name collisions

Area: SafetyPriority: Medium

git switch -c feat/plan-and-collisions

Два файла с одинаковым именем могут попасть в одну и ту же категорию — например, два разных notes.txt из разных подкаталогов исходного каталога. Если бы SafeSort просто перемещал файл поверх существующего, второй файл исчез бы молча — в каталоге назначения осталось бы одно и то же имя notes.txt, но с содержимым только одного из двух файлов, без единого предупреждения об этом.

SafeSort никогда не решает конфликт имён перезаписью: вместо этого он находит свободное имя по понятной схеме.

def _resolve_collision(candidate: Path, reserved: set[Path]) -> Path:
    if candidate not in reserved and not candidate.exists():
        return candidate

    stem, suffix, parent = candidate.stem, candidate.suffix, candidate.parent
    counter = 1
    while True:
        alternative = parent / f"{stem} ({counter}){suffix}"
        if alternative not in reserved and not alternative.exists():
            return alternative
        counter += 1

otchet.pdf уже существует в Sorted/documents/
→ следующий otchet.pdf получит имя otchet (1).pdf
→ если и оно занято — otchet (2).pdf, и так далее