CKTIS / Python
`cache_info()` : consulter les statistiques de `lru_cache`
Appelez `cache_info()` sur une fonction décorée avec `lru_cache` pour connaître le nombre de succès et d’échecs des recherches, la capacité maximale et le nombre d’entrées en cache.
Version : Python 3.12
Syntaxe
f.cache_info()Si f est décorée avec functools.lru_cache, appelez f.cache_info() sans argument. La méthode appartient à l’objet qui enveloppe la fonction, pas au module functools. Elle renvoie un tuple nommé contenant les statistiques au moment de la consultation. Cette lecture n’exécute pas la fonction d’origine et ne modifie ni le contenu du cache ni les compteurs.
hits compte les appels qui réutilisent un résultat en cache ; misses compte les recherches qui n’y trouvent pas de résultat. maxsize est le nombre maximal d’entrées (None signifie qu’il n’y a pas de limite). currsize est le nombre d’entrées actuellement stockées, pas l’espace occupé en octets. Quand un cache de taille limitée est plein, l’ajout d’une entrée évince celle qui n’a pas été utilisée depuis le plus longtemps. Le nombre d’échecs ne compte pas les évictions.
Consultez ces statistiques après une série d’appels représentative pour évaluer la fréquence de réutilisation des résultats et décider s’il faut ajuster maxsize. Ces chiffres ne mesurent pas le temps d’exécution. Pour vider le cache plutôt que le consulter, utilisez f.cache_clear().
Exemples
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}")
Résultat
hits=1, misses=4, maxsize=2, currsize=2
La deuxième recherche pour `2` est la seule à trouver un résultat en cache et fait de son entrée la plus récemment utilisée. L’ajout de l’entrée pour `4` évince celle pour `3`, donc le dernier appel avec `3` ne trouve de nouveau aucun résultat. Au total, quatre recherches échouent et deux entrées restent en cache.
Leçons associées
- Python · Leçon 17 · Intermédiaire · Version : 3