Repository navigation
Что нового
Выпуск добавляет поддержку общего срока выполнения операции (deadline) и улучшает обработку кооперативного прерывания в стратегиях отказоустойчивости.
Срок выполнения операции
Расширен СигналПрерыванияОперации (#17):
- Добавлен метод
УстановитьСрок(Длительность)для задания срока операции в миллисекундах относительно текущего момента. - Добавлен метод
ОсталосьВремени(), возвращающий оставшееся время до истечения срока. ПрерываниеЗапрошено()теперь учитывает истечение установленного срока.- Добавлен код ошибки
resilience.operation.deadline_exceededдля истечения срока. Явная отмена по-прежнему используетresilience.operation.cancelled. - В модуль
КодыОшибокОтказоустойчивостидобавлен методПревышениеСрокаОперации().
Учет срока в стратегиях
Стратегии отказоустойчивости теперь учитывают общий срок операции:
СтратегияПовторапроверяет оставшееся время перед задержкой. Если задержка не помещается в срок, следующая попытка не запускается, обработчик повтора не вызывается, а последний результат или ошибка сохраняются.СтратегияОграниченияВызововиСтратегияОграниченияПараллелизмапрекращают ожидание разрешения или свободного слота при истечении срока.СтратегияПредохранителяне запускает операцию с истекшим сроком и не учитывает прерывание как сбой защищаемого ресурса, в том числе при пробных вызовах.СтратегияЗапасногоСценарияне запускает запасной обработчик после прерывания.СтратегияТаймаутапроверяет сигнал перед запуском операции.
Исправления
- Исправлена обработка ошибки последней попытки в
СтратегияПовтора: если повтор не требуется или попытки исчерпаны, исходная ошибка операции больше не подменяется исключением прерывания (#16). - Уточнена последовательность проверки прерывания: сигнал предотвращает запуск следующей попытки, но не скрывает результат уже завершённой операции, когда дальнейший повтор не нужен.
- Уточнена обработка прерывания в предохранителе и запасном сценарии, чтобы отмена операции не влияла на состояние защищаемого ресурса и не запускала fallback.
Документация и инфраструктура
- Обновлена документация публичного API, стратегий и кодов ошибок.
- Добавлен пример повтора с общим сроком операции.
- Расширены тесты для проверки срока операции, повторных попыток, предохранителя и запасного сценария.
- Тестирование переведено на
OneUnit. - Обновлены зависимости:
lambdasдо0.3.5,errorsдо0.3.0. - Обновлён GitHub Action для автоматического обновления зависимостей до
depos-action@v2. - Удалены устаревшие скрипты тестирования и сохранённые отчёты бенчмарков.
Совместимость
- Минимальная версия OneScript —
2.0.0. - Для операций без установленного срока и без прерывания поведение библиотеки не меняется.
- Прерывание остаётся кооперативным: истечение срока не останавливает принудительно уже выполняющийся пользовательский код.
- Для различения явной отмены и истечения срока можно использовать структурированные коды ошибок
resilience.operation.cancelledиresilience.operation.deadline_exceeded.
Full Changelog: v0.4.0...v0.5.0