Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Python

`cache_info()`: consultar as estatísticas de `lru_cache`

Chama `cache_info()` numa função decorada com `lru_cache` para consultar os acertos, as falhas, o limite de entradas e quantas estão atualmente na cache.

Versão: Python 3.12

Sintaxe

f.cache_info()

Se f estiver decorada com functools.lru_cache, chama f.cache_info() sem argumentos. O método pertence ao objeto que envolve a função, não ao módulo functools. Devolve um tuplo com campos nomeados que regista as estatísticas no momento da consulta. A leitura não executa a função original nem altera o conteúdo da cache ou os contadores.

hits conta as chamadas que reutilizam um resultado em cache; misses conta as pesquisas que não encontram um resultado. maxsize é o limite de entradas (None significa que não há limite), ao passo que currsize é o número de entradas guardadas nesse momento, não o espaço ocupado em bytes. Quando uma cache com limite está cheia, acrescentar uma entrada remove a que não é usada há mais tempo. O número de falhas não indica quantas entradas foram removidas.

Consulta as estatísticas depois de uma série representativa de chamadas para perceber com que frequência são reutilizados os resultados e decidir se vale a pena ajustar maxsize. Estes valores não medem o tempo de execução. Para esvaziar a cache em vez de consultar as estatísticas, usa f.cache_clear().

Exemplos

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}")

Resultado

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

A segunda pesquisa de `2` dá o único acerto e torna a respetiva entrada a mais recentemente usada. Acrescentar a entrada de `4` remove a de `3`, pelo que a última chamada com `3` volta a não encontrar um resultado. Há quatro falhas no total e ficam duas entradas na cache.

Lições relacionadas

  • Python · Lição 17 · Intermédio · Versão: 3

Fontes