Module slack_bolt.context.base_context

Classes

class BaseContext (*args, **kwargs)

Context object associated with a request from Slack.

Expand source code

class BaseContext(dict):
    """Context object associated with a request from Slack."""

    standard_property_names = [
        "logger",
        "token",
        "enterprise_id",
        "is_enterprise_install",
        "team_id",
        "user_id",
        "actor_enterprise_id",
        "actor_team_id",
        "actor_user_id",
        "channel_id",
        "response_url",
        "matches",
        "authorize_result",
        "bot_token",
        "bot_id",
        "bot_user_id",
        "user_token",
        "client",
        "ack",
        "say",
        "respond",
    ]

    @property
    def logger(self) -> Logger:
        """The properly configured logger that is available for middleware/listeners."""
        return self["logger"]

    @property
    def token(self) -> Optional[str]:
        """The (bot/user) token resolved for this request."""
        return self.get("token")

    @property
    def enterprise_id(self) -> Optional[str]:
        """The Enterprise Grid Organization ID of this request."""
        return self.get("enterprise_id")

    @property
    def is_enterprise_install(self) -> Optional[bool]:
        """True if the request is associated with an Org-wide installation."""
        return self.get("is_enterprise_install")

    @property
    def team_id(self) -> Optional[str]:
        """The Workspace ID of this request."""
        return self.get("team_id")

    @property
    def user_id(self) -> Optional[str]:
        """The user ID associated ith this request."""
        return self.get("user_id")

    @property
    def actor_enterprise_id(self) -> Optional[str]:
        """The action's actor's Enterprise Grid organization ID.
        Note that this property is especially useful for handling events in Slack Connect channels.
        That being said, it's not guaranteed to have a valid ID for all events due to server-side inconsistency.
        """
        return self.get("actor_enterprise_id")

    @property
    def actor_team_id(self) -> Optional[str]:
        """The action's actor's workspace ID.
        Note that this property is especially useful for handling events in Slack Connect channels.
        That being said, it's not guaranteed to have a valid ID for all events due to server-side inconsistency.
        """
        return self.get("actor_team_id")

    @property
    def actor_user_id(self) -> Optional[str]:
        """The action's actor's user ID.
        Note that this property is especially useful for handling events in Slack Connect channels.
        That being said, it's not guaranteed to have a valid ID for all events due to server-side inconsistency.
        """
        return self.get("actor_user_id")

    @property
    def channel_id(self) -> Optional[str]:
        """The conversation ID associated with this request."""
        return self.get("channel_id")

    @property
    def response_url(self) -> Optional[str]:
        """The `response_url` associated with this request."""
        return self.get("response_url")

    @property
    def matches(self) -> Optional[Tuple]:
        """Returns all the matched parts in message listener's regexp"""
        return self.get("matches")

    # --------------------------------

    @property
    def authorize_result(self) -> Optional[AuthorizeResult]:
        """The authorize result resolved for this request."""
        return self.get("authorize_result")

    @property
    def bot_token(self) -> Optional[str]:
        """The bot token resolved for this request."""
        return self.get("bot_token")

    @property
    def bot_id(self) -> Optional[str]:
        """The bot ID resolved for this request."""
        return self.get("bot_id")

    @property
    def bot_user_id(self) -> Optional[str]:
        """The bot user ID resolved for this request."""
        return self.get("bot_user_id")

    @property
    def user_token(self) -> Optional[str]:
        """The user token resolved for this request."""
        return self.get("user_token")

    def set_authorize_result(self, authorize_result: AuthorizeResult):
        self["authorize_result"] = authorize_result
        if authorize_result.bot_id is not None:
            self["bot_id"] = authorize_result.bot_id
        if authorize_result.bot_user_id is not None:
            self["bot_user_id"] = authorize_result.bot_user_id
        if authorize_result.bot_token is not None:
            self["bot_token"] = authorize_result.bot_token
        if authorize_result.user_id is not None:
            self["user_id"] = authorize_result.user_id
        if authorize_result.user_token is not None:
            self["user_token"] = authorize_result.user_token

Ancestors

• builtins.dict

Subclasses

• AsyncBoltContext
• BoltContext

Class variables

var standard_property_names

Instance variables

var actor_enterprise_id : Optional[str]

The action's actor's Enterprise Grid organization ID. Note that this property is especially useful for handling events in Slack Connect channels. That being said, it's not guaranteed to have a valid ID for all events due to server-side inconsistency.

Expand source code

@property
def actor_enterprise_id(self) -> Optional[str]:
    """The action's actor's Enterprise Grid organization ID.
    Note that this property is especially useful for handling events in Slack Connect channels.
    That being said, it's not guaranteed to have a valid ID for all events due to server-side inconsistency.
    """
    return self.get("actor_enterprise_id")

