Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

pstats — analizzare i risultati della profilazione

Il modulo pstats analizza i dati di cProfile o profile: ordina le statistiche delle funzioni e produce report che aiutano a individuare le parti più costose di un programma.

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

Sintassi

import pstats
stats = pstats.Stats(profile_or_filename)
stats.sort_stats(pstats.SortKey.CUMULATIVE).print_stats(10)

pstats analizza i risultati della profilazione, invece di misurare direttamente l’esecuzione del programma. pstats.Stats accetta un oggetto profiler o il nome di un file che ne contiene i dati.

pstats.Stats legge i dati di profilazione salvati usando marshal, il cui utilizzo non è sicuro con dati in ingresso non attendibili o non autenticati. Non caricare file di profilazione provenienti da fonti non attendibili né file la cui autenticità non sia stata verificata.

sort_stats(pstats.SortKey.TIME) ordina in base al tempo proprio di una funzione, escludendo le funzioni chiamate; pstats.SortKey.CUMULATIVE include il loro tempo. print_stats(10) stampa le prime dieci voci.

get_stats_profile() consente l’accesso programmatico. L’esempio legge il numero di chiamate a work, evitando misurazioni dei tempi variabili.

Non dare per scontata la compatibilità dei file di profilazione tra versioni di Python, profiler o sistemi operativi. strip_dirs() rimuove irreversibilmente i percorsi dall’oggetto e può unire voci indistinguibili.

Esempi

import cProfile
import pstats


def work():
    return sum(range(10))


profiler = cProfile.Profile()
result = profiler.runcall(work)
stats = pstats.Stats(profiler)
functions = stats.get_stats_profile().func_profiles

print(result)
print(functions["work"].ncalls)

Risultato

45
1

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