riven-calen/datareturnlogic icon
public
Published on 5/1/2025
riven-calen/datareturnlogic

Это правило помогает формировать предсказуемую, легко обрабатываемую логику возврата во всех функциях работы с Excel

Rules

Правило: Возврат из Excel-функций Любая комплексная функция, связанная с созданием, обновлением или заполнением листа Excel, должна строго придерживаться следующей логики возврата:

  1. Если по логике требуется возврат данных для дальнейшего использования в run.py, функция должна возвращать соответствующий результат (например, словарь, датафрейм и т.п.).

  2. Если возврат данных не требуется — используется флаговая логика:

    True — изменения были внесены и успешно сохранены.
    None — изменений не требовалось, всё уже было актуально.
    False — произошла ошибка (например, файл не открылся, не сохранился и т.д.).