Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

pstats.Stats.stats — statistiche grezze di profilazione

pstats.Stats.stats è un dizionario di dati di profilazione le cui chiavi combinano il nome del file, il numero di riga e il nome della funzione. Consente di leggere direttamente i conteggi delle chiamate, il tempo interno, il tempo cumulativo e le informazioni sulle funzioni chiamanti, senza analizzare un rapporto testuale.

Versione: Python 3.14; repository image, production runtime not attested

Sintassi

stats = pstats.Stats(profiler)
cc, nc, tt, ct, callers = stats.stats[(filename, line_number, function_name)]

pstats.Stats.stats è un attributo di istanza, non un metodo. Ogni chiave ha la forma (filename, line_number, function_name) e ogni valore la forma (cc, nc, tt, ct, callers). Nemmeno la chiave completa identifica una funzione in modo univoco: due funzioni lambda distinte definite sulla stessa riga di codice sorgente hanno lo stesso nome di file, lo stesso numero di riga e lo stesso nome di funzione (<lambda>), quindi condividono la stessa chiave.

cc conta le chiamate primitive, escludendo quelle indotte dalla ricorsione; nc conta tutte le chiamate. tt è il tempo interno della funzione, escluse le chiamate secondarie, mentre ct è il tempo cumulativo, comprese le chiamate secondarie, in secondi. Non sommare i valori ct di tutte le funzioni per ottenere il tempo totale del programma: questi intervalli si sovrappongono.

callers associa alle chiavi delle funzioni chiamanti dati che dipendono dal profiler. Con cProfile, ogni valore è (nc, cc, tt, ct) per la relazione di chiamata corrispondente: l’ordine dei conteggi è inverso rispetto alla tupla esterna. Con profile, ogni valore è un conteggio delle chiamate. La ricorsione può far sì che una funzione sia la chiamante di sé stessa.

Considera questo dizionario una rappresentazione di implementazione di basso livello di CPython 3.14, non una garanzia di formato portabile. Evita di modificarlo manualmente: l’oggetto mantiene anche totali e cache. strip_dirs() cambia le chiavi e può unire voci; sort_stats() stabilisce l’ordine del rapporto, non quello del dizionario. L’esempio mostra conteggi deterministici anziché tempi variabili. Questa voce si basa sul codice del repository; l’ambiente di produzione non è attestato.

Esempi

import cProfile
import pstats


def countdown(n):
    if n:
        countdown(n - 1)


profiler = cProfile.Profile()
profiler.runcall(countdown, 3)
stats = pstats.Stats(profiler)
key = (countdown.__code__.co_filename,
       countdown.__code__.co_firstlineno,
       countdown.__code__.co_name)
cc, nc, tt, ct, callers = stats.stats[key]
assert (cc, nc) == (1, 4)
assert key in callers
print(f"primitive={cc}, total={nc}")
print(f"recursive_caller={key in callers}")

Risultato

primitive=1, total=4
recursive_caller=True

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti