CKTIS / Python
cProfile.run
run profiliert Anweisungen im Namensraum des Hauptmoduls.
Version: Python 3.14; repository image, production runtime not attested
Syntax
cProfile.run(statement, filename=None, sort=-1)run profiliert Anweisungen im Namensraum des Hauptmoduls.
In CPython 3.14.9 fängt run ein SystemExit aus der Anweisung ab und liefert None. ValueError erreicht den Aufrufer. Mit filename kann pstats.Stats in beiden Fällen die gespeicherten Daten lesen. Dessen Wörterbuch dient zugleich als globaler und lokaler Namensraum. Ohne filename erscheint ein nach sort geordneter Bericht, mit Dateinamen werden Statistikdaten für pstats.Stats gespeichert. Der Rückgabewert ist None.
Das Beispiel liest einen Aufruf von square aus der temporären Datei.
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
Beispiele
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"))
Ergebnis
1
Das Beispiel liest einen Aufruf von square aus der temporären Datei.