Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

Consultare le statistiche della cache LRU con cache_info()

Chiama `cache_info()` sulla funzione decorata per vedere gli hit e i miss accumulati, il limite configurato e il numero di voci attualmente in cache.

Versione: Python 3.12

Sintassi

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

info = f.cache_info()

In Python 3.12, functools.lru_cache avvolge una funzione e memorizza i risultati in base agli argomenti, che devono essere hashable. Chiama cache_info() sulla funzione decorata, per esempio gross_cents.cache_info(), non sul decoratore né sul risultato calcolato.

Il metodo restituisce un'istantanea sotto forma di tupla con campi denominati CacheInfo. hits e misses sono contatori cumulativi: un hit riutilizza un risultato memorizzato, mentre un miss indica che nella cache non è stato trovato un risultato. maxsize è il limite configurato di voci (None indica che non c'è limite) e currsize è il numero attuale di voci, non una dimensione in byte. La consultazione non modifica i contatori. Quando una cache con limite è piena, una nuova voce rimuove quella usata meno di recente.

L'esempio memorizza il risultato per la coppia (net, vat) di ogni articolo, non il totale del carrello. Confrontare le due istantanee mostra quanti risultati sono stati riutilizzati per il secondo carrello, ma non quanto tempo è stato risparmiato.

Esempi

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())

Risultato

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

`net` è espresso in centesimi e `vat` è una percentuale intera. Il primo carrello provoca due miss. Il secondo riutilizza il risultato di `(1000, 20)` e aggiunge una voce per `(200, 5)`. Entrambe le istantanee provengono dalla stessa funzione decorata.

Lezioni correlate

  • Python · Lezione 13 · Avanzato · Versione: 5

Fonti