CKTIS / Python
pstats — analisar os resultados da criação de perfis
O módulo pstats analisa dados de cProfile ou profile: ordena as estatísticas das funções e gera relatórios que ajudam a localizar as partes mais dispendiosas de um programa.
Versão: Python 3.14; repository image, production runtime not attested
Sintaxe
import pstats
stats = pstats.Stats(profile_or_filename)
stats.sort_stats(pstats.SortKey.CUMULATIVE).print_stats(10)pstats analisa os resultados da criação de perfis, em vez de medir por si só a execução do programa. pstats.Stats aceita um objeto profiler ou o nome de um ficheiro que contenha os respetivos dados.
pstats.Stats lê os dados de perfil guardados através de marshal, que não é seguro para dados de entrada não fiáveis ou não autenticados. Não carregues ficheiros de perfil de fontes não fiáveis nem ficheiros cuja autenticidade não tenha sido verificada.
sort_stats(pstats.SortKey.TIME) ordena pelo tempo próprio de uma função, excluindo as funções chamadas; pstats.SortKey.CUMULATIVE inclui o tempo destas. print_stats(10) apresenta as primeiras dez entradas.
get_stats_profile() permite o acesso programático. O exemplo lê o número de chamadas a work, evitando medições de tempo variáveis.
Não pressuponhas que os ficheiros de criação de perfis são compatíveis entre versões do Python, profilers ou sistemas operativos. strip_dirs() remove irreversivelmente os caminhos do objeto e pode combinar entradas indistinguíveis.
Exemplos
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)Resultado
45 1
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.