CKTIS / Python
`cache_info()`: consultar las estadísticas de `lru_cache`
Llama a `cache_info()` en una función decorada con `lru_cache` para consultar los aciertos, los fallos, el límite de entradas y cuántas hay en la caché.
Versión: Python 3.12
Sintaxis
f.cache_info()Si f está decorada con functools.lru_cache, llama a f.cache_info() sin argumentos. El método pertenece al objeto que envuelve la función, no al módulo functools. Devuelve una tupla con campos nombrados que recoge las estadísticas en el momento de la consulta. La lectura no ejecuta la función original ni modifica el contenido de la caché o sus contadores.
hits cuenta las llamadas que reutilizan un resultado almacenado; misses cuenta las búsquedas que no encuentran un resultado. maxsize es el límite de entradas (None indica que no hay límite), mientras que currsize es el número de entradas almacenadas en ese momento, no la memoria ocupada en bytes. Cuando una caché de tamaño limitado se llena, añadir una entrada expulsa la que lleva más tiempo sin usarse. El número de fallos no indica cuántas entradas se han expulsado.
Consulta las estadísticas tras una serie representativa de llamadas para ver con qué frecuencia se reutilizan resultados y decidir si conviene ajustar maxsize. Estas cifras no miden el tiempo de ejecución. Para vaciar la caché en vez de consultarla, usa f.cache_clear().
Ejemplos
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}")
Resultado
hits=1, misses=4, maxsize=2, currsize=2
La segunda búsqueda de `2` produce el único acierto y hace que su entrada sea la más reciente en usarse. Al añadir la entrada de `4`, se expulsa la de `3`, de modo que la última llamada con `3` vuelve a fallar en la caché. Hay cuatro fallos en total y quedan dos entradas almacenadas.
Lecciones relacionadas
- Python · Lección 17 · Intermedio · Versión: 3