Class SlackError

enterprise/integrations/slack/slack_errors.py:33–65

Exception for errors that should be communicated to the Slack user. This exception is caught by the centralized error handler in SlackManager, which logs the error and sends an appropriate message to the user. Usage: raise SlackError(SlackErrorCode.USER_NOT_AUTHENTICATED,

class SlackError(Exception):
    """Exception for errors that should be communicated to the Slack user.

    This exception is caught by the centralized error handler in SlackManager,
    which logs the error and sends an appropriate message to the user.

    Usage:
        raise SlackError(SlackErrorCode.USER_NOT_AUTHENTICATED,
                        message_kwargs={'login_link': link})
    """

    def __init__(
        self,
        code: SlackErrorCode,
        message_kwargs: dict[str, Any] | None = None,
        log_context: dict[str, Any] | None = None,
    ):
        """Initialize a SlackError.

        Args:
            code: The error code identifying the type of error
            message_kwargs: Kwargs for formatting the user message
                           (e.g., {'login_link': '...'})
            log_context: Additional context for structured logging
        """
        self.code = code
        self.message_kwargs = message_kwargs or {}
        self.log_context = log_context or {}
        super().__init__(f'{code.value}: {code.name}')

    def get_user_message(self) -> str:
        """Get the user-facing message for this error."""
        return get_user_message(self.code, **self.message_kwargs)


# Centralized user-facing messages