CKTIS / Python
pstats.Stats — analisar resultados de profiling
pstats.Stats analisa dados do profiler, ordenando estatísticas de funções e produzindo relatórios. Não mede a execução por si próprio: aceita um perfil guardado ou um objeto profiler.
Versão: Python 3.14; repository image, production runtime not attested
Sintaxe
pstats.Stats(*filenames, stream=sys.stdout)
pstats.Stats(profile, stream=sys.stdout)pstats.Stats aceita nomes de ficheiros de perfil ou um objeto cProfile.Profile ou profile.Profile. O parâmetro stream seleciona o destino do relatório; o valor predefinido é sys.stdout.
sort_stats(pstats.SortKey.CUMULATIVE) ordena por ordem decrescente segundo o tempo que inclui as funções chamadas. pstats.SortKey.TIME considera apenas o tempo dentro da própria função. print_stats(10) imprime as dez primeiras entradas.
strip_dirs() remove permanentemente os caminhos dos diretórios e pode juntar entradas indistinguíveis; ordene depois desta operação. A compatibilidade dos ficheiros de perfil entre versões de Python, profilers e sistemas operativos não é garantida.
Exemplos
import cProfile
import io
import pstats
def work():
return sum(range(10))
profiler = cProfile.Profile()
result = profiler.runcall(work)
report = io.StringIO()
stats = pstats.Stats(profiler, stream=report)
stats.sort_stats(pstats.SortKey.CUMULATIVE).print_stats()
print(result)
print("work" in report.getvalue())Resultado
45 True
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.