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

CKTIS / Python

Consultar estatísticas da cache LRU com cache_info()

Chama `cache_info()` na função decorada para consultar os acertos e as falhas acumulados, o limite configurado e o número atual de entradas na cache.

Versão: Python 3.12

Sintaxe

@functools.lru_cache(maxsize=128, typed=False)
def f(net, vat):
    ...

info = f.cache_info()

Em Python 3.12, functools.lru_cache envolve uma função e guarda os resultados com base nos argumentos, que têm de ser hashable. Chama cache_info() na função decorada, por exemplo gross_cents.cache_info(), e não no decorador nem no resultado calculado.

O método devolve um retrato do estado da cache num tuplo com campos nomeados, CacheInfo. hits e misses são contadores acumulados: um acerto reutiliza um resultado guardado e uma falha indica que não foi encontrado um resultado na cache. maxsize é o limite de entradas configurado (None significa sem limite) e currsize é o número atual de entradas, não o tamanho em bytes. A consulta não altera os contadores. Quando uma cache com limite está cheia, uma nova entrada elimina a que está há mais tempo sem ser usada.

O exemplo guarda o resultado do par (net, vat) de cada artigo, não o total do cesto. Comparar as duas leituras mostra quantos resultados foram reutilizados ao processar o segundo cesto, mas não quanto tempo se poupou.

Exemplos

from functools import lru_cache


@lru_cache(maxsize=4)
def gross_cents(net, vat):
    return net + net * vat // 100


basket_a = [(1000, 20), (500, 10)]
basket_b = [(1000, 20), (200, 5)]

for basket in (basket_a, basket_b):
    print(sum(gross_cents(net, vat) for net, vat in basket))
    print(gross_cents.cache_info())

Resultado

1750
CacheInfo(hits=0, misses=2, maxsize=4, currsize=2)
1410
CacheInfo(hits=1, misses=3, maxsize=4, currsize=3)

`net` é expresso em cêntimos e `vat` é uma percentagem inteira. O primeiro cesto gera duas falhas. O segundo reutiliza o resultado de `(1000, 20)` e acrescenta uma entrada para `(200, 5)`. As duas leituras são feitas na mesma função decorada.

Lições relacionadas

  • Python · Lição 13 · Avançado · Versão: 5

Fontes