slider_stack.py

from typing import ClassVar, Tuple

from stack import Stack


class SliderStack:
    """Класс для отслеживания изменений значений слайдера и управления историей изменений.

    Используется для реализации функциональности Undo/Redo при работе со слайдерами.

    Атрибуты:
        stack (Stack): Стек для хранения истории изменений в виде пар (предыдущее значение, текущее значение).
    """

    stack: ClassVar[Stack[Tuple[int | float, int | float]]] = Stack()

    def execute(self, previous: int | float, current: int | float) -> None:
        """Фиксирует изменение значения слайдера и сохраняет его в истории.

        Сохраняет в стек только если текущее значение отличается от предыдущего.

        Аргументы:
            previous (int): Предыдущее значение слайдера.
            current (int): Текущее значение слайдера.
        """
        if current != previous:
            self.stack.push((previous, current))

    def undo(self) -> Tuple[int | float, int | float]:
        """Отменяет последнее изменение слайдера.

        Возвращает предыдущее значение из последней сохраненной пары изменений.
        """
        result = self.stack.pop()
        return result