bokeh.application.handlers.code_runner

Provide a utility class CodeRunner for use by handlers that execute Python source code.

class CodeRunner(source: str, path: str | PathLike[str], argv: list[str], package: ModuleType | None = None)

Compile and run Python source code.

__init__(source: str, path: str | PathLike[str], argv: list[str], package: ModuleType | None = None) → None

Parameters:

• source (str) – A string containing Python source code to execute

• path (str) – A filename to use in any debugging or error output

• argv (list[str]) – A list of string arguments to make available as sys.argv when the code executes

• package (bool) – An optional package module to configure

Raises:

ValueError, if package is specified for an __init__.py –

new_module() → ModuleType | None

Make a fresh module to run in.

Returns:

Module

reset_run_errors() → None

Clears any transient error conditions from a previous run.

Returns

None

run(module: ModuleType, post_check: Callable[[], None] | None = None) → None

Execute the configured source code in a module and run any post checks.

Parameters:

• module (Module) – A module to execute the configured code in.

• post_check (callable, optional) – A function that raises an exception if expected post-conditions are not met after code execution.

property doc: str | None

Contents of docstring, if code contains one.

property error: str | None

If code execution fails, may contain a related error message.

property error_detail: str | None

If code execution fails, may contain a traceback or other details.

property failed: bool

True if code execution failed

property path: str | PathLike[str]

The path that new modules will be configured with.

property source: str

The configured source code that will be executed when run is called.