Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

cProfile.Profile

Obiekt Profile zbiera statystyki wywołań, a runcall zwraca zwykły wynik funkcji.

Wersja: Python 3.14; repository image, production runtime not attested

Składnia

cProfile.Profile()
profiler.runcall(func, /, *args, **kwargs)

Obiekt Profile zbiera statystyki wywołań, a runcall zwraca zwykły wynik funkcji.

create_stats() wyłącza pomiar i zapamiętuje zebrane statystyki. print_stats() wypisuje raport tekstowy, natomiast dump_stats(path) zapisuje dane do późniejszego odczytu przez pstats.Stats. Dla square(4) wynikiem jest 16 i profil rejestruje jedno wywołanie square. Przy rekurencji pstats.Stats rozróżnia wszystkie wywołania od pierwotnych, które nie wynikają z rekurencji. Zakres pomiaru można wybrać przez enable() i disable() lub blok with.

Czasy zależą od obciążenia maszyny.

import cProfile,pstats
def visit(n):
    return visit(n-1)+1 if n else 1
p=cProfile.Profile()
assert p.runcall(visit,2)==3
stats=pstats.Stats(p).stats
counts=[v[:2] for k,v in stats.items() if k[2]=='visit']
assert counts==[(1,3)]
import contextlib,io,tempfile,os
p.enable()
visit(1)
p.create_stats()
visit(4)
assert [v[1] for k,v in p.stats.items() if k[2]=='visit']==[5]
with contextlib.redirect_stdout(io.StringIO()) as out: p.print_stats()
assert 'visit' in out.getvalue()
with tempfile.TemporaryDirectory() as d:
    path=os.path.join(d,'prof')
    p.dump_stats(path)
    assert [v[1] for k,v in pstats.Stats(path).stats.items() if k[2]=='visit']==[5]

cProfile.Profile.enable · cProfile.Profile.disable

enable() rozpoczyna zbieranie zdarzeń profilera, a disable() je zatrzymuje. Użycie finally domyka pomiar po wyjątku. Spośród trzech wywołań work tylko środkowe wpada w mierzony odcinek.

import cProfile
def work(): return 5
p=cProfile.Profile()
work()
p.enable()
try: work()
finally: p.disable()
work()
counts=[r.callcount for r in p.getstats() if r.code is work.__code__]
assert counts==[1]

Przykłady

import cProfile
def square(n): return n * n

p = cProfile.Profile()
print(p.runcall(square, 4))
print([e.callcount for e in p.getstats() if getattr(e.code, "co_name", None) == "square"])

Wynik

16
[1]

Czasy zależą od obciążenia maszyny.

Źródła