CKTIS / Python
cProfile.runctx
runctx profiluje instrukcje z podanym słownikiem globalnym i lokalnym odwzorowaniem nazw.
Wersja: Python 3.14; repository image, production runtime not attested
Składnia
cProfile.runctx(statement, globals, locals, filename=None, sort=-1)runctx profiluje instrukcje z podanym słownikiem globalnym i lokalnym odwzorowaniem nazw.
W CPython 3.14.9 instrukcja raise SystemExit() w tym kontekście kończy runctx wynikiem None, a raise ValueError() propaguje wyjątek. W obu przypadkach profil trafia do wskazanego pliku i daje się odczytać przez pstats.Stats. Kod wykonuje się jak exec, więc zwykłe przypisanie na najwyższym poziomie zapisuje wynik w locals. W przykładzie n ma wartość 4, a po wykonaniu local['total'] ma 12. Podanie filename zapisuje profil do pliku, bez niego powstaje raport według sort.
Funkcja zwraca None.
import cProfile,pstats,tempfile,os
g={'scale':3}
l={'n':4}
with tempfile.TemporaryDirectory() as directory:
path=os.path.join(directory,'t.prof')
assert cProfile.runctx("total = n*scale",g,l,path) is None
assert l['total']==12 and 'total' not in g
assert pstats.Stats(path).total_calls>0
with tempfile.TemporaryDirectory() as directory:
for exc in ('SystemExit','ValueError'):
path=os.path.join(directory,exc+'.prof')
try: result=cProfile.runctx("raise "+exc+"()",g,l,path)
except ValueError: assert exc=='ValueError'
else: assert exc=='SystemExit' and result is None
assert pstats.Stats(path).total_calls>0
Przykłady
import cProfile
from pathlib import Path
from tempfile import TemporaryDirectory
local = {"n": 4}
with TemporaryDirectory() as d:
p = Path(d) / "sample.prof"
cProfile.runctx("total = n * 3", {}, local, str(p))
print(local["total"], p.is_file())
Wynik
12 True
Funkcja zwraca None.