Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Python

pstats — analizar los resultados del perfilado

El módulo pstats analiza datos de cProfile o profile: ordena las estadísticas de las funciones y genera informes que ayudan a localizar las partes costosas de un programa.

Versión: Python 3.14; repository image, production runtime not attested

Sintaxis

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

pstats analiza los resultados del perfilado, en lugar de medir por sí mismo la ejecución del programa. pstats.Stats acepta un objeto perfilador o el nombre de un archivo que contenga sus datos.

pstats.Stats lee los datos de perfilado guardados mediante marshal, cuyo uso no es seguro con datos de entrada no fiables o no autenticados. No cargues archivos de perfilado de fuentes no fiables ni archivos cuya autenticidad no se haya verificado.

sort_stats(pstats.SortKey.TIME) ordena según el tiempo propio de una función, sin contar las funciones llamadas; pstats.SortKey.CUMULATIVE incluye su tiempo. print_stats(10) muestra las diez primeras entradas.

get_stats_profile() permite acceder a los datos desde el programa. El ejemplo lee el número de llamadas a work y evita mediciones de tiempo variables.

No des por sentado que los archivos de perfilado son compatibles entre distintas versiones de Python, perfiladores o sistemas operativos. strip_dirs() elimina irreversiblemente las rutas del objeto y puede combinar entradas indistinguibles.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes