httk.serve.web.functions
========================

.. py:module:: httk.serve.web.functions

.. autoapi-nested-parse::

   Provide handlers for trusted site-local Python function modules.



Submodules
----------

.. toctree::
   :maxdepth: 1

   /reference/autoapi/httk/serve/web/functions/python_module/index


Classes
-------

.. autoapisummary::

   httk.serve.web.functions.PythonFunctionHandler


Package Contents
----------------

.. py:class:: PythonFunctionHandler(functions_dir)

   Load cached site function modules and invoke their public facades.

   :param functions_dir: Directory containing trusted site function modules.


   .. py:attribute:: functions_dir


   .. py:method:: execute(*, function_name, params, global_data)

      Execute a site function with request parameters and global data.

      :param function_name: Relative function module name.
      :param params: String parameters passed as keyword arguments.
      :param global_data: Site-global values passed as ``global_data``.
      :return: Value returned by the module's ``execute`` facade.
      :raises FileNotFoundError: If the function module does not exist.
      :raises ValueError: If the module path or execute facade is invalid.



   .. py:method:: execute_provider(*, provider_name, context, request, provider_args)

      Call a contained site function module's explicit ``provide`` facade.

      :param provider_name: Relative provider module name.
      :param context: Immutable provider context.
      :param request: Bounded table page request.
      :param provider_args: Literal provider arguments from the widget.
      :return: Value returned by the module's ``provide`` facade.
      :raises FileNotFoundError: If the provider module does not exist.
      :raises ValueError: If the module or provider signature is invalid.