🧩 Функции и области видимости

Короткий ответ Декоратор оборачивает исходную функцию во внутреннюю функцию-обёртку, которая выполняет замер времени до и после вызова оригинала; без functools.wraps обёрнутая функция теряет своё имя, docstring и другие метаданные, так как снаружи видна только функция-обёртка, а не оригинал. Как это работает подробнее Декоратор @my_decorator синтаксически эквивалентен func = my_decorator(func) — имя func в месте использования начинает указывать на объект, который вернул декоратор (обычно это wrapper-функция). functools.wraps(func) — это сам декоратор, применяемый к wrapper, который копирует __name__, __doc__, __module__ и прочие атрибуты оригинальной функции на wrapper, чтобы снаружи decorated-функция выглядела как исходная. Пример кода Что использовать на практике Практика. Без functools.wraps инструменты автодокументации, отладчики, логирование стектрейсов и help(func) показывают имя wrapper вместо реального имени функции, что затрудняет диагностику в продакшене. Это особенно критично, если декораторы приме

Читать полностьюdecorators

Короткий ответ Значение-аргумент по умолчанию вычисляется один раз при определении функции, а не при каждом вызове, поэтому изменяемый default (список, словарь) переживает между вызовами и накапливает данные — правильное решение: использовать None как default и создавать новый объект внутри функции. Как это работает подробнее Python создаёт объект для значения по умолчанию один раз, в момент выполнения def, и хранит его в __defaults__ функции. Каждый вызов без явного аргумента получает ссылку на этот же самый объект, а не на свежую копию. Пример кода Что использовать на практике Практика. Безопасный паттерн — def f(items=None): items = items if items is not None else []. Это гарантирует новый список на каждый вызов без явного аргумента. Такой же баг возникает с default-словарями и default-множествами, а не только со списками. Подводные камни Риски. Разработчики ожидают, что каждый вызов "начинает с чистого листа", и удивляются, когда данные из предыдущих вызовов появляются в текущем. Баг особенно незаметен в

Читать полностьюfunctions-scope

Короткий ответ Замыкание захватывает не только нужные ему переменные, но неявно удерживает ссылки на весь объект объемлющей области видимости, если он на него ссылается хоть одним атрибутом; если большой объект конфигурации доступен в той же функции, где создаётся callback, он может держаться в памяти через ячейку замыкания даже тогда, когда реально callback'у нужен только один маленький параметр из него — решение: явно скопировать нужное значение в отдельную переменную перед созданием замыкания, не ссылаясь на весь большой объект. Как это работает подробнее Замыкание хранит ссылки на переменные объемлющей функции, к которым оно обращается по имени в своём теле — если тело callback обращается, например, к config.retry_limit, то замыкание держит ссылку на весь объект config, а не только на число retry_limit, потому что Python разрешает имя config динамически при каждом вызове, а не копирует значение атрибута заранее. Пока существует хотя бы один живой callback, созданный в этой функции, весь объект config (и в

Читать полностьюclosures

Короткий ответ Повторная конкатенация строк через += в цикле на больших объёмах данных квадратично деградирует по времени, так как строки в Python неизменяемы и каждая конкатенация создаёт новую строку, копируя все предыдущие символы; решение — собирать части в список и объединить один раз через ''.join(parts) в конце. Как это работает подробнее Строка — неизменяемый объект, поэтому result += chunk не дополняет существующую строку "по месту", а создаёт новый объект, копируя все символы старой строки плюс новый фрагмент. При N итерациях суммарный объём скопированных символов растёт квадратично (1+2+...+N), хотя CPython в некоторых случаях оптимизирует этот паттерн для простых локальных переменных, такая оптимизация не гарантирована языком и не работает надёжно, например, при накоплении в атрибуте объекта или списке. Пример кода Что использовать на практике Практика. Профилировать такую проблему можно через cProfile/timeit на реальном объёме данных, сравнивая время при росте N: квадратичная деградация видна по

