CKTIS / Python
cProfile.run
run profiluje příkazy ve jmenném prostoru hlavního modulu.
Verze: Python 3.14; repository image, production runtime not attested
Syntaxe
cProfile.run(statement, filename=None, sort=-1)run profiluje příkazy ve jmenném prostoru hlavního modulu.
V CPythonu 3.14.9 zachytí run výjimku SystemExit z příkazu a vrátí None. ValueError se předá volajícímu. Při zadání filename lze v obou případech data načíst pomocí pstats.Stats. Jeho slovník slouží současně jako globální a lokální prostor. Bez filename vypíše přehled seřazený podle sort. Při zadání cesty uloží statistiky pro pstats.Stats. Funkce vrátí None.
Příklad načte z dočasného souboru jedno volání square.
import cProfile, pstats, tempfile, os, __main__
def probe(): return 5
__main__.__dict__['profile_probe']=probe
try:
with tempfile.TemporaryDirectory() as directory:
target=os.path.join(directory,'p.prof')
assert cProfile.run("profile_probe()", target) is None
assert [v[1] for k,v in pstats.Stats(target).stats.items() if k[2]=='probe']==[1]
finally: del __main__.__dict__['profile_probe']
with tempfile.TemporaryDirectory() as directory:
for exc in ('SystemExit','ValueError'):
path=os.path.join(directory,exc+'.prof')
try: result=cProfile.run("raise "+exc+"()",path)
except ValueError: assert exc=='ValueError'
else: assert exc=='SystemExit' and result is None
assert pstats.Stats(path).total_calls>0
Příklady
import cProfile
import pstats
from pathlib import Path
from tempfile import TemporaryDirectory
def square(n): return n * n
with TemporaryDirectory() as d:
p = str(Path(d) / "sample.prof")
cProfile.run("square(4)", p)
print(sum(stat[1] for key, stat in pstats.Stats(p).stats.items() if key[2] == "square"))
Výsledek
1
Příklad načte z dočasného souboru jedno volání square.