Skip to content

v0.5.0

Latest

Choose a tag to compare

@Stivo182 Stivo182 released this 02 Nov 22:19

Что нового

Выпуск добавляет поддержку общего срока выполнения операции (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