CKTIS / Python
pstats.Stats.stats — estatísticas brutas de profiling
pstats.Stats.stats é um dicionário de dados de profiling cujas chaves combinam o nome do ficheiro, o número da linha e o nome da função. Permite consultar diretamente as contagens de chamadas, o tempo interno, o tempo cumulativo e informações sobre as funções chamadoras, sem analisar um relatório de texto.
Versão: Python 3.14; repository image, production runtime not attested
Sintaxe
stats = pstats.Stats(profiler)
cc, nc, tt, ct, callers = stats.stats[(filename, line_number, function_name)]pstats.Stats.stats é um atributo de instância, não um método. Cada chave tem a forma (filename, line_number, function_name) e cada valor tem a forma (cc, nc, tt, ct, callers). Nem mesmo a chave completa identifica uma função de forma inequívoca: duas funções lambda distintas definidas na mesma linha de código-fonte têm o mesmo nome de ficheiro, o mesmo número de linha e o mesmo nome de função (<lambda>), pelo que partilham a mesma chave.
cc conta as chamadas primitivas, excluindo as chamadas induzidas pela recursão; nc conta todas as chamadas. tt é o tempo interno da função, sem subchamadas, enquanto ct é o tempo cumulativo, incluindo subchamadas, em segundos. Não somes os valores ct de todas as funções para obter o tempo total do programa: estes intervalos sobrepõem-se.
callers associa dados dependentes do profiler às chaves das funções chamadoras. Com cProfile, cada valor é (nc, cc, tt, ct) para a relação de chamada correspondente — a ordem das contagens é inversa à da tupla externa. Com profile, cada valor é uma contagem de chamadas. A recursão pode fazer com que uma função seja a sua própria chamadora.
Considera este dicionário uma representação de implementação de baixo nível do CPython 3.14, não uma garantia de formato portátil. Evita modificá-lo manualmente: o objeto também mantém totais e caches. strip_dirs() altera as chaves e pode unir entradas; sort_stats() define a ordem do relatório, não a ordem do dicionário. O exemplo mostra contagens determinísticas, em vez de tempos variáveis. Esta entrada baseia-se no código do repositório; o ambiente de produção não foi atestado.
Exemplos
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
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.