var actor_team_id : Optional[str]

The action's actor's workspace ID. Note that this property is especially useful for handling events in Slack Connect channels. That being said, it's not guaranteed to have a valid ID for all events due to server-side inconsistency.

Expand source code

@property
def actor_team_id(self) -> Optional[str]:
    """The action's actor's workspace ID.
    Note that this property is especially useful for handling events in Slack Connect channels.
    That being said, it's not guaranteed to have a valid ID for all events due to server-side inconsistency.
    """
    return self.get("actor_team_id")

var actor_user_id : Optional[str]

The action's actor's user ID. Note that this property is especially useful for handling events in Slack Connect channels. That being said, it's not guaranteed to have a valid ID for all events due to server-side inconsistency.

Expand source code

@property
def actor_user_id(self) -> Optional[str]:
    """The action's actor's user ID.
    Note that this property is especially useful for handling events in Slack Connect channels.
    That being said, it's not guaranteed to have a valid ID for all events due to server-side inconsistency.
    """
    return self.get("actor_user_id")

var authorize_result : Optional[AuthorizeResult]

The authorize result resolved for this request.

Expand source code

@property
def authorize_result(self) -> Optional[AuthorizeResult]:
    """The authorize result resolved for this request."""
    return self.get("authorize_result")

var bot_id : Optional[str]

The bot ID resolved for this request.

Expand source code

@property
def bot_id(self) -> Optional[str]:
    """The bot ID resolved for this request."""
    return self.get("bot_id")

var bot_token : Optional[str]

The bot token resolved for this request.

Expand source code

@property
def bot_token(self) -> Optional[str]:
    """The bot token resolved for this request."""
    return self.get("bot_token")

var bot_user_id : Optional[str]

The bot user ID resolved for this request.

Expand source code

@property
def bot_user_id(self) -> Optional[str]:
    """The bot user ID resolved for this request."""
    return self.get("bot_user_id")

var channel_id : Optional[str]

The conversation ID associated with this request.

Expand source code

@property
def channel_id(self) -> Optional[str]:
    """The conversation ID associated with this request."""
    return self.get("channel_id")

var enterprise_id : Optional[str]

The Enterprise Grid Organization ID of this request.

Expand source code

@property
def enterprise_id(self) -> Optional[str]:
    """The Enterprise Grid Organization ID of this request."""
    return self.get("enterprise_id")

var is_enterprise_install : Optional[bool]

True if the request is associated with an Org-wide installation.

Expand source code

@property
def is_enterprise_install(self) -> Optional[bool]:
    """True if the request is associated with an Org-wide installation."""
    return self.get("is_enterprise_install")

var logger : logging.Logger

The properly configured logger that is available for middleware/listeners.

Expand source code

@property
def logger(self) -> Logger:
    """The properly configured logger that is available for middleware/listeners."""
    return self["logger"]

var matches : Optional[Tuple]

Returns all the matched parts in message listener's regexp

Expand source code

@property
def matches(self) -> Optional[Tuple]:
    """Returns all the matched parts in message listener's regexp"""
    return self.get("matches")

var response_url : Optional[str]

The response_url associated with this request.

Expand source code

@property
def response_url(self) -> Optional[str]:
    """The `response_url` associated with this request."""
    return self.get("response_url")

var team_id : Optional[str]

The Workspace ID of this request.

Expand source code

@property
def team_id(self) -> Optional[str]:
    """The Workspace ID of this request."""
    return self.get("team_id")

var token : Optional[str]

The (bot/user) token resolved for this request.

Expand source code

@property
def token(self) -> Optional[str]:
    """The (bot/user) token resolved for this request."""
    return self.get("token")

var user_id : Optional[str]

The user ID associated ith this request.

Expand source code

@property
def user_id(self) -> Optional[str]:
    """The user ID associated ith this request."""
    return self.get("user_id")

var user_token : Optional[str]

The user token resolved for this request.

Expand source code

@property
def user_token(self) -> Optional[str]:
    """The user token resolved for this request."""
    return self.get("user_token")

Methods

def set_authorize_result(self, authorize_result: AuthorizeResult)

Expand source code

def set_authorize_result(self, authorize_result: AuthorizeResult):
    self["authorize_result"] = authorize_result
    if authorize_result.bot_id is not None:
        self["bot_id"] = authorize_result.bot_id
    if authorize_result.bot_user_id is not None:
        self["bot_user_id"] = authorize_result.bot_user_id
    if authorize_result.bot_token is not None:
        self["bot_token"] = authorize_result.bot_token
    if authorize_result.user_id is not None:
        self["user_id"] = authorize_result.user_id
    if authorize_result.user_token is not None:
        self["user_token"] = authorize_result.user_token