Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Python

cProfile.runctx

runctx profiluje příkazy se zadaným globálním slovníkem a mapováním lokálních jmen.

Verze: Python 3.14; repository image, production runtime not attested

Syntaxe

cProfile.runctx(statement, globals, locals, filename=None, sort=-1)

runctx profiluje příkazy se zadaným globálním slovníkem a mapováním lokálních jmen.

V CPythonu 3.14.9 ukončí raise SystemExit() v tomto kontextu runctx s výsledkem None, zatímco raise ValueError() předá výjimku dál. V obou případech se profil zapíše do určeného souboru a pstats.Stats jej dokáže přečíst. Stejně jako u exec zapisuje jednoduché přiřazení na nejvyšší úrovni do locals. V příkladu má n hodnotu 4 a local['total'] pak obsahuje 12. S filename se profil uloží, bez něj se vypíše přehled seřazený podle sort.

Funkce vrátí 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

Příklady

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())

Výsledek

12 True

Funkce vrátí None.

Zdroje