Разработка Python-модуля для заполнения Excel-шаблонов

Задача

Создать модуль на Python, который будет заполнять готовый Excel-шаблон (.xlsx) данными на основе конфигурационных файлов. Модуль должен аккуратно вписывать данные, не нарушая исходную структуру, форматирование и функциональность документа.

Требования к решению

Технический стек

  • Python версии 3.10 или выше.
  • Основная библиотека для работы с Excel: openpyxl.

Входные данные

  • template.xlsx - исходный шаблон файла.
  • data.json - словарь с данными для заполнения.
  • mapping.json - файл конфигурации, связывающий данные с ячейками в шаблоне.

Выходные данные

  • result.xlsx - итоговый заполненный файл (исходный шаблон должен оставаться неизменным).

Функциональность модуля

  • Заполнение одиночных значений: Внесение скалярных данных (числа, строки, даты) в конкретные ячейки, указанные в конфигурации.
  • Заполнение табличных блоков: Заполнение данными из списков в фиксированные диапазоны ячеек (табличные блоки). Шаблон содержит два таких блока.
  • Обработка типов данных: Корректное преобразование строковых представлений дат и чисел в соответствующие типы Excel.
  • Сохранение целостности шаблона: Все формулы, условное форматирование, стили и объединенные ячейки должны оставаться работоспособными.

Критически важные ограничения и правила

  • Запрещено изменять структуру листа: Нельзя вставлять или удалять строки/столбцы (insert_rows и аналогичные операции запрещены).
  • Фиксированные диапазоны для таблиц: Табличные блоки имеют заранее определенное максимальное количество строк (max_rows). Если данных меньше - незаполненные строки нужно очистить или скрыть (в зависимости от настройки). Если данных больше - заполняются только первые max_rows строк, остальные игнорируются.
  • Защита формул: Если целевая ячейка для записи содержит формулу - модуль должен считать это ошибкой конфигурации или шаблона и прекратить выполнение.
  • Работа с объединенными ячейками: Данные можно записывать только в верхнюю левую ячейку объединенного диапазона. Попытка записи в любую другую часть диапазона должна вызывать ошибку.
  • Совместимость: Итоговый файл должен корректно открываться и отображаться в популярных онлайн-редакторах таблиц (проверяется вручную).

Ожидаемые артефакты от исполнителя

  • Исходный код Python-модуля.
  • Файл README.md с инструкцией по установке и запуску.
  • Демонстрационный скрипт demo_fill.py, который наглядно показывает процесс заполнения шаблона.
  • Набор базовых модульных тестов (с использованием pytest), покрывающих три ключевых сценария:
    • Заполнение с пустыми списками данных.
    • Стандартное заполнение.
    • Сценарий, когда количество переданных данных превышает max_rows.