Читать полностьюfunctions-scope

Короткий ответ Функция не содержит инструкции return после цикла, поэтому она всегда неявно возвращает None, хотя внутри корректно строит список result — исправление: добавить явный return result после цикла. Как это работает подробнее Если функция доходит до конца тела без явного return value, Python автоматически завершает её, возвращая None. Это не вызывает ошибку интерпретатора — код "работает" в смысле не падает, но вызывающая сторона получает None вместо ожидаемого значения, и ошибка обнаруживается только там, где это None пытаются использовать как список. Пример кода Что использовать на практике Практика. Отлавливают такие баги через unit-тесты, проверяющие именно возвращаемое значение (assert result == [2, 4]), а не только отсутствие исключений. Также полезно включить проверку типов (type hints + статический анализатор типа mypy), который подскажет несоответствие аннотированного -> list[int] и фактического None в некоторых путях выполнения. Подводные камни Риски. Забывают return при рефакторинге, когд

Читать полностьюdebugging

Короткий ответ Python по умолчанию считает переменную, которой присваивается значение внутри функции, локальной для этой функции; ключевое слово global явно говорит интерпретатору, что присваивание должно изменить переменную в глобальной области видимости модуля, а не создавать новую локальную. Как это работает подробнее Интерпретатор анализирует тело функции целиком перед выполнением: если переменной где-либо внутри функции присваивается значение (без global/nonlocal), она считается локальной во всей функции, даже в строчках до присваивания — это может привести к UnboundLocalError, если переменную с тем же именем сначала читают, а потом присваивают. global name отменяет это поведение для конкретного имени внутри функции. Пример кода Что использовать на практике Практика. Читать глобальную переменную внутри функции можно без global — он нужен только для её изменения (присваивания нового значения) внутри функции. На практике частое изменение глобальных переменных через global считается плохой практикой — предп

Читать полностьюfunctions-scope

Короткий ответ Замыкание — это функция, которая запоминает переменные из окружающей (объемлющей) области видимости даже после завершения выполнения этой области; при создании нескольких замыканий в цикле они обычно ссылаются на одну и ту же переменную цикла по имени, а не на её значение на момент создания, поэтому все замыкания видят её финальное значение. Как это работает подробнее Внутренняя функция хранит ссылку на ячейку переменной (cell) во внешней функции, а не копию значения на момент определения. Переменная цикла for i in range(n) — это одна и та же переменная на всех итерациях, поэтому все замыкания, созданные в цикле и ссылающиеся на i, после завершения цикла видят её последнее значение. Пример кода Что использовать на практике Практика. Проблема решается "захватом" текущего значения через параметр по умолчанию (def f(i=i): ...) или через functools.partial, который фиксирует значение аргумента в момент создания. Замыкания широко используют для фабрик функций, мемоизации и для реализации декораторов

Читать полностьюclosures

Короткий ответ nonlocal позволяет функции, вложенной в другую функцию, изменять переменную из области видимости объемлющей (не глобальной) функции, тогда как global всегда ссылается на переменную модульного уровня — без nonlocal попытка присвоить значение внешней переменной внутри вложенной функции создаёт новую локальную переменную во вложенной функции. Как это работает подробнее Python следует правилу LEGB (Local, Enclosing, Global, Built-in) при поиске имени для чтения, но для присваивания переменной по умолчанию выбирается самая внутренняя (Local) область видимости. nonlocal name явно указывает интерпретатору искать и изменять name в ближайшей объемлющей функции (Enclosing), а не создавать новую локальную переменную во вложенной функции. Пример кода Что использовать на практике Практика. Типичный случай — функция-фабрика, создающая счётчик, аккумулятор или кэш внутри замыкания: внутренняя функция должна изменять состояние, "принадлежащее" внешней функции, между вызовами. Это распространённый паттерн до по

Читать полностьюfunctions-scope