WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

LRU-Cache-Statistik mit cache_info() abfragen

Rufe `cache_info()` an der dekorierten Funktion auf, um die bisherigen Treffer und Fehltreffer, die konfigurierte Obergrenze und die aktuelle Zahl der Cache-Einträge abzulesen.

Version: Python 3.12

Syntax

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

info = f.cache_info()

In Python 3.12 umhüllt der Dekorator functools.lru_cache eine Funktion und speichert ihre Ergebnisse anhand der Argumente, die hashbar sein müssen. Rufe cache_info() an der dekorierten Funktion auf, etwa mit gross_cents.cache_info(), nicht am Dekorator oder am berechneten Ergebnis.

Die Methode liefert mit dem benannten Tupel CacheInfo eine Momentaufnahme. hits und misses sind fortlaufende Zähler: Bei einem Treffer wird ein gespeichertes Ergebnis verwendet, bei einem Fehltreffer wurde keines im Cache gefunden. maxsize ist die eingestellte Obergrenze für Einträge (None bedeutet unbegrenzt), currsize die aktuelle Anzahl der Einträge, nicht die Größe in Byte. Das Auslesen ändert die Zähler nicht. Ist ein begrenzter Cache voll, verdrängt ein neuer Eintrag den Eintrag, dessen letzte Nutzung am längsten zurückliegt.

Das Beispiel speichert das Ergebnis für das Paar (net, vat) eines einzelnen Artikels, nicht die Summe des gesamten Warenkorbs. Der Vergleich der beiden Momentaufnahmen zeigt, wie viele Ergebnisse beim zweiten Warenkorb wiederverwendet wurden, aber nicht, wie viel Zeit dadurch eingespart wurde.

Beispiele

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

Ergebnis

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

`net` ist ein Betrag in Cent, `vat` ein ganzzahliger Prozentsatz. Der erste Warenkorb verursacht zwei Fehltreffer. Der zweite nutzt das Ergebnis für `(1000, 20)` erneut und fügt einen Eintrag für `(200, 5)` hinzu. Beide Momentaufnahmen stammen von derselben dekorierten Funktion.

Zugehörige Lektionen

  • Python · Lektion 13 · Fortgeschritten · Version: 5

Quellen