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