Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes