httk.serve.web.functions.python_module

Load and invoke site-local Python function modules safely.

Classes

PythonFunctionHandler

Load cached site function modules and invoke their public facades.

Module Contents

class httk.serve.web.functions.python_module.PythonFunctionHandler(functions_dir)

Load cached site function modules and invoke their public facades.

Parameters:

functions_dir (pathlib.Path) – Directory containing trusted site function modules.

functions_dir

execute(*, function_name, params, global_data)

Execute a site function with request parameters and global data.

Parameters:

• function_name (str) – Relative function module name.

• params (dict[str, str]) – String parameters passed as keyword arguments.

• global_data (dict[str, object]) – Site-global values passed as global_data.

Returns:

Value returned by the module’s execute facade.

Raises:

• FileNotFoundError – If the function module does not exist.

• ValueError – If the module path or execute facade is invalid.

Return type:

Any

execute_provider(*, provider_name, context, request, provider_args)

Call a contained site function module’s explicit provide facade.

Parameters:

• provider_name (str) – Relative provider module name.

• context (object) – Immutable provider context.

• request (object) – Bounded table page request.

• provider_args (dict[str, object]) – Literal provider arguments from the widget.

Returns:

Value returned by the module’s provide facade.

Raises:

• FileNotFoundError – If the provider module does not exist.

• ValueError – If the module or provider signature is invalid.

Return type:

Any