25.8.1 Profile Objects

25.8.1 Profile Objects

Profile objects have the following methods:

addinfo( key, value): Add an arbitrary labelled value to the profile output.

close( ): Close the logfile and terminate the profiler.

fileno( ): Return the file descriptor of the profiler's log file.

run( cmd): Profile an exec-compatible string in the script environment. The globals from the __main__ module are used as both the globals and locals for the script.

runcall( func, *args, **keywords): Profile a single call of a callable. Additional positional and keyword arguments may be passed along; the result of the call is returned, and exceptions are allowed to propagate cleanly, while ensuring that profiling is disabled on the way out.

runctx( cmd, globals, locals): Evaluate an exec-compatible string in a specific environment. The string is compiled before profiling begins.

start( ): Start the profiler.

stop( ): Stop the profiler.

See About this document... for information on suggesting changes.