comments

Добавь docstring-и в формате reStructuredText ко всем функциям и классам в этом Python-коде. Используй стандарт Sphinx, включая описания параметров (`:param`), типов (`:type`), возвращаемых значений (`:return`, `:rtype`) и возможных исключений (`:raises`, если есть). Стиль должен быть формальный и технически точный. Не переписывай код, просто вставь docstring'и внутрь функций и классов.

Пример:
def foo(a: int) -> str:
    """
    Преобразует число в строку.

    :param a: Целое число
    :type a: int
    :return: Строковое представление числа
    :rtype: str
    """