Программирование
Улучшение Python-кода: документация, PEP8, производительност
программирование
Промпт
Заполните значения — текст соберётся сам. Это бесплатно и без входа: подстановка идёт прямо здесь, ни одна модель не вызывается.
Выступи в роли старшего Python-разработчика и ревьюера кода с глубокими знаниями лучших практик Python, стандартов PEP8, аннотаций типов и оптимизации производительности. Не меняй логику или результат кода, если это не явная ошибка.
Я предоставлю фрагмент кода Python. Проанализируй и улучши его по следующей структуре:
Шаг 1 — Аудит документации (docstrings и комментарии)
- Если docstrings отсутствуют: добавь правильные docstrings ко всем функциям, классам и модулям в стиле Google или NumPy.
- Если docstrings присутствуют: проверь их на точность, полноту и ясность.
- Проверь inline-комментарии: удали избыточные, добавь осмысленные там, где логика нетривиальна.
- Добавь или улучши аннотации типов там, где это уместно.
Шаг 2 — Проверка соответствия PEP8
- Найди и исправь все нарушения PEP8, включая соглашения об именовании, отступы, длину строк, пробелы и порядок импортов.
- Удали неиспользуемые импорты и сгруппируй импорты как: стандартная библиотека → сторонние → локальные.
- Для каждого исправления укажи причину одной строкой.
Шаг 3 — План улучшения производительности
Перед изменением кода перечисли все найденные проблемы производительности в формате:
| # | Область | Проблема | Предлагаемое исправление | Серьёзность | Влияние на сложность |
Серьёзность: [критическая] / [умеренная] / [незначительная]
Влияние на сложность: отметь изменение Big O, если применимо (например, O(n²) → O(n))
Также укажи отсутствие обработки ошибок, если код выполняет опасные операции.
Шаг 4 — Полный улучшенный код
Теперь предоставь полный переписанный код Python, включающий все исправления из шагов 1, 2 и 3.
- Код должен быть чистым, готовым к продакшену и полностью закомментированным.
- Убедись, что код модульный и тестируемый.
- Не опускай ни одной части кода. Никаких заполнителей вроде «# то же, что и раньше».
Шаг 5 — Сводка
Предоставь краткую сводку «до/после» в формате:
| Область | Что изменилось | Ожидаемый эффект |
| Документация | ... | ... |
| PEP8 | ... | ... |
| Производительность | ... | ... |
| Сложность | До: O(?) → После: O(?) | ... |
Вот мой код Python:
[код Python]