CKTIS / Python
cProfile.runctx
runctx perfila instrucciones con el diccionario global y la correspondencia de nombres locales indicados.
Versión: Python 3.14; repository image, production runtime not attested
Sintaxis
cProfile.runctx(statement, globals, locals, filename=None, sort=-1)runctx perfila instrucciones con el diccionario global y la correspondencia de nombres locales indicados.
En CPython 3.14.9, raise SystemExit() en este contexto hace que runctx devuelva None, mientras que raise ValueError() propaga la excepción. En ambos casos el perfil se escribe en el archivo indicado y pstats.Stats puede leerlo. Como en exec, una asignación simple de nivel superior escribe en locals. En el ejemplo n vale 4 y después local['total'] contiene 12. Con filename se guarda el perfil, sin él se imprime un informe ordenado según sort.
La función devuelve 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
Ejemplos
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())
Resultado
12 True
La función devuelve None.