CKTIS / Python
pstats.Stats.stats — estadísticas de perfilado sin procesar
pstats.Stats.stats es un diccionario de datos de perfilado cuyas claves combinan el nombre de archivo, el número de línea y el nombre de función. Permite consultar directamente los recuentos de llamadas, el tiempo interno, el tiempo acumulado y la información sobre las funciones que llaman, sin analizar un informe de texto.
Versión: Python 3.14; repository image, production runtime not attested
Sintaxis
stats = pstats.Stats(profiler)
cc, nc, tt, ct, callers = stats.stats[(filename, line_number, function_name)]pstats.Stats.stats es un atributo de instancia, no un método. Cada clave tiene la forma (filename, line_number, function_name) y cada valor, la forma (cc, nc, tt, ct, callers). Ni siquiera la clave completa identifica una función de forma unívoca: dos funciones lambda distintas definidas en la misma línea de código fuente tienen el mismo nombre de archivo, el mismo número de línea y el mismo nombre de función (<lambda>), por lo que comparten la misma clave.
cc cuenta las llamadas primitivas, excluidas las inducidas por la recursión; nc cuenta todas las llamadas. tt es el tiempo interno de la función, sin las subllamadas, mientras que ct es el tiempo acumulado, incluidas las subllamadas, en segundos. No sumes los ct de todas las funciones para obtener el tiempo total del programa: esos intervalos se solapan.
callers asigna datos dependientes del perfilador a las claves de las funciones que llaman. Con cProfile, cada valor es (nc, cc, tt, ct) para esa relación de llamada: el orden de los contadores es inverso al de la tupla externa. Con profile, cada valor es un recuento de llamadas. La recursión puede hacer que una función sea su propia función llamadora.
Trata este diccionario como una representación de implementación de bajo nivel de CPython 3.14, no como una garantía de formato portable. Evita modificarlo manualmente: el objeto también mantiene totales y cachés. strip_dirs() cambia las claves y puede fusionar entradas; sort_stats() establece el orden del informe, no el del diccionario. El ejemplo muestra recuentos deterministas en lugar de tiempos variables. Esta entrada se basa en el código del repositorio; el entorno de producción no está acreditado.
Ejemplos
import cProfile
import pstats
def countdown(n):
if n:
countdown(n - 1)
profiler = cProfile.Profile()
profiler.runcall(countdown, 3)
stats = pstats.Stats(profiler)
key = (countdown.__code__.co_filename,
countdown.__code__.co_firstlineno,
countdown.__code__.co_name)
cc, nc, tt, ct, callers = stats.stats[key]
assert (cc, nc) == (1, 4)
assert key in callers
print(f"primitive={cc}, total={nc}")
print(f"recursive_caller={key in callers}")Resultado
primitive=1, total=4 recursive_caller=True
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.