av
b9f0929d0c
- предел длины компонента (255 байт) проверяется в BuildLinks до первой операции с ФС: ни каталога, ни ссылки при отказе не создаётся - причина пустого предпросмотра считается на показе (ReviewData.PreviewError) и печатается в панели действий и в карточке Telegram: у задачи без записанной причины взять её больше неоткуда
5.2 KiB
ADDED Requirements
Requirement: Непомещающееся целевое имя уходит в review
Система SHALL отклонять раскладку целиком, если хотя бы один компонент целевого
пути (папка тайтла, папка сезона, имя файла с расширением и суффиксами) длиннее
предела, и SHALL переводить задачу в review с доменной причиной, а не в
failed. Проверка SHALL выполняться до первой операции с файловой системой: ни
каталога, ни ссылки при отказе не создаётся. Причина SHALL нести собственный код,
отличный и от кода коллизии, и от общего кода отказа построения плана, а
человекочитаемый текст SHALL называть непомещающийся компонент и НЕ SHALL
содержать текста системной ошибки.
Предел SHALL меряться в байтах UTF-8-представления имени, а не в символах:
кириллическое название упирается вдвое раньше латинского той же длины в знаках.
Величина — 255 байт (NAME_MAX у ext4/xfs/btrfs); она фиксирована и у ядра не
выясняется, потому что раскладка обязана отказать до обращения к диску. На
файловой системе с меньшим пределом остаётся сегодняшний исход — отказ ядра и
failed; это осознанный остаток, а не пробел.
Проверка длины SHALL выполняться после проверки нахождения пути под корнем библиотеки: путь, вышедший за песочницу, SHALL отклоняться как выход за библиотеку, иначе находка безопасности спряталась бы за косметической причиной.
Самостоятельно обрезать или переименовывать название система НЕ SHALL — это решение человека.
Scenario: Слишком длинное имя файла уходит в review
- GIVEN распознавание даёт название, из которого имя целевого файла складывается длиннее 255 байт
- WHEN выполняется раскладка
- THEN задача переходит в
reviewс причиной «имя не помещается», ни один каталог и ни одна ссылка не созданы, а текст системной ошибки человеку не показан
Scenario: Предел меряется в байтах
- GIVEN два названия одинаковой длины в знаках — латинское и кириллическое
- WHEN строятся целевые пути
- THEN кириллическое отклоняется вдвое раньше латинского, а граница проходит между 255 и 256 байтами
Scenario: Слишком длинное имя папки тайтла уходит в review
- GIVEN название укладывается в имя файла, но папка тайтла с годом и provider-тегом длиннее предела
- WHEN выполняется раскладка
- THEN задача переходит в
reviewс той же причиной, каталог тайтла не создан
Scenario: Выход за библиотеку важнее длины
- GIVEN целевой путь одновременно выходит за корень библиотеки и длиннее предела
- WHEN строятся целевые пути
- THEN отказ называет выход за библиотеку, а не длину имени
Scenario: Подсказка человека чинит случай
- GIVEN задача в
reviewс причиной «имя не помещается» - WHEN человек задаёт название короче и применяет раскладку заново
- THEN раскладка проходит штатно и задача переходит в
done
Scenario: Унаследованная база в предел помещается всегда
- GIVEN база имени унаследована от живой папки-якоря по правилу сходимости
- WHEN строятся имена файлов внутри этой папки
- THEN они помещаются в предел, потому что папка-якорь лежит на диске и уже не длиннее предела, а хвост имени файла не длиннее хвоста имени папки