Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes