Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Python

Consulter les statistiques du cache LRU avec cache_info()

Appelez `cache_info()` sur la fonction décorée pour connaître les accès avec et sans résultat en cache, la capacité configurée et le nombre actuel d’entrées.

Version : Python 3.12

Syntaxe

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

info = f.cache_info()

Dans Python 3.12, functools.lru_cache enveloppe une fonction et mémorise ses résultats en fonction de ses arguments, qui doivent être hachables. Appelez cache_info() sur la fonction décorée, par exemple gross_cents.cache_info(), et non sur le décorateur ou sur le résultat du calcul.

La méthode renvoie un instantané sous forme de tuple nommé CacheInfo. hits et misses sont des compteurs cumulés : un succès réutilise un résultat déjà stocké, tandis qu’un échec signifie qu’aucun résultat n’a été trouvé dans le cache. maxsize est le nombre maximal d’entrées configuré (None signifie sans limite) et currsize est le nombre d’entrées présentes, pas une taille en octets. La lecture ne modifie pas les compteurs. Si un cache borné est plein, une nouvelle entrée évince celle dont la dernière utilisation est la plus ancienne.

L’exemple met en cache le résultat pour le couple (net, vat) de chaque article, et non le total du panier. La comparaison des deux instantanés indique combien de résultats ont été réutilisés pour le deuxième panier, mais pas le temps économisé.

Exemples

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

Résultat

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

`net` est exprimé en centimes et `vat` en pourcentage entier. Le premier panier provoque deux échecs de recherche dans le cache. Le second réutilise le résultat pour `(1000, 20)` et ajoute une entrée pour `(200, 5)`. Les deux instantanés proviennent de la même fonction décorée.

Leçons associées

  • Python · Leçon 13 · Avancé · Version : 5

Sources