CKTIS / Python
`cache_info()`: consultare le statistiche di `lru_cache`
Chiama `cache_info()` su una funzione decorata con `lru_cache` per leggere i conteggi di hit e miss, il limite di voci e il numero di voci attualmente in cache.
Versione: Python 3.12
Sintassi
f.cache_info()Se f è decorata con functools.lru_cache, chiama f.cache_info() senza argomenti. Il metodo appartiene all’oggetto che avvolge la funzione, non al modulo functools. Restituisce una tupla con campi denominati che fotografa le statistiche al momento della lettura. La lettura non esegue la funzione originale e non modifica né il contenuto della cache né i contatori.
hits conta le chiamate che riutilizzano un risultato in cache; misses conta le ricerche che non trovano un risultato. maxsize è il limite al numero di voci (None indica che non c’è limite), mentre currsize è il numero di voci memorizzate al momento, non lo spazio occupato in byte. Se una cache con un limite è piena, aggiungere una voce espelle quella inutilizzata da più tempo. Il conteggio dei miss non indica quante voci sono state espulse.
Leggi le statistiche dopo una serie rappresentativa di chiamate per capire quanto spesso vengono riutilizzati i risultati e decidere se modificare maxsize. Questi numeri non misurano il tempo di esecuzione. Per svuotare la cache invece di consultarne le statistiche, usa f.cache_clear().
Esempi
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}")
Risultato
hits=1, misses=4, maxsize=2, currsize=2
La seconda ricerca di `2` è l’unico hit e rende la sua voce quella usata più di recente. Aggiungendo la voce per `4` si espelle quella per `3`, quindi l’ultima chiamata con `3` produce un altro miss. In totale ci sono quattro miss e restano due voci in cache.
Lezioni correlate
- Python · Lezione 17 · Intermedio · Versione: 3