Почему модуль декоратора заставляет меня поднять внутреннюю функцию на внешний уровень?

Question

Как указано в документе memoization example в документах decorator, вы не можете использовать подход вложенных функций для реализации memoization, сохраняя при этом подпись функции. Вместо этого, вы должны поднять внутреннюю функцию, и затем создать тривиальную функцию декоратора:

def _memoize(func, *args, **kwargs): 
    # the memoization code 

def memoize(f): 
    f.cache = {} 
    return decorator(_memoize, f) 

Почему я не могу использовать внутреннюю функцию? Или документы вводят в заблуждение, то есть есть возможность использовать внутреннюю функцию с @decorator? Есть ли какая-то практическая причина, основанная на реализации, почему это так, или я действительно вынужден сделать это чужой путь? Я ненавижу вспомогательные функции и хотел бы избежать этого подхода, если это возможно; если есть хак, чтобы заставить его работать (без, конечно, самого написания с нуля), я хотел бы услышать, что это такое.

Следует отметить, что без необходимости инициализации cache или любого другого кода, который не был бы частью внутренней функции, конечно, @decorator работает просто отлично, не используя внешнюю функцию вообще (но затем снова , зачем использовать внутреннюю функцию, если у вас нет кода вне внутренней функции?).

Answer 1

Требуя это намеренный выбор дизайн decorator библиотеки, поясняется в документации (курсив в оригинале):

Разница в отношении memoize_uw подхода, который основан на вложенных функций, является что модуль декоратора заставляет вас поднимать внутреннюю функцию на внешнем уровне (плоский лучше, чем вложенный).

Это также объясняется прямо в разделе мотивации Введения:

Например, типичные реализации декораторов включают вложенные функции, и все мы знаем, что плоское лучше, чем вложенные.

Конечно, «плоский лучше, чем вложенный» является частью the Zen of Python. Но вы можете не соглашаться с тем, что оно применимо здесь, или может думать, что какой-то другой принцип его переопределяет.

Если вы не согласны с принципами дизайна библиотеки, вы, вероятно, не будете довольны этим.

---

Если вы смотрите в the source code, вы можете увидеть, что модуль делает некоторое использование предположения о том, что вы собираетесь проездом в функции верхнего уровня. Например, он копирует func_globals, но не пытается копировать нелокальные ячейки закрытия, и он ожидает, что inspect будет иметь функцию уровня модуля для работы. Во многих случаях нарушение этих предположений не повредит вам. Но если вы настаиваете на этом, вам нужно будет понять код достаточно хорошо, чтобы знать, когда будет причинить вам вред.