CKTIS / Python
cProfile.run
run profiluje príkazy v mennom priestore hlavného modulu.
Verzia: Python 3.14; repository image, production runtime not attested
Syntax
cProfile.run(statement, filename=None, sort=-1)run profiluje príkazy v mennom priestore hlavného modulu.
V CPythone 3.14.9 zachytí run výnimku SystemExit z príkazu a vráti None. ValueError sa odovzdá volajúcemu. Pri zadaní filename sa v oboch prípadoch dajú údaje načítať pomocou pstats.Stats. Jeho slovník slúži súčasne ako globálny aj lokálny priestor. Bez filename vypíše prehľad zoradený podľa sort. Pri zadaní cesty uloží štatistiky pre pstats.Stats. Funkcia vráti None.
Príklad načíta z dočasného súboru jedno volanie 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
Prí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ýsledok
1
Príklad načíta z dočasného súboru jedno volanie square.