Skip to content

EventHandler class

Bases: ABC

An abstract base class that defines the workflow and essential protocols for event handling.

Source code in pyventus/events/handlers/event_handler.py 
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
class EventHandler(ABC):
    """An abstract base class that defines the workflow and essential protocols for event handling."""

    # Allow subclasses to define __slots__
    __slots__ = ()

    @abstractmethod
    async def _handle_event(self, *args: Any, **kwargs: Any) -> Any:
        """
        Handle the event response.

        :param args: Positional arguments containing event-specific data.
        :param kwargs: Keyword arguments containing event-specific data.
        :return: The result of handling the event.
        """
        pass

    @abstractmethod
    async def _handle_success(self, results: Any) -> None:
        """
        Handle the successful completion of the event response.

        :param results: The results of handling the event.
        :return: None.
        """
        pass

    @abstractmethod
    async def _handle_failure(self, exception: Exception) -> None:
        """
        Handle the failed completion of the event response.

        :param exception: The exception that occurred during the event handling.
        :return: None.
        """
        pass

    async def execute(self, *args: Any, **kwargs: Any) -> None:
        """
        Execute the event workflow.

        :param args: Positional arguments containing event-specific data.
        :param kwargs: Keyword arguments containing event-specific data.
        :return: None.
        """
        try:
            # Start the event handling process and store the results
            results: Any = await self._handle_event(*args, **kwargs)
        except Exception as exception:
            # Log the exception that occurred during the event handling.
            StdOutLogger.error(source=summarized_repr(self), action="Exception:", msg=f"{repr(exception)}")

            # Handle the failed completion of the event response.
            await self._handle_failure(exception=exception)
        else:
            # Handle the successful completion of the event response.
            await self._handle_success(results=results)

Functions

execute async 

execute(*args: Any, **kwargs: Any) -> None

Execute the event workflow.

PARAMETER DESCRIPTION
args

Positional arguments containing event-specific data.

TYPE: Any DEFAULT: ()

kwargs

Keyword arguments containing event-specific data.

TYPE: Any DEFAULT: {}

RETURNS DESCRIPTION
None

None.
Source code in pyventus/events/handlers/event_handler.py 
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
async def execute(self, *args: Any, **kwargs: Any) -> None:
    """
    Execute the event workflow.

    :param args: Positional arguments containing event-specific data.
    :param kwargs: Keyword arguments containing event-specific data.
    :return: None.
    """
    try:
        # Start the event handling process and store the results
        results: Any = await self._handle_event(*args, **kwargs)
    except Exception as exception:
        # Log the exception that occurred during the event handling.
        StdOutLogger.error(source=summarized_repr(self), action="Exception:", msg=f"{repr(exception)}")

        # Handle the failed completion of the event response.
        await self._handle_failure(exception=exception)
    else:
        # Handle the successful completion of the event response.
        await self._handle_success(results=results)