База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Python

`cache_info()`: преглед на статистиката на `lru_cache`

Извикай `cache_info()` върху функция, декорирана с `lru_cache`, за да прочетеш броя на попаденията и пропуските, лимита и текущия брой записи в кеша.

Версия: Python 3.12

Синтаксис

f.cache_info()

Ако f е декорирана с functools.lru_cache, извикай f.cache_info() без аргументи. Методът принадлежи на обекта, който обвива функцията, а не на модула functools. Той връща кортеж с именувани полета, който показва статистиката към момента на прочитането. Прочитането не изпълнява оригиналната функция и не променя съдържанието на кеша или броячите.

hits брои извикванията, които използват запазен резултат, а misses — търсенията, при които в кеша няма резултат. maxsize е лимитът на броя записи (None означава, че няма лимит), а currsize е текущият брой съхранени записи, не заетата памет в байтове. Когато кешът с ограничен размер е пълен, новият запис измества този, който най-отдавна не е използван. Броят на пропуските не показва колко записа са изместени.

Прочети статистиката след представителна поредица от извиквания, за да разбереш колко често се използват повторно резултатите и дали има смисъл да промениш maxsize. Тези стойности не измерват времето за изпълнение. За да изчистиш кеша, вместо да преглеждаш статистиката му, използвай f.cache_clear().

Примери

from functools import lru_cache

@lru_cache(maxsize=2)
def square(n):
    return n * n

for n in (2, 3, 2, 4, 3):
    square(n)

info = square.cache_info()
print(f"hits={info.hits}, misses={info.misses}, maxsize={info.maxsize}, currsize={info.currsize}")

Резултат

hits=1, misses=4, maxsize=2, currsize=2

Второто търсене за `2` е единственото попадение и прави този запис последно използвания. Добавянето на запис за `4` измества записа за `3`, затова последното извикване с `3` отново не намира резултат. Общо има четири пропуска, а в кеша остават два записа.

Свързани уроци

  • Python · Урок 17 · Средно · Версия: 3

Източници